Plugin Minecraft AxVaults

🔌 Giới thiệu AxVaults

AxVaults là một plugin Minecraft nhẹ, dựa trên quyền hạn, cung cấp vault ảo theo từng người chơi (lưu trữ). Dự án được Artillex-Studios duy trì và được thiết kế để lưu trữ mọi vật phẩm (bao gồm cả vật phẩm có NBT), ngăn trùng lặp và cho phép admin xem cũng như chỉnh sửa vault.

🎯 Mục đích

AxVaults giải quyết nhu cầu về lưu trữ người chơi bền vững, tách biệt, hoạt động với vật phẩm tùy chỉnh và dữ liệu NBT, đồng thời hướng tới việc tránh các khai thác trùng lặp. Plugin này dành cho các server muốn có vault có thể cấu hình, kiểm soát bằng quyền như một lựa chọn thay thế hoặc bổ sung cho rương vật lý.

⚙️ Tính năng

• Truy cập vault dựa trên quyền bằng các node có dạng axvaults.vault.<number>.
• Số lượng slot vault không giới hạn cho mỗi người chơi (thực tế bị giới hạn bởi giới hạn integer).
• Lưu trữ an toàn với NBT: vật phẩm được lưu ở dạng nhị phân để giữ nguyên dữ liệu vật phẩm tùy chỉnh.
• Chống dupe theo thiết kế (lưu trữ do plugin quản lý thay vì tuần tự hóa vật phẩm thô).
• GUI/menu chọn để điều hướng các trang vault với hỗ trợ pagination.
• Hệ thống blacklist để ngăn một số vật phẩm nhất định được đặt vào vault.
• Biểu tượng có thể tùy chỉnh, cho phép người chơi chọn icon vault.
• Công cụ admin để xem và chỉnh sửa vault người chơi, bao gồm cả truy cập offline cho staff.
• Hỗ trợ cơ sở dữ liệu H2 và SQLite làm backend lưu trữ.

🧩 Dành cho ai

• Server Survival và SMP cần lưu trữ riêng cho từng người chơi.
• Server sử dụng vật phẩm tùy chỉnh hoặc crate và cần lưu trữ an toàn với NBT.
• Server có quản trị cần staff truy cập để kiểm tra hoặc chỉnh sửa vault người chơi.

🏗️ Ví dụ sử dụng

• Cấp cho người chơi một số vault cố định thông qua quyền (ví dụ axvaults.vault.1, axvaults.vault.5).
• Dùng menu chọn để người chơi mở nhanh các trang vault khác nhau.
• Ngăn chìa khóa crate hoặc các vật phẩm kinh tế khác được lưu vào vault bằng blacklist.
• Staff lấy hoặc điều chỉnh vault của người chơi khi người chơi đó đang offline.

🔐 Quyền

⚙️ Cài đặt

📥 Thiết lập

• Tải file jar chính thức của plugin và đặt vào thư mục plugins/ của server dành cho các server dựa trên Bukkit/Spigot/Paper.
• Khởi động lại server và kiểm tra console của server để xác nhận plugin đã được tải.
• Cấu hình quyền (cấp các node axvaults.vault.<number> khi cần) bằng plugin permissions của bạn.

📦 Phụ thuộc

• Mặc định không cần phụ thuộc runtime nào (không có plugin bắt buộc nào được xác nhận). Plugin sử dụng các backend lưu trữ riêng của nó.

🧾 Cấu hình

• Plugin sử dụng các backend lưu trữ có thể cấu hình (H2, SQLite được ghi nhận là được hỗ trợ).
• Blacklist, cài đặt icon và các hàng lưu trữ vault đều có thể cấu hình (xem tài liệu chính thức để biết chi tiết).

🧠 Ghi chú kỹ thuật

• Kho lưu trữ dự án và các tài nguyên chính thức được Artillex-Studios duy trì.
• Plugin quảng bá hỗ trợ lưu trữ H2 và SQLite.
• Admin có thể truy cập vault của người chơi offline (quyền truy cập offline cho admin đã được ghi nhận).
• Plugin cho biết nó chống dupe theo thiết kế và lưu vật phẩm ở dạng nhị phân để giữ NBT.
• Hãy xác nhận yêu cầu Java và các phiên bản server được hỗ trợ từ ghi chú phát hành chính thức trước khi triển khai.

🤝 Khi nào plugin này hữu ích

Nếu bạn cần lưu trữ ảo an toàn NBT, được kiểm soát bằng quyền cho người chơi, có công cụ kiểm tra cho staff và lưu trữ đơn giản dựa trên cơ sở dữ liệu (H2/SQLite), AxVaults cung cấp một giải pháp tập trung mà không cần thêm phụ thuộc.