Plugin Minecraft ChestShop

🔌 Giới thiệu ChestShop

ChestShop là một plugin Minecraft để tạo các cửa hàng do người chơi quản lý bằng rương và biển báo. Nó kết nối hoạt động của cửa hàng với nền kinh tế của máy chủ (qua Vault hoặc Reserve) để người chơi có thể mua và bán vật phẩm bằng tiền của máy chủ. Dự án được duy trì trên GitHub và phát hành các bản build qua những nền tảng plugin phổ biến.

🎯 Mục đích

Cung cấp một marketplace trong thế giới đơn giản, bền vững, nơi người chơi tạo cửa hàng bằng cách đặt một biển báo lên rương. ChestShop xử lý giao dịch giữa kho đồ của người chơi và nền kinh tế của máy chủ, đồng thời có các cơ chế bảo vệ và hook tương thích để giảm griefing và dễ tích hợp hơn.

⚙️ Tính năng

• Tạo cửa hàng mua/bán bằng cách đặt một biển báo đã định dạng lên rương.
• Tích hợp với Vault hoặc Reserve và các plugin kinh tế tương thích khác để xử lý tiền.
• Tùy chọn bảo vệ cửa hàng và tương thích để phù hợp với các plugin bảo vệ rương phổ biến.
• Các biện pháp chống lag / đảm bảo an toàn giao dịch được tác giả tài liệu hóa.
• Có thể mở rộng bằng add-on cộng đồng và plugin tương thích (danh sách add-on được dự án duy trì).
• Các lệnh quản trị và thông tin đã được thêm trong các bản phát hành gần đây (ví dụ: /shopinfo, /iteminfo).

🧩 Dành cho ai

• Các máy chủ Survival và SMP dùng nền kinh tế dựa trên tiền tệ.
• Các máy chủ muốn có cửa hàng người chơi đơn giản, dựa trên biển báo thay vì giao diện GUI.
• Các admin thích cửa hàng lưu vật phẩm trong rương vanilla (không cần cơ sở dữ liệu bắt buộc cho lưu trữ cửa hàng cơ bản).

🏗️ Ví dụ sử dụng

• Người chơi đặt một rương, bỏ vật phẩm muốn bán vào, rồi tạo một biển báo để đặt giá mua/bán; người chơi khác nhấp vào biển báo để giao dịch.
• Quản trị viên máy chủ tạo shop admin để bán vật phẩm do máy chủ vận hành.
• Một cộng đồng thêm plugin tương thích để tích hợp ChestShop với addon bảo vệ hoặc hiển thị.

⌨️ Lệnh

(Các lệnh được liệt kê được lấy từ ghi chú phát hành và tài liệu của dự án. Chỉ những lệnh được dự án tài liệu hóa rõ ràng mới được hiển thị.)

🔐 Quyền

(Các node quyền chỉ được đưa vào nơi chúng xuất hiện trong tài nguyên chính thức của dự án và ghi chú phát hành.)

⚙️ Cài đặt

📥 Thiết lập

• Tải xuống tệp .jar chính thức của ChestShop và đặt vào thư mục plugins/ của máy chủ.
• Cài đặt Vault hoặc Reserve và một plugin kinh tế tương thích cung cấp API tiền tệ.
• Khởi động lại máy chủ và kiểm tra console để xác nhận ChestShop đã được bật thành công.

📦 Phụ thuộc

• Vault (hỗ trợ tích hợp) hoặc Reserve (hỗ trợ tích hợp)
• Một plugin kinh tế tương thích có cung cấp API tiền tệ (cài cùng với Vault/Reserve)

🧾 Cấu hình

Plugin tạo các tệp cấu hình/yml khi chạy lần đầu; các tùy chọn cấu hình và công tắc tương thích có sẵn trong các tệp đó và trong tài liệu dự án.

🧠 Ghi chú kỹ thuật

• Mã nguồn và theo dõi lỗi được lưu trữ trên GitHub theo giấy phép LGPL-2.1.
• Dự án liệt kê các bản build và artifact phát hành trên các trang plugin phổ biến; người bảo trì cũng phát hành bản development build trên máy chủ CI.
• ChestShop được thiết kế cho các loại máy chủ Bukkit/Spigot/Paper (điều này được ghi rõ trong tài liệu dự án và repository).

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

Nếu bạn muốn một marketplace trong thế giới thật đơn giản, nơi vật phẩm vẫn ở trong các rương thường và giao dịch dùng tiền của máy chủ, ChestShop cung cấp một hệ thống shop bằng rương và biển báo trưởng thành, có thể mở rộng, với tích hợp kinh tế và tương thích add-on.