Plugin Minecraft AuctionHouse

🔌 Giới thiệu về AuctionHouse

AuctionHouse là một plugin Minecraft bổ sung một nhà đấu giá trong game có thể truy cập bằng lệnh /ah. Người chơi có thể đăng món đồ để bán, duyệt và tìm kiếm các mục đăng, và mua vật phẩm thông qua thị trường dựa trên GUI. Plugin tập trung vào giao dịch giữa người chơi với các quy tắc đăng bán, phí và thông báo có thể cấu hình.

🎯 Mục đích

AuctionHouse cung cấp một thị trường tập trung, điều khiển bằng GUI để các server có thể cung cấp hệ thống đấu giá được quản lý thay vì dựa vào shop do người chơi vận hành hoặc thị trường dùng biển hiệu. Nó dành cho các server muốn có một thị trường công khai có thể tìm kiếm, với các giới hạn có thể cấu hình và tích hợp kinh tế.

⚙️ Tính năng

• Nhà đấu giá GUI mở bằng /ah.
• Tạo và hủy mục đăng; nhận lại vật phẩm đã hủy hoặc hết hạn.
• Tìm kiếm và lọc mục đăng theo tên, loại, lore, enchant hoặc người bán.
• Sắp xếp mục đăng theo thời gian hoặc giá.
• Điều khiển đăng bán: đặt giá tối thiểu/tối đa, phí đăng (cố định và/hoặc theo phần trăm), thuế người bán có giới hạn, và thời gian chờ giữa các lần đăng.
• Giới hạn vật phẩm theo tên, loại, lore, enchantments, damage, cờ unbreakable, custom_model_data và các mẫu regex.
• Tùy chọn đăng vật phẩm của server (đăng một lần hoặc không giới hạn).
• Các trình kích hoạt đặc biệt để mở đấu giá qua biển hiệu, block entity có tên (chest, shulker, dispenser, v.v.), hoặc entity có tên tùy chỉnh.
• Tooltip khi rê vào vật phẩm hiển thị thời gian còn lại và enchant.
• Thông báo tùy chọn cho mục đăng mới và tích hợp Discord.
• Hỗ trợ quốc tế hóa và các tin nhắn, vật liệu, âm thanh có thể cấu hình.
• Ghi nhật ký giao dịch vào file log riêng và tự động dọn các vật phẩm bị bỏ quên.

🧩 Dành cho ai

• Các server Survival và SMP muốn có một thị trường chung cho người chơi.
• Các server tập trung vào kinh tế muốn có GUI đấu giá có thể tìm kiếm.
• Quản trị viên cần quy tắc đăng bán, phí và giới hạn vật phẩm có thể cấu hình.

🏗️ Ví dụ sử dụng

• Người chơi đăng các món loot dư thừa và đem đấu giá cho cộng đồng server thay vì dùng chest hoặc shop.
• Nhân viên server tạo các mục đăng do server cung cấp với số lượng giới hạn hoặc không giới hạn cho các vật phẩm cửa hàng.
• Quản trị viên áp dụng quy tắc kinh tế server bằng cách giới hạn một số vật phẩm hoặc áp thuế đăng bán.

⌨️ Lệnh

🔐 Permissions

⚙️ 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 cho các server tương thích Spigot.
• Khởi động lại server hoàn toàn và kiểm tra console để xác nhận plugin đã được tải.
• Cấu hình plugin bằng các file cấu hình được cung cấp theo nhu cầu.

📦 Dependencies

• Vault (bắt buộc, khuyến nghị 1.7.1+).
• Một plugin economy phù hợp (ví dụ EssentialsX economy hoặc một nhà cung cấp economy tương thích Vault khác).
• Một plugin permissions phù hợp (nếu bạn dùng quyền ngoài mặc định).

🧠 Ghi chú kỹ thuật

• Lưu trữ: plugin dùng SQLite (không có tài liệu về hỗ trợ cơ sở dữ liệu bên ngoài).
• Plugin ghi giao dịch vào một file log riêng và hỗ trợ quốc tế hóa.
• Hỗ trợ HeadDatabase heads và texture skull tùy chỉnh làm nút GUI.
• Tác giả lưu ý tính năng và khả năng tương thích phiên bản nhắm tới Spigot; hành vi có thể khác trên phần mềm server khác.

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

Nếu bạn muốn một hệ thống đấu giá có thể cấu hình, dựa trên GUI và tích hợp với economy của server cùng Vault, AuctionHouse cung cấp kiểm soát mục đăng, tìm kiếm/lọc, phí/thuế và ghi nhật ký giao dịch để tạo ra một khu chợ người chơi dễ quản lý.