TotemAnnouncement ☠️

A simple and ultra-lightweight Spigot/Paper plugin specifically designed for Hardcore (HC), Ultra Hardcore (UHC), or Survival MultiPlayer (SMP) game modes.

This plugin allows you to maintain rigorous control and tracking of player deaths and totem usage (totem pops) on your server, without bloating your infrastructure with heavy auditing plugins or complex databases (such as CoreProtect, LuckPerms, or EssentialsX).

✨ Features

• 📢 Custom Messages: Fully customize global death and totem pop messages in the chat with full color code (&) support.
• 🔌 Toggleable via Config: Easily enable or disable global chat announcements independently if you prefer using the base game's default messages.
• 🪵 Real-Time Console Logs: Sends immediate, clean logs to the console specifying the player, world, and exact coordinates of the event.
• 🗃️ Local YAML Database: Automatically generates a logs.yml file inside the plugin folder, chronologically organized by player and timestamp (System.currentTimeMillis()) for quick auditing.
• ⚡ Highly Optimized: Virtually zero resource consumption. Designed to prevent lag and avoid overworking your server's processor.

🛠️ Configuration (config.yml)

The configuration file is intuitive and easy to edit for server administrators:

# Permission node required to reload the plugin config (Customizable)
reload-permission: "toteman.admin"

# Should the global death alert be displayed in chat?
death-alert: true
# Custom death message (%player% will be replaced by the player's name)
death-message: "&8[&c☠&8] &e%player% &7has passed away."

# Should the global totem alert be displayed in chat?
totem-alert: true
# Custom message when a totem pops
totem-message: "&6[!] &e%player% &7has popped a totem."

📂 Audit Format (logs.yml)

Data is structured natively in YAML format, making it ideal to open directly from your server's FTP client without dealing with messy plain text files:

deaths:
  Arashi:
    '1713542400000':
      world: world
      coords: 120, 64, -300
totems:
  Arashi:
    '1713542415000':
      world: world_nether
      coords: 15, 80, 44

🚀 Installation

• Download the TotemAnnouncement.jar file.

• Drop it into your server's /plugins/ directory.

• Start or restart your Spigot/Paper server to generate the default configuration folder.

• You are all set! Adjust the messages in the config.yml to your liking.

⌨️ Commands & Permissions

/totemannounce # Main administration command.

toteman.admin # Default permission node to reload the plugin configuration (Customizable in config.yml).

📄 License

This project is licensed under the GNU AGPLv3 (GNU Affero General Public License v3.0). You are free to use, modify, and distribute this code, as long as any modified or derived version is shared openly and completely free of charge under this exact same license.