Plugin Minecraft Shopkeepers

🔌 Giới thiệu về Shopkeepers

Shopkeepers là một plugin Minecraft cho Bukkit/Spigot cho phép chủ server đặt các villager shopkeeper có thể tùy chỉnh, bán các vật phẩm được cấu hình với mức giá được cấu hình. Plugin hỗ trợ cả admin shops (nguồn hàng vô hạn) và player shops lấy hàng từ một container, đồng thời cung cấp ShopkeepersAPI để tích hợp addon và mở rộng.

🎯 Mục đích

Plugin cung cấp một hệ thống cửa hàng dựa trên NPC ngay trong game, để server có thể có các cửa hàng cố định mà không cần quản lý chest thủ công hay các cửa hàng dùng lệnh phức tạp. Phù hợp cho kinh tế server, cửa hàng roleplay, và các server survival/SMP muốn có thương nhân NPC. ()

⚙️ Tính năng

• Tạo shopkeeper villager tùy chỉnh với trade và giá được xác định.
• Admin shops với nguồn cung vô hạn.
• Player shops lấy vật phẩm từ một container (chest) được gắn vào để làm hàng tồn kho.
• ShopkeepersAPI dành cho lập trình viên plugin để truy vấn và quản lý shopkeeper bằng chương trình.
• Tùy chỉnh item/item-data trong game và hỗ trợ file ngôn ngữ thông qua wiki của dự án và các file ngôn ngữ. ()

🧩 Dành cho ai

• Các server Survival và SMP muốn có cửa hàng do NPC vận hành.
• Các server roleplay hoặc kinh tế dùng NPC villager làm thương nhân.
• Các lập trình viên plugin cần một API để tích hợp hành vi cửa hàng vào hệ thống khác. ()

🏗️ Ví dụ sử dụng

• Một admin tạo một admin shop vô hạn bán hàng do server cung cấp.
• Một người chơi mở một shop tự động bán vật phẩm từ chest được liên kết.
• Một developer xây dựng addon để liệt kê hoặc chỉnh sửa shopkeeper bằng ShopkeepersAPI. ()

⌨️ Lệnh

(Lưu ý: chỉ các lệnh được tài liệu chính thức ghi rõ mới được liệt kê ở trên.) ()

⚙️ Cài đặt

📥 Thiết lập

• Tải file jar plugin chính thức và đặt vào thư mục plugins/ của server.
• Khởi động lại server và kiểm tra console để xác nhận plugin đã được tải.

(Đây là các bước cài đặt tiêu chuẩn cho plugin Bukkit/Spigot và được tài liệu của dự án hỗ trợ.) ()

🧠 Ghi chú kỹ thuật

• Shopkeepers được phát hành theo giấy phép GPL-3.0 và kho dự án bao gồm một module API (ShopkeepersAPI) cùng hướng dẫn build. ()
• Dự án cung cấp artifact Maven và một API đã được phát hành cho các nhà phát triển addon; README mô tả cách dùng repository và tọa độ phụ thuộc của API. ()
• Bản phát hành chính thức và hỗ trợ cộng đồng có sẵn qua trang resource của Spigot và máy chủ Discord của plugin. ()

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

Nếu bạn cần các thương nhân NPC ổn định, có thể cấu hình, hỗ trợ cả admin shops lẫn player shops, và muốn có API để tích hợp cửa hàng vào các plugin khác, Shopkeepers cung cấp một giải pháp đã được kiểm chứng cho server Bukkit/Spigot. ()