## 1.21.1-2.4.5 ### Added - Added **Instant Spin Attacks** using circular movement followed by right-click. - Added separate configuration options for charged and instant Spin Attack cooldowns. - Added an option for Spin Attacks to break grass and plants. - Added **Hookshot target configuration**, allowing servers/modpacks to restrict which blocks Hookshots can attach to. - Added **Weather2 compatibility** for the Song of Storms. - Added configurable structure generation weight, spacing, and separation. - Added a configurable Sword Beam knockback multiplier. ### Improved - Reworked the **Ocarina song selection and playback system**. - Improved Hookshot, Longshot, Hypershot, and Endershot behavior. - Adjusted Kakariko Ore generation to behave more like Ancient Debris. - Improved fairy persistence, summoning, and dismissal behavior. - Improved custom sword durability handling. ### Fixed - Fixed Ocarina songs not working correctly. - Fixed the **Temple of Time music disc**. - Fixed custom shield enchantability. - Fixed a Master Sword duplication exploit when dual wielding with a full inventory. - Fixed Fairy Bow empowerment returning a vanilla Glass Bottle instead of a Hylian Bottle. - Fixed Navi hint logic. - Fixed the Magic Boomerang enchantment advancement. - Fixed Rupee pickup sounds. - Fixed a potential Din Campfire cooldown issue preventing the Fire Golem from being resummoned. - Added additional protection against Goron Merchants becoming Zombie Villagers. - Fixed several fairy duplication issues. Includes all changes since **1.21.1-2.4.2**.

# 📜 Changelog — Version 2.4.2 ## ✨ Navi Improvements - Added additional contextual hints for the **Magic Boomerang** - Fire Golem hint behavior ## 🌀 Magic Boomerang Elemental Rituals - Added **Gale Force** boomerang enchantment (increases damage and velocity) - Added Magic Boomerang "ritual" enchantments: **Din’s Fury (Fire)**, **Farore’s Storm (Lightning)**, **Nayru’s Embrace (Ice)** ## 🛒 Goron Merchant Updates - Goron trades rotate daily and are selected per tier - Added config support for **custom trades** ## ⚔️ Item & Progression Updates - True Master Sword now cleanses Zombie Villagers on right-click - Updated brewing logic for Din’s, Farore’s, and Nayru’s Flames - Improved advancement and progression checks ## 🧚 Fairy & World Fixes - Added config option to disable specific structures - Improved **Healing Fairy** spawn logic around Healing Fountains - Fixed fairy deployment messages triggering incorrectly - Fixed ore blocks dropping incorrect items - Fixed fairy arrow crafting tags - Replaced/cleaned up **Giant Zombie** placeholder - Adjusted loot tables (including Ocean Monument fixes)

# 📜 Changelog — NeoForge 1.21.1 Full Release ## ✨ Major Platform Update - Fully migrated the mod to **NeoForge 1.21.1** - Adopted **Minecraft 1.21 Data Components** across all items, blocks, and entities - Updated all registrations to NeoForge’s latest lifecycle rules - Modernized rendering, transforms, and animation hooks for 1.21 - Removed legacy 1.20.1 systems and deprecated compatibility code - Internal modernization for long-term stability and forward compatibility --- ## ⚙️ Systems & Configuration - Introduced a new **JSON-driven configuration system** for fine-tuning mod behavior - Replaced legacy config handlers with modern component-based formatting - Migrated tooltips, item data, and block state data to Data Components - Cleaned up outdated registry entries and deprecated event hooks - General stability, performance, and crash-resistance improvements --- ## 🧚 Fairy System, AI & Spawning ### General Improvements - Fixed **Pet Fairy duplication** after crashes or improper world reloads - Added server-side safeguards to prevent stray or duplicate pet entities - Improved AI navigation, collision handling, and owner-following behavior - Improved spawn validation and density handling across fairy types - Reduced duplicate deployment messages and chat spam - Fixed fairy arrow crafting tag issues - Fixed bottle NBT/tag issues ### Navi Overhaul - Reworked spawn logic: - Temple of Time proximity validation - Dynamic spawn chance tuning - Density limits to prevent over-spawning - Stabilized Temple of Time behavior - Expanded contextual hint system - Improved cooldown handling (including fire warnings) - Refined hint priority logic (combat → progression → secrets → flavor) - Improved clarity and usefulness of hint text #### Goddess Sword Interaction - Navi greets the player upon first obtaining the Goddess Sword - If no active fairy is present, Navi becomes the player’s companion - If a fairy is already active, Navi provides a bottled version instead - One-time trigger prevents repeat greetings ### Structure & Healing Fairies - Ensured **Healing Fairies** properly spawn around Healing Fountain structures - Updated Leaf Fairy spawn rules - Improved multi-type fairy spawn consistency --- ## 🪄 Items, Weapons & Combat - Magic Boomerang now throws from the correct hand and position in first-person - Fixed rod use animations appearing too low in 1.21 - Rods now display foil/glint when fully charged - Updated Ice Rod and other charge-based rods to comply with new use-tick rules - Fixed bottle use animations and aligned them with updated vanilla timing - Rewrote multiple interaction (`useOn`) handlers for improved block, fluid, and entity consistency - Updated all weapons to NeoForge’s frozen attribute system - Improved attack damage, durability, and interaction feedback consistency - Restored **Curios** compatibility ### Upgrade & Component Fixes - Fixed Goddess Sword upgrade paths - Fixed Golden → True Master Sword attribute copying - Fixed Bow → Fairy Bow component copying - Fixed ore blocks dropping incorrect items --- ## 🏪 Entities & World Interaction - Fixed boomerang → fairy collision crash - Improved Goron Merchant stock rotation logic and stability - Prevented Goron profession from appearing in zombie villager conversions - Fixed/replaced Giant Zombie placeholder entity - Improved structure detection and validation checks - Adjusted loot tables (including Ocean Monuments) - Cleaned up shrine and progression interaction hooks --- ## 🔥 Blocks - Fixed campfire block entity issues under Minecraft 1.21’s stricter validation rules - Updated all custom lanterns: - Corrected light emission levels - Fixed toggle and interaction behavior - Migrated state data to Data Components - Improved block interaction logic and tooltips --- ## 📜 Advancements - Updated all advancements to the Minecraft 1.21 trigger system - Fixed broken or non-functional criteria - Corrected missing icons and invalid parent relationships - Improved shrine, weapon, and overall progression consistency --- ## 🎨 Visual & First-Person Improvements - Corrected first-person transforms for rods, boomerangs, and bottles - Fixed animation regressions caused by updated hand transform pipelines - Reduced reequip flicker and visual popping - Fixed tick-based animation flicker caused by client/server desync - Improved consistency between first-person and third-person visuals --- ## 🧪 Crafting & Brewing - Din’s Flame, Farore’s Flame, and Nayru’s Flame are now proper brewing ingredients - Updated legacy crafting logic to modern 1.21 systems --- ## 🛠 Overall Polish - Numerous small bug fixes across items, entities, and world systems - Improved consistency in spawning, interactions, and progression logic - Continued internal cleanup and performance optimizations

# Change Log – v2.3.1 ## 🔧 Fixes & Improvements - Fixed a bug with Zelda’s Lullaby introduced in v2.3 - Fixed Sun’s Song resetting the in-game time back to Day 1 - Fairies are now immune to indirect damage (e.g. explosions) ## ⚔️ Balance & Configuration - Further reduced Leaf Fairy spawn rates for better balance - Refined and reorganized the Master Sword common configuration file for improved clarity and maintainability ## ✨ New Additions - Baby Lon Lon Cows! - Introduced configurable Friendly Fire Blacklist options in the common config

# Change Log – v2.3 ## 🔧 Fixes & Improvements - Vanilla recipe book integration: custom recipes now appear as expected. - *TosserUUID* NBT stacking issue re-addressed — may finally be resolved. - Ice Rod particle alignment corrected. - Nayru Shrine riddle message fixed for accuracy. - Boomerang no longer affects the Ender Dragon. - Gorons should now world-spawn with varied trade inventories instead of always having the same. - Resolved issue where vanilla villagers could spawn with the Goron Merchant profession due to mod conflicts. - Music Block no longer causes overlapping songs in multiplayer. - Custom particles should now render correctly. - Improved performance of **Zelda's Lullaby** to prevent client/server lag. ## ⚔️ Balance & Configuration - Fierce Deity Sword now uses magic to fire beams, rather than requiring full health. - Added config options:   - Fierce Deity Sword beam magic cost   - Sword Beam cooldowns   - Toggle for Spin Attack breaking plants (true/false) ## ✨ New Additions - **Hypershot**: a powerful new tool for advanced traversal. - **Endershot**: harness Ender energy for ranged mobility. - **Supporter-Exclusive Sheikah Fairy**: available only to verified supporters.

# Change Log 2.2.9 ## Additions ### New Features: - Added **Great Fairy Fountain** structure and **healing fairy fountain music block** (plays *Great Fairy Fountain* by Harp Twins). - Introduced **Fairy Water Block/Liquid**. - Added **Great Fairy** entity. - Healing fairies can now spawn in the Overworld again (very rare) and are added as a new **healing fairy fountain spawn** location. - Introduced **Friendly Fire check** to Boomerang and Magic Boomerang impacts. - **Undead mobs** now affected by Zelda's Lullaby. - Added **bombchus** to rare creeper drops. - Added **Goron Merchant Shop** to Savanna biome structure generation. - Crafting recipe added for **Fairy Arrows**. - Added Traveler's Backpack tool slot compatibility for the ocarinas, boomerangs, hookshots and lanterns. ### Curios and Dynamic Lighting Support: - Added **Curios mod integration** for Magic and Fairy Lanterns. - Added **Dynamic Lighting support** for Magic and Fairy Lanterns. ## Changes ### Gameplay Adjustments: - Healing fairies no longer spawn naturally, except via dedicated structures. - Music Blocks now drop themselves when destroyed. - Zelda's Lullaby can now reset nearby **cow milk cooldowns**. - Separated cooldowns for **Spin Attack** and **Sword Beam**; increased Sword Beam cooldown. - Default **Fire Rod damage** increased to 20. - **Epona upgraded** when summoned via Ocarina of Time. - Increased rare item drop and generation rates. - Goron Merchant default trade price for Fairy Arrows adjusted. ### Balancing and Tuning: - Massively reduced **Leaf** and **Gray Fairy** spawn rates. - Removed Magic Boomerang and Fairy Lantern from **Triforce wish options**. - Removed Fighter's Shield crafting recipe. - **Slightly adjusted shield model widths**. ### Optimizations: - Various changes to reduce the mod file size. - Tweaked pet fairies for better performance. ### Visual and Sound Improvements: - Adjusted healing fairy sound events and slightly increased volume for new music blocks. - Adjusted light levels for fairy bottle blocks. ## Fixes ### Bug Fixes: - Fixed a bug with fairy bottles causing the player's arm to shorten. - Fixed the Master Sword spin ability. - Fixed "Hey Listen" spam from Navi in multiplayer environments. - Fixed damage types to register correctly as player kills. - Prevented pet fairies from duplicating with the **Create mod**. - Fixed "Tael" description and **Fairy Bow** magic consumption issue. - Fixed issues with fairies visually catching fire or drowning. - Fixed ability to enchant **Mirror Shield (OOT)** via anvil. - Resolved **Song of Storms** not working in specific instances. - Overhauled structure generation and fixed all Fairy spawns. - Fixed missing Old Rusty Shield from Link's House structure - Fixed bug in new Boomerang friendly fire check ## ??? - Added small thank-you gestures to an amazing contributor. ## Miscellaneous - Excluded **Silverfish** from dropping Rupees. - Added loot table for a **hidden chest** in Lon Lon Ranch.

IF EXPERIENCING ANY PROBLEMS AFTER UPDATING FROM A PREVIOUS 1.X VERSION, TO VERSION 2.0+, THEN DELETE YOUR MASTERSWORD COMMON CONFIG FILE __**Change Log**__ * Reworked the entire way Structures generate * Sword Shrine will emit redstone signal(15) when displaying a weapon * Fixed voxel shape for Sword Shrine * Fixed swing animation on items using custom use animation * Made Fierce Deity Sword two-handed with Better Combat * Fixed Healing Fairy Bottle Block * Updated Hylian Shield model and texture * Added de_de language file * Adjusted Fairy Bottle models in GUI * Added dependencies to mods.toml _Credit for German translation - Thanks @not_octo1_

IF EXPERIENCING ANY PROBLEMS AFTER UPDATING FROM A PREVIOUS 1.X VERSION, TO VERSION 2.0+, THEN DELETE YOUR MASTERSWORD COMMON CONFIG FILE __**Change Log**__ * Reworked the entire way Structures generate * Sword Shrine will emit redstone signal(15) when displaying a weapon * Fixed voxel shape for Sword Shrine * Fixed swing animation on items using custom use animation * Made Fierce Deity Sword two-handed with Better Combat * Fixed Healing Fairy Bottle Block * Updated Hylian Shield model and texture * Added de_de language file * Adjusted Fairy Bottle models in GUI * Added dependencies to mods.toml _Credit for German translation - Thanks @not_octo1_

IF EXPERIENCING ANY PROBLEMS AFTER UPDATING FROM A PREVIOUS 1.X VERSION, TO VERSION 2.0+, THEN DELETE YOUR MASTERSWORD COMMON CONFIG FILE __**Change Log**__ * Reworked the entire way Structures generate * Sword Shrine will emit redstone signal(15) when displaying a weapon * Fixed voxel shape for Sword Shrine * Fixed swing animation on items using custom use animation * Made Fierce Deity Sword two-handed with Better Combat * Fixed Healing Fairy Bottle Block * Updated Hylian Shield model and texture * Added de_de language file * Adjusted Fairy Bottle models in GUI * Added dependencies to mods.toml _Credit for German translation - Thanks @not_octo1_

IF EXPERIENCING ANY PROBLEMS AFTER UPDATING FROM A PREVIOUS 1.X VERSION, TO VERSION 2.0+, THEN DELETE YOUR MASTERSWORD COMMON CONFIG FILE __**Change Log**__ * Reworked the entire way Structures generate * Sword Shrine will emit redstone signal(15) when displaying a weapon * Fixed voxel shape for Sword Shrine * Fixed swing animation on items using custom use animation * Made Fierce Deity Sword two-handed with Better Combat * Fixed Healing Fairy Bottle Block * Updated Hylian Shield model and texture * Added de_de language file * Adjusted Fairy Bottle models in GUI * Added dependencies to mods.toml _Credit for German translation - Thanks @not_octo1_