- NPC API가 추가되었습니다 (/mnpc).
- NBT API가 추가되었습니다 (EntityNBT, ItemNBT).
- Multi World API가 추가되었습니다 (/mworld).
무료M-Core
Paper · Folia 플러그인 개발용 올인원 코어 — 설정 · DB · 다국어 · 명령어 · GUI · 지역 · 스코어보드 · 홀로그램을 jar 하나로. 플러그인이 꺼지면 모두 자동 정리됩니다.
1 다운로드
0 팔로워
🎉 M-Core 첫 공개 릴리스입니다. 플러그인 개발에 필요한 기능을 한 플러그인에 담았고, 일반 Paper와 Folia에서 같은 코드가 그대로 돌아갑니다.
| 항목 | 내용 |
|---|---|
| 릴리스 날짜 | 2026년 11월 10일 |
| 대상 | Paper · Purpur · Folia 1.21 이상 / Java 21 / Kotlin 2.1 |
| 테스트 | 단위 테스트 50개 통과 |
✨ 새로운 기능
코어 · 플러그인 기반
ModernPlugin기반 클래스 — 상속만 하면core로 모든 기능에 접근ModernCore.of(plugin)으로ModernPlugin을 상속하지 않은 플러그인도 사용 가능- 플러그인이 꺼질 때 명령어 · GUI · DB 커넥션 풀 · 모듈 · 코루틴 · 홀로그램 · 스코어보드 자동 정리
- Kotlin 런타임과 코루틴을 코어가 제공 — 플러그인마다 중복 번들 불필요
/moderncore명령어: 코어 상태 · 플러그인 목록 · 모듈 목록 · 리로드
설정
- 여러 yml 파일을 이름으로 불러오고 한 번에 리로드
- 타입 지정 읽기(
ConfigNode·ConfigValue·Codecs)와 기본값 처리
데이터베이스
- MySQL · MariaDB · PostgreSQL · SQLite 지원, HikariCP 커넥션 풀
- 테이블 빌더, Row 매핑, 키-값 저장소(
KeyValueStore) config.yml의database섹션을 그대로 읽는connectFromConfig()- SQLite · MySQL 드라이버는 서버 시작 시 자동 다운로드
- HikariCP를 재배치(relocate)해 다른 플러그인의 사본과 충돌하지 않음
EveryDB
- everydb.kr REST 클라이언트 — 테이블 · 스키마 · 조건 조회 · 내보내기
- 플러그인 설정을 먼저 보고, 없으면 M-Core 설정 사용 — 키를 한 번만 넣으면 모든 플러그인이 공유
- 네트워크 오류 · 5xx · 429 응답에 대한 재시도 횟수 설정
다국어
- 한국어 · 영어 · 일본어 기본 지원, 플레이어별 언어를 서버 전체에서 공유
/lang으로ko·en·jp·auto선택 (auto는 클라이언트 언어를 따름)- 메시지를
lang/messages_*.yml로 자동 생성 — 관리자가 직접 수정 가능 - 언어를 바꾸면
PlayerLanguageChangeEvent발생 — 화면을 즉시 다시 그릴 수 있음
명령어
plugin.yml에 적지 않고 코드로 등록하는 명령어 DSL- 하위 명령어, 인자 타입(플레이어 · 정수 · 문자열 · 열거형 등), 선택 인자, 권한, 탭 완성, 도움말 자동 생성
executesAsync로 비동기 실행, 플러그인이 꺼지면 등록 자동 해제
모듈
- 기능을
ModernModule단위로 나누고 의존 관계를 적으면 활성화 순서 자동 정렬 - 비활성화는 활성화의 역순으로 진행
색상
- 2색 · 3색 그라데이션, 무지개,
<gradient:#aaa:#bbb>태그, 레거시&코드 혼용 - 보간 방식 선택(RGB 선형 등)
GUI · 인벤토리
- 일반 GUI(
ChestGui)와 페이지 GUI(PaginatedGui), 아이템 빌더, 테두리 · 채움 유틸 - 화면 기록(
GuiHistory) 관리 — '뒤로 가기' 버튼이 항상 직전 화면으로 이동 - 페이지 GUI를 다시 열 때 보던 페이지 복원 (언어 변경 등으로 다시 열어야 할 때)
- 플러그인이 꺼지면 열려 있던 GUI를 모두 닫음
GUI 레이아웃 (yml)
- 제목 · 줄 수 · 배경 · 칸 배치 · 버튼 · 클릭 동작 · 설명 문구를
gui/폴더의 yml로 분리 - 관리자가 파일을 고치고 리로드하면 인게임 GUI에 바로 반영
지역
- 직육면체 · 구 · 다각형 지역, 우선순위 지원
- 플래그:
PVPBUILDBREAKINTERACTDAMAGEMOB_SPAWNINGEXPLOSIONITEM_DROPENTRYEXITGREETINGFAREWELL - 코어가 플래그를 직접 적용하고
RegionEnterEvent·RegionLeaveEvent발생 regions.yml에 자동 저장, 서버 시작 시 복원mservice.core.region.bypass권한으로 모든 보호 무시
스코어보드
- 제목 · 줄을 람다로 주면 주기적으로 갱신되는 사이드바
- 제목만 따로 갱신 가능 — 제목 애니메이션에 활용
- Folia에서는 사이드바 패킷을 직접 전송, 일반 Paper에서는 Bukkit 스코어보드 API 사용
- 플레이어가 나가면 자동 정리, 플러그인이 꺼지면 서버 기본 스코어보드로 복귀
홀로그램
- 텍스트 디스플레이 기반 — 줄 간격 · 정렬 · 배경색 · 투명도 · 그림자 · 크기 · 시야 거리 · 밝기 · 줄 너비 설정
- 플레이어마다 다른 내용 표시와 클릭 처리
- 접속한 플레이어에게 공개 홀로그램을 다시 표시 — 접속 직후 글자가 안 보이는 현상 없음
- 서버가 비정상 종료된 뒤 남은 엔티티도 다음 시작 때 자동 정리
패킷 · NMS
- 패킷 송신과 가로채기(
PacketListener), 버전별 클래스 매핑 처리 - 서버 전역에서 매니저 하나를 공유
스케줄러 · Folia
- Folia와 일반 Paper를 같은 코드로 지원
- 엔티티용(
ensureEntity) · 위치용(ensureAt) · 전역 · 비동기 예약을 구분 제공 - 반복 작업(
timer)과 취소(ModernTask.cancel), 안전한 텔레포트 헬퍼
유틸
- JSON 직렬화, 리플렉션 헬퍼, 접두사가 붙는 로거
📌 참고
- 플러그인 이름은 M-Core이며 데이터 폴더는
plugins/M-Core/입니다. - 다른 플러그인에서는
plugin.yml에depend: [M-Core]를 적습니다. - PostgreSQL · MariaDB를 쓰려면 JDBC 드라이버를 추가해야 합니다.
- 권한:
mservice.core.admin,mservice.core.region.bypass(둘 다 기본 OP) - 문서: docs.mservice.kr/core