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