Plugin Minecraft AxRewards

🔌 Giới thiệu AxRewards

AxRewards là một plugin Minecraft cung cấp hệ thống phần thưởng nhẹ và có thể cấu hình. Quản trị viên máy chủ định nghĩa phần thưởng với cooldown tùy ý, hiển thị chúng trong các GUI có thể chỉnh sửa, và thực thi lệnh nhận thưởng khi người chơi nhận phần thưởng. Dự án được duy trì bởi Artillex-Studios và bao gồm lưu trữ dựa trên cơ sở dữ liệu cùng hỗ trợ nhiều máy chủ.

🎯 Mục đích

AxRewards giải quyết nhu cầu phổ biến về phần thưởng người chơi theo lịch hoặc có thể lặp lại (ví dụ phần thưởng đăng nhập hằng ngày hoặc hằng tuần) đồng thời cung cấp cooldown linh hoạt, khóa bằng permission, và hiển thị qua GUI. Plugin này dành cho các máy chủ muốn có một hệ thống phần thưởng tích hợp, có thể cấu hình mà không cần hệ thống cache bên ngoài.

⚙️ Tính năng

• Phần thưởng có thể cấu hình với cooldown tùy ý (tính bằng giây).
• Menu GUI có thể chỉnh sửa để hiển thị phần thưởng; các mục GUI có thể hiển thị nhiều trạng thái khác nhau (có thể nhận / không thể nhận / không có permission).
• Lưu trữ cơ sở dữ liệu với hỗ trợ H2, SQLite, MySQL và PostgreSQL.
• Hỗ trợ nhiều máy chủ mà không cần Redis.
• GUI tự động cập nhật (làm mới định kỳ mà không cần mở lại).
• Khả năng khóa phần thưởng bằng permission (mỗi phần thưởng có thể yêu cầu một permission).
• Hành động nhận thưởng được triển khai dưới dạng danh sách lệnh máy chủ (hỗ trợ placeholder %player%).
• Tích hợp PlaceholderAPI và hỗ trợ nhiều định dạng màu.

🧩 Dành cho ai

• Máy chủ Survival và SMP muốn có phần thưởng nhận hằng ngày/hằng tuần/tùy chỉnh.
• Người vận hành máy chủ cần dữ liệu được lưu bền vững qua các lần khởi động lại hoặc trên nhiều máy chủ.
• Quản trị viên thích trình bày phần thưởng bằng GUI và phần thưởng bị khóa bằng permission.

🏗️ Ví dụ sử dụng

• Cung cấp phần thưởng đăng nhập hằng ngày, tặng vật phẩm hoặc chạy lệnh khi được nhận.
• Cung cấp phần thưởng VIP hằng tuần có giới hạn, yêu cầu permission của hạng để nhận.
• Chạy các phần thưởng dựa trên lệnh, cấp tiền, vật phẩm hoặc thực thi lệnh máy chủ tùy chỉnh bằng %player%.

⌨️ Lệnh

(Chỉ những lệnh được xác nhận trong tài liệu chính thức mới được liệt kê.)

⚙️ Cài đặt

📥 Thiết lập

• Tải file JAR của plugin và đặt vào thư mục plugins/ của máy chủ nếu đó là máy chủ tương thích Bukkit/Spigot/Paper.
• Khởi động hoặc khởi động lại máy chủ để plugin có thể tạo thư mục dữ liệu và cấu hình.
• Các file cấu hình và menu được đặt trong thư mục plugin (ví dụ plugins/AxRewards/menus).

📦 Phụ thuộc

• PlaceholderAPI (tích hợp tùy chọn cho placeholder) — đã xác nhận hỗ trợ.

🧠 Ghi chú kỹ thuật

• Các backend cơ sở dữ liệu đã xác nhận: H2, SQLite, MySQL, PostgreSQL.
• Plugin hỗ trợ PlaceholderAPI và các định dạng màu phổ biến (bao gồm MiniMessage và các định dạng legacy).
• GUI tự động làm mới (auto-updating) mà người chơi không cần mở lại.
• Phần thưởng xác định cooldown theo giây; đặt cooldown thành -1 sẽ khiến phần thưởng không bao giờ làm mới.
• Dự án là open-source và được cấp phép theo MIT.
• Phần mềm máy chủ và chủ đề được xác nhận hỗ trợ bao gồm Bukkit, Spigot, Paper và Folia.
• Yêu cầu được xác nhận: runtime Java hiện đại (ghi chú dự án cho biết Java 21 trở lên cho các bản phát hành gần đây).

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

Nếu bạn cần một hệ thống phần thưởng có thể cấu hình, điều khiển bằng GUI, với lưu trữ bền vững và hỗ trợ liên máy chủ, AxRewards cung cấp menu có thể chỉnh sửa, xử lý cooldown và hành động nhận thưởng bằng lệnh, đồng thời tích hợp với PlaceholderAPI và các cơ sở dữ liệu phổ biến.