Nucleus

🐛 Critical Bug Fixes

• Duel Match Not Ending - Fixed matches not finalizing after a player dies
  • Root cause: processDeathResult() had early return when isEnded() was true
  • But declareWinner() sets both ended=true AND state=ENDING
  • This caused scheduleMatchEnd() to never be called
  • Players were stuck in arena/spectator with no way to leave
• Hotbar Not Restoring After Duel - Fixed lobby hotbar not given after match ends
  • Queue system clears inventory before match, so "original inventory" was just barrier
  • Now always gives lobby hotbar after match ends (consistent behavior)
• Spectate Cross-World Teleport - Fixed spectating not working when lobby and arena are different worlds
  • Setting spectator mode BEFORE cross-world teleport causes failure
  • Now teleports in survival mode first, then sets spectator mode after teleport completes
  • Uses async teleport with proper callback for game mode change
• Spectate Leave Cross-World - Fixed leaving spectate not working across worlds
  • Now sets survival mode before teleporting back to lobby
  • Hotbar given after teleport completes
• Crystal/Anchor Kills Not Counting - Fixed indirect kills (end crystals, respawn anchors) not crediting the attacker
  • Added lastAttacker tracking to FfaSession with 10-second expiry
  • When player dies without direct killer, checks for recent attacker
  • Attacker is tracked on any damage dealt to the victim
• Menu Size < 54 Error - Fixed stats/spectate menus not opening when size configured below 54
  • Added safeSetItem() helper to prevent ArrayIndexOutOfBoundsException
  • Back button slot now auto-adjusts to fit within menu size
  • FFA/Duel Player Desync - Fixed critical desync where players appear frozen to others after death
  • Root cause: State changes during damage/respawn events caused client-server desync
  • Now uses player scheduler with proper delays for all state changes
  • Removed duplicate death handling between CombatListener and FFA/Match listeners
• FFA Respawn Item Usage - Fixed players unable to use items (pearls, etc.) after respawning
  • Removed setInvulnerable(true) from protection (blocks ender pearl teleportation)
  • Now uses Resistance 255 potion effect only for damage immunity
  • Kit applied immediately without extra delay
• Duel Death Handling - Fixed players getting stuck after dying in duels
  • Death state changes now deferred to next tick using player scheduler
  • Added proper cleanup (health, food, fire, potion effects)
  • Participant restore uses delayed scheduling to prevent conflicts
• Spectate Mode Not Activating - Fixed spectators staying in survival mode
  • Removed invalid item giving (spectators can't hold items)
  • Added proper setSpectatorTarget() to follow players
  • Added /spectate leave instruction message

✨ New Features

• Spectator Placeholders (PAPI) - New placeholders for spectators:
  • <spectating> - Yes/No if currently spectating
  • <match_time> - Match duration in mm:ss format
  • <round> / <total_rounds> - Current round info
  • <player1> / <player2> - Participant names
  • <player1_health> / <player2_health> - Health values
  • <player1_hits> / <player2_hits> - Hit counts