Minecraft 서버 DeluxeMenus 플러그인

## 🔌 DeluxeMenus 소개 DeluxeMenus는 설정 가능한 인벤토리 기반 GUI 메뉴를 만들 수 있는 Minecraft 플러그인입니다. 서버 관리자는 YAML로 메뉴와 메뉴 아이템을 정의하며, 아이템은 PlaceholderAPI를 통해 동적 데이터를 표시하고 클릭 시 명령어나 작업을 실행할 수 있습니다. 이 플러그인은 외부 메뉴 파일용 `gui_menus` 폴더를 생성하고, 핵심 설정에는 중앙 `config.yml`을 사용합니다. ## 🎯 목적 DeluxeMenus는 코딩 없이 게임 내 그래픽 메뉴를 만드는 문제를 해결합니다. 서버 소유자는 상점, 서버 선택기, 킷 메뉴, 안내 패널 및 기타 상호작용형 인터페이스를 만들어 명령을 실행하거나 플레이어별 데이터를 표시할 수 있습니다. ## ⚙️ 기능 - YAML로 인벤토리 GUI 메뉴 생성 가능(외부 메뉴 파일 지원). - 메뉴 아이템은 클릭 시 명령을 실행하거나 작업을 수행할 수 있습니다. - PlaceholderAPI 연동으로 동적 아이템 이름, lore, 조건 지원. - 메뉴별 및 클릭별 권한 설정(메뉴 접근 및 클릭 제한). - 메뉴를 열기, 목록 보기, 다시 불러오기, 작업 실행을 위한 명령. - 처음 실행 시 `plugins/DeluxeMenus/gui_menus`와 예시 메뉴 파일을 생성합니다. - 익명 통계를 위해 bStats를 사용합니다(비활성화하지 않으면 기본 활성화). ## 🧩 대상 - 게임 내 맞춤형 GUI(상점, 선택기, 킷)를 원하는 서버 소유자와 관리자. - GUI 기반 상점이나 정보 메뉴를 사용하는 SMP 및 survival 서버. - PlaceholderAPI 값을 사용하는 설정 가능한 메뉴가 필요한 네트워크. ## 🏗️ 예시 사용 사례 - 플레이어를 텔레포트시키거나 서버 연결 명령을 실행하는 서버 선택 메뉴. - 플레이어가 아이템을 클릭하면 구매 명령을 실행하는 상점 메뉴. - 플레이어별 정보를 플레이스홀더로 표시하는 킷 선택 GUI. ## ⌨️ 명령어 | **명령어** | **설명** | **권한** | **접근** | |---|---|---|---| | `/dm open <menuName>` | 지정한 메뉴를 자신에게 엽니다. | `deluxemenus.open` | 플레이어 | | `/dm open <menuName> <player>` | 지정한 메뉴를 다른 플레이어에게 엽니다. | `deluxemenus.open.others` | 관리자 | | `/dm list` | 접근 가능한 모든 메뉴를 나열합니다. | `deluxemenus.list` | 플레이어 | | `/dm reload` | DeluxeMenus 설정과 메뉴를 다시 불러옵니다. | `deluxemenus.reload` | 관리자 | | `/dm execute <player> <action>` | 설정된 작업을 대상 플레이어에게 실행합니다(제한됨). | op / console | 관리자 | ## 🔐 권한 | **권한** | **설명** | **기본값** | |---|---|---| | `deluxemenus.open` | `/dm open`을 통해 메뉴를 열 수 있습니다. | 지정되지 않음 | | `deluxemenus.open.others` | 다른 플레이어를 위해 메뉴를 열 수 있습니다. | 지정되지 않음 | | `deluxemenus.list` | 접근 가능한 메뉴 목록을 볼 수 있습니다. | 지정되지 않음 | | `deluxemenus.reload` | 플러그인 설정을 다시 불러올 수 있습니다. | 지정되지 않음 | | `deluxemenus.clickmenu.<menuName>` | 메뉴별 클릭 메뉴 접근을 제한하는 데 사용되는 권한 노드입니다. | 지정되지 않음 | ## ⚙️ 설치 ### 📥 설정 - Spigot용 공식 DeluxeMenus `.jar`를 다운로드해 서버의 `plugins/` 디렉터리에 넣으세요. - DeluxeMenus를 실행하기 전에 PlaceholderAPI가 설치되어 있는지 확인하세요(플레이스홀더가 작동하려면 PlaceholderAPI가 필요합니다). - 서버를 실행하거나 재시작하면 DeluxeMenus가 `config.yml`과 `gui_menus` 폴더가 포함된 `plugins/DeluxeMenus` 폴더를 생성합니다. - 서버 콘솔에서 플러그인이 정상적으로 로드되었는지 확인하고 Java 버전 경고가 있는지 살펴보세요. ### 📦 의존성 - PlaceholderAPI(플레이스홀더 지원 필요). ### 🧾 설정 - DeluxeMenus는 기본 `config.yml`을 사용하며 `plugins/DeluxeMenus/gui_menus`에 저장된 외부 YAML 메뉴 파일을 지원합니다. - 플러그인으로 새 메뉴를 만들면 기본 외부 메뉴 파일이 생성되며, 이를 편집해 슬롯, 아이템, 플레이스홀더, 작업을 사용자 지정할 수 있습니다. ## 🧠 기술 참고 - 아이템 이름, lore, 조건의 동적 플레이스홀더에는 PlaceholderAPI가 필요합니다. - 플러그인의 최신 릴리스에는 Java 11 이상이 필요합니다. - DeluxeMenus는 bStats를 통해 익명 통계를 수집합니다(원하면 비활성화 가능). - 이 플러그인은 오픈 소스이며 공개 저장소가 있고, 설정 안내를 위한 예시 메뉴와 위키를 제공합니다. - 지원되는 Minecraft 버전은 프로젝트에 목록화되어 있습니다. 배포 전에 서버 버전과의 호환성을 확인하세요. ## 🤝 이 플러그인이 유용한 경우 플레이어별 데이터를 표시하고 클릭 시 명령을 실행할 수 있는, 설정 가능한 YAML 기반 인벤토리 GUI가 필요하다면 DeluxeMenus는 커스텀 코딩 없이 상점, 선택기, 게임 내 인터페이스를 만드는 데 실용적인 선택입니다.

플러그인