AutoTotem-Plugin

AutoTotem

Never die to a missed click again. AutoTotem automatically consumes a totem of undying from your inventory whenever you take a fatal hit — saving you from death without requiring you to hold it in your offhand.

Features

• ⚡ Auto-consume totems — When a hit would kill you, a totem of undying is automatically consumed and the damage is cancelled
• 🧪 Vanilla totem effects — Restores 1 HP, clears fire and potion effects, and applies Regeneration II, Absorption IV and Fire Resistance I, complete with the original sound and particle effects
• 🎒 Smart search order — Looks for totems in your offhand, then main hand, then the rest of your inventory
• ⚔️ PvP toggle: optionally disable triggering on player-caused lethal damage
• 👤 Per-player settings — Toggle state and cooldown are stored separately for each player
• ⏱ Trigger cooldown — Set a per-player cooldown (in ticks) to prevent repeated triggers
• 🌍 Multi-language — Built-in English (en-US) and Simplified Chinese (zh-CN), auto-selected by the player's client language
• 📖 Localization welcome — New languages can be added by dropping a .lang file into the plugin's lang/ folder; contributions are welcome via pull request

Commands

All commands support tab-completion.

Permissions

Installation

1. Download the AutoTotem-*.jar file
2. Place it into your server's plugins/ folder
3. Restart your server
4. A config file will be generated at plugins/AutoTotem/config.yml on first startup

Configuration

# Whether players have auto totem enabled by default
default-enabled: true
# Default trigger cooldown (in ticks, 20 ticks = 1 second)
default-cooldown-ticks: 0
# Whether to trigger auto totem on lethal damage caused by another player (PvP)
pvp-enabled: true
# Default locale (used when the player's client language is not in the lang/ folder, e.g. en-US, zh-CN)
default-locale: en-US

Requirements

• Server: Paper (or a fork such as Purpur)
• Java: 17+

Support

Found a bug or have a feature request? Feel free to open an issue on GitHub.

License

This project is licensed under the MIT License with Non-Commercial and No Closed-Source Redistribution Clauses — not the standard MIT license. Please read the LICENSE file for the full terms before using, modifying, or redistributing this project.

Disclaimer & Precautions

⚠️ This is a server‑side only plugin, installed and controlled entirely by server administrators. It modifies vanilla Minecraft mechanics by automatically consuming Totems of Undying. Automated item‑consumption logic may create gameplay imbalances and may be considered an unfair advantage, especially on PvP, competitive or tournament servers.

1. This plugin is provided as‑is without any form of warranty. The developer assumes no liability for player disputes, rule‑related issues, sanctions, bans or any other consequences resulting from server administrators installing or configuring this plugin.
2. It is the server administrator's sole responsibility to assess whether this feature aligns with server rules and fair‑play expectations before enabling it. Administrators are responsible for making configuration decisions such as permission restrictions, cooldown values and whether to disable the feature for specific game modes.
3. Automated totem consumption may create imbalance against players who rely on manual totem usage. For competitive or PvP scenarios, administrators should carefully consider whether to enable this functionality.
4. Third‑party anti‑cheat plugins may trigger false positives caused by this plugin's server‑side automatic behaviour. Compatibility testing is strongly recommended before production deployment.
5. This plugin shall only be operated at the server operator's own risk.