TotemTweak

# ✨ New Features - **Granular Drop Prevention Control**: Enhanced the existing drop prevention system with individual configuration for various drop sources: - Entity death drops (evokers, raids, etc.) - Entity drop events - Player death/drop events - Minecart destruction (storage minecarts) - Container destruction (chests, hoppers, dispensers, droppers, barrels) - Block break events - Explosion events - Piston events - **Totem Stacking**: Optional feature to allow totems to be stacked (configurable max stack size, default 16) - **Update Checker**: Automatic update notifications for admins with clickable links to Spigot and Modrinth - **Config Updater**: Automatically adds missing configuration entries without overwriting existing values - **Server Software Detection**: Automatic detection of Paper vs Spigot for stacking compatibility - **Admin Warnings**: Notifies admins about Spigot stacking limitations Configuration - `config.yml`: Enhanced with granular drop prevention settings - Totem stacking configuration - Update checker toggle

**TotemTweak** is a powerful Minecraft plugin that revolutionizes how totems of undying are obtained on your server. Instead of allowing totems to drop from various sources, this plugin makes them exclusive to stronghold chests, creating a more balanced and exploration-focused gameplay experience. ## 🌟 Key Features ### 🚫 **Drop Prevention System** - Completely prevents totem of undying drops from evokers, raids, and other sources - Configurable toggle to allow/disallow normal drops - Maintains game balance while encouraging exploration ### 🏰 **Stronghold Integration** - Adds totems to stronghold chests with configurable spawn rates (0-100%) - Smart detection system identifies stronghold chests automatically - Encourages players to explore and discover strongholds ### ⚙️ **Advanced Configuration** - Fully configurable drop chances via config.yml - Debug mode for detailed logging and troubleshooting - Easy reload system with `/totemtweak reload` ### 🌍 **International Support** - All messages in English for global compatibility - Customizable message system via messages.yml - Perfect for international servers ## 🎯 Perfect For - **Survival Servers** - Make totems more valuable and exclusive - **RPG Servers** - Create progression systems around stronghold exploration - **Hardcore Servers** - Increase difficulty by limiting totem availability - **Adventure Servers** - Encourage exploration and discovery - **Economy Servers** - Make totems more valuable in trading ## 🛠️ Commands & Permissions **Commands:** - `/totemtweak reload` - Reload plugin configuration - `/totemtweak help` - Show help information - `/tt reload` - Short alias for reload **Permissions:** - `totemtweak.admin` - Full access to all commands - `totemtweak.reload` - Permission to reload configuration ## 📋 Configuration ```yaml # Totem drop chance in stronghold chests (0.0 to 1.0) totem-drop-chance: 0.3 # Prevent totem drops from other sources prevent-other-drops: true # Debug mode for detailed logging debug: false # Enable bStats metrics bstats-enabled: true ``` ## 🔧 Technical Details - **Minecraft Version**: 1.21+ - **Java Version**: 21+ - **Server Type**: Spigot, Paper, Bukkit - **Dependencies**: None - **API Version**: 1.21 ## 🚀 Installation 1. Download the JAR file 2. Place it in your `plugins` folder 3. Start/restart your server 4. Configure via `config.yml` 5. Use `/totemtweak reload` to apply changes ## 💡 Use Cases ### **Survival Server Example:** Set `totem-drop-chance: 0.5` and `prevent-other-drops: true` to make totems rare but obtainable through exploration. ### **Hardcore Server Example:** Set `totem-drop-chance: 0.1` to make totems extremely rare and valuable. ### **Adventure Server Example:** Set `totem-drop-chance: 0.8` to reward players for finding strongholds. ## 🔍 How It Works 1. **Detection**: Plugin detects when players open chests in strongholds 2. **Chance Calculation**: Uses configured probability to determine if totem should be added 3. **Smart Placement**: Only adds totems if chest doesn't already contain one 4. **Drop Prevention**: Removes totems from entity death drops and other sources ## 📈 Benefits - **Balanced Gameplay**: Makes totems more valuable and exclusive - **Encourages Exploration**: Players must find strongholds to get totems - **Server Economy**: Totems become more valuable in trading systems - **Customizable**: Fully configurable to match your server's needs - **Performance**: Lightweight with minimal impact on server performance ## 🆘 Support - **Documentation**: Complete [ReadME](https://github.com/BischoffTV/TotemTweak/blob/main/README.md) included - **Configuration**: Detailed config.yml with comments - **Debug Mode**: Built-in debugging for troubleshooting - **Discord**: [Discord](https://discord.com/qKzzMNgNMH) --- **Download now and transform how totems work on your server!** 🎮