Перейти к содержимому
Mineforgian

Youkai's Homecoming-unofficial-port

Unofficial 1.21.1 port of Youkai's Homecoming. Original by lcy0x1, ported by yinyuze. Contains essentially all 1.20.1 content.

Загрузки
11K
Подписчики
6
Обновлён
15 августа 2026 г.
Лицензия
LGPL-2.1-only

Опубликован 13 мая 2026 г.

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 lcy0x1GitHub
  • 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.

Ченджлог

4.2.14Релиз1.21.1 · 15 августа 2026 г.

4.2.14

New Features

  • Added stairs + stairs composition: right-clicking a stair with another material's stair in hand now produces a combined stair. The extra half returns to the player as a vertical slab of the second material.
  • Added disableCompositeBlocks client config: hides the Composite Blocks creative tab entries from creative inventory and JEI. Placed blocks and right-click assembly are unaffected. Requires a game restart to take effect.
  • Added disableComposeMechanic server config: disables the right-click compose mechanic entirely. Existing composite blocks are unaffected.

Bug Fixes

  • Fixed the compose mechanic being silently broken since porting: CombinedBlockSet.init() was never called, so the block-to-set lookup table was empty and no right-click composition worked.
  • Fixed BIRCH wood type registering BRICK_STAIRS as its stair block (copy-paste typo), which prevented birch stairs from participating in any composition.
  • Fixed hats, hairbands and Cirno wings leaking into the Composite Blocks creative tab. The default creative tab is now restored to the main mod tab after composite blocks are registered.
  • Fixed Curios head/back slot definitions clobbering Curios defaults: added the missing curios:tag validator so that accessory tooltips correctly show the slot hint and third-party head-accessory mods keep working.
  • Added a Curios can-equip fallback so this mod's hats/hairbands/wings can still be equipped even when another mod attaches a narrow validator to the head slot (e.g. GoetyDelight's doll-only rule).
  • Fixed a misleading Curios query name (hasWings was used for head-slot checks); consolidated the query and cleaned up related slot-check logic.
4.2.13+1Релиз1.21.1 · 9 августа 2026 г.

4.2.13+1

  • Added the missing kettle crafting recipe.
  • Fixed the short iron pot crafting recipe.
4.2.13Релиз1.21.1 · 7 августа 2026 г.

4.2.13

New Features

  • Ported the full 1.20.1 kettle interaction: 1000 mB fluid tank + heat counter, no GUI. Empty-hand left click packs the kettle (items/fluid/heat) into an item; shift + right click dumps items; right click toggles handle/tray support; water bucket/bottle fills the tank; drink items go into recipe slots; other fluid containers route through FluidItemTile.
  • Added 11 hand-written kettle recipe JSONs (BLACK/GREEN/WHITE/OOLONG_TEA, CORNFLOWER_TEA, GREEN_WATER, TEA_MOCHA, SAIDI_TEA, SAKURA_HONEY_TEA, GENMAI_TEA, SCARLET_TEA).
  • Kettle hover tooltip shows Heating: X% / Brewing: X%.
  • JEI kettle category now shows the tea bottle item as the output instead of a raw fluid.
  • Restored the boil sound and bubble/steam particles that heated kettles emit.

Bug Fixes

  • Fixed client crash when REI is installed and any kettle/moka GUI is open. BasePotMenu no longer extends RecipeBookMenu, so REI's DefaultRecipeBookExclusionZones stops probing an unregistered RecipeBookType and no longer NPEs during render. The recipe-book side of the pot GUI was unused anyway (JEI/REI/EMI replace it).
4.2.12Релиз1.21.1 · 31 июля 2026 г.

4.2.12

New Features

  • Backported three flesh entries from 1.20.1: flesh_feast (block), raw_flesh_feast (item) and bloody_flesh (saucer dish). Names, tooltips and Reimu-response tag behavior all follow the existing weird-meat/flesh switching.
  • Added the "Source" tooltip to raw flesh: while wearing a Touhou hat, hovering shows the acquisition hint (kill human mobs with knife while youkaifying/youkaified); otherwise shows ???.
  • monstrosity advancement icon now points at the flesh_feast block (matching 1.20.1).
  • The bowl-of-flesh-feast cooking pot recipe is removed; the meal is now obtained by right-clicking the flesh_feast block.

Bug Fixes

  • Fixed save corruption when attacking Reimu with the "Dream World" spell card while Touhou Little Maid is not installed. PlayerHolderMixin now skips itself when the maid mod is absent instead of crashing during class transform.
  • Fixed intermittent Windows 10 startup failures (~60% chance) caused by a class-loading race between the mod's TLM compat class and Touhou Little Maid's own worker thread. TLM compat registration is now deferred to FMLCommonSetupEvent and no longer touches TLM classes from modloading-worker.
4.2.11Релиз1.21.1 · 21 июля 2026 г.

4.2.11

New Features

  • Added Create Mechanical Harvester compatibility: the harvester can now properly harvest tea trees and grape vine crops without destroying them.
    • Tea tree: harvestable at 75% growth (age ≥ 6), drops tea leaves, resets to age 4 (single-block bush state).
    • Grape vine structure (center vine, branch vine, hanging fruit): harvestable at max age, drops grapes, resets to base age. Harvested items are sent into contraption storage.
    • Immature crops are ignored by the harvester and left intact.
    • Create is an optional dependency; the mod functions normally without it installed.
4.2.10Релиз1.21.1 · 8 июля 2026 г.

4.2.10

New Features

  • Added spawn rate multipliers for Deer, Boar, Tuna and Lamprey under the natural_spawn config group (0.0 blocks all, 1.0 keeps every attempt), letting server owners fine-tune density without hard-disabling a species. Chinese translations included.

Bug Fixes

  • Fixed server crash when a chunk containing Marisa unloaded.
  • Fixed bamboo-based foods (raw bamboo, rice powder pork, kaguya hime, tutu congee, etc.) rendering misaligned when placed inside a steamer.

Balance

  • Reduced natural spawn density for Deer and Boar.
    • Boar: weight 20 → 10, group size 2-3 → 1-2; biomes trimmed to #is_forest + #is_taiga + youkai_biomes.
    • Deer: weight 14 → 10, group size 2-3 → 1-2; biomes trimmed to #is_forest + meadow + cherry_grove + youkai_biomes.
    • Tuna and Lamprey unchanged; use the new spawn rate config to reduce them further.

QoL

  • Ingredient rack now prefers the main inventory over the hotbar when retrieving items with an empty main hand. Shift-click for a full stack still works.
4.2.9Релиз1.21.1 · 17 июня 2026 г.

4.2.9

New Features

  • Added configurable attribute modifiers for the Youkaified effect: max health bonus (default +20 flat), attack damage bonus (default +50% on base), and movement speed bonus (default +30% on total). All values update live without restarting the game.
  • Added configurable attribute modifiers for the Fairy effect: max health, attack damage, movement speed, plus a new danmaku hitbox modifier (default -50%, makes the player harder to hit by danmaku while in the Fairy state). All values update live.
  • Added a master switch for Curios slot support on this mod's hats, hairbands and accessories. When disabled, accessories are recognized only in vanilla equipment slots even if Curios is loaded.
  • Added a configurable cooldown for the Koishi hat: how long the hat's continuous unconscious effect stays suppressed after being interrupted by an attack or opening a container (default 200 ticks; set to 0 to disable interruption).
  • Backported missing configuration options from the 1.20.1 build and connected them to existing implementations: exRumiaConversion, reimuSummonKill, reimuSummonMoney, reimuSummonCost, reimuHairbandFlightEnable. These options now actually take effect.
  • Reorganized server config groups: split the misplaced rumiaHairbandDrop out of the reimu group into its own rumia group, added a new effect_modifiers group for the new attribute options, and added a compat group for the Curios master switch.
  • Added per-mob natural spawn toggles for Deer, Boar, Tuna, Crab and Lamprey under a new natural_spawn config group. Disabling a toggle prevents only NATURAL / CHUNK_GENERATION / SPAWNER spawns; spawn eggs, commands and breeding still work.
  • Filled in Chinese translations for all configuration option titles and tooltips that were previously untranslated.

Bug Fixes

  • Fixed the "The Best Bunch" advancement not being triggered when harvesting grapes.
4.2.8Релиз1.21.1 · 14 июня 2026 г.

4.2.8

New Features

  • Added Camellia accessory support: can be worn in the Curios head slot and renders on the player model. While worn, prevents Phantom from spawning on the wearer.

Bug Fixes

  • Fixed Sober effect failing to properly clear Youkaified and Youkaifying states.
  • Fixed Diversity compatibility: crops now correctly trigger their associated advancements when harvested through Diversity's right-click harvest feature.
  • Fixed two-tall coffea/tea crops being corrupted when right-click-harvested in multi-mod environments (Quark / FTB Ultimine): right-clicking either half now correctly drops fruit and resets growth without orphaning the upper half or wiping the crop.
  • Fixed Flesh Chocolate Mousse, Red Velvet Cake and Scarlet Devil Cake recipes: now correctly require Blood Bottle instead of an empty Glass Bottle, matching the 1.20.1 recipes. Milk inputs now accept any milk item (milk bucket / Farmer's Delight milk bottle) via the c:foods/milk tag.

Комментарии

Загружаем…