Plugin Minecraft ajLeaderboards

🔌 Giới thiệu về ajLeaderboards

ajLeaderboards là một plugin Minecraft dùng để tạo bảng xếp hạng từ bất kỳ placeholder nào của PlaceholderAPI trả về giá trị số. Plugin này thu thập và xếp hạng các giá trị do placeholder cung cấp, và có thể hiển thị kết quả bằng hologram, biển tích hợp sẵn, NPC, armor stand và đầu người chơi.

🎯 Mục đích

Plugin này giải quyết vấn đề tạo bảng xếp hạng linh hoạt, dùng được với nhiều plugin mà không cần tích hợp riêng: bất kỳ plugin nào cung cấp placeholder số của PlaceholderAPI đều có thể được theo dõi và hiển thị trên các màn hình trong thế giới hoặc xuất ra dưới dạng placeholder cho các plugin hiển thị khác.

⚙️ Tính năng

• Theo dõi bất kỳ placeholder số nào của PlaceholderAPI như một mục trong bảng xếp hạng.
• Nhiều tùy chọn hiển thị: hologram, biển tích hợp sẵn, NPC, armor stand và đầu người chơi.
• Bảng xếp hạng theo thời gian với tự động đặt lại (theo giờ, ngày, tháng, v.v.) nhưng vẫn giữ thống kê mọi thời gian.
• Hỗ trợ MySQL để đồng bộ bảng xếp hạng giữa các server (placeholder được theo dõi cũng phải được đồng bộ).
• Tùy chọn hiển thị prefix/suffix của người chơi thông qua tích hợp Vault.
• Placeholder "Extra" để hiển thị thêm văn bản placeholder bên cạnh các mục bảng xếp hạng.
• Hỗ trợ Folia và tương thích với các plugin hiển thị phổ biến (ví dụ: hệ thống hologram và NPC).
• Thu thập thống kê sử dụng ẩn danh qua bStats (có thể tắt trong cấu hình bStats).

🧩 Dành cho ai

• Các server Survival và SMP muốn có bảng xếp hạng động cho số dư, thống kê hoặc chỉ số tùy chỉnh.
• Các server đã dùng PlaceholderAPI và muốn hiển thị thứ hạng trong thế giới (hologram, biển, NPC).
• Quản trị viên cần bảng xếp hạng theo thời gian (ngày/giờ/tháng) và tùy chọn đồng bộ MySQL.

🏗️ Ví dụ sử dụng

• Hiển thị số dư kinh tế cao nhất bằng placeholder của plugin kinh tế và plugin hologram.
• Hiển thị số kill cao nhất hoặc điểm minigame tùy chỉnh trên NPC hoặc biển.
• Chạy bảng xếp hạng theo giờ hoặc theo ngày cho người thắng sự kiện trong khi vẫn giữ thành tích mọi thời gian.

⌨️ Lệnh

(Lưu ý: tên lệnh được plugin ghi tài liệu; quản trị server nên xem wiki của plugin để biết đầy đủ danh sách lệnh và cú pháp.)

🔐 Quyền hạn

⚙️ 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.
• Đảm bảo PlaceholderAPI đã được cài đặt trước khi khởi động server; plugin cần PlaceholderAPI để đọc các giá trị được theo dõi.
• Khởi động hoặc khởi động lại server và kiểm tra console để xác nhận plugin đã được tải.

📦 Phụ thuộc

• PlaceholderAPI (bắt buộc)
• Vault (tùy chọn; dùng để hiển thị prefix/suffix)
• Citizens (tùy chọn; cho hiển thị bảng xếp hạng dựa trên NPC)
• DecentHolograms hoặc các plugin hologram khác (tùy chọn; cho hiển thị hologram)

🧠 Ghi chú kỹ thuật

• Plugin hỗ trợ bảng xếp hạng theo thời gian (theo giờ/ngày/tháng) và có thể dùng MySQL để đồng bộ bảng xếp hạng khi giá trị placeholder được theo dõi cũng được đồng bộ.
• Hỗ trợ Folia đã có sẵn.
• Plugin gửi số liệu ẩn danh đến bStats; có thể tắt trong cấu hình bStats.

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

Nếu bạn đã dùng PlaceholderAPI và muốn một cách dễ dùng, không phụ thuộc vào loại hiển thị để đưa dữ liệu số có xếp hạng (kinh tế, thống kê, chỉ số tùy chỉnh) ra trong thế giới hoặc dưới dạng placeholder, ajLeaderboards cung cấp bảng xếp hạng theo thời gian, nhiều tùy chọn hiển thị và đồng bộ MySQL tùy chọn mà không cần tích hợp riêng cho từng plugin.