AuroraDominion

AuroraDominion is a high-performance Minecraft Paper plugin (1.21.x) designed to track and crown the player with the most kills inside specific regions defined by WorldGuard.

The plugin features fully customizable visual announcements, asynchronous database storage, and a cached PlaceholdersAPI (PAPI) expansion to easily display statistics in scoreboards, chat, or external hologram plugins like FancyHolograms.

🚀 Features

• WorldGuard Monitoring: Automatically tracks and counts PvP deaths occurring physically inside configured region boundaries.
• Customizable Output (messages.yml & config.yml): Edit chat broadcasts, titles, subtitles, action bar notices, and custom display names for each monitored region.
• Robust Connection Pooling: Asynchronous SQLite (local file) and MySQL/MariaDB (external pool) connections using HikariCP.
• Anti-Farm Protection: Configurable cooldown in seconds between registered kills of the same player pair to prevent leaderboard farming.
• Lag-Free Design: All database transactions and placeholder updates run completely off the main thread to ensure zero TPS impact.
• PlaceholdersAPI (PAPI) Support: Serve leaderboard statistics straight from an active memory cache to prevent tick lag.
• Custom Spawning Positions: Straightforward command to register coordinate vectors for holograms.
• File Update Protection: Replacing the .jar file will not overwrite or modify existing config edits.

🛠️ Commands and Permissions

Commands

• /auroradominion (aliases: /ad, /dominion)
  • /ad reload: Instantly reloads configurations (config.yml, messages.yml, hologram-locations.yml) and flushes expansions cache.
  • /ad sethologram <region>: Sets your current coordinates as the spawning location of the region's hologram.

Permissions

• auroradominion.use: Grants basic access to comandos (Default: everyone).
• auroradominion.admin: Grants administrative permission to reload and set hologram points (Default: OP).

📊 Placeholders (PAPI)

Hook AuroraDominion data anywhere using these PlaceholdersAPI keys:

• %auroradominion_dominant_<region>%: Name of the current leading player in the region.
• %auroradominion_dominant_kills_<region>%: Kills count of the dominant player in the region.
• %auroradominion_top_<pos>_name_<region>%: Username at rank <pos> (1 to 10) in the region.
• %auroradominion_top_<pos>_kills_<region>%: Kills count at rank <pos> (1 to 10) in the region.

(Example: %auroradominion_top_1_name_pvp_arena% returns the username of the top 1 player in the PvP Arena)

💾 Installation & Requirements

1. Ensure your server runs Paper 1.21.x (Java 21 or higher).
2. Install the necessary libraries in your plugins folder:
   • WorldGuard (Required - for region bounds check).
   • PlaceholderAPI (Recommended - for placeholder resolving).
   • FancyHolograms (Recommended - to build top kills holograms referencing our placeholders).
3. Place AuroraDominion.jar inside the plugins folder.
4. Restart your server to generate config files.