Minecraft 플러그인 AxVaults

🔌 AxVaults 소개

AxVaults는 권한 기반의 가벼운 Minecraft 플러그인으로, 플레이어별 가상 보관함(저장 공간)을 제공합니다. 이 프로젝트는 Artillex-Studios가 관리하며, NBT가 포함된 아이템을 포함한 모든 아이템을 저장하고, 복제를 방지하며, 관리자가 보관함을 확인하고 수정할 수 있는 접근 기능을 제공하도록 설계되었습니다.

🎯 목적

AxVaults는 커스텀 아이템과 NBT 데이터를 지원하면서도 복제 악용을 피하려는, 지속적이고 분리된 플레이어 저장 공간의 필요를 해결합니다. 물리적인 상자의 대안 또는 보완으로, 설정 가능하고 권한으로 제어되는 보관함을 원하는 서버에 적합합니다.

⚙️ 기능

• axvaults.vault.<number> 형식의 노드를 사용하는 권한 기반 보관함 접근.
• 플레이어당 무제한 보관함 슬롯(실제로는 정수 제한 내).
• NBT 안전 저장: 커스텀 아이템 데이터를 보존하기 위해 아이템을 이진 형식으로 저장합니다.
• 설계상 dupe 방지(원시 아이템 직렬화가 아닌 플러그인 관리 저장).
• 페이지 이동을 지원하는 보관함 페이지 탐색용 선택 GUI/메뉴.
• 특정 아이템이 보관함에 들어가지 않도록 하는 블랙리스트 시스템.
• 플레이어가 보관함 아이콘을 선택할 수 있는 사용자 지정 아이콘.
• 오프라인 접근을 포함해 플레이어 보관함을 확인하고 수정할 수 있는 관리자 도구.
• 저장 백엔드로 H2와 SQLite 지원.

🧩 대상 사용자

• 플레이어별 개인 저장 공간이 필요한 Survival 및 SMP 서버.
• 커스텀 아이템이나 crates를 사용하며 NBT 안전 저장이 필요한 서버.
• 플레이어 보관함을 검사하거나 수정하기 위해 staff 접근이 필요한 관리자 운영 서버.

🏗️ 사용 예시

• 권한을 통해 플레이어에게 정해진 수의 보관함을 제공하기(예: axvaults.vault.1, axvaults.vault.5).
• 선택 메뉴를 사용해 플레이어가 서로 다른 보관함 페이지를 빠르게 열 수 있게 하기.
• 블랙리스트를 사용해 crate key나 기타 경제 아이템이 보관함에 저장되는 것을 막기.
• 플레이어가 오프라인일 때 staff가 해당 플레이어의 보관함을 가져오거나 조정하기.

🔐 권한

⚙️ 설치

📥 설정

• 공식 플러그인 jar를 다운로드하여 Bukkit/Spigot/Paper 기반 서버의 plugins/ 디렉터리에 넣습니다.
• 서버를 재시작하고 콘솔을 확인해 플러그인이 로드되었는지 확인합니다.
• 권한 플러그인을 사용해 권한을 설정하고, 필요에 따라 axvaults.vault.<number> 노드를 부여합니다.

📦 의존성

• 기본적으로 런타임 의존성은 필요하지 않습니다(확인된 필수 플러그인 없음). 이 플러그인은 자체 저장 백엔드를 사용합니다.

🧾 설정

• 이 플러그인은 설정 가능한 저장 백엔드를 사용합니다(H2, SQLite가 지원되는 것으로 문서화됨).
• 블랙리스트, 아이콘 설정, 보관함 저장 행은 설정할 수 있습니다(자세한 내용은 공식 문서를 참조).

🧠 기술 참고

• 프로젝트 저장소와 공식 리소스는 Artillex-Studios가 관리합니다.
• 이 플러그인은 H2 및 SQLite 저장 지원을 제공합니다.
• 관리자는 오프라인 플레이어의 보관함에 접근할 수 있습니다(관리자 오프라인 접근이 문서화됨).
• 이 플러그인은 설계상 dupe 방지라고 명시하며, NBT 보존을 위해 아이템을 이진으로 저장합니다.
• 배포 전에 공식 릴리스 노트에서 Java 요구 사항과 지원되는 서버 버전을 확인하세요.

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

NBT 안전, 권한 제어가 가능한 가상 저장 공간이 필요하고, staff 검사 도구와 간단한 데이터베이스 기반 저장(H2/SQLite)을 원한다면, AxVaults는 추가 의존성 없이 사용할 수 있는 집중형 솔루션을 제공합니다.