TotemBoost

# ⚡ TotemBoost - Advanced Area Boost Plugin ## 📋 Overview **TotemBoost** is a powerful and feature-rich area boost plugin for Paper 1.21+ that allows players to place customizable totem beacons that grant various buffs to players within their radius. Create reusable templates, visualize coverage areas, and optimize server performance with built-in async processing! ## ✨ Key Features ### 🎯 Core System - **Item-Based Totems** - Place beacons by right-clicking special totem items - **Area Buffs** - Grant multiple potion effects and EXP multipliers to nearby players - **Customizable Radius** - Configure coverage from 1 to 50+ blocks - **Duration System** - Set temporary (minutes/hours/days) or permanent totems - **Smart Hologram Display** - Shows owner, radius, duration, and active boosts above each totem ### 🎨 User-Friendly GUI - **Template Library** - Browse and use pre-made totem configurations - **Template Creator** - Design custom totems with interactive GUI - **Drag & Drop** - Easy boost configuration with click controls - **Give System** - Admin tool to distribute totems to players ### 🔧 Boost Types - **EXP Multiplier** (1.5x, 2x, 3x, etc.) - **Speed** (I-X) - **Strength** (I-X) - **Regeneration** (I-X) - **Haste** (I-X) - **Resistance** (I-X) - **Jump Boost** (I-X) - **Night Vision** (I-X) - **Absorption** (I-X) - **Luck** (I-X) ### 🎆 Visual Effects - **Radius Visualization** - Colored particle circles showing coverage area - **Placement Effects** - Stunning particle animations when placing totems - **Cardinal Pillars** - Golden markers at North/South/East/West edges - **Auto-Display** - Automatically shows radius for 5 seconds on placement ### ⚡ Performance Optimized - **Async Processing** - Offloads calculations to separate threads - **Chunk-Based Checking** - Only checks totems in loaded chunks - **Smart Caching** - Reduces redundant calculations by 50-80% - **Performance Monitoring** - Built-in profiling and reporting system - **Configurable** - Tweak all optimization settings via config ## 📦 Requirements - **Server Software**: Paper 1.21.3 or newer (Spigot not supported) - **Java Version**: Java 21+ - **Permissions Plugin**: Optional (has built-in permission support) ## 🎮 Commands | Command | Description | Permission | |---------|-------------|------------| | `/totem gui` | Open main GUI menu | `totemboost.gui` | | `/totem create <radius> <duration> <boost:value>` | Create totem item | `totemboost.create` | | `/totem give <player> <radius> <duration> <boost:value>` | Give totem to player | `totemboost.give` | | `/totem list` | List your totems | `totemboost.list` | | `/totem info` | View totem details | `totemboost.info` | | `/totem radius` | Show totem radius visualization | `totemboost.radius` | | `/totem remove` | Remove totem you're looking at | `totemboost.remove` | | `/totem performance` | View performance statistics | `totemboost.performance` | | `/totem cleanup ` | Clean orphaned holograms | `totemboost.admin` | | `/totem reload` | Reload configuration | `totemboost.reload` | **Duration Format**: `1s` (seconds), `30m` (minutes), `1h` (hours), `1d` (days), `permanent` **Example**: ``` /totem create 15 2h exp_multiplier:2.0 speed:2 strength:1 ``` ## 🔐 Permissions ```yaml totemboost.* # All permissions (default: op) totemboost.use # Basic command access (default: true) totemboost.gui # Access GUI menu (default: true) totemboost.create # Create totem items (default: op) totemboost.give # Give totems to others (default: op) totemboost.remove # Remove own totems (default: op) totemboost.remove.others # Remove other players' totems (default: op) totemboost.list # List own totems (default: true) totemboost.list.all # List all totems (default: op) totemboost.radius # Show radius visualization (default: true) totemboost.performance # View performance stats (default: op) ``` ## ⚙️ Configuration Highlights ```yaml # Performance (recommended for 50+ players) performance: async-processing: true # Async calculations chunk-based-checking: true # Chunk optimization cache-expiry-time: 5000 # 5 second cache # Hologram Display hologram: enabled: true update-interval: 20 # 1 second updates max-boost-lines: 5 # Lines shown # Radius Visualization radius-visualizer: enabled: true particles-per-circle: 60 # Smooth circles vertical-layers: 3 # Multi-level display show-on-placement: true ``` ## 🎯 Use Cases - **Spawn Towns** - Permanent EXP/Speed boost zones - **Mining Outposts** - Haste + Night Vision for miners - **PvP Arenas** - Strength + Resistance combat zones - **Farms** - EXP multiplier for grinding areas - **Events** - Temporary boost zones for special occasions - **VIP Areas** - Premium perks for donators ## 📊 Performance Benchmarks Tested on Paper 1.21.3 with 100 active totems: - **Avg Boost Ta