Minecraft 서버 Multiverse-Inventories 플러그인

## 🔌 Multiverse-Inventories 소개 Multiverse-Inventories는 Multiverse Core용 Minecraft 플러그인 애드온으로, 플레이어의 인벤토리와 관련 데이터를 월드별 또는 그룹별로 관리합니다. 서버 관리자는 플레이어 데이터(인벤토리, 엔더 체스트, 경험치, 체력, 허기, 포션 효과 등)를 월드 간에 분리하거나 공유할 수 있어, 하나의 서버 인스턴스에서 혼합된 게임 모드 구성을 만들 수 있습니다. ## 🎯 목적 이 플러그인은 멀티 월드 서버에서 원치 않는 월드 간 데이터 섞임 문제를 해결합니다. 월드를 그룹으로 묶고 어떤 플레이어 데이터를 공유하거나 분리할지 설정할 수 있습니다. 이는 서로 다른 규칙이나 게임 모드를 사용하는 월드(예: 크리에이티브 건축 월드와 서바이벌 월드)를 별도의 서버 인스턴스나 프록시 시스템 없이 운영할 때 유용합니다. ## ⚙️ 기능 - 월드별 및 그룹별 인벤토리와 데이터 분리. - 월드 간에 어떤 데이터를 공유할지 정확히 제어하는 설정 가능한 "shares"(예: 인벤토리, 엔더 체스트, 경험치, 체력, 허기, 포션 효과, 마지막 위치). - 그룹과 해당 shares를 생성하고 관리하는 명령어. - 플레이어 데이터 가져오기/마이그레이션 및 저장된 인벤토리 데이터 대량 편집용 도구(공식 사용 문서에 안내됨). - 첫 실행 시 기본 설정과 `default` 그룹을 생성해 바닐라의 월드 그룹 동작에 맞춥니다. ## 🧩 대상 사용자 - 하나의 서버에서 여러 월드를 운영하며 서로 다른 플레이어 인벤토리 또는 선택적 공유가 필요한 서버 소유자. - 월드별 플레이어 상태가 필요한 서바이벌, SMP, 크리에이티브 빌드, 미니게임 서버 구성. - 이미 Multiverse Core를 사용 중이며 애드온으로 인벤토리/그룹 관리를 추가하고 싶은 관리자. ## 🏗️ 사용 예시 - 크리에이티브와 서바이벌 인벤토리를 분리하면서 해당 월드들 사이 이동은 허용하기. - 체력과 경험치만 공유하고 인벤토리는 메인 월드와 분리한 PvP 아레나 그룹 만들기. - 문서화된 도구를 사용해 다른 플러그인에서 플레이어 인벤토리를 가져오거나 저장된 인벤토리 기록을 대량 수정하기. ## ⌨️ 명령어 | **명령어** | **설명** | **권한** | **접근** | |---|---:|---:|---:| | `/mvinv create-group <group-name> <world1,world2,...> <share1,share2,...>` | 새 그룹을 만들고 포함할 월드와 shares를 설정합니다. | 지정되지 않음 | 관리자 | | `/mvinv info default` | `default` 그룹의 설정을 표시합니다. | 지정되지 않음 | 관리자 | | `/mvinv add-worlds default <worldname>` | 기존 월드를 `default` 그룹에 추가하여 같은 데이터를 공유하게 합니다. | 지정되지 않음 | 관리자 | (참고: 이 명령어들은 공식 사용 문서에 안내되어 있으며, 필요하면 권한 노드는 플러그인 레퍼런스에 나와 있습니다.) ## ⚙️ 설치 ### 📥 설정 - Multiverse-Inventories를 추가하기 전에 Multiverse-Core가 설치되어 있는지 확인하세요. - 프로젝트의 공식 릴리스/다운로드 페이지에서 플러그인 JAR를 다운로드하세요. - JAR를 서버의 `plugins/` 디렉터리에 넣고 서버를 시작하세요. - 첫 실행 시 플러그인이 기본 설정과 `default` 그룹을 생성합니다. 콘솔 로그를 확인해 정상적으로 로드되었는지 확인하세요. ### 📦 의존성 - Multiverse-Core(필수). ## 🧠 기술 메모 - Multiverse-Inventories는 BSD-3-Clause 라이선스로 배포됩니다. - 이 프로젝트는 공개 저장소에서 소스와 이슈를 관리합니다. 공식 문서에는 설정 레퍼런스, 명령어 사용법, 권한 목록, 마이그레이션/가져오기 가이드가 포함됩니다. - 그룹과 shares를 변경하면 저장된 플레이어 데이터가 덮어써지거나 이동될 수 있습니다. 공식 문서는 큰 설정 변경을 하기 전에 서버 데이터를 백업하라고 안내합니다. ## 🤝 이 플러그인이 유용한 경우 하나의 서버 인스턴스에서 여러 월드를 운영하면서 플레이어 인벤토리와 관련 상태를 제어된 방식으로 분리하거나 공유해야 한다면, Multiverse-Inventories는 그룹 기반 설정과 데이터 관리 도구를 제공해 별도 서버를 운영하지 않고도 관리할 수 있게 해줍니다.

플러그인