Changelog: Hooked on Hydro

[3.1.0] - Universal Spawning & Cross-Mod Architecture

• Universal Water Body Spawning: Expanded runtime block scanning to dynamically detect and populate all water environments—including small custom ponds, inland rivers, lakes, and deep ocean coasts.
• Old & New Chunk Compatibility: Implemented an active server-side game-tick listener (RegisterGameTickListener) that continuously scans around online players every 10 seconds, forcing visible, swimming fish entities to materialize in both newly generated territory and already-explored old chunks.
• Climate-Independent Flexibility: Removed rigid coordinate biome temperature and rainfall filters to allow an equitable random distribution of all vanilla fish species (trout, pike, catfish, carp, bass, yellow perch) across any water body.
• Cross-Mod Soft-Dependencies: Added lightweight runtime detection for Ithania Expanded Fishing and Primitive Survival, automatically recognizing custom baits (like Nightcrawlers and R3D Worms) and aquatic catch types without forcing hard requirements.
• Server-Side Diagnostics: Added detailed console and debug logging to track live entity spawning coordinates and confirm system initialization.
• Modern .NET 10 Framework Alignment: Upgraded the underlying project structure and assembly configuration to target .NET 10 for complete API compliance with current Vintage Story releases.

Changelog: Hooked On Hydro 3.0.0 

🌊 Major Features & Mechanics

• Pure C# Procedural Spawning System: Implemented a lightweight, self-contained server-side tick listener that scans local water blocks around active online players, reads real-time world climate metrics, and programmatically populates matching vanilla fish species into rivers, lakes, and oceans.
• Streamlined, Error-Free Architecture: Stripped out obsolete block entities and complex asset configuration files to ensure the codebase compiles cleanly with 0 Errors and 0 Warnings under modern .NET environments.
• Smart Climate & Biome Matching: Integrated real-time coordinate evaluation (api.World.BlockAccessor.GetClimateAt) to automatically dictate which regional fish species (such as trout, pike, catfish, bass, or yellow perch) naturally thrive based on local temperature and rainfall thresholds.

🔗 Cross-Mod Integrations & Soft Dependencies

• Ithania Expanded Fishing Integration: Added intelligent runtime mod detection (ithaniaexpandedfishing) that recognizes custom bait items (Nightcrawlers, R3D Worms, Sea Worms) and applies customized catch effectiveness multipliers.
• spooq's Biomes Mod Integration: Implemented soft-dependency compatibility (biomes) that automatically scales regional temperature and rainfall habitat amplifier factors.
• Primitive Survival Compatibility: Added robust check logic for handling water-based gear and traps from Primitive Survival.

⚡ Environmental Simulation & Quality-of-Life

• Substrate & Flora Scanning: Automatically detects lakebed substrates (gravel, sand, clay, mud, peat) and underwater flora (reeds, kelp, seagrass) beneath and around water positions to grant vital habitat and breeding bonuses.
• Day/Night Diurnal Cycles: Configured time-of-day calculations (GetTimeOfDayMultiplier) to grant optimal activity and feeding boosts to standard fish during daylight hours.
• Universal Version Compatibility: Configured the mod assembly and modinfo.json dependencies ("game": "*") to allow smooth loading across all modern Vintage Story updates (v1.19, v1.20+) without version mismatch errors.

Changelog: Hooked on Hydro 

[2.3.0] -  Primitive Survival Integration Update

🌊 Major Features & Cross-Mod Integrations

• Primitive Survival Compatibility & Buffs: * Added dynamic soft-dependency detection (api.ModLoader.IsModEnabled("primitivesurvival")) to recognize when Primitive Survival is active.
  
  
  • Integrated baseline aquaculture resilience bonuses to ensure seamless, harmonious gameplay alongside popular survival gear like fish baskets, trotlines, and bait harvesting tools.
    
    
• Biome Climate Integration: * Connected player-built water basins directly to Vintage Story's real-time world mapping engine to sample local coordinate temperature and rainfall.
  
  
  • Added temperature comfort buffers ($8^\circ\text{C}$ to $22^\circ\text{C}$) for optimal breeding, penalties for extreme freezing or scorching climates, and high-moisture rainfall multipliers for lush/swamp biomes.
• Visible Living Aquariums & Autonomous Breeding: * Right-clicking vanilla fish items into enclosed stone, wood, or glass water blocks physically spawns and animates swimming fish entities inside bases.
  
  
  • Background server ticks automatically handle population growth and local species propagation when breeding pairs (2+ fish) are present.
• Real-Time Player Feedback: * Instant in-game chat updates alert players to local water temperatures, moisture buffs, and fish comfort levels upon releasing a catch, complete with active mod integration status notes.

🛠️ Technical Enhancements & Stability

• Clean Soft-Dependency Routing: Utilizes lightweight runtime checks (IsModEnabled) to support optional expansions safely without hard dependency crashes or source-code duplication.
• Zero-Wiping Save Safety: Fully compatible with existing save files. Players can drop in the updated .dll directly into active worlds without altering chunk maps or losing base builds.
• Pristine Build State: Maintained a clean, bug-free 0 Errors, 0 Warnings compilation state in Visual Studio.

Changelog: Hooked on Hydro 

[2.2.0] - Biomes Mod Cross-Compatibility Update

🌍 Major Features & Integration

• Spoog's Biomes Mod Compatibility: Added soft-dependency integration (api.ModLoader.IsModEnabled("biomes")) allowing Hooked on Hydro to natively detect and coordinate with external biome-overhaul mods.
• Smart Region Adaptation: * Automatically detects if custom biome mods are present upon server startup and logs compatibility status.
  
  
  • Adjusts baseline environmental reproduction calculations to seamlessly fit within strict regional world-gen zones without requiring source code duplication.
• Flexible Playstyle Support: Fully optimized to operate as a seamless experience whether players choose to run the game with or without external biome mods (gracefully falling back to standard vanilla climate mapping if the biomes mod is absent).

🛠️ Technical Enhancements & Save Safety

• Zero World-Wiping Required: Fully compatible with existing save games. Players can drop in the updated .dll without breaking current bases, custom aquariums, or world structures.
• Clean Soft-Dependency Routing: Avoids internal compilation clashes by querying external mod states dynamically at runtime rather than hardcoding hard-linked libraries.

Changelog: Hooked on Hydro Vanilla  Biome-Balanced Breeding Mod

[2.1.5] - Current Stable Release (Biome Climate & Visible Aquaculture Update)

🌊 Major Features & Mechanics

• Biome Climate Integration: Linked player-constructed water ponds directly to Vintage Story's real-time world mapping engine, allowing the mod to sample localized temperature and rainfall values at specific block coordinates.
• Environmental Breeding Buffs & Penalties: * Implemented optimal temperature comfort ranges ($8^\circ\text{C}$ to $22^\circ\text{C}$) that grant breeding boosts.
  
  
  • Added severe reproduction penalties for extreme freezing polar conditions ($< -5^\circ\text{C}$) or scorching heat ($> 35^\circ\text{C}$).
  • Added high-moisture rainfall bonuses ($> 0.4$) to reward aquaculture setups built in lush or swamp biomes.
• Visible Swimming Fish Entities: Configured server-side logic to physically spawn living vanilla swimming fish entities (Entity) into water tanks when released by players, allowing them to visibly swim around inside custom-built aquariums or ponds.
• Autonomous Population Growth: Added a background server-side tick listener (running every 40 seconds) that evaluates active enclosures with 2 or more fish, automatically breeding and populating new fish based on local biome suitability.
• Instant Climate Feedback: Integrated real-time chat notifications (serverApi.SendMessage) that dynamically inform players about local water temperature, humidity buffs, and fish comfort levels upon release.

🛠️ Technical Fixes & Code Refactoring

• API Compatibility Resolution: Replaced obsolete or unsupported server event hooks with bulletproof, standard server-side interaction workflows.
• Optimized Block & Climate Lookups: Replaced unsupported accessor methods with reliable world chunk climate map queries.
• Clean Compilation State: Resolved all namespace dependencies and constructor warnings, maintaining a pristine 0 Errors, 0 Warnings build state in Visual Studio.

Changelog – Hooked on Hydro

[2.0.0] - The Vanilla-First & Fish Breeding Update

🚀 Major Architectural Changes

• Eliminated Custom Block Registration Errors: Completely deprecated and removed the custom JSON blocks (fishtank.json, fishtrap.json) and complex C# block-entity scripts that previously caused engine crashes (no such class registered).
• Shift to Vanilla Integration: Redesigned the mod to run natively off vanilla water blocks and standard vanilla fish items. Players can now use regular building materials (such as glass, stone, or planks) to design and construct custom aquariums and outdoor breeding ponds.

🌊 New Features & Mechanics

• Pond Enclosure Validation: Added intelligent backend spatial checks that scan blocks surrounding water sources to verify if a player-made tank or pond has a valid solid floor and protective walls.
• Pond Population Tracking: Implemented a dynamic server-side dictionary system (pondPopulations) that tracks how many fish have been released into each specific coordinate-based pond.
• Autonomous Fish Breeding: Added a background game tick listener that periodically evaluates active ponds with 2 or more fish, giving them a natural chance to reproduce over time and expand the local population.
• Instant In-Game Feedback: Configured chat notification feedback (serverApi.SendMessage) to dynamically inform players when they successfully establish a pond, or warn them if an enclosure requires more solid walls/fish to support breeding.

🛠️ Bug Fixes & Code Cleanliness

• API Compliance: Updated all event handlers and messaging wrappers to match modern Vintage Story API guidelines (GlobalConstants.GeneralChatGroup, safe nullable reference types).
• Zero-Error Build: Cleared all compiler warnings and errors, achieving a stable 0 Errors, 0 Warnings build state in Visual Studio.

Changelog: Hooked on Hydro 

[1.0.0] - Initial Concept & Custom Block Implementation

• Custom Block & Entity Architecture: Introduced custom JSON block definitions (fishtank.json and fishtrap.json) paired with custom C# block entity classes (BlockEntityFishTank and BlockEntityFishTrap).
• Initial Asset Framework: Laid down the foundational file paths for mod registration, block types, and assets within the AquacultureMod library.

[1.1.0] - Debugging & Engine Registration Refactoring

• Class Mapping & Registration Fixes: Resolved internal namespace registration mismatches by explicitly pairing short and fully-qualified class types (BlockFishTank, BlockFishTrap) in AquacultureCore.cs.
• Build Path Optimization: Streamlined build outputs, resolved missing assembly references, and standardized folder configurations inside the %appdata%\VintagestoryData\Mods\ active directory.

[1.2.0] - The Vanilla-First Pivot & Error Elimination

• Removal of Broken Custom Classes: Completely deprecated and removed the custom fishtank and fishtrap JSON blocks and complex block-entity structures to permanently eliminate engine registration crashes (no such class registered).
• Vanilla Interaction System: Shifted to a lightweight, highly stable system where players use vanilla building materials (stone, glass, wood) to construct enclosed water ponds and tanks.
• Native Item Integration: Implemented clean server-side logic allowing players to right-click water blocks holding standard vanilla fish items to release and farm them.
• API Compliance & Zero-Error Build: Refactored event hooks to match current Vintage Story server API standards, resolving all nullable reference warnings, resolving namespace dependencies, and achieving a clean 0 Errors, 0 Warnings build state.

OUTDATED BROKEN VERSION DO NOT USE

Changelog: Hooked On Hydro 

[1.0.0] - Initial Release & Core Features

🌟 New Blocks & Interactive Machines

• Passive Fish Trap (aquaculture:fishtrap): * Implemented a custom wooden block class (BlockFishTrap) and ticking block entity (BlockEntityFishTrap).
  
  
  • Automatically checks for water and rolls a random catch chance over time based on local climate, depth, and temperature conditions.
• Fillable & Breedable Fish Tank (aquaculture:fishtank):
  
  
  • Added a stone basin block class (BlockFishTank) and block entity (BlockEntityFishTank) to support controlled aquaculture anywhere in the world.
  • Upgraded from neighbor-water checks to an internal water storage system allowing players to fill the tank directly using a Water Bucket.
  • Implemented a 3-slot inventory system supporting two matching breeding stock slots and one bait slot.
  • Added automated breeding cycles that consume bait, play ambient sounds (game:sounds/effect/squit), and multiply fish stacks sustainably over time.

🎣 Items, Crafting Recipes & Loot Tables

• Craftable Bait (aquaculture:bait): * Added single-slot crafting recipes using vanilla ingredients (like dry grass) to yield multiple bait items.
  
  
  • Integrated bait mechanics into the fish trap and fish tank loops to drastically boost catch rates and trigger breeding cycles.
• New Aquatic Species & Crustaceans:
  
  
  • Introduced individual JSON item definitions with protein nutrition and cooking properties for Trout, Catfish, Perch, Bass, and Crabs.
  • Implemented dynamic weighted loot tables for the fish trap that distribute species based on environmental factors.

🎨 Visual Assets & UI

• Custom 3D Models & Voxel Shapes:
  
  
  • Configured voxel shape references for blocks to render unique shapes rather than plain cubes.
• Hand-Crafted Pixel Art Textures (32x32):
  
  
  • Added custom texture assets matching Vintage Story's survival art style, including woven wicker textures for traps (fishtrap.png), chiseled stone/masonry textures for tanks (fishtank.png), and distinct inventory icons for all catchable fish and crustacean species.
• Mod Metadata & Custom Logo:
  
  
  • Configured modinfo.json and a custom "Hooked On Hydro" mod logo (logo.png) for the main menu mod browser.

🛠️ Technical & Architecture Improvements

• Mod System Registration: Established AquacultureCore.cs with proper positional assembly attributes (ModInfo) to cleanly register custom blocks, items, and block entities with the game engine.
• Strict Null-Safety Refactoring: Updated C# logic with local variable caching and null-guards to ensure clean compilation under strict C# nullable reference type checking.