Titans - World Bosses

Titans 1.5 INVADER UPDATE

This update is a massive expansion to the Titans system, adding a full server-wide Invader threat engine, long-term player progression, a custom economy, daily bounties, mastery perks, invasion events, and much more.

The goal of this update is to make Titans and Invaders feel like major server events with real consequences, real rewards, and long-term progression for every player.

---

# ADDITIONS

## Invader System

- Added a new server-wide **Invader System**.
- Added Invader-specific JSON configuration support.
- Added support for custom Invader names, species, palettes, stats, moves, punishments, and rewards.
- Added server-wide consequences when Invaders are not defeated.
- Added server-wide blessings when Invaders are defeated.
- Added Invader lifetime damage tracking.
- Added Invader teleport, active effects, multiplier, and leaderboard commands.

---

## Global Panic / Heat System

- Added a new **Global Panic** system, also known as **Heat**.
- Added server-wide Heat tracking from `0` to `100`.
- Added Heat increases when Invaders despawn undefeated.
- Added Heat decreases when players successfully defeat Invaders.
- Added Heat-based scaling for future Invader spawn chances.
- Added admin commands to view and manually set the server Heat level.

---

## Server-Wide Punishments

- Added server-wide punishments when Invaders are not defeated.
- Added support for lowered sell prices during punishment periods.
- Added support for disabling shiny spawns during punishment periods.
- Added support for disabling legendary spawns during punishment periods.
- Added support for increased shop prices during punishment periods.
- Added support for reduced EXP gain during punishment periods.
- Added support for disabling mount flying during punishment periods.
- Added support for global wild Pokémon aggression modifiers.
- Added support for trade tax on player currency trades.

---

## Server-Wide Blessings

- Added server-wide blessings when Invaders are defeated.
- Added support for EXP gain blessings.
- Added support for shiny spawn rate blessings.
- Added support for Hidden Ability chance blessings.
- Added support for EV gain blessings.
- Added support for catch rate modifiers.
- Added configurable blessing durations.

---

## Dynamic Minion Reinforcements

- Added minion reinforcement waves for Invaders.
- Added HP threshold-based minion spawning.
- Added support for custom minion species.
- Added support for custom minion count.
- Added support for custom minion levels.
- Added support for minion stat multipliers.
- Added support for custom minion palettes and forms.
- Added automatic minion cleanup when the boss is defeated or despawns.

---

## Environmental Hazards

- Added pulsing environmental hazards around Invaders.
- Added configurable hazard radius.
- Added configurable hazard pulse intervals.
- Added `GRAVITY_WELL` hazard support.
- Added `ABYSSAL_PULSE` hazard support.
- Added hazards that can slow, ground, or debuff nearby players.
- Added support for making boss areas more dangerous during combat.

---

## Multi-Phase Boss Battles

- Added phase-based Titan and Invader transformations.
- Added HP threshold-based phase changes.
- Added support for changing boss forms mid-fight.
- Added support for changing boss palettes mid-fight.
- Added support for changing boss movesets mid-fight.
- Added support for phase stat multipliers.
- Added custom phase announcement messages.

---

## Defense Pylons

- Added protective boss pylons.
- Added configurable pylon count.
- Added configurable pylon spawn radius.
- Added configurable damage reduction per active pylon.
- Added pylon-based tactical objectives during boss fights.
- Added support for weakening bosses by destroying active pylons.

---

## Invasion Events

- Added scheduled **Invasion Events**.
- Added support for event files inside `config/titans/invasion_events/`.
- Added configurable event names.
- Added configurable event start and end times.
- Added support for permanent events using `0` timestamps.
- Added targeted Invader event boosts.
- Added support for targeting all Invaders with `ALL`.
- Added event-based spawn chance multipliers.
- Added global weather locks during events.
- Added custom event announcement messages.

---

## Strategy Rules

- Added advanced strategy rules for Titans and Invaders.
- Added support for limiting the number of Pokémon players can bring.
- Added support for scaling player Pokémon down to a maximum level.
- Added support for blocking legendary Pokémon from specific boss fights.
- Added tools for creating more tactical and restricted boss encounters.

---

## Field Effects

- Added permanent battle field effects for boss fights.
- Added forced battle weather support.
- Added forced battle terrain support.
- Added gravity field support.
- Added Trick Room support.
- Added Magic Room support.
- Added Wonder Room support.
- Added more tools for creating unique boss battle conditions.

---

## World Corruption

- Added corruption zones around bosses.
- Added configurable corruption radius.
- Added configurable corruption particle types.
- Added configurable potion effects inside corruption zones.
- Added overworld danger areas around Titans and Invaders.
- Added more immersive world effects while bosses are active.

---

## Boss Cinematics

- Added cinematic boss spawn effects.
- Added cinematic boss defeat effects.
- Added custom intro sound support.
- Added custom intro title support.
- Added custom outro sound support.
- Added custom outro title support.
- Added Minecraft color code support for cinematic titles.

---

## Mastery Tree

- Added a long-term **Mastery Tree** progression system.
- Added Mastery Points.
- Added unspent point tracking.
- Added lifetime earned point tracking.
- Added Offensive Power upgrades.
- Added Defensive Power upgrades.
- Added Utility Loot upgrades.
- Added commands for viewing and upgrading mastery perks.

---

## Daily Bounties

- Added Daily Bounties.
- Added bounty rotation every 24 hours.
- Added Mastery Point rewards from bounties.
- Added DAMAGE bounty type.
- Added KILL bounty type.
- Added support for bounties targeting all Titans.
- Added support for bounties targeting specific Titan species.
- Added player bounty progress tracking.

---

## Titan Bestiary

- Added a persistent Titan and Invader Bestiary.
- Added kill count tracking for each boss species.
- Added max damage dealt tracking.
- Added first discovered timestamp tracking.
- Added personal boss hunting records for players.
- Added a command to view Bestiary progress.

---

## Titan XP System

- Added expanded Titan XP progression.
- Added Titan XP rank tracking.
- Added progress toward next rank.
- Added Titan XP prestige support.
- Added admin XP logs.
- Added server-wide XP events.
- Added admin commands to give, take, and set Titan XP.
- Added party-based XP management.

---

## Economy System

- Added a custom Titans economy system.
- Added **Titan Shards** as a custom currency.
- Added configurable starting shard balance.
- Added configurable shard display name.
- Added configurable shard color.
- Added player-to-player shard payments.
- Added minimum payment amount setting.
- Added admin shard balance management.

---

## Shard Shop

- Added a configurable `/titans shop` GUI.
- Added shop configuration through `config/titans/shop.yml`.
- Added custom shop categories.
- Added custom shop item IDs.
- Added custom display items.
- Added enchanted item glow support.
- Added RGB gradient name support.
- Added custom item lore support.
- Added Titan Shard pricing.
- Added player purchase limits.
- Added global purchase limits.
- Added purchase limit reset timers.
- Added console command rewards on purchase.
- Added confirmation menus for expensive purchases.

---

## Advanced Leaderboards

- Added boss kill leaderboards.
- Added total damage leaderboards.
- Added boss fights joined leaderboards.
- Added first-hit leaderboards.
- Added Titan XP leaderboards.
- Added party XP leaderboards.
- Added persistent Invader damage leaderboard.
- Added styled leaderboard GUI support.

---

## Multipliers and Cooldowns

- Added global Titan damage multipliers.
- Added player-specific Titan damage multipliers.
- Added optional multiplier durations.
- Added multiplier reset command.
- Added cooldown reset command.
- Added support for resetting all cooldowns for a player.
- Added support for resetting a cooldown for a specific boss.

---

## Invader Commands

- Added `/titans invaders top`.
- Added `/titans invaders active`.
- Added `/titans invaders multipliers`.
- Added `/titans invaders dps`.
- Added `/titans invaders teleport <invaderName>`.
- Added `/titans invaders spawn <invaderId>`.
- Added `/titans invaders despawn <invaderName>`.
- Added `/titans invaders panic set <0-100>`.
- Added `/titans invaders panic get`.
- Added `/titans invaders event list`.
- Added `/titans invaders clear [name]`.
- Added `/titans invaders scheduler next`.
- Added `/titans invaders list`.
- Added `/titans invaders reload`.

---

## Player Commands

- Added `/titans activebosses`.
- Added `/titans info <bossName>`.
- Added `/titans time`.
- Added `/titans top <bossName>`.
- Added `/titans mydamage <bossName>`.
- Added `/titans rewards <bossName>`.
- Added `/titans where`.
- Added `/titans tp <bossName>`.
- Added `/titans join <bossName>`.
- Added `/titans xp`.
- Added `/titans xp <player>`.
- Added `/titans xp prestige`.
- Added `/titans shop`.
- Added `/titans shards`.
- Added `/titans shards pay <player> <amount>`.
- Added `/titans mastery`.
- Added `/titans mastery upgrade <offensive|defensive|utility>`.
- Added `/titans bestiary`.
- Added `/titans bounties`.

---

## Admin Commands

- Added `/titans despawn <bossName>`.
- Added `/titans list`.
- Added `/titans reload`.
- Added `/titans webhooktest`.
- Added `/titans scheduler toggle`.
- Added `/titans scheduler next`.
- Added `/titans heal <bossName> [amount|full]`.
- Added `/titans damage <bossName> <amount>`.
- Added `/titans shieldinfo <bossName>`.
- Added `/titans breakshield <bossName>`.
- Added `/titans addshield <bossName> <type> <hpThreshold> <hp>`.
- Added `/titans debug`.
- Added `/titans spawn <bossId>`.
- Added `/titans reloadconfig`.
- Added `/titans xp log <player>`.
- Added `/titans xp event <multiplier> <durationMinutes>`.
- Added `/titans xp admin give <targets> <amount>`.
- Added `/titans xp admin take <targets> <amount>`.
- Added `/titans xp admin set <targets> <amount>`.
- Added `/titans xp admin party <partyName> <give|take|set> <amount>`.
- Added `/titans shards <player>`.
- Added `/titans shards admin give <targets> <amount>`.
- Added `/titans shards admin take <targets> <amount>`.
- Added `/titans shards admin set <targets> <amount>`.
- Added `/titans resetcooldown <player> [bossId]`.
- Added `/titans admin multiplier global <value> [durationMinutes]`.
- Added `/titans admin multiplier player <targets> <value> [durationMinutes]`.
- Added `/titans admin multiplier reset`.

---

## Configuration Files

- Added `config/titans/econ.yml`.
- Added `config/titans/shop.yml`.
- Added `config/titans/invasion_events/`.
- Added `invader_leaderboard.json`.
- Added new Invader JSON blocks for minions, hazards, phases, pylons, panic, punishments, and blessings.
- Added new boss JSON blocks for strategy rules, field effects, corruption, and cinematics.

---

## Performance Improvements

- Added throttled atmospheric and world checks.
- Added automatic cleanup for Invader minions.
- Added optimized event handling for scheduled Invasion Events.
- Added integrated Invader logic within the boss spawning system.
- Reduced unnecessary repeated checks during active boss events.
- Improved handling for large server-wide boss events.

---

# BUG FIXES

## Boss Cleanup

- Fixed leftover minions remaining after an Invader is defeated or despawns.
- Fixed boss-related entities not always cleaning up correctly after events.
- Fixed potential world clutter from abandoned boss mechanics.

---

## Invader Effects

- Fixed active Invader punishments not always clearing correctly.
- Fixed active blessings not always displaying correctly.
- Fixed multiplier display issues for active Invader effects.
- Fixed server-wide effects sometimes persisting longer than intended.

---

## Panic / Heat

- Fixed Heat values being able to exceed intended limits.
- Fixed Heat values not always updating properly after Invader success or failure.
- Fixed admin Heat commands not always showing the latest value.

---

## Invasion Events

- Fixed scheduled event reload behavior.
- Fixed event list display issues.
- Fixed event multipliers not always applying to the correct Invaders.
- Fixed weather locks not always clearing correctly after events.

---

## Leaderboards

- Fixed leaderboard tracking for Invader lifetime damage.
- Fixed leaderboard GUI display issues.
- Fixed damage values not always saving correctly.
- Fixed ranking updates after boss fights end.

---

## Economy and Shop

- Fixed shard balance checks.
- Fixed player-to-player payment edge cases.
- Fixed shop purchase limit tracking.
- Fixed global purchase limits not always updating correctly.
- Fixed confirmation menu behavior for expensive purchases.
- Fixed shop reward commands not always running correctly.

---

## Titan XP and Progression

- Fixed Titan XP display issues.
- Fixed XP event multiplier handling.
- Fixed prestige command edge cases.
- Fixed Mastery Point tracking issues.
- Fixed Daily Bounty progress display.
- Fixed Bestiary records not always updating correctly.

---

## Commands and Permissions

- Fixed command permission checks across new Titans systems.
- Fixed several command feedback messages.
- Fixed admin command handling for XP, shards, multipliers, and Invaders.
- Fixed command reload behavior for updated configs.
- Fixed teleport command handling for active Invaders and Titans.

---

## Boss Mechanics

- Fixed shield info display issues.
- Fixed shield break command behavior.
- Fixed boss damage and healing admin command handling.
- Fixed pylon damage reduction calculations.
- Fixed phase trigger handling at HP thresholds.
- Fixed hazard pulse timing.
- Fixed field effect and corruption checks.

---

## General Stability

- Improved server stability during large boss events.
- Improved config reload safety.
- Reduced possible errors from missing or incomplete config sections.
- Improved handling for invalid boss, Invader, shop, and event IDs.
- Improved overall reliability of the expanded Titans systems.