RandomLootBox v1.1.1

Small fixes

v1.1.0 - HUGE UPDATE!
Quest Chest System - 5 New Spawning Modes!​

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

MAJOR NEW FEATURE: Quest Chest System

Introducing a completely new reward system! Chests now spawn when players kill mobs, complete streaks, defeat bosses, and more!

5 SPAWNING MODES (All Independently Toggleable):

1. Chance-Based Spawning

• Each mob kill has % chance to spawn personal chest
• Configurable per mob type (Zombie 5%, Ender Dragon 100%)
• Instant rewards for lucky kills
• Perfect for keeping players engaged

2. Kill Counter Spawning

• Track kills per player per mob type
• Spawn chest after reaching kill goal (e.g., 50 Zombies)
• Quest-style progression system
• Display progress: "25/50 zombies killed"

3. Streak Spawning

• Kill X mobs within Y seconds
• Maintain streak without dying
• Bonus rewards for skilled play
• Example: "KILLING SPREE! 10 kills in 60s"

4. Boss Kill Spawning

• Guaranteed chests on boss kills
• Multiple players can get rewards
• Minimum damage requirement
• Ender Dragon, Wither, Warden, Elder Guardian

5. Combo Spawning

• Kill mobs in specific sequence
• Example: Zombie → Skeleton → Creeper
• Timed challenges (complete in 2 minutes)
• Unique combo rewards

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

QUEST CHEST FEATURES

Personal Protection:

• 30-second owner-only protection
• Other players can't steal your rewards
• Configurable protection duration
• After protection: anyone can open OR auto-despawn

Smart Spawning:

• Spawns near player (configurable radius)
• Safety checks (solid ground, no water/lava)
• Async spawning for zero lag
• Max attempts to find safe location

Auto-Despawn:

• Chests despawn after 2 minutes (configurable)
• Warning at 30 seconds remaining
• Prevents world clutter
• Cleanup on logout/server restart

Tier Integration:

• Uses existing loot tier system
• Different modes reward different tiers
• Bosses give legendary, streaks give epic, etc.
• Fully customizable per spawn trigger

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

VISUAL ENHANCEMENTS

• Spawn particles (DRAGON_BREATH)
• Open particles (VILLAGER_HAPPY)
• Despawn particles (SMOKE)
• Protection deny particles (VILLAGER_ANGRY)
• Sound effects for all actions
• All effects configurable/toggleable

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

PERFORMANCE OPTIMIZATIONS

• Every mode independently toggleable (disable to reduce lag)
• Async chest spawning (zero main thread lag)
• Per-player chest limits (max 5 active)
• Per-player spawn cooldowns (prevent spam)
• Automatic cleanup tasks (expired data removal)
• World blacklist (disable in creative/lobby)
• In-memory storage (no database overhead)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

STATISTICS TRACKING

• Total chests spawned/claimed/despawned
• Per-mode statistics
• Highest streak records
• Favorite spawn mode tracking
• Kill count tracking
• Fully toggleable

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

CONFIGURATION

New Config Sections:

Code:

quest-chest-system:
  enabled: true
 
  # 5 independent modes
  chance-based: {...}
  kill-counter: {...}
  streak-spawning: {...}
  boss-spawning: {...}
  combo-spawning: {...}
 
  # Behavior settings
  chest-behavior: {...}
  effects: {...}
  performance: {...}
  statistics: {...}

Fully Modular:

• Enable/disable entire system
• Enable/disable each mode independently
• Enable/disable per mob type
• Enable/disable per boss
• Enable/disable per combo
• Configure every aspect

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

TECHNICAL IMPROVEMENTS

• 5 new manager classes (modular design)
• Enhanced mob kill detection
• Streak tracking system
• Combo sequence validation
• Boss damage tracking
• Protection handler system
• Improved particle/sound integration
• Reload support for all new features

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

NEW MESSAGES

Code:

quest-chest:
  chance-spawn: "&aYou found a chest!"
  kill-progress: "&e%kills%/%required% %mob% killed"
  streak-achieved: "&6&lKILLING SPREE! &eChest spawned!"
  boss-defeated: "&5&lBoss Slain! &eLegendary chest!"
  combo-complete: "&a&lCOMBO! &e%combo% completed!"
  protection-denied: "&cThis chest belongs to %player%!"
  despawn-warning: "&eChest despawns in %time%!"
  claimed: "&aChest claimed! +%rewards%"

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

BUG FIXES

• Fixed particle effects not showing for some players
• Improved chest spawning location algorithm
• Fixed memory leak in hologram manager
• Better null checks for edge cases
• Improved error handling

Added some more features.

Big update on visuals.