무료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에 바로 반영

지역

  • 직육면체 · 구 · 다각형 지역, 우선순위 지원
  • 플래그: PVP BUILD BREAK INTERACT DAMAGE MOB_SPAWNING EXPLOSION ITEM_DROP ENTRY EXIT GREETING FAREWELL
  • 코어가 플래그를 직접 적용하고 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

파일

m-core-1.0.0.jar
3.9 MB · 기본 파일

메타데이터

채널
정식
버전 번호
1.0.0
플랫폼
Paper, Purpur, Folia
게임 버전
26.3, 26.2, 26.1, 1.21.11, 1.21.10, 1.21.9, 1.21.8, 1.21.7, 1.21.6, 1.21.5, 1.21.4, 1.21.3, 1.21.1, 1.21
다운로드
1
등록일
2026. 11. 10. 20:56