Youkai's Homecoming-unofficial-port

# Youkai's Homecoming — Unofficial 1.21.1 NeoForge Port > An unofficial port of [**Youkai's Homecoming**](https://modrinth.com/mod/youkaishomecoming) 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](https://github.com/Minecraft-LightLand/Youkai-Homecoming) - **License**: LGPL-2.1-only (inherited from the upstream project) - **This port**: maintained by **yinyuze**, **with permission from lcy0x1** - Port source code: [GitHub repository](https://github.com/yinyuze/Youkaishomecoming-1.21.1-Unofficial-Port) 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](https://github.com/Minecraft-LightLand/DanmakuAPI) (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](https://modrinth.com/mod/curios) 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](https://github.com/yinyuze/Youkaishomecoming-1.21.1-Unofficial-Port/issues). --- ## 📜 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](https://github.com/yinyuze/Youkaishomecoming-1.21.1-Unofficial-Port/blob/main/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.