무료M-Core

Paper · Folia 플러그인 개발용 올인원 코어 — 설정 · DB · 다국어 · 명령어 · GUI · 지역 · 스코어보드 · 홀로그램을 jar 하나로. 플러그인이 꺼지면 모두 자동 정리됩니다.

1 다운로드 0 팔로워
💡 플러그인을 만들 때마다 다시 짜던 코드를 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 커넥션 풀, 테이블 빌더, 키-값 저장소
☁️ EveryDBeverydb.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에 자동 저장되고 서버를 다시 켜도 그대로 복원됩니다.
  • 서버가 비정상 종료된 뒤 남은 홀로그램 엔티티도 다음 시작 때 자동으로 치웁니다.

설치

  1. modern-core-1.0.0.jar를 서버의 plugins 폴더에 넣습니다.
  2. 서버를 시작하면 plugins/M-Core/config.yml이 만들어집니다.
  3. 기본 언어, 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가 제공)
의존성없음

비슷한 플러그인