mcMMO Rewards: 마인크래프트 레벨업 보상 플러그인 소개

인기 있는 RPG 시스템 mcMMO는 낚시, 채광, 약초학 같은 스킬 레벨업 메커니즘을 마인크래프트 서버에 추가한다. 하지만 원작 플러그인 개발자들은 플레이어가 특정 레벨에 도달했을 때 아이템, 화폐, 커스텀 칭호를 자동으로 지급하는 유연한 시스템을 마련하지 않았다. 보조 확장 플러그인 mcMMO Rewards는 바로 이 문제를 해결한다. mcMMO의 레벨 시스템을 서버 콘솔 명령어와 연결함으로써, 서버 운영자는 복잡한 스크립트를 작성하지 않고도 활동적인 플레이어를 위한 자동 보상을 설정할 수 있다.

이벤트 처리와 API 연동

mcMMO Rewards는 Spigot/Paper 서버 코어에 직접 연결되는 경량 이벤트 리스너로 작동하며, mcMMO 플러그인의 공식 API와 통신한다.

McMMOPlayerLevelUpEvent 이벤트 가로채기

플레이어가 어떤 스킬에서든 레벨업할 때마다(예: 광석을 채굴하거나 작물을 수확할 때), mcMMO는 McMMOPlayerLevelUpEvent 이벤트를 발생시킨다. mcMMO Rewards는 이 이벤트를 가로채 다음 로직을 실행한다.

1. 스킬 이름과 플레이어가 도달한 새 레벨을 읽는다.

2. 이 데이터를 설정 파일 config.yml에 정의된 보상 목록과 대조한다.

3. 일치하는 항목이 있으면, 플러그인은 콘솔 권한으로 설정된 명령어 목록을 실행하며, 자리표시자 %player%를 플레이어 이름으로 치환한다.

이벤트 처리의 주요 제한 사항

이 플러그인은 오직 McMMOPlayerLevelUpEvent 이벤트에만 연결되어 있으므로, 게임 플레이 중 자연스럽게 이루어지는 레벨업에만 반응한다. ⚠️ 레벨 초기화와 데이터베이스 수정: 관리자가 SQLite/MySQL 데이터베이스 파일을 통해 플레이어의 레벨을 직접 변경하거나(예: 통계 마이그레이션이나 초기화 시), 표준 레벨업 이벤트를 발생시키지 않고 레벨 값을 변경하는 콘솔 명령어를 사용하면 보상이 활성화되지 않는다. 또한 이 플러그인은 소급 보상 지급도 지원하지 않는다. 플레이어가 mcMMO Rewards 설치 이전에 이미 레벨 50에 도달했다면, 다음 레벨에 도달하기 전까지는 이전에 지나친 레벨(10, 20 등)에 대한 보상을 받지 못한다.

config.yml 구조와 보상 설정

모든 보상은 단일 설정 파일 plugins/mcMMORewards/config.yml에 정의된다. YAML의 단순한 문법 덕분에 개발자는 다단계 보상 시스템을 빠르게 구축할 수 있다.

설정 문법 설명

각 보상 블록은 엄격한 계층 구조를 따른다.

• 스킬 이름(Skill): mcMMO의 공식 스킬 이름과 일치해야 한다(예: mining, woodcutting, swords, herbalism).

• 레벨(Level): 명령어가 실행되는 레벨을 나타내는 정수.

• 명령어 목록: 콘솔 동작 목록. 명령어 앞에 슬래시 /를 붙일 필요는 없다. 모든 명령어는 서버가 콘솔 권한(OP 등급)으로 직접 실행하기 때문이다.

설정 파일 예시

아래는 아이템과 돈을 지급하기 위해 올바르게 구성된 파일의 예시다.

rewards:
  mining:
    10:
      - "give %player% iron_ingot 5"
      - "broadcast &6[RPG] &e%player% &fдосяг 10-го рівня видобутку руди!"
    50:
      - "eco give %player% 1000"
      - "give %player% diamond 3"
  swords:
    25:
      - "xp give %player% 500"

이 예시에서 플레이어 %player%는 mining 스킬 레벨 10에 도달하면 철 주괴를 받고, 서버 전체에 메시지가 전송된다. 레벨 50에 도달하면 플레이어는 경제 플러그인(예: EssentialsX)을 통해 화폐 1000단위와 다이아몬드 3개를 받는다.

플러그인 관리: 명령어와 권한

mcMMO Rewards는 매우 컴팩트한 확장 플러그인이므로, 명령어와 권한 목록은 관리 기능으로만 제한된다.

설정 재로드 명령어

config.yml 파일의 변경 사항을 적용하기 위해 마인크래프트 서버 전체를 재시작하거나 게임 플레이를 중단할 필요는 없다. 다음 명령어만 실행하면 된다. /mcmmorewards reload 이 명령어는 서버 메모리에서 이전 설정을 언로드하고 설정 파일을 다시 읽어들여 새 보상을 즉시 적용한다.

관리자 권한(Permissions)

서버 보안을 위해 재로드 명령어를 실행할 수 있는 권한은 전용 퍼미션 노드로 제한된다. 일반 플레이어는 이 명령어에 접근할 수 없다. 관리자나 모더레이터에게 권한을 부여하려면(예: LuckPerms를 통해) 다음 노드를 사용한다: mcmmorewards.reload 기본적으로 이 권한은 서버 운영자(OP) 상태를 가진 모든 플레이어에게 자동으로 부여된다.

결론

mcMMO Rewards는 mcMMO의 스킬 시스템을 사용하는 RPG 및 생존 요소가 있는 마인크래프트 서버에 훌륭한 보조 도구다. 복잡한 스크립트 언어를 배우거나 무거운 스크립트를 사용할 필요 없이 게임 내 활동에 대한 자동 보상 지급을 쉽게 설정할 수 있다.

mcMMO 이벤트를 감지하기 위해 자체 문법을 작성해야 하는 Skript 같은 복잡한 스크립트나 완전한 퀘스트 플러그인과 비교하면, mcMMO Rewards는 가능한 한 간단하고 빠르게 설정할 수 있으며 서버 리소스를 거의 소모하지 않는 시스템을 제공한다. 다만 mcMMO 플러그인 설치에 전적으로 의존한다는 점과 명령어가 오직 콘솔 권한으로만 실행될 수 있다는 점이 주요 한계다. 이 플러그인은 자원 채집이나 전투 스킬 향상에 대한 간단한 보상을 빠르게 추가하고 싶은 서버에 완벽하게 어울린다.