UniqueKills Plugin Description for SpigotMC.org
UniqueKills - Celebrate and Track Epic PVP Achievements!

Elevate your server's PVP experience with UniqueKills, a lightweight and engaging Spigot plugin for Minecraft 1.21! This plugin tracks unique player kills, ensuring every first-time victory against an opponent is celebrated with flair. Perfect for PVP servers, factions, or any community that thrives on competitive glory, UniqueKills adds a layer of prestige and competition to your gameplay.

✨ Features

• Unique Kill Tracking: Counts only the first kill on each player, making every new opponent a milestone. No grinding the same player for points!
• Epic Celebrations: When a player scores a new unique kill, they receive a personal message, and the server broadcasts their achievement with their total unique kills.
• Top Killers Leaderboard: Use /topkiller to display the top 10 players with the most unique kills, showcasing the server's deadliest warriors.
• Player Kill List: Run /topkiller <player> to see a detailed list of all players a specific user has defeated, perfect for bragging rights or strategizing.
• Persistent Data: All kill data is saved in data.yml, ensuring stats persist across server restarts for long-term rivalries.
• Velocity Compatible: Works seamlessly with Velocity proxy setups (requires proper UUID forwarding configuration).
• Lightweight & Easy to Use: No complex setup—just drop the JAR into your plugins/ folder and let the battles begin!

Why Choose UniqueKills?

• Encourages Diverse PVP: Players are motivated to seek out new opponents rather than farming kills, fostering a dynamic PVP environment.
• Community Engagement: Public kill announcements and leaderboards spark competition and camaraderie among players.
• Server-Friendly: Built for performance, with minimal resource usage and reliable data storage.
• Perfect for Any PVP Server: Whether you run a survival, factions, or hardcore server, UniqueKills adds a fun and competitive edge.

Commands

• /topkiller: Displays the top 10 players with the most unique kills.
• /topkiller <player>: Lists all players a specific player has uniquely defeated.

Installation

1. Download the UniqueKills-1.0-SNAPSHOT.jar from the releases page.
2. Place the JAR in your server's plugins/ folder.
3. Restart your server or run /reload (restart recommended for stability).
4. Ensure your server is running Spigot 1.21 and Java 21. For Velocity setups, configure modern or legacy forwarding for proper UUID handling.
5. Watch the kills roll in! Data is automatically saved to plugins/UniqueKills/data.yml.

Compatibility

• Minecraft Version: 1.21
• Java Version: 21
• Proxy Support: Compatible with Velocity (modern or legacy forwarding required).
• Online/Offline Mode: Best with online-mode for consistent UUIDs, but works in offline-mode with potential UUID inconsistencies.

Notes

• The plugin saves data on server shutdown or after each unique kill to prevent data loss.
• For servers with years of logs, a companion Python script is available to import historical kill data into data.yml—contact the developer or check the documentation for details!
• Want to exclude alt accounts? Reach out for a custom version with manual UUID linking or other detection methods.

Join the Battle!
Download UniqueKills today and let your players carve their names into your server’s PVP legacy! Got feedback or feature requests? Join our discussion thread or DM us on SpigotMC. Let’s make every kill count!