💡 플러그인을 만들 때마다 다시 짜던 코드를 M-Core 하나로. 설정 · DB · 다국어 · 명령어 · GUI · 지역 · 스코어보드 · 홀로그램이 모두 들어 있습니다.
소개
M-Core는 플러그인을 만들 때 반복해서 작성하게 되는 기능을 한곳에 모은 개발용 코어 라이브러리입니다.
- jar 하나로 끝 — 서버에는 M-Core만 설치하고, 다른 플러그인은
depend: [M-Core]한 줄만 적으면 됩니다. - 중복 번들 없음 — Kotlin 런타임과 코루틴을 M-Core가 제공하므로 플러그인마다 넣을 필요가 없습니다.
- 자동 정리 — 플러그인이 꺼지면 명령어 · GUI · DB 커넥션 풀 · 모듈 · 코루틴 · 홀로그램이 모두 정리됩니다. 정리를 빠뜨려 생기는 메모리 누수와 유령 엔티티가 없습니다.
- Folia 지원 — 일반 Paper와 Folia에서 같은 코드가 그대로 돌아갑니다.
주요 기능
| 기능 | 설명 |
|---|---|
| ⚙️ 설정 | 여러 yml 파일을 이름으로 불러오고, 타입을 지정해 읽고, 한 번에 리로드 |
| 🗄️ 데이터베이스 | MySQL · MariaDB · PostgreSQL · SQLite, HikariCP 커넥션 풀, 테이블 빌더, 키-값 저장소 |
| ☁️ EveryDB | everydb.kr 연동 클라이언트. API 키를 M-Core에 한 번만 넣으면 모든 플러그인이 공유 |
| 🌐 다국어 | 한국어 · 영어 · 일본어 기본 지원. 플레이어가 /lang ko를 한 번 입력하면 M-Core 기반 플러그인 전체가 그 언어로 표시 |
| ⌨️ 명령어 | 코드로 쓰는 명령어 DSL. 하위 명령어 · 인자 타입 · 권한 · 탭 완성 · 도움말 자동 생성 |
| 🧩 모듈 | 기능을 모듈로 나누고 의존 관계를 적으면 활성화 순서를 자동 정렬 |
| 🎨 색상 | 2색 · 3색 그라데이션, 무지개, <gradient:#aaa:#bbb> 태그, 레거시 & 코드 |
| 🖼️ GUI | 일반 GUI · 페이지 GUI, '뒤로 가기' 기록 관리, 레이아웃을 yml 파일로 분리 |
| 📍 지역 | 직육면체 · 구 · 다각형 지역, PVP · BUILD · EXPLOSION 등 보호 플래그, 출입 이벤트 |
| 📋 스코어보드 | 람다로 제목 · 줄을 주면 자동 갱신. Folia에서도 같은 코드로 동작 |
| 💬 홀로그램 | 텍스트 디스플레이 기반, 플레이어별 내용 · 클릭 처리 · 정렬 · 배경색 · 크기 조절 |
| 📦 패킷 | NMS 패킷 송신과 가로채기, 버전별 매핑은 코어가 처리 |
| ⏱️ 스케줄러 | 엔티티용 · 위치용 · 전역 · 비동기 예약을 구분 제공 — Folia 스레드 규칙을 지키기 쉬움 |
서버 관리자에게 좋은 점
- 메시지는
lang/messages_*.yml, GUI 배치는gui/폴더의 yml에서 직접 고치고 리로드하면 바로 반영됩니다. - 지역은
regions.yml에 자동 저장되고 서버를 다시 켜도 그대로 복원됩니다. - 서버가 비정상 종료된 뒤 남은 홀로그램 엔티티도 다음 시작 때 자동으로 치웁니다.
설치
modern-core-1.0.0.jar를 서버의plugins폴더에 넣습니다.- 서버를 시작하면
plugins/M-Core/config.yml이 만들어집니다. - 기본 언어, EveryDB 키, 데이터베이스 설정을 필요에 따라 채웁니다.
M-Core를 쓰는 플러그인은 plugin.yml에 아래 한 줄을 추가합니다.
depend: [M-Core]
ℹ️ SQLite · MySQL 드라이버는 서버 시작 시 자동으로 내려받습니다. PostgreSQL · MariaDB를 쓰려면 드라이버를 추가해 주세요.
개발자 빠른 시작
ModernPlugin을 상속하면 core로 모든 기능에 접근할 수 있습니다.
class MyPlugin : ModernPlugin() {
override fun onEnableModern() {
val db = core.database.connectFromConfig()
command("hello") {
val target = playerArgument().optional()
executes {
val who = getOrNull(target) ?: player
sendLang("hello", "name" to who.name) // 플레이어 언어로 번역
}
}
core.scoreboards.create("main") {
title("<gradient:#00ffea:#7b2fff>SERVER</gradient>")
lines { player -> listOf("<gray>이름 <white>${player.name}") }
updateEvery(20)
}
}
}
✅ 위에서 만든 명령어 · DB 연결 · 스코어보드는 플러그인이 꺼질 때 따로 정리하지 않아도 모두 해제됩니다.
자세한 사용법은 M-Core 문서에서 확인하세요.
명령어 · 권한
| 명령어 | 설명 |
|---|---|
/moderncore | 코어 상태 · 플러그인 목록 · 모듈 목록 · 리로드 (별칭 /mcore, /mc-core) |
/lang | 플레이어 언어 선택: ko · en · jp · auto (별칭 /language, /언어) |
| 권한 | 설명 |
|---|---|
mservice.core.admin | /moderncore 사용 (기본: OP) |
mservice.core.region.bypass | 모든 지역 보호 플래그 무시 (기본: OP) |
호환성
| 항목 | 지원 |
|---|---|
| 서버 | Paper · Purpur · Folia 1.21 이상 |
| 자바 | Java 21 |
| 언어 | Kotlin 2.1 (런타임은 M-Core가 제공) |
| 의존성 | 없음 |