Minecraft Servers HQ

Minecraft 플러그인 CommandPanels

CommandPanels와 확인된 서버에 대한 정보

SurvivalMinigamesPaperAdmin ToolsPermissionsAdminUtilityGUIInventoryDialogs

🔌 CommandPanels 소개

CommandPanels는 서버를 위한 YAML 기반 GUI/메뉴 시스템을 제공하는 Minecraft 플러그인입니다. 인벤토리 기반 패널, 대화형(폼) 패널, 그리고 Bedrock 플레이어를 위한 Floodgate 호환 패널에 중점을 둡니다. 이 프로젝트에는 명령을 실행하고, 동적 플레이스홀더를 표시하며, 로직과 권한에 반응하는 인터랙티브한 데이터 기반 메뉴를 만들 수 있는 온라인 에디터와 구조화된 형식이 포함되어 있습니다.

🎯 목적

이 플러그인은 상점, 키트, 로비, 모더레이션 도구 또는 맞춤형 워크플로를 위해 유연하고 프로그래밍 가능한 GUI가 필요한 서버 관리자와 개발자를 위한 것입니다. 패널이 명령을 실행하고, 조건을 확인하고, 아이템을 애니메이션으로 표시하고, 다른 시스템에서 사용할 세션 또는 영구 데이터를 노출할 수 있도록 설계되었습니다.

⚙️ 기능

  • 아이템 상호작용, 슬롯 배치, 애니메이션 체인을 갖춘 인벤토리 패널.
  • 플레이어 입력과 구조화된 폼을 위한 다이얼로그 패널.
  • Geyser/Floodgate 설정을 통해 Bedrock 플레이어에게 호환 가능한 패널을 보여주는 Floodgate 패널 지원.
  • 표시 여부와 동작을 제어하는 인라인 로직 및 조건(AND/OR/NOT 스타일 연산자).
  • 명령/액션 시스템: open/close 훅, 클릭 액션, 바깥 클릭 액션, 조건부 명령 실행.
  • PlaceholderAPI 지원 및 패널 내부의 동적 플레이스홀더 업데이트.
  • 패널과 명령 전반에서 접근 가능한 세션 및 영구 패널 데이터.
  • 권한이 변경되면 로직 전체를 다시 파싱하도록 트리거할 수 있는 주기적 업데이트와 권한 관찰자.
  • YAML 실시간 미리보기와 구조 검사를 갖춘 온라인 에디터.

🧩 대상

Paper 호환의 최신 서버를 운영하며 유연한 GUI 메뉴가 필요한 관리자와 플러그인 개발자: 서바이벌/SMP 서버, 미니게임 네트워크, PvP 허브, 그리고 맞춤형 관리/모더레이션 인터페이스가 필요한 서버를 위한 것입니다.

🏗️ 사용 예시

  • 서버 명령을 실행하고 특정 권한 또는 경제 잔액이 필요한 키트 또는 상점 GUI를 만든다.
  • 플레이어 등급에 따라 애니메이션 아이템과 조건부 표시를 사용하는 허브 이동 메뉴를 만든다.
  • Floodgate 전용 패널 변형을 사용해 Bedrock 호환 메뉴를 제공한다.

⌨️ 명령어

명령어설명권한접근
/pa open <panel>이름이 있는 패널을 엽니다.commandpanels.command.open관리자
/pa reload플러그인 설정과 패널을 다시 불러옵니다.commandpanels.command.reload관리자
/pa generate예시 패널 또는 기본 구조를 생성합니다.commandpanels.command.generate관리자
/pa version플러그인 버전을 표시합니다.commandpanels.command.version플레이어
/pa data패널 데이터를 설정하거나 확인합니다.commandpanels.command.data관리자
/pa help/pa 명령의 도움말을 표시합니다.commandpanels.command.help플레이어

(명령어와 권한은 공식 CommandPanels 문서를 기준으로 합니다.)

🔐 권한

권한설명기본값
commandpanels.command기본 /pa 명령어에 대한 접근을 허용합니다.true
commandpanels.command.reload플러그인 다시 불러오기를 허용합니다.op
commandpanels.command.generate패널 생성 명령어에 접근할 수 있습니다.op
commandpanels.command.version플러그인 버전 확인을 허용합니다.true
commandpanels.command.data패널 데이터 설정에 접근할 수 있습니다.op
commandpanels.command.open/pa open으로 패널을 열 수 있습니다.op
commandpanels.command.open.other다른 플레이어를 위해 패널을 열 수 있습니다.op
commandpanels.command.help/pa help에 접근할 수 있습니다.true

⚙️ 설치

📥 설정

  • 공식 CommandPanels .jar 파일을 다운로드해 서버의 plugins/ 폴더에 넣습니다.
  • 서버를 시작해 플러그인 데이터를 생성합니다.
  • 처음 실행한 뒤 plugins/CommandPanels에서 config.yml과 패널 정의 파일이 들어 있는 panels/ 폴더를 확인하세요.

📦 의존성

  • PlaceholderAPI — 동적 플레이스홀더용 선택 사항이지만 권장됩니다.
  • Floodgate — Bedrock(Floodgate) 패널 지원용 선택 사항입니다.

🧾 설정

  • 패널은 panels/ 디렉터리에 배치된 YAML 파일로 정의됩니다. 정리를 위해 하위 폴더도 지원됩니다.
  • panels/ 디렉터리가 삭제되고 플러그인이 재시작되면 예시 패널이 생성됩니다.

🧠 기술 참고

  • 공식 문서와 릴리스에서는 현대 v4 릴리스의 지원 서버 플랫폼으로 Paper와 Folia(Paper 포크)를 명시합니다.
  • v4 릴리스 계열은 최근 Minecraft 서버 버전에 초점을 맞추며, 패널 정의는 런타임에 파싱되는 동적 플레이스홀더와 조건 로직을 지원합니다.
  • 이 플러그인은 패널을 여는 권한 노드와 명령 기반 API를 제공합니다. 패널 YAML을 로드하고 open 액션을 호출하여 다른 플러그인에 라이브러리로 포함할 수도 있습니다.

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

동적 데이터, 조건 로직, Bedrock 호환성, 온라인 에디터를 지원하는 구조화된 스크립트형 GUI 시스템이 필요하다면, CommandPanels는 Paper 기반 서버와 네트워크에 잘 맞는 검증된 YAML 우선 접근 방식을 제공합니다.

CommandPanels 플러그인 서버

플러그인 CommandPanels 페이지에는 모니터링에서 이 플러그인을 확인한 서버, 사용 중인 플랫폼과 버전이 표시됩니다.

플러그인은 명령어, 경제, 보호, 접근 권한, 미니게임, 연동 및 기타 메커니즘을 추가할 수 있습니다. CommandPanels의 실제 역할은 서버별 설정에 따라 다릅니다.

데이터는 서버의 기술 응답에서 자동으로 생성됩니다. 서버가 플러그인 목록을 비공개로 설정한 경우, CommandPanels을 사용하더라도 이 섹션에 표시되지 않을 수 있습니다.

CommandPanels을 사용하는 서버 목록을 통해 프로젝트를 비교하거나, 지원 버전을 확인하거나, 공개 서버에서의 플러그인 사용 사례를 찾을 수 있습니다.