Plugin Minecraft VotingPlugin

🔌 Giới thiệu về VotingPlugin

VotingPlugin là một plugin Minecraft hoạt động như một trình theo dõi vote nâng cao và trình quản lý phần thưởng. Nó nhận thông báo vote từ các dịch vụ vote bên ngoài (thông qua Votifier hoặc các listener tương tự) và áp dụng các phần thưởng, thông báo, cũng như theo dõi có thể cấu hình rất linh hoạt trên server.

🎯 Mục đích

Plugin này tập trung việc xử lý vote và trao phần thưởng, để quản trị viên server có thể: theo dõi tổng số vote và vote theo tháng, trao phần thưởng theo từng site hoặc phần thưởng tích lũy, phát thông báo sự kiện vote, và duy trì bảng xếp hạng cho người vote nhiều nhất.

⚙️ Tính năng

• Phần thưởng vote có thể cấu hình theo từng site vote và phần thưởng tích lũy theo người chơi (vote X lần để nhận thưởng).
• Tùy chọn thông báo và broadcast cho các vote mới.
• Theo dõi người vote nhiều nhất và phần thưởng tùy chọn cho top voter.
• Tương thích với PlaceholderAPI (cung cấp placeholders cho hiển thị trong game).
• Hỗ trợ trình chỉnh sửa bên ngoài để đơn giản hóa cấu hình phức tạp.
• Phát triển tích cực với source và các bản phát hành được duy trì trên một repository công khai.

🧩 Phù hợp với ai

• Chủ server và admin dùng voting trên server list để tăng traffic và muốn phần thưởng tự động.
• Các server SMP và Survival dùng voting để nhận thưởng và tăng tương tác của người chơi.
• Các network chấp nhận vote qua listener kiểu Votifier và cần một hệ thống phần thưởng tập trung.

🏗️ Ví dụ sử dụng

• Cho người chơi một vật phẩm hoặc phần thưởng tiền tệ mỗi khi họ vote trên một site.
• Trao một phần thưởng đặc biệt sau khi người chơi đạt đến số vote đã cấu hình.
• Duy trì bảng xếp hạng hàng tháng và trao giải cho top voter.

📥 Cài đặt

📥 Thiết lập

• Tải file JAR chính thức của plugin và đặt nó vào thư mục plugins/ của server tương thích với Spigot.
• Khởi động lại server và kiểm tra log trong console để xác nhận plugin đã được tải.
• Đảm bảo đã cấu hình listener kiểu Votifier để các site vote bên ngoài có thể thông báo cho server của bạn.

📦 Phụ thuộc

• Votifier (hoặc một listener thông báo vote khác) là bắt buộc để nhận vote từ bên ngoài.
• PlaceholderAPI được hỗ trợ cho placeholders nếu bạn cần tích hợp với scoreboard, chat hoặc GUI.

🧠 Ghi chú kỹ thuật

• Nền tảng đã xác nhận: Spigot.
• Các phiên bản Minecraft chính đã được thử nghiệm bao gồm những mục được dự án liệt kê (ví dụ: 1.17, 1.18, 1.19, 1.20, 1.21); dự án cũng liệt kê một phiên bản major native sớm hơn.
• Source code và issue tracker đều được công khai trong repository của dự án.

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

Nếu bạn cần một hệ thống có thể cấu hình để chuyển các vote từ server list bên ngoài thành phần thưởng trong game, thông báo và bảng xếp hạng, VotingPlugin cung cấp một giải pháp giàu tính năng và được duy trì tích cực cho các server tương thích với Spigot.