Touhou Little Maid: Tsumugi

This is an unofficial fork. Maintained independently by gege-tlph, it is not an official Touhou Little Maid release and is not supported by the original author.

Project repository · Releases · Issues

Touhou Little Maid: Tsumugi is a Touhou Project themed maid mod. Summon maids to keep you company and put them to work: farming, fishing, cooking, sorting storage and fighting at your side. You can dress them up, use custom models and talk to them.

This project continues the Fabric work from Touhou Little Maid: Orihime, while maintaining separate builds for more than one Minecraft version. Choose the file, loader, dependencies and optional integrations for the version you are playing.

Supported versions

The mod ID remains touhou_little_maid. Do not mix files, dependencies or saves between Minecraft versions without a tested migration path.

Downloads

The shared CurseForge project page is currently under review. After approval, it will host files for the supported Minecraft versions. Until then, download the matching JAR from the project's GitHub Releases.

Install the JAR whose name does not contain sources, shadow or dev. Always match the artifact to your Minecraft version, and back up your world before updating.

Shared gameplay

The following player-facing behavior is maintained across the supported branches:

• Maids can defend themselves or protect their owner while preserving their scheduled work.
• Threat response is temporary and can be set to Off, Self-defence or Protect owner.
• Maids keep their distance when using bows, crossbows or supported TACZ guns with ammunition.
• The global configuration and AI settings screens are separated and easier to use.
• Server rules are synchronized to clients; site settings can be checked in place, voices can be previewed, and configuration changes can be reloaded without restarting the game.
• Furnace backpacks, off-hand food handling, Loyalty tridents, extinguishers, maid screens and several rendering paths include compatibility fixes.

Threat response

Threat response does not replace a maid's current work assignment. When instructed by an AI command or server rule, a maid can attack passive creatures; on her own she does not attack passive, neutral or owned creatures. During a response she can melee with whatever she is holding, including nothing at all.

Configuration and AI

The configuration screens keep world rules, client settings and AI settings in separate places. Operators can edit the singleplayer world's or server's rules from the in-game menu. A site can be checked in place, voices can be auditioned, API keys remain server-side, and changes take effect after reload.

AI chat and voice require players to provide their own service endpoints and credentials. This mod does not provide or proxy any AI service.

Fixes

The maintained branches include fixes for the following problems:

• Furnace backpacks no longer shuffle items, burn fuel placed in the wrong slot or lose smelting progress after rejoining the world.
• A malformed entry in a hand-edited configuration no longer makes the whole world unopenable; the bad entry is skipped and written to the log while other settings continue to apply.
• Maids no longer lose unrelated off-hand items while eating.
• Maids no longer intercept a thrown Loyalty trident on its way back to the player.
• Opening a maid screen as the maid disappears no longer crashes the client.
• Extinguishers can put out soul fire.
• Maids keep following orders after long conversations instead of acknowledging a command without acting.
• A selected voice language no longer silently reverts to the chat language.
• Slow cloud speech recognition no longer freezes the entire client.
• A maid equipped with a bow, crossbow, danmaku spell card or trident no longer crashes a dedicated server when switching to ranged combat.

Version differences

Minecraft 1.21.11 Fabric — stable maintenance

The 1.21.11 line includes these tested player-facing integrations:

• Custom maid models: use the organization's OpenYSM-Updated releases. Its maid model compatibility keeps backpacks, held items, main hand, off hand, headwear and back banners attached to model bones.
• Patchouli manual: use the organization's Patchouli: Fabric Edition.
• Maid Restaurant: use the organization's MaidRestaurant releases for the kitchen addon.
• Furniture: MrCrayfish's Furniture: Refurbished storage furniture joins wireless item transfer, and tables can be recognized as food surfaces.
• Shaders: maid tracking markers remain visible with Iris / Sodium.

Other tested optional integrations include JEI / REI, Jade, Farmer's Delight Refabricated, Kaleidoscope Cookery Refabricated, Kaleidoscope Tavern Refabricated, Rustic Delight, Carry On, PatPat and Inventory Profiles Next.

Minecraft 26.1.2 Fabric — Beta

The 26.1.2 line carries the same core maid behavior in the newer Minecraft runtime and includes:

• Patchouli manual: use Patchouli Fabric 26.1-94-beta; the game displays a download prompt if it is missing.
• Optional integrations: JEI / REI, Sodium / Iris, Carry On, Farmer's Delight Refabricated, Kaleidoscope Cookery Refabricated and Kaleidoscope Tavern Refabricated.
• Beta scope: KubeJS, Aquaculture, Accessories, Sophisticated Backpacks and YSM / OpenYSM do not currently have a fully verified 26.1.2 Fabric integration in this Beta.

Compatibility will be reevaluated when a usable target build or a reliable Fabric integration path becomes available. Optional compatibility code does not participate in base loading when its target mod is absent.

TaCZ Refabricated compatibility

The maid gun integration is available through the unofficial TaCZ Refabricated CurseForge project. Install the build matching your Minecraft version:

Maids can recognize supported guns, take ammunition from their backpack, reload, use gun-holding animations and render a slung gun on their back. Other TaCZ builds, including Forge / NeoForge builds, are not supported by these Fabric integrations.

Installation

1. Install the Fabric Loader for the Minecraft version you are playing.
2. Install the matching Fabric API and the required Forge Config API Port version from the table above.
3. Put the matching Tsumugi JAR and dependencies in the mods folder on both the client and server.
4. Install optional integrations for your version if you want their features.

Recommended but not required for both lines: Mod Menu and Cloth Config for the in-game configuration screen, and JEI or REI to browse altar recipes.

Reporting problems

Please report issues through the project's GitHub issue tracker. Include:

1. Minecraft, Java, Fabric Loader and Fabric API versions.
2. The complete mod list and whether the issue occurs in singleplayer, LAN or a dedicated server.
3. Reproduction steps and whether the problem is consistent.
4. logs/latest.log and the matching crash report, with API keys and other credentials removed.

Credits and licence

• Original mod: TartaricAcid/TouhouLittleMaid
• Fabric continuation: Sh1roCu/TouhouLittleMaid-Orihime
• This project: gege-tlph/TouhouLittleMaid-Tsumugi

Code is licensed under the MIT License. Art and assets are licensed under CC BY-NC-SA 4.0.