Minecraft 플러그인 CommandButtons

🔌 CommandButtons 소개

CommandButtons는 블록 상호작용에 명령어를 연결하기 위한 Minecraft 플러그인입니다. 서버 관리자는 블록(버튼, 표지판, 압력판 또는 클릭 가능한 블록)에 명령어 묶음을 연결해, 플레이어가 설정된 블록과 상호작용할 때 해당 명령어가 실행되도록 할 수 있습니다. 이 플러그인은 콘솔로 실행하거나 블록을 작동시킨 플레이어로 실행하는 것을 지원하며, 게임 내 GUI 편집기를 통해 버튼과 그 속성을 관리할 수 있습니다.

🎯 목적

이 플러그인은 플레이어가 직접 명령어를 입력하지 않아도 관리용 또는 게임플레이용 동작을 수행하는 상호작용형 월드 요소를 만들 수 있게 해 줍니다. 대표적인 사용 예로는 텔레포트 보드, 키트 선택기, 구매형 액션, 블록 상호작용으로 발동되는 커스텀 메커니즘 등이 있습니다.

⚙️ 기능

• 하나의 커맨드 버튼에 무제한의 명령어를 연결 가능(콘솔 명령어 및 플레이어 명령어).
• 게임 내 편집 GUI로 커맨드 버튼과 위치를 생성 및 편집.
• 플레이어별 및 전역 쿨다운; 쿨다운은 서버 재시작 후에도 유지됩니다.
• Vault를 통한 선택적 경제 연동으로 버튼 사용 시 플레이어에게 비용을 청구 가능.
• 특정 버튼의 사용을 제한하는 커스텀 권한 노드.
• messages 파일을 통한 사용자 지정 메시지.
• 커맨드 버튼마다 여러 위치를 설정할 수 있어 하나의 설정을 여러 블록에 적용 가능.
• 생성, 편집, 플러그인 데이터 재로드를 위한 기본 명령어 제공.

🧩 대상

• 명령어를 실행하는 클릭 가능한 월드 요소를 원하는 서버 관리자와 빌더.
• 인터랙티브 메뉴나 텔레포트/키트 선택 보드가 필요한 미니게임 및 로비 서버.
• 경제 플러그인을 사용하며 사용량 기반 과금 메커니즘을 원하는 서버.

🏗️ 사용 예시

• 스폰 텔레포트 보드에서 각 버튼이 클릭한 플레이어를 서로 다른 아레나로 텔레포트하는 경우.
• 키트 선택 월: 버튼을 누르면 키트와 메시지를 지급하는 명령어 묶음이 실행됩니다.
• 구매형 액션: 버튼이 게임 내 화폐를 차감하고 보상 명령어를 실행합니다.

⌨️ 명령어

🔐 권한

⚙️ 설치

📥 설정

• 공식 플러그인 jar를 다운로드하여 서버의 plugins/ 디렉터리에 넣습니다.
• 서버를 재시작하고 콘솔 로그를 확인해 플러그인이 올바르게 로드되었는지 확인합니다.
• 제공된 /commandbuttons 명령어를 사용해 게임 내에서 버튼 설정을 만들고 편집합니다.

📦 의존성

• 선택 사항: 경제 청구 기능을 활성화하려면 Vault가 필요합니다. Vault와 연동되는 경제 플러그인(예: EssentialsX economy)이 사용량당 과금 기능을 사용하기 위해 필요합니다.

🧠 기술 메모

• 이 플러그인은 GUI 편집기를 제공하며, 사용자 지정용 설정/메시지 파일을 생성합니다.
• 쿨다운은 서버 재시작 후에도 유지됩니다.
• 콘솔 실행과 플레이어 실행 모드를 모두 지원합니다. 플레이어로 실행된 명령어는 해당 플레이어의 권한을 사용합니다(플레이어보다 더 높은 권한이 필요한 명령어는 플레이어로 실행할 때 작동하지 않습니다).
• 경제 기능에는 Vault와 지원되는 경제 플러그인이 필요합니다.

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

CommandButtons는 플레이어 상호작용(버튼, 표지판, 압력판)으로 발동되는, 설정 가능하고 위치에 묶인 액션이 필요할 때 유용합니다. 내장 쿨다운, 권한 확인, 선택적 경제 비용을 갖추고 있으며 게임 내 편집기로 관리할 수 있습니다.