Plugin Minecraft zAuctionHouse

🔌 Giới thiệu zAuctionHouse

zAuctionHouse là một plugin Minecraft triển khai một hệ thống đấu giá đầy đủ tính năng để người chơi đăng bán, duyệt và mua vật phẩm. Plugin tập trung vào khả năng tùy biến, giao diện dựa trên GUI và hỗ trợ nhiều loại economy. Dự án được GroupeZ-dev duy trì, và repository cùng tài liệu cho thấy một bản viết lại V4 nhắm tới Java hiện đại và các kiến trúc máy chủ hiện đại.

🎯 Mục đích

zAuctionHouse giải quyết vấn đề giao dịch vật phẩm trong game bằng cách cung cấp một thị trường trung tâm nơi người chơi có thể tạo các listing mua ngay, thực hiện bán số lượng lớn và duyệt kho theo danh mục. Plugin hướng tới các server muốn có một marketplace tích hợp với khả năng kiểm tra cho admin và đồng bộ mạng tùy chọn.

⚙️ Tính năng

• Listing mua ngay (buy-it-now) và quy trình kiểu đấu giá khi được hỗ trợ.
• Bán số lượng lớn: bán nhiều vật phẩm trong một listing.
• Xem trước shulker box để người mua kiểm tra nội dung trước khi mua.
• Lọc theo danh mục, sắp xếp nâng cao và phân trang cho các tập listing lớn.
• Hỗ trợ nhiều economy (Vault, PlayerPoints, CoinsEngine, tiền tệ dựa trên vật phẩm, XP/cấp độ).
• Hệ thống thuế có thể cấu hình và giảm thuế dựa trên quyền.
• Giao tiền tự động hoặc thủ công, và thông báo bán hàng khi offline.
• Tích hợp zMenu cho GUI và mẫu inventory có thể tùy chỉnh hoàn toàn.
• Hỗ trợ PlaceholderAPI và MiniMessage cho tin nhắn định dạng và placeholder.
• Công cụ admin: bảng điều khiển admin, nhật ký hành động, lịch sử giao dịch, khôi phục vật phẩm và lệnh quản lý cache.
• Đồng bộ nhiều server thông qua Redis addon với distributed locking và pub/sub.
• Điều khiển vật phẩm blacklist/whitelist, giới hạn world, giới hạn listing và giá, cùng transaction locking để tránh race condition.
• Hỗ trợ Discord webhook cho thông báo bán hàng với nội dung embed có thể cấu hình.

🧩 Phù hợp cho

• Các server Survival và SMP muốn một marketplace do người chơi điều khiển.
• Server Skyblock, Factions và các server tập trung vào kinh tế cần hệ thống giao dịch.
• Các network cần marketplace đồng bộ trên nhiều backend server.
• Quản trị viên server cần log kiểm tra và công cụ khôi phục cho admin.

🏗️ Ví dụ sử dụng

• Người chơi đăng các vật phẩm hiếm hoặc vật phẩm đã craft với giá cố định để người khác có thể mua ngay.
• Chủ server áp dụng quy tắc thuế và giảm thuế VIP thông qua quyền.
• Một network nhiều server đồng bộ listing và giao dịch giữa hub và backend server bằng Redis addon.

⌨️ Lệnh

(Các lệnh trên được lấy từ tài liệu chính thức của dự án và tài liệu quick-start trong repository.)

🔐 Quyền

(Chỉ các node permission được nêu rõ trong cấu hình và tài liệu chính thức mới được liệt kê.)

⚙️ Cài đặt

📥 Thiết lập

• Lấy file jar chính thức của zAuctionHouse từ bản phân phối của dự án (trang bán chính thức hoặc catalog).
• Đặt file jar zAuctionHouse (và các plugin cần thiết) vào thư mục plugins/ của server.
• Khởi động lại server và kiểm tra xem plugin đã khởi tạo thành công trong console chưa.
• Cấu hình plugin bằng plugins/zAuctionHouse/config.yml và tùy chỉnh các inventory GUI trong plugins/zAuctionHouse/inventories/.

📦 Phụ thuộc

• Cần: zMenu, PlaceholderAPI.
• Tích hợp tùy chọn / được hỗ trợ: Vault, LuckPerms, và zAuctionHouse Redis addon cho đồng bộ nhiều server.

🧠 Ghi chú kỹ thuật

• Dự án nhắm tới Java hiện đại (bản viết lại V4 nhắm tới Java 21) và sử dụng repository pattern / ORM trong kiến trúc của nó.
• Phần mềm server được khuyến nghị gồm Paper và các fork của Paper; Folia và một số fork dựa trên Paper cũng được liệt kê là được hỗ trợ.
• Tài liệu chính thức và bản phân phối cho thấy hỗ trợ từ Minecraft 1.20 đến 1.21+ (hãy kiểm tra tài liệu dự án để biết chính xác khả năng tương thích của build trước khi triển khai lên production).

❓ FAQ

• Có phiên bản miễn phí không?
  Có bản demo miễn phí (dự án cung cấp bản phát hành miễn phí/demo trên một số nền tảng), trong khi các bản phát hành đầy đủ, được hỗ trợ được phân phối qua các kênh premium của dự án.

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

Nếu bạn cần một marketplace có thể tùy chỉnh, dựa trên GUI, có hỗ trợ nhiều economy và đồng bộ nhiều server tùy chọn, zAuctionHouse cung cấp một triển khai hệ thống đấu giá được duy trì cùng với kiểm tra admin và tùy biến GUI qua zMenu.