Touhou Chatty Maids
An immersive Fabric addon for Touhou Little Maid: Oriheme that replaces and complements traditional GUI management with natural chat-based commands, dynamic conversations, and fully configurable triggers.
🌟 Overview
Touhou Chatty Maids makes interacting with your maids in Minecraft feel natural, immersive, and hands-free. Instead of navigating complex GUIs and toggling settings manually, simply talk to your maid in local in-game chat!
Whether you are ordering her to gear up for battle, harvest crops, head home, or change her shift, your nearest owned maid will understand your intent, react in chat with personality, and execute the command instantly. Perfect for survival gameplay, roleplay, and scripted Minecraft videos.
💡 Tip: For the best experience, disable the maid's default AI chat so Touhou Chatty Maids handles all chat responses seamlessly.
⚠️ Warning: This mod is currently designed with only Single Player in mind. Running it on a multiplayer server means ALL maids will share the same global triggers, replies, and reactions, and /tlmchat commands are accessible without OP permissions. Use on servers at your own risk!
✨ Features
- 💬 Natural Chat Commands: Command your nearest owned maid within a 20-block radius using plain text in chat.
- ⚡ In-Game Management Commands: Dynamically add triggers, responses, and order replies directly in-game using
/tlmchat. - ⚔️ Smart Weapon & Gear Swapping:
- Automatically searches the maid's inventory for requested weapons (Swords, Axes, Bows, Crossbows, Tridents, Gohei wands) and equips them to her main hand.
- Automatically sets the corresponding combat AI task (
Melee,Ranged,Crossbow,Trident,Danmaku). - Contextually warns you if she lacks required weapons or ammunition (e.g., missing arrows).
- 🏠 Persistent Home System: Save and manage home locations per maid using server-saved NBT storage.
- 🔒 Grounding & Lockdown:
- Put maids on "grounded" lockdown (restricting movement to home, locking doors/gates, hiding chat bubbles, and silencing audio).
- Quickly toggle door opening, gate access, climbing, riding, and chat bubbles via chat.
- 🌾 Task Automation: Order maids to farm crops, sugar cane, melons, cocoa, honey, clear snow/grass, fish, shear sheep, milk cows, feed animals, feed the player, place torches, or play board games.
- ☀️ Shift Schedules: Easily toggle work schedules between
Day Shift,Night Shift, orFull Shift. - 🎒 Flexible Pickup Control: Dynamically filter item/XP pickup preferences (All items & XP, XP only, Items only, or Disabled).
- ❤️ Favorability & Dialogue:
- Dynamic responses with chat delays to simulate natural conversation.
- Respect your maid—using rude language will decrease her favorability!
- ⚙️ Fully Configurable: Customize triggers, aliases, and replies through auto-generated JSON configuration files or in-game commands.
📦 Requirements
- Minecraft: 1.20.1+
- Fabric Loader
- Fabric API
- Touhou Little Maid: Oriheme (Unofficial Fabric Port)
- Forge Config API Port
💻 In-Game Commands (/tlmchat)
You can manage orders, triggers, and replies directly inside Minecraft using the /tlmchat command tree:
| Command | Usage & Description |
|---|---|
/tlmchat setup |
Prints a quick setup guide and list of useful command examples. |
/tlmchat addreply "<triggers>" "<replies>" |
Teaches maids how to respond to chat phrases. Multiple replies separated by | are chosen at random. Example: /tlmchat addreply "ping" "pong!|ping back!" |
/tlmchat addorder <id> "<triggers>" |
Adds new trigger phrases to an existing order ID. Example: /tlmchat addorder sit "sit down|rest" |
/tlmchat addorderreply <id> "<replies>" |
Adds custom maid reactions/dialogue when a specific order ID is executed. |
/tlmchat triggers <id> |
Displays all registered trigger keywords for the specified order ID. |
/tlmchat help <id> |
Displays the description and purpose of a specific order ID. |
📜 Chat Commands & Triggers
Command triggers support multiple natural phrases separated by | aliases. Below is a breakdown of default available commands:
🤺 Combat & Equipment
| Command / Trigger | Action |
|---|---|
gear up, attack, fight, throw hands |
Equips appropriate weapon and sets combat task |
sword, melee, use sword, protect me |
Equips sword & sets melee attack task |
axe, chop, equip axe, use axe |
Equips axe & sets melee attack task |
bow, use bow, ranged, take aim |
Equips bow & sets ranged attack task |
crossbow, equip crossbow, use crossbow |
Equips crossbow & sets crossbow attack task |
trident, smite em, water spear, lightning fork |
Equips trident & sets trident attack task |
danmaku, gohei, magical girl, bullethell |
Equips Gohei wand & sets Danmaku attack task |
relax, at ease, take a break, chill |
Switches maid back to Idle task |
🏡 Position & Movement
| Command / Trigger | Action |
|---|---|
sit, sit down, take a seat, rest |
Makes the maid sit |
stay, wait here, don't move, stay put |
Holds current position |
follow, come on, let's go, up, stand |
Commands maid to stand and follow |
set home, save home, remember this spot |
Saves current location as maid's home |
go home, head home, return home |
Commands maid to walk back to saved home |
grounded, stay inside, lockdown |
Restricts maid to home position and locks permissions |
ungrounded, free, you are free |
Lifts lockdown and restores standard permissions |
🌾 Tasks & Automation
| Command / Trigger | Action |
|---|---|
farm, harvest, plant, gather crops |
Standard crop farming task |
sugar cane, get sugar, cane farm |
Sugar cane harvesting task |
melon / cocoa / honey |
Melon, cocoa, or honey collecting tasks |
torch, place torches, light up, illuminate |
Torch placing task |
fishing, catch fish, fishing time |
Fishing task |
shears, shear, cut wool, wool |
Animal shearing task |
milk, get milk, milk cow |
Cow milking task |
feed me, gimme food, hungry |
Player feeding task |
feed pets, breed animals |
Animal feeding/breeding task |
extinguish, put out fire, help fire |
Fire extinguishing task |
board games, play game, let's play |
Board games task |
⚙️ Behavior & Config Toggles
| Command / Trigger | Action |
|---|---|
open door / close door |
Toggle door opening access |
open gate / close gate |
Toggle fence gate opening access |
climb / stop climbing |
Toggle active wall climbing |
mute / unmute |
Toggle vocalization sounds |
show bubble / hide bubble |
Toggle chat speech bubbles |
ride / on foot |
Toggle mob and broom riding |
pickup / no pickup |
Enable/disable item & XP ground pickup |
pickup all / pickup xp / pickup item |
Set specific pickup filters |
day shift / night shift / full shift |
Change maid work schedule |
🛠️ Configuration Files
On first run, two configuration files are generated in your .minecraft/config/ directory:
TCM_orders_config.json: Defines order IDs, trigger keywords, and descriptions.chatty_maids_replies_config.json: Defines trigger words and possible responses (randomly picked using|separation).
Both files can be modified directly or updated dynamically using /tlmchat commands in-game.
📄 License
This project is licensed under the MIT License - see the LICENSE file for details. Feel free to use, modify, redistribute, or include it in any project or video.
