TotemDisabler

** 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

---

Use Cases

1. Hardcore Survival Servers
   Make death meaningful again. Without totems, players must be more careful and strategic in dangerous situations.

2. PvP Servers
   Level the playing field in combat. No more totem-popping advantages during fights. Skill determines the winner.

3. Economy Servers
   Prevent totem hoarding and trading that could unbalance your server economy.

4. Challenge Servers
   Create unique challenges where players cannot rely on totems as a safety net.

5. Roleplay Servers
   Maintain immersion by removing "magical resurrection" items from your world's lore.

6. Anarchy Servers (Modified)
   Add extra risk to gameplay even on servers with minimal rules.

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

---

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

---

Performance

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

1. Download TotemDisabler-1.0.0.jar
2. Place in your server's plugins/ folder
3. Restart the server
4. (Optional) Edit plugins/TotemDisabler/config.yml
5. Restart again if you made changes

---

Technical Specifications

---

Testing Checklist

---

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! **