Youkai's Homecoming — Unofficial 1.21.1 NeoForge Port

An unofficial port of Youkai's Homecoming by lcy0x1, bringing essentially all 1.20.1 content to Minecraft 1.21.1 / NeoForge.

Ported by yinyuze with permission from the original author. Source code, license, and all original design credit belong to lcy0x1 and the upstream contributors.

---

⚠️ Attribution & License

• Original mod: Youkai's Homecoming by lcy0x1 — GitHub
• License: LGPL-2.1-only (inherited from the upstream project)
• This port: maintained by yinyuze, with permission from lcy0x1
• Port source code: GitHub repository

If you encounter a bug that exists in the original 1.20.1 version, please report it to the upstream repository, not here.
For bugs introduced by this port (1.21.1 specific), please use this project's issue tracker.

---

What This Port Brings to 1.21.1

This port migrates the majority of 1.20.1 content into the 1.21.1 NeoForge ecosystem. Below is a feature overview.

🍱 Food & Cooking System

A complete Touhou-themed culinary system, fully ported and JEI-integrated:

• Cooking Pots — Small Iron Pot, Short Iron Pot, Stockpot (3 sizes)
• Cuisine Board — sushi, rolls, and assembled dishes
• Wood Basin — stomping recipes for batch processing
• Steamer Pot + Rack + Lid — stackable steam-cooking
• Sauce Rack, Ingredient Rack, Wine Shelf — decorative storage
• Moka Pot, Kettle, Fermentation Barrel, Drying Rack — coffee, tea, fermented drinks, dried goods
• Cutting Board recipes — over 25 custom cuts (sushi prep, ingredient processing, etc.)
• 70+ cooking pot recipes — full Touhou cuisine lineup (ramen, dango, mochi, sushi, curries, etc.)

👥 Touhou Characters

Full AI behavior, trading systems, and quest mechanics:

• Reimu Hakurei — donation box summoning, feeding quest for her hairband, anger response when villagers are harmed
• Cirno — fairy AI, frog hunting (drops Frozen Frogs), trading, freezing danmaku
• Rumia — flesh-feeding mechanics, charged attack mode, drops hairband on Ex defeat
• Reputation system with character-specific responses
• Donation Box — drop emeralds/gold to summon Reimu

🌸 Equipment & Mechanics

All hats and hairbands ported with their original behaviors:

Item	Effect
Reimu's Hairband	Creative flight, danmaku bypasses magical protection, +1 initial resource, -10% hitbox
Rumia's Hairband	+25% attack, drops mob heads (skeleton/wither skull/zombie/creeper/piglin) on kill, flesh & blood drops without knife (knife gives bonus drops), grants constant Youkaifying
Cirno's Hairband	Magic damage freezes targets and frogs, grants constant Fairy effect
Cirno's Wings	Creative flight when Fairy effect is active
Suwako's Hat	Drops from frogs eating raiders in front of villagers; grants constant Native effect
Koishi's Hat	Drops after blocking Koishi attacks N times in a row; grants constant Unconscious effect
Straw Hat	Equip on frogs (while Youkaifying/Youkaified) to make them attack pillagers

🎯 Danmaku System

Powered by danmaku_api (bundled):

• Circle / Ball / Mentos / Bubble / Butterfly / Spark / Star bullet types
• 16 dye colors
• Upgrade recipes: 4 Ball danmaku → 1 Bubble danmaku; 4 Spark danmaku → 1 Star danmaku (per color)
• Lasers and laser pencils with upgrade paths
• Hat-based no-consumption support: matching-color danmaku doesn't deplete when wearing the right hat
• Damage type modifications (Reimu hairband → abyssal; etc.)

🍴 Food Items & Effects

• Youkaifying / Youkaified progression (eat flesh → become half-youkai → full youkai)
• Flesh & Cooked Flesh — drops from human-type mobs killed with knife under youkai effects
• Blood Bottle — same mechanic but requires offhand glass bottle
• Higan Soup, Power Soup, Mushroom Soup, Miso Soup, Seafood Miso Soup, Poor God Soup, Tutu Congee, Kaguya Hime, Rice Powder Pork, etc.
• Full coffee lineup (Espresso, Americano, Latte, Cappuccino, Macchiato, Mocha, Affogato, etc.) + remix recipes
• Tea lineup (Green, White, Black, Oolong, Cornflower, Sakura Honey, Saidi, Genmai, Tea Mocha, Green Water)
• Sushi & rolls (handled via Cuisine Board)
• Dango variants (Mitarashi, Kinako, Tsukimi, Sakura, Sweet Ormosia)

🌍 World Generation

• Hakurei Shrine — generates in cherry biomes
• Cirno's Nest — generates in snowy biomes
• Youkai Nest — generates in dark forests
• Sakura Forest / Sakura Birch Forest / Sakura Taiga — three custom biomes
• Crops & wild plants — Soybean, Red Bean, Tea, Coffea, Cucumber, Black/Red/White Grape, Mandrake Root, Udumbara
• Mobs — Boar (forest), Deer (forest, balanced spawn rate), Lamprey (water), Crab (river)
• Loot modifiers — Udumbara appears in Ancient City chests; Crab can be fished from rivers; Lamprey from any water

🏆 Advancements

20+ original advancements ported, including the Feed Reimu challenge (feed Reimu every non-meat food in the mod to obtain her hairband).

---

🔗 Curios Integration (Soft Dependency)

Curios is fully optional. The mod runs without it, but if Curios API is installed, every hat and hairband gains a Curios capability automatically:

• ✅ Wear hats/hairbands in any Curios slot in addition to the vanilla head slot
• ✅ All hat mechanics check both the vanilla head slot and all Curios slots — wearing Rumia's hairband in a Curios necklace slot still drops mob heads on kill
• ✅ Multi-hat stacking: if you have multiple Curios slots, wearing multiple hats of different colors stacks the danmaku no-consumption support across colors
• ✅ Custom loot conditions correctly read Curios-equipped items (e.g., Rumia's head-drop loot modifier)

---

🧩 Mod Compatibility

• Lithium (NeoForge) — Compatible. The frog AI mixin uses @ModifyReturnValue so Suwako-hat frogs still attack pillagers even with Lithium's frog_attackables optimization active.
• Kaleidoscope (Cookery) — Compatible. Cooking-pot and cutting-board recipes are generated under the youkaishomecoming namespace (rather than farmersdelight) to prevent silent overrides.
• Farmer's Delight — Required. Cooking pot and cutting board recipe types come from here.
• JEI — Optional. All custom recipe categories registered (Cuisine, Pot Cooking, Basin, Steamer, etc.).
• Jade — Optional. Tooltips on cooking pots, kettles, fermentation barrels.

---

📦 Dependencies

Required

• NeoForge 21.1.62+
• Farmer's Delight 1.2.4+

Optional

• JEI — recipe viewing
• Curios API — extended slot support for hats/hairbands
• Jade — block tooltips
• TerraBlender — required for the custom Sakura biomes to generate in the Overworld

Bundled (no separate install needed)

The mod bundles all of lcy0x1's library mods via jarJar:
l2core, l2serial, l2library, l2modularblocks, l2damagetracker, l2itemselector, l2menustacker, l2harvester, danmaku_api, fast_projectile_api.

---

🐛 Reporting Issues

Please include:

1. Minecraft version, NeoForge version, this mod's version
2. List of other installed mods (especially performance/AI mods like Lithium, ModernFix, Embeddium)
3. Steps to reproduce
4. Crash report or latest.log (preferably both)

Report on the GitHub issue tracker.

---

📜 License

This project is licensed under LGPL-2.1-only, the same license as the upstream Youkai's Homecoming. The full text is in the LICENSE file in the source repository.

---

🙏 Credits

• lcy0x1 — original creator of Youkai's Homecoming and all upstream library mods, and for granting permission for this port
• yinyuze — 1.21.1 NeoForge port maintainer
• Touhou Project by ZUN — for the characters and inspiration this mod is based on

This port is a community effort to bring lcy0x1's excellent work to newer Minecraft versions, with the original author's permission. All original content credit belongs to the upstream authors.