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

- Smart Hologram Display - Place beacons by right-clicking special totem items - Smart Hologram Display - Grant multiple potion effects and EXP multipliers to nearby players - Smart Hologram Display - Configure coverage from 1 to 50+ blocks - Smart Hologram Display - Set temporary (minutes/hours/days) or permanent totems - Smart Hologram Display - Shows owner, radius, duration, and active boosts above each totem

🎨 User-Friendly GUI

- Give System - Browse and use pre-made totem configurations - Give System - Design custom totems with interactive GUI - Give System - Easy boost configuration with click controls - Give System - Admin tool to distribute totems to players

🔧 Boost Types

- Luck (1.5x, 2x, 3x, etc.) - Luck (I-X) - Luck (I-X) - Luck (I-X) - Luck (I-X) - Luck (I-X) - Luck (I-X) - Luck (I-X) - Luck (I-X) - Luck (I-X)

🎆 Visual Effects

- Auto-Display - Colored particle circles showing coverage area - Auto-Display - Stunning particle animations when placing totems - Auto-Display - Golden markers at North/South/East/West edges - Auto-Display - Automatically shows radius for 5 seconds on placement

⚡ Performance Optimized

- Configurable - Offloads calculations to separate threads - Configurable - Only checks totems in loaded chunks - Configurable - Reduces redundant calculations by 50-80% - Configurable - Built-in profiling and reporting system - Configurable - Tweak all optimization settings via config

📦 Requirements

- Permissions Plugin: Paper 1.21.3 or newer (Spigot not supported) - Permissions Plugin: 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 [force]` | 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

- VIP Areas - Permanent EXP/Speed boost zones - VIP Areas - Haste + Night Vision for miners - VIP Areas - Strength + Resistance combat zones - VIP Areas - EXP multiplier for grinding areas - VIP Areas - Temporary boost zones for special occasions - VIP Areas - Premium perks for donators

📊 Performance Benchmarks

Tested on Paper 1.21.3 with 100 active totems: - Memory Usage: ~50μs per tick - Memory Usage: ~15μs per player - Memory Usage: 70% fewer checks vs traditional - Memory Usage: <5MB for cache system

📸 Screenshots

GUI

TEMPLATE TOTEM

PLACE TOTEM

And Many More..

---

Made with ❤️ for the Minecraft community