Sunveil SMP plus v2.5

# SUNVEIL SMP PLUS – STABILITY & CINEMATICS [v2.5]

We are back with a major stability and feature update! After deep internal refactoring, we’ve hardened our systems against exploits and introduced a brand-new cinematic experience for our creators and spectators.

---

### NEW: CINEMATIC SPECTATOR SUITE (CAM ACCOUNT)
Experience minigames like never before with our advanced spectator engine:

• Smooth-Camera Interpolation: Spectators now enjoy buttery-smooth camera movements (Lerp) and target-cycling, perfect for capturing epic moments.
• Stream Integration: Fully compatible with OBS overlays and interactive stream commands, allowing creators to let their community influence the cinematic focus.
• CAM Bot: A dedicated bot logic that can now follow players automatically with professional camera angles.

### REFACTORED MINIGAME FRAMEWORK
The engine room has been completely rebuilt to ensure a flawless experience:

• Standardized Architecture: All minigames now share a robust base class, eliminating "Symbol Not Found" build errors and improving overall server performance.
• Optimized Boundary Checks: Our map protection now uses a high-performance Zone Check system, preventing lag even with hundreds of players near the 35k block limit.
• Unified Setup Process: Admins can now configure TTT, KOTH, and BlockHunt through a single, streamlined command system and the improved Setup Stick.

### HARDENED SECURITY & ANTI-EXPLOIT
We’ve closed several critical loops to ensure fair play:

• Equipment Protection: Fixed the recurring helmet-swapping exploit. Inventory slots are now forcefully managed upon game termination.
• Transaction Verification: Implemented a new verification layer for mission rewards and token transfers to eliminate "phantom" losses or gains.
• Grief-Proof Spectators: Hardened interaction logic ensures spectators can no longer loot chests or interfere with active matches.
• Immediate DB Sync: Token balances and mission progress now synchronize with the database instantly, preventing data loss during unexpected restarts.

### STABILITY & PERFORMANCE PATCHES

• SmoothCam Crash Fix: Resolved illegal state errors and null pointer exceptions during cinematic transitions.
• Mission Accuracy: Upgraded mission tracking to EventPriority.MONITOR for 100% reliable data capture.
• Startup Optimization: Refined the plugin initialization sequence to prevent rare race conditions during server boot.

---

### PLUGINS UPDATED
* SunveilSMPplus (v2.4-COMMUNITY-EVOLUTION → v2.5-STABILITY-CINEMATICS)

# SUNVEIL SMP PLUS – COMMUNITY EVOLUTION [v2.4]

We have completely overhauled the server based on your feedback! This massive update introduces a unified minigame engine, deep economy and progression features, and major combat balancing.

---

### UNIFIED MINIGAME ENGINE & NEW MODES
We have completely rebuilt the way minigames operate under the hood:

• New Game Modes: Say hello to King of the Hill (KOTH), Trouble in Terrorist Town (TTT) (with full Karma & Traitor Shop mechanics), and BlockHunt (Hide & Seek with block disguises)!
• Map Restoration: Explosions and map damage (like C4) are now automatically and asynchronously repaired after every match without causing server lag.
• Admin Setup Wizard: Administrators can easily set up arenas using the interactive Setup Stick (Blaze Rod).
• Smart Rewards: Minigame winners receive Vault coins, fireworks, and a rare 10% chance to temporarily summon an exclusive Mini-Dragon Pet.

### PVP & COMBAT REBALANCE
Combat on Sunveil just became much more rewarding (and punishing):

• Elytra Combat Lock: Elytras work normally with PvP enabled, but the moment you deal or take damage, you are combat-tagged for 20 seconds. Gliding is instantly disabled, and firework rockets are blocked until the tag expires.
• Killstreaks & Bounties: Rack up kills to earn streak rewards (e.g., Netherite at 10 kills). Killing players on high streaks grants massive bounties. An anti-farm limit ensures you can only gain streak points from the same player 3 times a day.
• Global PvP Override: PvP is now strictly enforced during active minigames, ignoring any newbie protection or /pvp off toggles.

### MISSIONS, ECONOMY & REWARDS
New ways to earn and spend your wealth:

• Crate Roulette System: Use your keys to spin the new Roulette Crates at spawn, featuring tiered rewards and a smooth, fully functional spinning animation.
• Missions & Streaks: Complete dynamically generated tasks (mining, killing, crafting) for tokens and crate keys. Play for at least 1 hour a day to build a streak and earn buffs or keys.
• Infinite Villager Trades: Villagers no longer lock their trades or require cooldowns to restock.
• Advanced Minecarts: Introduced Light (LT) and Heavy (HT) carts with custom speed and durability modifiers to make villager and player transport reliable again.

### UNDER THE HOOD (STABILITY)

• Startup Stability: Fixed critical initialization errors where the plugin would disable itself, ensuring perfect server startup.
• Safe Spawning: Rigid ground checks ensure players will never spawn in the air, in the void, or inside unsafe blocks.
• Ghost Item Fix: Eradicated ghost holograms. Minigame-specific items (like DNA scanners or Disguise Blocks) are now forcefully purged when a player leaves the match, preventing them from entering the survival world.

---

### PLUGINS UPDATED
* SunveilSMPplus (v2.3-HG-REFORGED → v2.4-COMMUNITY-EVOLUTION)

The Hunger Games engine just received a massive overhaul! We've completely rewritten the spawning, teleportation, and map-scanning mechanics to deliver a flawless Battle Royale experience.

---

### SMART ARENA BOUNDARIES & SPAWNING
The arena mechanics now strictly respect your physical map borders:

• True Center Calculation: The arena center is now flawlessly calculated using the exact middle of your arenaPos1 and arenaPos2 bounding box. It no longer inaccurately derives the center from player spawn locations.
• Safe Fallback Spawns: If no spawn points are set, the system now dynamically distributes players in a perfect circle around the true arena center.
• Out-of-Bounds Fix: Players will never be teleported outside the map into walls or the void again. This also completely fixes the false-positive [ANTI-GODMODE] alerts caused by players suffocating inside blocks.

### DEATHMATCH REWRITE
Deathmatch just got significantly fairer:

• Individual Spawns: Teleporting to the Deathmatch no longer clumps every remaining player onto a single center block.
• Cornucopia Logic: Players are now dynamically distributed back to their individual, designated starting spawn points (/hg addspawn) to ensure a fair and spaced-out final battle.

### DYNAMIC MAP LOOT GENERATION
Empty map chests are a thing of the past!

• Full Arena Scanning: The ChestManager now uses advanced Long-based chunk deduplication to scan the entire physical bounding box between arenaPos1 and arenaPos2.
• Auto-Fill Native Chests: Any empty chests that were naturally placed on the map (not spawned by the script) are now instantly detected and populated with randomized, tier-appropriate loot via the LootGenerator the moment the game starts.

### UNDER THE HOOD (STABILITY)

• TeleportUtils Crash Resolved: Fixed a critical internal compilation mapping issue where TeleportUtils could not be resolved during a PlayerRespawnEvent, permanently resolving game engine crashes when a player respawns.
• Task Management: Cleaned up the game-loop state machine. graceTask and lobbyTask timers are now properly cancelled across state skips (/hg skipstage), preventing overlapping events like Rogue Poison Zones.

---

### PLUGINS UPDATED
* SunveilSMPplus (v2.2-CONTENT → v2.3-HG-REFORGED)

SUNVEIL SMP PLUS – LOYALTY & TUTORIAL UPDATE [v2.2]​

This is a huge content update! We've added two brand-new NPC systems, tightened combat mechanics, and rewritten every item limiter from scratch. Sunveil SMP just got way more immersive. ---

LOYALTY TRADER — Wandering Merchant NPC​

The Loyalty Shop just got a massive upgrade. No more boring inventory GUIs — you're now trading with a real NPC villager:

• /loyalty summons the Wandering Merchant who physically spawns nearby and walks toward you.
• Right-click him to open a Minecraft Merchant trade GUI with custom trades for Claim Blocks, VIP, and Notch Apples.
• Uses physical Daily Hour Tokens from your inventory — withdraw from /bank first!
• If you don't trade within 2 minutes, the Merchant walks away with smoke effects and despawns.
• Only one Merchant can be active server-wide — no spam, no exploits.
• The GUI now auto-closes when the Merchant leaves, and rewards are processed instantly.

TUTORIAL VILLAGER — Meet "Sage"​

Brand-new onboarding system for new players:

• After 15–30 minutes of playtime (randomized), Sage spawns nearby and walks up to you.
• He sends a private chat message: "Hey there, traveler! Need some help getting started?"
• Click the message or type /tutorial to open an interactive guide with 10 topics: Getting Started · Discord Linking · Bounties · Auction House · Homes & Spawn · PvP · Clans · Quests · Loyalty & Bank · Teleportation
• Each topic has clickable buttons, detailed commands, and a "← Back to Topics" navigation.
• Sage has villager sounds, happy particles, and despawns on his own if ignored.
• /tutorial works anytime as a standalone command — even without Sage being present!

HOME SYSTEM UPDATE​

• Default home limit adjusted to 5 homes for non-VIP players (VIP still unlimited).

PVP SYSTEM HARDENING​

The PvP Manager got a full security rewrite to close every known exploit:

• Combat-Log Protection: Elytra combat tags are now persisted to the database — logging out and back in no longer resets your tag!
• Newbie Shield: Fresh players get automatic PvP protection on first join.
• Consolidated Combat Logic: TNT, End Crystals, and Mace restrictions are now unified under a single, bulletproof handler.
• Dual Cooldown System: Separate cooldowns for PvP toggling and disable-after-combat, eliminating timing exploits.

ITEM LIMITER REWRITES​

Every item limiter has been rebuilt from scratch for stability and performance:

• Mace Manager: Global scarcity system now uses atomic counters (thread-safe). Ender Chest protection covers all edge cases — shift-click, hotbar-swap, and drag are all blocked.
• Elytra Limiter: Complete rewrite with per-player carry limits, container locking, and Ender Chest blocking. All edge cases patched.
• Spear Limiter: New message cooldown system prevents chat spam. Ground tridents are deleted on pickup instead of just cancelled.
• Minecart Remover: Now respects the enable-minecarts config flag — can be toggled without touching code.

UNDER THE HOOD​

• LoyaltyDatabase: New tutorial_shown column with automatic schema migration for existing databases.
• TimeTrackerTask: Session tracking now works for all players (not just Discord-linked), so the tutorial triggers properly.
• Config Cleanup: Removed duplicate message keys, fixed orphaned bounty strings, and consolidated mace/elytra configuration.
• TAB Integration 2.0: Continues to only send team packets on actual changes, keeping bandwidth minimal.

---

PLUGINS UPDATED​

• SunveilSMPplus (v2.1-HOTFIX → v2.2-CONTENT)