📜 Awakening System — Changelog v0.3.2

Version Transition: v0.3.1 ➔ v0.3.2
Minecraft Version: 1.21.1
Mod Loader: NeoForge (21.1.249+)
Java Version: Java 21 LTS
Release Target: awakening_system-0.3.2.jar

🛡️ 1. Critical Fix: Dungeon Dimension Isolation & External Mod Mob Infiltration Fix

A critical bug was resolved where players in Rank D dungeons encountered external mod mobs (e.g., wolves and ants from Mo' Creatures, Alex's Mobs, or creature mods) scaled up to Level 70–80, while native dungeon mobs properly stayed around Level 20:

• Preservation of Overworld Distance Scaling (Core Feature):
  • The core RPG system of distance-based mob level scaling ("the further away from spawn, the higher the mob level") remains 100% active and preserved throughout the Overworld and standard dimensions (Lv. 1–20 near spawn up to Lv. 80–100+ in distant zones).
• Root Cause: Foreign Mod Mob Infiltration in Dungeon Realm:
  • Dungeon instances generate inside their own dimension (DUNGEON_REALM) at distant coordinates (X >= 10,000, Z >= 10,000).
  • External creature mods were naturally spawning in the dark chambers of the dungeon dimension. Because those external mobs did not belong to the dungeon system, they were erroneously subjected to coordinate-based distance scaling, artificially inflating their level to 75–80 with extreme damage and health.
• Triple-Layer Strict Dungeon Entity Isolation Filter:
  • Layer 1 (Natural Spawn Suppression): FinalizeSpawnEvent cancels any natural or chunk-based mob spawn inside DUNGEON_REALM.
  • Layer 2 (Highest-Priority Join Interception): In EntityJoinLevelEvent (HIGHEST priority), any living entity entering DUNGEON_REALM that is NOT a player, NOT a player shadow soldier (shadow_soldier), NOT a tamed pet, and NOT a registered dungeon minion/boss (dungeon_mob) is immediately cancelled and discarded.
  • Layer 3 (Active Session Tick Purge): Active dungeon sessions continuously sweep a 150-block radius around the chamber every second (20 ticks), instantly purging and discarding any non-whitelisted foreign entities or leaked ambient creatures.
  • Dungeon instances are now strictly isolated: ONLY Awakening System dungeon minions, bosses, shadow soldiers, players, and pets can ever exist inside dungeons.
• Baran & Igris Theme Minion and Boss Stat Scaling:
  • Minions and mini-bosses in Baran and Igris themed chambers previously had hardcoded Rank S baseline stats (180–450 HP and 12–20 base DMG) across all ranks.
  • Health, attack damage, and armor now scale proportionally with dungeon rank tier (tierRatio = Math.max(0.30D, (double) tier / 7.0D)). In a Rank D dungeon, minions now appropriately possess 50–75 HP and 4–5 base attack damage.
  • Baran and Igris boss armor and knockback resistance now scale smoothly according to rank tier instead of having max armor in low-tier portals.

🌐 2. System Versioning & Dimension Side Tabs Progression Fix

• Dimension-Based System Progression (Not Level-Based):
  • System updates are tied directly to dimensional travel rather than player level. Passing into each realm unlocks its corresponding System tier:
  • Default / Overworld: Base System 1.0 (standard system screen without external dimension tabs).
  • System 2.0 (Isekai Arrival): Unlocked upon entering the Isekai Realm (isekai_world), enabling Overworld, Isekai, and Subspace navigation tabs.
  • System 3.0 (Murim Arrival): Unlocked upon entering the Murim Realm (murim_world), enabling the Murim navigation tab.
  • System 4.0 (Teyvat Arrival): Unlocked upon entering Teyvat (teyvat_world), enabling the Teyvat navigation tab.
  • When players are in any other realm, return navigation tabs remain accessible to allow easy transit back.
• Fix for LAN / OP Privilege Bypass:
  • Removed isDev check (hasPermissions(2)) from getActiveSideTabs(). Previously, any LAN host or player with operator status was flagged as a developer, bypassing dimensional progression checks and rendering all 5 dimension tabs at Level 1.

📦 3. Shop Mystery Boxes Level Lock Requirements

Minimum level requirements were introduced for purchasing loot boxes in the Hunter Point Shop:

• Common Mystery Box (box_common): Requires Level 10 (Cost: 350 Coins).
• Lucky Mystery Box (lucky_box): Requires Level 20 (Cost: 850 Coins).
• Rare Mystery Box (box_rare): Requires Level 35 (Cost: 2,200 Coins).
• Epic Mystery Box (box_epic): Requires Level 55 (Cost: 6,500 Coins).
• Legendary Mystery Box (box_legendary): Requires Level 75 (Cost: 20,000 Coins).
• Purchase attempts below the required level display a clear notification stating the minimum level needed.

⚡ 4. Dungeon Break Event Fixes & Hardening

• Chunk Pre-loading: The event now pre-loads a 3x3 chunk area surrounding the rift prior to collapse, guaranteeing that terrain is fully generated and ready before monster emergence.
• Persistence & Daylight Protection: Monsters breaking through gain persistence (preventing despawn when players distance themselves) and sunlight immunity so the horde does not burn during the day.
• Break Leader: Every dungeon break spawns a designated Break Leader with buffed combat statistics and special naming.
• Full Localization: Translatable broadcast announcements and alerts configured for all languages (es_es, es_cl, en_us, ru_ru).
• Cooldown Protection: Added a 10-minute cooldown and 180-block radius restriction between consecutive breaks to prevent overlapping crises.

🗺️ 5. Biome & Dimension Titles Integration (Traveler's Titles)

• Implemented full compatibility with the Traveler's Titles mod format across all 40 mod biomes and 28 dimensions:
  • Dimension titles: "travelerstitles.awakening_system.<dim>" with matching hex color overrides "travelerstitles.awakening_system.<dim>.color".
  • Biome titles: "biome.awakening_system.<biome>" and "travelerstitles.biome.awakening_system.<biome>" with custom hex colors "travelerstitles.biome.awakening_system.<biome>.color".
  • Vanilla biome title overrides for Spanish locales (travelerstitles.biome.minecraft.<id>) ensuring that players in Spanish games see translated names rather than raw English terms.

⚔️ 6. Dokkaebi Server-Wide Timed Sub-Scenarios & Progressive Overkill Overhaul

• Synchronized Global Server Event:
  • Replaced individual, out-of-sync player tick triggers with a centralized server event (onServerTick every ~20 minutes / 24,000 ticks).
  • Dokkaebi Bihyung initiates a Star Stream emergency broadcast to all active Overworld hunters simultaneously with celestial chime acoustics.
  • Dokkaebi spawns near active players, and each hunter receives their own individual HUD tracking card and percentage progress bar.
• Progressive Difficulty Tiers & Generous Timers:
  • Scenario targets dynamically adapt according to highest hunter level on the server, with significantly extended hunt timers:
  • Tier 1 (Basic Hunt): 8–10 kills across 6:00 minutes (increased to eliminate scarcity stress in quiet biomes). Base reward: 250 Coins, 400 EXP.
  • Tier 2 (Advanced Hunt): 15–18 kills across 8:00 minutes. Base reward: 400 Coins, 700 EXP.
  • Tier 3 (Elite Hunt): 20–24 kills across 10:00 minutes. Base reward: 600 Coins, 1,100 EXP.
  • Tier 4 (Star Stream Calamity): 25–32 kills across 12:00 minutes. Base reward: 850 Coins, 1,600 EXP.
• Universal Kill Detection:
  • Fixed an issue where indirect kills failed to register. The engine now recognizes melee attacks, bow/trident projectiles, lingering Fire Aspect/poison damage, and kills performed by summoned Shadow Soldiers or tamed allies.
  • Properly tracks kills across all hostile entities, creature mods, and custom RPG mobs.
• Escalating Overkill Rates & Constellation Gift Milestones:
  • Exceeding the quota transforms the HUD card into a radiant gold frame and grants scaling rewards per extra kill:
  • 1–5 Extra Kills: +50 Coins & +80 EXP each (Rank: Combat Overload).
  • 6–10 Extra Kills: +75 Coins & +120 EXP each (Rank: Destructive Frenzy).
  • 11–20 Extra Kills: +100 Coins & +160 EXP each (Rank: Stellar Massacre).
  • 21+ Extra Kills: +150 Coins & +250 EXP each (Rank: Absolute Calamity).
  • Achieving Overkill milestones triggers real-time fanfares and awards physical Constellation Gifts deposited directly into player inventories upon completion:
  • +5 Extra Kills: +150 Coins donation bonus + 1x Mana Crystal Shard (Rank E).
  • +10 Extra Kills: +350 Coins donation bonus + 1x Mana Crystal Shard (Rank D).
  • +15 Extra Kills: +700 Coins donation bonus + 1x Mana Crystal Shard (Rank C).
  • +20 Extra Kills: +1,200 Coins donation bonus + 1x Mana Crystal Shard (Rank B).
  • +30 Extra Kills: +2,500 Coins donation bonus + 1x Mana Crystal Shard (Rank A).
• Safe NPC Interaction & Automatic Resolution:
  • Talking to Dokkaebi after reaching the quota will no longer forfeit remaining hunt time; Bihyung displays remaining time and encourages continuous Overkill hunting.
  • Hunters may Sneak + Right-Click to cash out early if desired.
  • Timer expiration automatically resolves all base rewards, Overkill coin/EXP bonuses, level-up calculations (awardExperience), and fireworks.
• Full Trilingual Localization:
  • All announcements, actionbar overlays, dialog prompts, rank tags, and completion breakdowns are fully localized with dedicated translatable keys in Spanish (es_es, es_cl), English (en_us), and Russian (ru_ru).