Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details
** TotemDisabler Plugin
๐ Overview
TotemDisabler is a lightweight, high-performance Minecraft Paper/Spigot plugin that completely removes Totems of Undying from your server. It ensures totems cannot be obtained, used, or possessed by any player, making death a permanent consequence and adding a hardcore survival element to your gameplay.
๐ Description
Totems of Undying are powerful items in Minecraft that prevent player death. While they add excitement to vanilla gameplay, many server owners want to:
- Create a more challenging survival experience
- Prevent unfair advantages in PvP combat
- Implement hardcore-style gameplay without using hardcore mode
- Balance economy servers where totems break progression
TotemDisabler solves this by completely eliminating totems from every possible source. The plugin uses a purely event-driven architecture with zero scheduled tasks, ensuring minimal server impact.
โจ Features
| Feature | Description |
|---|---|
| ๐ซ Evoker Drop Prevention | Evokers no longer drop Totems of Undying when killed |
| ๐ World Spawn Blocking | Totems cannot spawn as items anywhere in the world |
| ๐ Join Inventory Scan | Removes totems from players when they log in |
| โ๏ธ Simple Configuration | Single toggle in config.yml to enable/disable |
| ๐ง In-Game Toggle Command | Admins can toggle settings without editing files |
| ๐ Permission-Based Access | Secure admin-only command access |
| โก Zero Lag Design | Pure event-driven, no schedulers or loops |
| ๐ฆ Lightweight | Minimal resource usage and small file size |
๐ฎ Use Cases
-
Hardcore Survival Servers Make death meaningful again. Without totems, players must be more careful and strategic in dangerous situations.
-
PvP Servers Level the playing field in combat. No more totem-popping advantages during fights. Skill determines the winner.
-
Economy Servers Prevent totem hoarding and trading that could unbalance your server economy.
-
Challenge Servers Create unique challenges where players cannot rely on totems as a safety net.
-
Roleplay Servers Maintain immersion by removing "magical resurrection" items from your world's lore.
-
Anarchy Servers (Modified) Add extra risk to gameplay even on servers with minimal rules.
-
Event Servers Run special events or competitions where death is final.
๐ก๏ธ How It Works
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ TOTEM BLOCKING SYSTEM โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ โ
โ โโโโโโโโโโโโโโโ EntityDeathEvent โโโโโโโโโโโโโโโโ โ
โ โ Evoker โ โโโโโโโโโโโโโโโโโโโโโโโถโ Drop Removed โ โ
โ โ Dies โ โ from List โ โ
โ โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโ โ
โ โ
โ โโโโโโโโโโโโโโโ ItemSpawnEvent โโโโโโโโโโโโโโโโ โ
โ โ Totem Item โ โโโโโโโโโโโโโโโโโโโโโโโถโ Event โ โ
โ โ Spawns โ โ Cancelled โ โ
โ โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโ โ
โ โ
โ โโโโโโโโโโโโโโโ PlayerJoinEvent โโโโโโโโโโโโโโโโ โ
โ โ Player โ โโโโโโโโโโโโโโโโโโโโโโโถโ Totems โ โ
โ โ Joins โ โ Removed โ โ
โ โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโ โ
โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
๐ Commands
| Command | Description | Permission |
|---|---|---|
/totemtoggle |
Toggles totem disabling on/off | totemdisabler.admin |
Command Output Example:
================================
TotemDisabler config updated!
totems-disabled: true โ false
Totems will be ENABLED after restart (vanilla behavior).
โ Changes will take effect after the server restarts.
================================
๐ Permissions
| Permission | Description | Default |
|---|---|---|
totemdisabler.admin |
Access to /totemtoggle command |
OP |
โ๏ธ Configuration
config.yml
TotemDisabler Config
When set to true, Totems of Undying are completely disabled.
- Evokers will not drop totems
- Totems cannot spawn as items in the world
- Totems are removed from player inventories on join
When set to false, vanilla behavior is restored.
NOTE: Changes require a server restart to take effect.
totems-disabled: true
| Option | Type | Default | Description |
|---|---|---|---|
totems-disabled |
Boolean | true |
Enable/disable totem blocking |
๐ Performance
| Metric | Value |
|---|---|
| Scheduled Tasks | 0 |
| Tick Listeners | 0 |
| Event Listeners | 3 (only when enabled) |
| Memory Footprint | Minimal |
| CPU Usage | Negligible |
Optimization Techniques Used:
- โ Early return checks for non-relevant entities
- โ Event priority set to HIGHEST for reliability
- โ ignoreCancelled flag to respect other plugins
- โ Conditional listener registration (disabled = no listeners)
- โ No persistent data storage required
- โ No database connections
๐ฆ Installation
- Download
TotemDisabler-1.0.0.jar - Place in your server's
plugins/folder - Restart the server
- (Optional) Edit
plugins/TotemDisabler/config.yml - Restart again if you made changes
๐ง Technical Specifications
| Specification | Value |
|---|---|
| Plugin Name | TotemDisabler |
| Version | 1.0.0 |
| API Version | 1.21 |
| Java Version | 21+ |
| Server Software | Paper / Spigot |
| Minecraft Versions | 1.21.1 - 1.21.x |
| Dependencies | None |
| Soft Dependencies | None |
๐งช Testing Checklist
| Test | Expected Result |
|---|---|
| Kill an Evoker | No totem drops |
/give @p totem_of_undying then relog |
Totem removed from inventory |
| Drop totem on ground | Item disappears instantly |
| Hold totem in off-hand and relog | Totem removed |
Use /totemtoggle |
Config flips, message shown |
Set totems-disabled: false and restart |
Vanilla behavior restored |
โ FAQ
Q: Will this affect existing totems in chests? A: No. The plugin only removes totems from player inventories on join and prevents new totems from spawning. Totems in chests remain until a player picks them up and relogs.
Q: Can players still use /give for totems?
A: Yes, but the totem will be removed when they relog. For complete prevention, use permission plugins to block the give command for totems.
Q: Does this work with Folia? A: This plugin is designed for Paper/Spigot. Folia compatibility is not guaranteed.
Q: Why require a restart for toggle changes? A: Listeners are registered once at startup. Dynamic registration/unregistration could cause issues with other plugins and event handling.
Q: Does this affect Totem sound/particles? A: No. Since totems are completely removed, the totem resurrection effect never triggers.
๐ Changelog
Version 1.0.0
- Initial release
- Evoker drop prevention
- Item spawn blocking
- Player join inventory scan
- Toggle command
- Configuration support
Built For: Minecraft Paper/Spigot 1.21.x
Enjoy a totem-free Minecraft experience! ๐ฎโ๏ธ**