⚡ 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 [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

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

# 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 Task: ~50μs per tick
• EXP Calculation: ~15μs per player
• Chunk-Based Mode: 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