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.
• 🔔 [NEW] Discord Webhooks Integration: Send real-time notifications to Discord when a player uses a Totem of Undying or dies, featuring player avatars, world details, and exact coordinates.

---

🛠️ Configuration (config.yml)

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

# Enable or Disable Totem usage messages.
totem-alert: true
# Custom text for Totem usage.
totem-message: "&6&lTotemAnnouncement &8» &e%player% &7has used a &6Totem of Undying&7."

# Enable or Disable death messages.
death-alert: true
# Custom text for death.
death-message: "&6&lTotemAnnouncement &8» &8[&c☠&8]&e%player% &7has passed away."

# Permission to reload the plugin
reload-permission: "toteman.admin"

# [BETA] Discord webhook URL
# New feature to announce 'Death' and 'Totem POP' in a Discord channel; 
# since the feature is in beta, the content is predefined, 
# and you simply need to enter the URL of a webhook created in a Discord channel.
webhook-url: ""

📂 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.