Youkai's Homecoming-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:

| 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: