📋 Changelog - TotemBoost v1.0.0

🎉 Initial Release

✨ Core Features

🎯 Totem System

• Item-Based Placement - Place totems by right-clicking beacon items in-world
• Area Boost Zones - Grant buffs to all players within configurable radius (1-50 blocks)
• 10 Boost Types Available:
  • 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)
• Flexible Duration System - Set temporary (seconds/minutes/hours/days) or permanent totems
• Per-Player Totem Limits - Configurable maximum totems per player
• Ownership Protection - Totems are protected from breaking by other players

🖥️ GUI System

• Main Menu - Centralized hub for all totem management
• Template Creator - Interactive GUI for designing custom totem templates
  • Click-based boost configuration
  • Visual radius adjustment (+/-1, +/-5)
  • Duration controls (hourly increments + permanent toggle)
  • Name & description editor with conversation prompts
• Template Library - Browse and use saved templates
  • Paginated list view (28 items per page)
  • Left-click to get 1 item
  • Shift+Left-click to get 64 items
  • Right-click to delete templates
  • Detailed template information display
• Give Totem Menu - Admin tool for distributing totems
  • Template selector
  • Player selector
  • Amount selector (1, 5, 10, 16, 32, 64)
  • Full inventory handling

🎨 Visual Effects

• Hologram Display - Floating text above each totem showing:
  • Owner name
  • Radius coverage
  • Remaining duration (with countdown)
  • Active boosts (configurable max lines)
  • Status indicators (Active/Expired/Permanent)
• Radius Visualization - Particle-based area display
  • Multi-layer colored circles (Green → Yellow → Orange)
  • Cardinal point pillars (N, S, E, W)
  • Configurable particle density (30-60 particles)
  • Auto-show on placement (5 seconds)
  • Manual toggle via /totem radius command
• Placement Effects - Stunning particle animations when placing totems
  • Totem of Undying particles
  • End Rod effects
  • Circular particle burst
• Ambient Particles - Continuous particles around active totems
  • Configurable particle type (Happy Villager, Heart, Flame, etc.)
  • Adjustable spawn interval

⚡ Performance Optimization

• Async Processing - Offloads boost calculations to separate threads
  • Reduces main thread load by up to 70%
  • Seamless sync for effect application
• Chunk-Based Checking - Only processes totems in loaded chunks
  • 50-80% reduction in unnecessary distance checks
  • Automatic chunk tracking and cleanup
• Smart Caching System:
  • EXP multiplier caching (5-second default expiry)
  • Boost timing cache to prevent rapid reapplication
  • Player-totem relationship tracking
  • Automatic cleanup for offline players
• Performance Monitoring:
  • Real-time timing metrics
  • Automatic performance reports (5-minute intervals)
  • Detailed operation statistics
  • /totem performance command for instant reports

📝 Template System

• Save & Reuse - Create templates for frequently used configurations
• Default Templates - 3 pre-configured templates:
  • Basic: 1.5x EXP, Speed I (10 blocks, 1 hour)
  • Advanced: 2.0x EXP, Speed II, Strength I, Regen I (20 blocks, 2 hours)
  • Ultimate: 3.0x EXP, Speed III, Strength II, Regen II, Haste II, Resistance I (30 blocks, permanent)
• Template Management:
  • Unique ID generation
  • Creator tracking
  • Description support
  • Full serialization/deserialization

🔧 Commands

/totem gui                    - Open main GUI menu
/totem create                 - Create custom totem item
/totem give                   - Give totem to player
/totem list                   - List all placed totems
/totem info                   - View totem details
/totem radius                 - Toggle radius visualization
/totem remove                 - Remove totem
/totem performance            - View performance stats
/totem cleanup [force]        - Clean orphaned holograms
/totem reload                 - Reload configuration

🔐 Permissions

totemboost.*                  # All permissions
totemboost.use                # Basic usage
totemboost.gui                # Access GUI
totemboost.create             # Create totem items
totemboost.give               # Give totems to players
totemboost.remove             # Remove own totems
totemboost.remove.others      # Remove any totem
totemboost.list               # List own totems
totemboost.list.all           # List all totems
totemboost.info               # View totem info
totemboost.radius             # Show radius visualization
totemboost.performance        # View performance stats
totemboost.break              # Break own totems
totemboost.break.others       # Break any totem
totemboost.place              # Place beacons manually
totemboost.reload             # Reload config
totemboost.template.delete    # Delete own templates
totemboost.template.delete.others # Delete any template

⚙️ Configuration

• Extensive customization - 100+ configuration options
• Performance tuning - All optimization features toggleable
• Visual customization - Particle types, colors, density
• Hologram settings - Update intervals, max lines, height
• Duration controls - Check intervals, notifications
• Debug options - Comprehensive logging for troubleshooting
• Boost presets - Pre-configured totem templates in config

🛠️ Technical Details

Requirements

• Server: Paper 1.21.3+ (Spigot not supported)
• Java: Java 21+
• API Version: 1.21

Data Storage

• YAML-based persistence for totems and templates
• Automatic saving on totem creation/removal
• Auto-cleanup of expired totems on load
• Migration-ready structure for future updates

📦 Installation

1. Download TotemBoost-1.0.0.jar
2. Place in server's plugins folder
3. Restart server
4. Configure in plugins/TotemBoost/config.yml
5. Reload with /totem reload or restart

📚 Documentation

• Full configuration guide included in config.yml
• Command usage available via /totem help
• Performance tips and troubleshooting in config comments