Soul Land Mod — Changelog v15 → v18

🌿 v18 — Wild Herbs, Biome Overhaul & Performance Fix

The "Actually Playable" Update

🌱 Wild Spirit Herb System (NEW)

• Herbs now spawn as breakable plant blocks instead of invisible floating items
• 6 visual tiers with unique cross-shaped models: Common Grass, Vine, Mushroom, Exotic Flower, Crystal, and Legendary
• Each plant glows based on rarity (light level 2-10)
• Break to harvest — drops the stored herb item (55+ unique herbs)
• Herbs generate naturally during Spirit Beast Forest world generation (3-4% ground coverage)
• Herbs also spawn near players every ~3 minutes in qi-rich areas
• Higher qi zones = rarer herb spawns (Legendary herbs only at Qi 5)

🌍 Spirit Beast Forest Biome Overhaul

• Forests are now rare and MASSIVE — one guaranteed near spawn (350-500 block radius!)
• Grid spacing increased from 400 → 1600 blocks (forests no longer in every chunk)
• Forest spawn chance reduced from 60% → 15% per grid cell
• Removed forced forests around spawn (only 1 guaranteed at origin)
• Each forest is 250-500 blocks in radius — feels like a real biome
• Mountain waterfalls replaced with glowing crystal nodes (eliminated water flow lag)
• Mountain generation rate reduced for better performance

⚡ Massive Performance Improvements

• Chunk decoration pre-filter: Only chunks near a forest get queued (eliminates 95%+ unnecessary processing)
• Persistent block scanning: Decorated chunks detected across server restarts (no more re-decorating)
• Queue processing reduced from 32/tick → 2/tick
• Spawn rate multipliers reduced: Qi 4: 4x→2x, Qi 5: 8x→2.5x
• All spirit beasts now have 10-minute max lifespan (hard despawn)
• Distance-based despawn: beasts at 96 blocks, NPCs at 80 blocks
• Random despawn chance when 48+ blocks from nearest player
• Legacy cleanup system: Automatically removes old unlimited-lifetime item entities on world load
• Periodic entity maintenance every 2 minutes clears stale soulland items

🪵 Spirit Wood Crafting

• Spirit Forest Logs now function as a proper wood type
• Spirit Wood Planks: Craft 4 from 1 Spirit Forest Log
• Spirit Wood Sticks: Craft 4 from 2 Spirit Wood Planks
• Both usable in future crafting recipes
• Custom textures, models, and blockstates
• Block loot tables added for all major blocks (logs, planks, qi stone, spirit stone, etc.)

🧪 Herb Spawn Table Fixes

• IMMORTAL_HERB and SPIRIT_RECOVERY_PILL added to rare herb drop tables
• All 55 unique herbs now confirmed spawning in both forest generation and player-proximity spawning
• Forest herb roller expanded to 14 entries in rare tier (was 12)

📖 Manual Updates

• Cultivation Manual (right-click item) completely rewritten with all current features
• Added sections: Wild Herbs, Spirit Beast Forest zones, Alchemy, Crafting
• Added new keybinds: B (Breakthrough), G (Ring Aura)
• Updated commands list with all 17 subcommands including locateforest, spawnall, speed
• Written Book version (given on first join) expanded to 13 pages
• Added crafting page, wild herbs page, and updated tips

🐛 Bug Fixes

• Fixed duplicate tick() method in SpiritBeastEntity causing compile failure
• Fixed WILD_HERB block missing from cutout render registration (herbs were invisible)
• Fixed WildHerbBlock drops: now uses playerWillDestroy for reliable block entity access before removal
• Added anti-double-drop protection (clears herb data after player break)
• Added onRemove handler for non-player destruction (explosions, pistons)
• Fixed 3x3 grid check (was 5x5 — wasteful with 1600 spacing)

🧪 v17 — Alchemy System & Herb Blocks

The Alchemy Update

🧪 Full Alchemy Crafting System

• 10-tier alchemy progression (Novice → Legendary Alchemist)
• 20+ pill recipes using spirit herbs as ingredients
• Success rate mechanics based on alchemy level
• Third GUI tab for alchemy crafting interface
• Pill items with cultivation XP, stat boosts, and special effects

🌿 50 Novel-Accurate Spirit Herbs

• 50 unique herbs from Soul Land lore: Blue Silver Grass, Nine Petal Jade Lotus, Yearning Heartbroken Red, etc.
• Level-gated consumption (higher herbs require higher cultivation)
• Tiered spawn rates based on Spirit Qi density
• Custom 16×16 item textures for all herbs
• Diminishing returns system prevents herb spam exploitation

🔧 Codebase Audit & Bug Fixes

• 13-point validation system for syntax, registries, packets, NBT, assets
• Network sync fixes for cultivation data
• Creative tab registration fixes
• Lang file coverage for all 140+ items

🎭 v16 — Ring Mutations & Aura System

The Evolution Update

💎 Spirit Ring Mutation System

• 1% chance on ring absorption for a Mutated Ring with evolved abilities
• Mutated rings have unique names, boosted stats, and enhanced skills
• Visual indicator for mutated rings in cultivation menu

✨ Ring Aura Display (G Key)

• Press G to toggle a visible aura around your character
• Particle halo effects based on your strongest ring color
• Intimidation mechanic — other players see your power level

📊 GUI Text Boxes

• Precise stat value entry in cultivation menu
• EditBox widgets for direct number input
• Replaces slider-only controls with hybrid input

🎨 UV-Accurate Beast Textures

• Complete regeneration of all 345 beast textures (115 species × 3 phases)
• UV overlap fixes for serpent/wyrm geometry models
• Element-specific color palettes (fire=red/orange, ice=blue/white, etc.)