Plugin Minecraft QuickShop-Hikari

🔌 Giới thiệu QuickShop-Hikari

QuickShop-Hikari là một plugin Minecraft triển khai các cửa hàng mua/bán dựa trên rương (ChestShops). Người chơi tạo và sử dụng cửa hàng bằng cách tương tác với rương; phần lớn lối chơi không cần bất kỳ lệnh nào. Dự án được duy trì bởi QuickShop-Community và tập trung vào khả năng tương thích hiện đại, an toàn dữ liệu, và các tích hợp có thể mở rộng.

🎯 Mục đích

Cung cấp một nền kinh tế trong game dựa trên vật phẩm, nơi người chơi có thể niêm yết vật phẩm để bán hoặc tạo cửa hàng mua bằng rương. Plugin này hướng tới các quản trị viên máy chủ muốn có một nền kinh tế vật lý, vận hành bằng rương và kiểm soát theo từng cửa hàng mà không ép người chơi phải học lệnh.

⚙️ Tính năng

• Tạo cửa hàng mua và bán bằng rương và bảng hiệu (cửa hàng dựa trên rương).
• Hỗ trợ dữ liệu NBT, enchantment, độ bền vật phẩm, dữ liệu potion và trứng mob.
• Vật phẩm hiển thị ảo phía trên cửa hàng có thể bật/tắt (hỗ trợ ProtocolLib hoặc PacketEvents).
• Hỗ trợ rương không giới hạn và hành vi mua/bán kết hợp ở rương đôi.
• Hỗ trợ blacklist với các tùy chọn quyền bypass.
• Quản lý quyền theo từng cửa hàng và lợi ích cửa hàng giữa chủ sở hữu và người chơi khác.
• Hỗ trợ i18n cho tên vật phẩm và enchantment, cùng cú pháp MiniMessage cho tin nhắn.
• Hỗ trợ datasource H2 (cục bộ) và MySQL (từ xa).
• Các hook tích hợp cho những plugin bảo vệ và tiện ích phổ biến (có sẵn module tương thích).
• API dành cho nhà phát triển (cung cấp tọa độ Maven/Gradle) để truy vấn cửa hàng và tích hợp tính năng.
• Telemetry bStats với tùy chọn tắt trong cấu hình.

🧩 Dành cho ai

Dành cho chủ và quản trị viên máy chủ chạy Survival/SMP hoặc các máy chủ tập trung vào kinh tế, muốn có một marketplace vật lý dựa trên rương. Phù hợp với máy chủ nhỏ đến lớn sử dụng plugin kinh tế tương thích Vault và muốn kiểm soát theo từng cửa hàng cùng lưu trữ dựa trên cơ sở dữ liệu.

🏗️ Ví dụ sử dụng

• Người chơi đặt vật phẩm vào một rương và gắn nhãn để tự động bán theo chồng cho người chơi khác.
• Một admin bật quyền theo từng cửa hàng để mod có thể quản lý cửa hàng ở các thế giới hoặc khu vực cụ thể.
• Một network dùng lưu trữ MySQL để giữ cửa hàng tồn tại bền vững giữa các instance máy chủ.

⌨️ Lệnh

Lưu ý: tài liệu dự án cho biết lối chơi của người chơi bình thường không cần lệnh; lệnh chủ yếu dành cho quản trị.

🔐 Quyền

⚙️ Cài đặt

📥 Thiết lập

• Tải file jar QuickShop-Hikari chính thức từ kênh phân phối của dự án (bản phát hành Modrinth/Spigot/GitHub).
• Đặt file jar vào thư mục plugins/ của máy chủ.
• Khởi động máy chủ và kiểm tra plugin đã được tải (tài liệu cho thấy chạy lệnh qs trong console để hiển thị trợ giúp/kết quả kiểm tra).

📦 Phụ thuộc

Các tích hợp bắt buộc/tùy chọn đã được dự án xác nhận:

• Vault (bắt buộc để kết nối kinh tế)
• Một plugin kinh tế tương thích Vault (dự án có đưa ví dụ)
• ProtocolLib hoặc PacketEvents (bắt buộc cho vật phẩm hiển thị ảo / bản địa hóa theo từng người chơi)
• LuckPerms (khuyến nghị cho quản lý quyền)

🧾 Cấu hình

• Plugin tạo và sử dụng config.yml (tài liệu có nhắc đến các khóa config.yml cho giao thức hiển thị và cài đặt riêng tư).
• Lưu trữ dữ liệu hỗ trợ H2 cục bộ hoặc MySQL từ xa; các tùy chọn cấu hình có trong file cấu hình của plugin.

🧠 Ghi chú kỹ thuật

• Tài liệu chính thức khuyến nghị chạy trên server dựa trên Paper và nêu yêu cầu Java 21.
• Dự án cung cấp API dành cho nhà phát triển và tọa độ Maven/Gradle để dùng khi biên dịch.
• QuickShop-Hikari đi kèm các module tương thích cho plugin bên thứ ba (ví dụ WorldGuard, WorldEdit, OpenInv) dưới dạng tải xuống tùy chọn.
• Telemetry: sử dụng bStats; có thể tắt trong phần cấu hình.

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

Nếu bạn muốn một marketplace dựa trên rương, hướng tới người chơi, có lưu trữ bền vững và kiểm soát theo từng cửa hàng (thay vì chỉ dùng GUI hoặc lệnh), QuickShop-Hikari cung cấp một triển khai hiện đại, dựa trên cơ sở dữ liệu, với các hook cho những plugin kinh tế và bảo vệ phổ biến.