Yokai´s Hell

⛩️ YOKAI'S HELL ⛩️

Five legendary yokai. One storm dragon. Zero easy fights.
Cataclysm-style boss battles straight out of Japanese folklore, for NeoForge 1.21.1.

🌑 When the lanterns go out and the torii bleed red, the old spirits return. A demon drums thunder in the deep caves. A cursed samurai guards the cherry groves. A ghost bride freezes the peaks, a crow-winged kami rules the cliffs, and something drags a ship anchor through the swamps. Take their relics. Climb to the Ancestral Temple. And wake the one thing that should have stayed asleep:

🐉 Ryū of the Storms.

✨ Why Yokai's Hell?

• 👹 6 handcrafted bosses: original models, textures and fully animated move sets. No vanilla reskins.
• ⚔️ Fights you learn, not tank: telegraphed attacks, multi-hit combos, jumpable shockwaves and punish windows.
• 🔥 Two phases per miniboss, three for the dragon: every boss changes how it fights at low health.
• 🐉 A 40+ block storm dragon with a body you can hit along its entire length.
• 🎁 6 unique relics with active abilities, plus a full Yokai Hunter armor set.
• 🏯 New structures: Ancestral Altars in every boss biome and the Ancestral Temple on the Jagged Peaks.
• 🏆 19 advancements, from first blood to Dragonslayer.
• ⚙️ Everything is configurable: health, damage, cooldowns, sizes, spawn rates, and every single ability can be turned off.
• 🚀 Built for performance: boss AI is profiled and optimized tick by tick, and every release passes 160+ automated combat tests.

🎯 Combat Built to Be Learned

💀 Mash your sword and you will die. Read the fight and you will win.

👺 THE BESTIARY

👹 The Calamity Oni

📍 Deep caves, below Y 0 · ❤️ 340 HP · 🎁 Kanabō Fragment

Calamity Oni

A 4.5-block demon in lacquered armor. Raijin's drums burn on its back, and its spiked kanabō has flattened armies.

• 🔨 Club Combo: smash, backhand, and an overhead finisher that sends out a shockwave.
• 🦘 Crushing Leap: run away and it lands right where you were standing.
• 🐂 Charge: it lines you up and charges. Dodge into a wall and watch it stagger.
• ⚡ Thunder Drums (phase 2): every drum beat calls lightning down on your head.
• 🪨 Rock Skin: swords bounce off. Bring a pickaxe to shatter the stone plates.

Overhead finisher Crushing Leap Thunder Drums

🗡️ The Desecrated Ronin

📍 Cherry groves · ❤️ 240 HP · 🎁 Ronin's Katana

Desecrated Ronin

His master is dead. His honor is gone. Only the 3.4-block nodachi remains.

• 🌸 Parry and Riposte: hit him while he's on guard and he appears behind you.
• 🌙 Nodachi Combo: a Rising Cut that launches you, then a Crescent Moon Slash that splits the ground.
• 💫 Dance of a Thousand Blades (phase 2): he teleports around you in a star and cuts five times.
• 🏴 Cursed Banner: heals him while it stands. Break it fast.
• 🔥 Duel Circle: a ring of burning petals. Try to leave and you get cut.

Rising Cut Crescent Moon Slash Thousand Blades

❄️ The Lady of Ice: Yuki-onna

📍 Snowy peaks and frozen biomes · ❤️ 225 HP · 🎁 Blizzard Crystal

Yuki-onna

Travelers lost in the snow say a woman in white found them. None of them saw the spring.

• 🧊 Frost Claw → Glacial Nova: she blinks behind you, tears at you, and the ice around her explodes.
• 🔪 Halo Barrage: she fires the ice blades orbiting her head in a fan.
• 🏔️ Glacier Wall: a row of ice spikes erupts across the ground.
• 🌨️ Whiteout (phase 2): icicles rain down all around you.
• 🪞 Mirages, blizzards and the Ice Prison: get frozen solid and you're locked in a block of ice.

Glacial Nova Halo Barrage Glacier Wall

🪶 The Tengu of the Peaks

📍 Taigas and bamboo jungles · ❤️ 225 HP · 🎁 Tengu's Fan

Tengu

The mountain kami does not forgive trespassers. It takes them, and the wind keeps their screams.

• 🌀 Staff Sweep → Staff Slam: a spinning shakujō strike, then a dive onto a marked circle.
• 🌬️ Gale Wall: a wall of wind that pushes you off cliffs.
• 👻 Kamikakushi: it grabs you and carries you into the sky. Hit it twice to break free, fast.
• ☄️ Descent of the Kami (phase 2): it climbs into the clouds and slams down on the spot under you.
• 🐦‍⬛ Karasu-tengu: it summons crow warriors to swarm you.

Staff Slam Kamikakushi Descent of the Kami

🐢 The Kappa of the Depths

📍 Swamps and mangroves · ❤️ 255 HP · 🎁 Kappa's Dish

Kappa

Children are told not to swim near the reeds. Something down there drags a rusted anchor, and it is always hungry.

• ⚓ Anchor Combo: a sweeping swing, then a sunken slam that sends out a shockwave.
• ⛓️ Thrown Anchor: it hooks you on a chain and reels you in.
• 🌪️ Shell Whirlwind (phase 2): it spins inside its shell and ricochets off the walls.
• 🤼 Foul Drag and the Sumo Challenge: it pulls you into the water or shoves you out of the ring.
• 🎯 Weak spot: spill the water dish on its head with an arrow or a critical hit to stun it.

Anchor Slam Thrown Anchor Shell Whirlwind

🐉 FINAL BOSS: RYŪ OF THE STORMS

📍 Ancestral Temple, Jagged Peaks · ❤️ 850 HP · 🎁 Ryū's Pearl (Legendary)

Ryu of the Storms

⚡ The sky turns black. Lightning strikes every few seconds. Antlers wider than your house rise above the torii gates. Three phases. A permanent thunderstorm. No mercy.

🏯 How to awaken it: bring the Ronin's Katana, the Kanabō Fragment and the Blizzard Crystal to the Ancestral Temple, a torii shrine high on the Jagged Peaks. The ritual consumes the relics, and the dragon rises from the temple in a spiral.

☁️ Phase 1: Lord of the Skies

• ⚡ Lightning Breath: a sweeping beam that sets the ground on blue fire.
• 🌀 Wind Orbs: homing spheres that blow you off the mountain.
• 🌩️ Thunder Pillars: five strikes, and one of them lands where you're about to run.

Lightning Breath Wind Orbs Thunder Pillars

🌋 Phase 2: Earthly Fury

• 🐍 Tail Sweep: the whole body spins and clears 10 blocks around it.
• 🦷 Bite and Lunge → Seismic Crash: it drives its head into the ground. That's your moment to strike.
• 👻 Minor yokai: onibi will-o'-wisps and wind spirits join the fight.

Tail Sweep Bite and Lunge Seismic Crash

🌪️ Phase 3: The Ancestral Storm

• 🎭 Shadow Dance: it splits into illusion dragons, and only the real one takes damage.
• ☄️ Death Dive: it climbs into the sky and falls like a meteor.
• 👁️ Eye of the Storm: a chasing lightning barrage that ends in one massive strike.

Shadow Dance Death Dive Eye of the Storm

🏆 Defeat it to claim the legendary Ryū's Pearl: permanent lightning immunity, plus the Dragon Ascent, which launches you into the sky with a thunder shockwave.

🎁 Relics and Progression

Ronin's Katana Kanabo Fragment Blizzard Crystal Tengu's Fan Kappa's Dish Ryu's Pearl

🥋 Yokai Hunter Armor

A samurai-style set (kabuto, dō, haidate, suneate) upgraded from diamond at the smithing table. It doesn't burn in lava and protects against freezing.

🎌 Full set bonus: +20% damage to yokai bosses and −15% damage taken from them.

🏯 Ancestral Altars

Pillar shrines hidden in each boss's biome. Get close and the boss appears without warning. Win, and a reward chest rises with loot, essences and a lore scroll telling that yokai's story.

🧭 Quick Start

1. 📥 Install NeoForge 21.1.x for Minecraft 1.21.1.
2. 📦 Drop Yokai's Hell and GeckoLib 4.9.3+ into your mods folder.
3. 🗺️ Find an altar: /locate structure miniboses_orientales:altar_oni (also altar_ronin, altar_yuki_onna, altar_tengu, altar_kappa).
4. ⛩️ Find the temple: /locate structure miniboses_orientales:ancestral_temple
5. 🧪 Just testing? Use /summon miniboses_orientales:<boss> or the spawn eggs in the Yokai's Hell creative tab.

💡 Tip: bosses also spawn naturally, but rarely, in their home biomes. Travel prepared.

📦 Requirements and Compatibility

• ✅ Modpacks: you're welcome to include it in any modpack.
• ✅ Datapack friendly: loot tables, structures, biome tags and recipes can all be replaced.
• ✅ Server friendly: block breaking follows mobGriefing, and multiplayer scaling is configurable.
• ⚙️ Config: config/miniboses_orientales-server.toml (balance) and miniboses_orientales-client.toml (screen shake).

💬 Community and Feedback

🏮 Every yokai in this mod was shaped by player feedback. Your report could be the next update.

• 💬 Discord: Join the shrine: sneak peeks, balance votes and boss-fight clips.
• 🐛 Bugs and suggestions: leave a comment here or open an issue on GitHub.
• 🎥 Content creators: videos and showcases are very welcome. Send us the link and we'll feature it!
• ⭐ Enjoying the mod? Hit Follow to get every new boss the moment it drops.

All models, textures and animations are 100% original.
Inspired by the boss design of L_Ender's Cataclysm.

⛩️ The spirits are waiting. Are you ready to descend into Yokai's Hell? ⛩️