Minecraft 플러그인 MyCommand

🔌 MyCommand 소개

MyCommand은 Java를 작성하지 않고도 커스텀 명령어, 별칭, 그리고 명령어 기반의 인터랙티브 인터페이스를 만들 수 있는 Minecraft 플러그인입니다. YAML 기반 시스템으로 다른 명령어를 실행하고, 포맷된 텍스트를 보내고, GUI를 열고, 스크립트를 트리거하고, 이벤트와 상호작용하는 명령어를 정의할 수 있습니다.

🎯 목적

MyCommand는 유연한 커스텀 명령어, 바로가기, 관리자/사용자 인터페이스가 필요한 서버 관리자들을 위한 도구입니다. 지연, 워밍업, 쿨다운, 탭 완성, 플레이스홀더 같은 맞춤형 명령어 동작과 가벼운 GUI 상호작용을, 전체 플러그인을 새로 개발하지 않고도 추가할 수 있습니다.

⚙️ 기능

• 새 명령어와 별칭을 만들고, 필요하면 탭 완성에 등록할 수 있습니다.
• 하나의 커스텀 명령어로 여러 명령어를 실행할 수 있습니다(콘솔 또는 플레이어 실행).
• 명령어에 지연, 워밍업, 쿨다운을 적용할 수 있습니다.
• 다른 명령어를 덮어쓰거나 바로가기/별칭을 제공할 수 있습니다.
• 아이템, 블록, 표지판, 책, NPC, 아이템 액자에서 명령어를 트리거할 수 있습니다.
• GUI 요소: 상자 기반 IconMenu, ActionBar, BossBar, Title, Scoreboard, Anvil GUI, Sign GUI.
• 동적 동작을 위한 플레이스홀더 지원과 스크립트처럼 동작하는 조건문.
• 경제 연동(Vault를 통한 옵션) 및 일부 독립적인 경제 기능.
• 플레이어 이벤트(접속/종료/사망) 및 예약 작업 지원.
• SQL 기반의 사용자 지정 플레이어 데이터베이스(선택 사항)와 무제한 명령어를 위한 다중 파일 지원.
• BungeeCord 관련 기능과 프록시 측 명령어를 위한 별도의 Bungee용 변형.
• HTTP 요청(GET/POST)과 지원되는 환경에서의 MiniMessage 포맷 지원.
• 메트릭 보고를 위해 bStats를 사용합니다.

🧩 대상

• 코딩 없이 커스텀 명령어와 메뉴를 원하는 Survival 및 SMP 서버.
• 커스텀 상점/명령어 흐름이 필요한 관리자 중심 또는 경제 서버.
• 중앙 관리형 또는 프록시 측 명령어 동작이 필요한 프록시 네트워크.
• 동적인 출력을 위해 스크립트 조건문과 플레이스홀더가 필요한 서버 운영자.

🏗️ 사용 예시

• 상점을 열고, 아이템을 지급하고, 구매를 기록하는 콘솔 명령어 시퀀스를 실행하는 단일 명령어를 정의하기.
• chest GUI 항목과 anvil/sign 프롬프트를 사용해 처벌/텔레포트 GUI 메뉴 만들기.
• 탭 완성과 함께 더 긴 BungeeCord 서버 전환 명령어에 매핑되는 짧은 별칭 제공하기.

⌨️ 명령어

공식 문서에는 플러그인을 관리하기 위한 관리 명령어가 나와 있습니다. 프로젝트에서 문서화한 예시는 다음과 같습니다.

(전체 목록과 정확한 문법은 플러그인의 공식 명령어 문서를 참고하세요.)

🔐 권한

이 프로젝트는 관리 작업을 위한 권한 노드를 문서화합니다. 공식 권한 목록의 예시는 다음과 같습니다.

(플러그인 권한 문서에서 전체 권한 맵을 확인하세요.)

⚙️ 설치

📥 설정

• 공식 .jar 플러그인을 다운로드하여 서버의 plugins/ 폴더에 넣습니다.
• 서버를 시작하거나 재시작한 뒤 콘솔 로그를 확인해 플러그인이 로드되었는지 확인합니다.
• 플러그인이 로드되지 않으면 필요한/선택적 지원 플러그인(의존성 참조)이 설치되어 있거나 최신 버전인지 확인하세요.

📦 의존성

• ProtocolLib — 플러그인이 로드되지 않거나 일부 기능에서 중요하다고 알려져 있습니다.
• Vault — 선택 사항, 경제 연동에 필요합니다.
• PlaceholderAPI — 선택 사항, 플레이스홀더 지원 확장용입니다.

원하는 기능에 대해 확인된 의존성만 설치하세요. 많은 연동 기능은 선택 사항입니다.

🧠 기술 메모

• 이 플러그인은 YAML 파일로 설정되며, 명령어 제한을 피하기 위해 여러 명령어 파일을 지원합니다.
• SQL 저장소는 사용자 지정 플레이어 데이터베이스(선택 사항)에 사용할 수 있으며, 다중 파일 구성도 지원됩니다.
• 프록시 측 명령어 처리를 위한 별도의 BungeeCord 컴포넌트가 있습니다.
• 이 프로젝트는 bStats를 통해 메트릭을 보고합니다.
• 지원되는 환경에서는 MiniMessage 포맷과 탭 완성 지원을 사용할 수 있습니다.

🤝 이 플러그인이 유용한 경우

Java를 작성하지 않고도 유연한 파일 기반 커스텀 명령어, 조건부 스크립팅, GUI 기반 명령어 흐름이 필요하다면, MyCommand는 그런 요구를 충족하는 설정 가능한 플랫폼을 제공하며 필요할 경우 프록시 및 경제 연동도 추가합니다.