Youkai's Homecoming — 1.21.1 Unofficial Port

An unofficial NeoForge port of Youkai's Homecoming for Minecraft 1.21.1, made with permission from the original author lcy0x1. This port brings the full 1.20.1 content to the 1.21.1 platform.

Original project: https://www.curseforge.com/minecraft/mc-mods/youkais-homecoming

Ported Content

This port includes but is not limited to:

• Cooking System — Stockpots, steamers, cuisine boards, and basin pressing, with dozens of Japanese dishes, soups, sushi, sake, and wines
• Touhou Project Character NPCs — Reimu, Cirno, Rumia, Koishi, Remilia, Marisa, Sanae, Yukari, Mystia, and more, with full home AI behavior
• Danmaku Combat System — Spell cards, danmaku projectiles, and related recipes
• Equipment — Reimu's Ribbon, Rumia's Hairband, Cirno's Ribbon, etc., with their original acquisition methods
• Youkaification System — Half-youkaified to fully youkaified state progression
• New Mobs — Boar, deer, crab, tuna, fairies, and youkai
• Biomes — Requires TerraBlender; without it, custom biomes will not generate
• Structures — Hakurei Shrine, wild youkai dens, Cirno's nest
• Crop & Brewing System — Grape cultivation and winemaking (missing from the official 1.21.1 version)
• 14 Status Effects

Changes from the Official 1.20.1 Version

• Touhou Little Maid Compatibility — With Touhou Little Maid installed, maids can be assigned the "Danmaku Battle" task, allowing them to use danmaku and spell cards. Damage scales with maid affection and base attack.
• Curios Compatibility — With Curios installed, all hairbands and hats can be equipped in the head accessory slot to activate their abilities (in 1.20.1 this required a separate compatibility mod).
• Danmaku Mechanics — Reduced invincibility frames for danmaku damage (4 hits per second).
• Character Adjustments — Some Touhou character abilities have been adjusted. The damage cap mechanic on Touhou characters has been removed.

Dependencies

• Hard dependency: Farmer's Delight
• Soft dependencies (optional): TerraBlender, Curios, Touhou Little Maid, JEI

Why This Port Exists

The official 1.21.1 version of Youkai's Homecoming only contains basic food and furniture content, missing most core features (characters, danmaku, youkaification, brewing, etc.). This port restores the full experience.

This port will continue to follow updates from the official 1.20.1 version.

Issues & Feedback

If you encounter any issues, please report them on GitHub: https://github.com/yinyuze/Youkaishomecoming-1.21.1-Unofficial-Port

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:

🎯 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.