ValoCraft - Update Notes

Version 1.6.3 - Matchmaking System, Critical Bug Fixes & New Admin Features

Date : August 21, 2026

Status : READY TO BUILD

---

1. New Matchmaking System

• Complete matchmaking system: New MatchmakingManager with team selection
• Command /matchmaking [attack/defend]: Join matchmaking with preferred team
• Real-time player count: Display "X players on Y" with black screen effect
• Automatic team balancing: Teams assigned based on preferences and map capacity
• Agent selection with LOCK: Mandatory agent selection before game start
• LOCK system: Double-click on same agent to LOCK selection
• Team visibility: See teammates' agent selections in real-time
• Auto-start: Game starts automatically when all agents are LOCKED
• Command /matchmaking leave: Leave matchmaking queue

2. Agent Selection Improvements

• Forced agent selection: Players MUST select an agent in matchmaking
• LOCK confirmation: Visual feedback when agent is locked
• Prevent changes: Cannot change agent after LOCK
• Auto-reopen menu: Menu reopens if no agent selected
• Team communication: Selections shared with teammates

3. Weapon System Fixes

• Fixed weapons not firing: Added debug logging and validation
• Dead player check: Players cannot fire while dead
• Weapon validation: Improved weapon detection with NBT tags
• Logging enhancement: Better error tracking for weapon issues
• Valorant-accurate fire rates & ammo: Vandal 576 RPM / 25 mag, Phantom 660 RPM / 30 mag, Sheriff 240 RPM / 6 mag, etc.
• All 17 weapons have resource-pack visuals in VCAssets

4. Shop Visual Fixes

• Fixed weapon visuals: Using VCAssets for resource pack models
• Correct materials: Weapons display proper models in shop
• Custom model data: Proper resource pack integration

5. Multi-Dimension Support

• Dynamic world loading: Maps can be in different dimensions
• Chunk loading: Automatic chunk loading before teleportation
• World validation: Null-safe world handling
• VC-WORLDARENA support: Compatible with external world plugins

6. Ability Protection System

• Anti-spam rate limiting: 250ms minimum between same ability uses
• Buy phase disable: Abilities disabled during BUY_PHASE
• Death disable: Abilities disabled when player is dead
• Agent change protection: Cannot change agent during active match
• Ultimate cooldowns verified: All 19 agents have proper 110-120s cooldowns

7. Critical Bug Fixes (This Session)

• AntiCheat thread safety: Capture Bukkit API data (Location, velocity, potion effects) on main thread before async processing
• ViolationManager async bug: Changed runTaskTimerAsynchronously → synchronous for ConcurrentHashMap.removeIf to prevent CME
• DamageSystem hit detection: Uses Paper's getHitLocation() via reflection with eye-height fallback
• Memory leaks fixed: PlayerQuitEvent cleanup added to WeaponPlayerListener.nextShotAt and UnifiedShopListener.lastPurchaseTime
• AFKDetector timing clarified: Renamed WARN_TICKS/KICK_TICKS → WARN_MS/KICK_MS (30s/60s), removed misleading * 50L multiplier

8. New Admin Features

• /vc reload [drop]: Reloads config.yml & maps.yml; drop flag drops all player items on ground and clears inventory/armor
• /vc wall <arena> <add|remove|list|test|confirm>: Buy phase wall system
  • add: Gives diamond axe, left-click=point1, right-click=point2
  • confirm: Saves wall to arena config
  • remove <index>: Removes wall by index
  • list: Lists all walls with coordinates
  • test: Shows walls for 10 seconds (auto-hides)
• Auto wall management: Walls auto-show during BUY_PHASE, hide at round start via BuyPhaseWallManager
• Added getMapSystem() getter to ValoCraft for reload command

9. Technical Details

• New classes: MatchmakingManager, MatchmakingCommand
• Updated listeners: AgentSelectorListener enhanced for matchmaking
• Map system: Improved multi-dimension support
• Plugin.yml: Added matchmaking command
• Version bump: 1.6.2 → 1.6.3