# 1.5.3 Update Log

• Added a fallback for agent asynchronous tool calls to ensure the final result is always returned on the main thread.
• Fixed a memory leak caused by circular references in the Backpack Cache (#1096), thanks to @CentaureaHO.
• Added compatibility for Traveler's Backpack.
• Fixed two site issues:
• Fixed compatibility issue with the DeepSeek site; it now supports the new v4 API.
• Fixed compatibility issue with the Fish Audio site; TTS will no longer trigger a 400 error.
• Modified the default LLM site prompt to instead direct players to register for a DeepSeek account.
• Modified the context compression mechanism: changed from detecting conversation rounds to detecting tokens, significantly improving coherence in long tasks.
• Corrected some prompts.
• Corrected molang for default models.
• Updated some translations (#1094).

# 1.5.3 Update Log

• Added a fallback for agent asynchronous tool calls to ensure the final result is always returned on the main thread.
• Fixed a memory leak caused by circular references in the Backpack Cache (#1096), thanks to @CentaureaHO.
• Added compatibility for Traveler's Backpack.
• Fixed two site issues:
• Fixed compatibility issue with the DeepSeek site; it now supports the new v4 API.
• Fixed compatibility issue with the Fish Audio site; TTS will no longer trigger a 400 error.
• Modified the default LLM site prompt to instead direct players to register for a DeepSeek account.
• Modified the context compression mechanism: changed from detecting conversation rounds to detecting tokens, significantly improving coherence in long tasks.
• Corrected some prompts.
• Corrected molang for default models.
• Updated some translations (#1094).

## Touhou Little Maid 1.5.2 Update

• Fix: Missing iron magic animation for wine fox
• Add: Minecraft Wiki query tool, maid AI chat can now call this website to look up information
• Adjust: Tool calls now support asynchronous blocking execution
• Optimize: Streamlined prompts to reduce token usage
• Optimize: Tool call fields in chat bubbles now support translation strings for a more user-friendly display
• Optimize: More user-friendly hint strings are shown during time-consuming tool calls
• Optimize: Added additional translation entries

## Touhou Little Maid 1.5.2 Update

• Fix: Missing iron magic animation for wine fox
• Add: Minecraft Wiki query tool, maid AI chat can now call this website to look up information
• Adjust: Tool calls now support asynchronous blocking execution
• Optimize: Streamlined prompts to reduce token usage
• Optimize: Tool call fields in chat bubbles now support translation strings for a more user-friendly display
• Optimize: More user-friendly hint strings are shown during time-consuming tool calls
• Optimize: Added additional translation entries

# 1.5.1 Touhou Little Maid — Changelog

## Bug Fixes

### Maid Behavior Fixes

• Fixed: Maid stealing her own food while eating, causing the eating animation to loop indefinitely
• Fixed: Right-clicking while the maid holds an instrument from Immersive Melodies causes the instrument to drop
• Fixed: Curios accessories not dropping correctly upon maid death (by CentaureaHO)
• Fixed: Food completely disappearing after the maid finishes eating when Accessorify is installed
• Fixed: Game crash caused by an excessively long persona system prompt in AI chat

### Model & Rendering Fixes

• Fixed: Certain default model issues — the Bridal Kitsune model not rendering when at low health

### Create Mod Compatibility Fixes

• Fixed: Destroying a Create Rotating Display block dropping an extra figurine item
• Fixed: Maid riding a Create Seat not rotating with the overall structure's orientation

### Block & Item Fixes

• Fixed: Snack Cabinet not dropping its contents when broken

### Mod Compatibility Fixes

• Fixed: Curios accessory slots unable to turn pages under NeoForge 1.21.1
• Fixed: Broom hitbox abnormality when installed alongside Alex's Caves (by CentaureaHO)
• Fixed: Conflict between broom riding and Leawind's Third Person (by CentaureaHO)

### AI / Network Interface Fixes

• Fixed: SiliconFlow speech recognition returning HTTP 422 errors
• Fixed: Multiple compatibility issues when using newer models such as GPT-4.5 with the updated OpenAI API

## Performance Optimizations

• Optimized: Refactored the rendering logic for item forms, significantly reducing render time for item figurines and seats
• Optimized: Improved the display logic for maid attribute values to prevent UI display abnormalities caused by value overflow

## AI Agent Updates

The maid's AI chat functionality has been significantly refactored in this update, with systematic optimizations based on mainstream Agent architecture design principles. Currently, only the **Touhou Little Maid: Epistalove** add-on has a known compatibility crash; all other add-ons are compatible.

### Provider Support Updates

• Updated model lists for providers including Aliyun, SiliconFlow, OpenAI, and others to their latest versions
• Removed Tencent Hunyuan provider
• Added the following default providers:
• Gemini
• Grok
• OpenRouter
• GLM
• MiniMax (supports both LLM and TTS)
• KiMi
• Tencent Cloud (ASR only)

### UI Interaction Improvements

This update significantly lowers the barrier for configuring AI-related features and greatly improves ease of use.

• All AI chat-related settings have been unified into the UI panel opened by pressing **T** while facing the maid; the corresponding tabs in the maid's original GUI have been removed
• The UI panel includes: provider settings, maid persona prompt editor, chat history viewer and deleter, LLM / TTS / language options, and provider configuration modules
• The panel displays real-time cumulative Token usage
• Provider configuration now includes an authentication mechanism, with full consideration for single-player, LAN, dedicated server host, and client scenarios — server administrators no longer need to worry about key and configuration security
• Provider configuration can now be fully modified in-game without manually editing JSON config files
• The chat input box supports using the up/down arrow keys to quickly recall previous inputs for re-editing
• A "None" option has been added to TTS provider selection, allowing players to disable speech synthesis on the client side

### AI Chat Functionality Refactor

• Prompt Optimization**
• The maid can now more accurately recognize player intent and call the correct tools
• Highly relevant contextual information is automatically injected into each conversation to improve instruction recognition efficiency

• Conversation Robustness Improvements**
• When a large model hallucinates or incorrectly calls a tool, the system will automatically trigger a retry mechanism to guide the model to self-correct
• Message history structure is validated before each conversation to prevent HTTP 400 errors (previously triggered frequently when using models such as DeepSeek)
• If the associated maid entity no longer exists, the conversation session will be immediately terminated to prevent erroneous calls

• Cache Hit Rate Optimization** (improving cache hit rate effectively reduces API costs and speeds up model responses)
• Conversation cache hit rate has been improved from approximately 50% to approximately 85%

• Tool Call Adjustments**
• Added more callable tools, including: toggling the maid's sit state, Home mode, work schedule, setting attack targets, etc.
• Increased the maximum number of rounds in a tool call chain and introduced multiple circuit-breaker mechanisms to support AI combining multiple tool calls for complex operations while preventing infinite loops that could cause abnormal Token consumption
• Some game context with rich content is now fetched on-demand via the tool call mechanism, reducing baseline Token usage
• Use the command /tlm ai_chat context to output all currently available game context information
• Use the command /tlm ai_chat tool to output all currently available tool lists

• Skill System**
• Added the Skill system: standard Skill files can be placed in a specified path within the config folder or data pack, and the system will inject them into the conversation context at the appropriate time
• A built-in default Skill is included, containing knowledge about the maid mod itself, enabling the maid to correctly answer questions about the mod
• Use the command /tlm ai_chat skill to output all currently loaded Skills

• Context Compression**
• When the conversation history reaches a certain length, the system will automatically compress and summarize the history, preserving conversation continuity while effectively reducing Token usage

• UI Feedback Improvements**
• When the maid executes a tool call, the chat bubble will refresh in real time to display the current tool call status, reducing player confusion during wait times
• Adjusted the maximum width of regular text chat bubbles to prevent overly long single lines from affecting readability

## New Content

### New Models

• Updated: K Snail model
• Added: Holy Kitsune, Elf Kitsune (Starfield), Survivor Kitsune (Rosemist), Mini Kitsune (White Polarbear), Tactical Kitsune (Sodaball Pixel)
• Added: Nian Gao Fox (Perfect Freeze)
• Added: Missing characters from Touhou Kinjokyou (FumoFumo)
• Updated: Reimu and Marisa models (CrystalSun)

### Sophisticated Backpacks Support

Added compatibility support for Sophisticated Backpacks: after placing a Sophisticated Backpack in the maid's Curios slot, the maid can interact with the backpack normally, including taking out and putting in items. (by CentaureaHO)

### Mini Maid Fairy

When a maid fairy spawns, there is now a **10%** chance to spawn a Mini Maid Fairy instead. The Mini Maid Fairy has a slightly higher flight speed than a regular maid fairy and drops double P-Points upon being killed.

## FallbackIngredient

Added the FallbackIngredient recipe ingredient type, used to implement differentiated crafting inputs in a multi-mod environment (the design concept is similar to the multi-mod adaptation approach of the Avaritia crafting table).

This ingredient type iterates through the fallbacks list in order and selects the first entry whose corresponding mod is installed as the actual crafting input, implementing logic such as "use item from mod A if installed, otherwise fall back to B".

• Usage Example:**

The following recipe demonstrates an altar recipe that uses the millstone from kaleidoscope_cookery if that mod is present, otherwise falls back to vanilla planks, while always requiring a diamond as a fixed ingredient:

``json
{
"type": "touhou_little_maid:altar_recipe",
"output": {
"item": "touhou_little_maid:bookshelf",
"count": 1
},
"power": 0.1,
"ingredients": [
{
// Required type parameter
"type": "touhou_little_maid:fallback_ingredient",
// Ordered list; the first entry whose mod is installed will be used as the actual input
"fallbacks": [
{
// Use the millstone from kaleidoscope_cookery if present
"modid": "kaleidoscope_cookery",
"value": {
"item": "kaleidoscope_cookery:millstone"
}
},
{
// Fallback: use vanilla planks (tag matching)
"modid": "minecraft",
"value": {
"tag": "minecraft:planks"
}
}
]
},
// Fixed ingredient: diamond (vanilla Ingredient syntax)
{
"tag": "forge:gems/diamond"
}
]
}
``

# 1.5.1 Touhou Little Maid — Changelog

## Bug Fixes

### Maid Behavior Fixes

• Fixed: Maid stealing her own food while eating, causing the eating animation to loop indefinitely
• Fixed: Right-clicking while the maid holds an instrument from Immersive Melodies causes the instrument to drop
• Fixed: Curios accessories not dropping correctly upon maid death (by CentaureaHO)
• Fixed: Food completely disappearing after the maid finishes eating when Accessorify is installed
• Fixed: Game crash caused by an excessively long persona system prompt in AI chat

### Model & Rendering Fixes

• Fixed: Certain default model issues — the Bridal Kitsune model not rendering when at low health

### Create Mod Compatibility Fixes

• Fixed: Destroying a Create Rotating Display block dropping an extra figurine item
• Fixed: Maid riding a Create Seat not rotating with the overall structure's orientation

### Block & Item Fixes

• Fixed: Snack Cabinet not dropping its contents when broken

### Mod Compatibility Fixes

• Fixed: Curios accessory slots unable to turn pages under NeoForge 1.21.1
• Fixed: Broom hitbox abnormality when installed alongside Alex's Caves (by CentaureaHO)
• Fixed: Conflict between broom riding and Leawind's Third Person (by CentaureaHO)

### AI / Network Interface Fixes

• Fixed: SiliconFlow speech recognition returning HTTP 422 errors
• Fixed: Multiple compatibility issues when using newer models such as GPT-4.5 with the updated OpenAI API

## Performance Optimizations

• Optimized: Refactored the rendering logic for item forms, significantly reducing render time for item figurines and seats
• Optimized: Improved the display logic for maid attribute values to prevent UI display abnormalities caused by value overflow

## AI Agent Updates

The maid's AI chat functionality has been significantly refactored in this update, with systematic optimizations based on mainstream Agent architecture design principles. Currently, only the **Touhou Little Maid: Epistalove** add-on has a known compatibility crash; all other add-ons are compatible.

### Provider Support Updates

• Updated model lists for providers including Aliyun, SiliconFlow, OpenAI, and others to their latest versions
• Removed Tencent Hunyuan provider
• Added the following default providers:
• Gemini
• Grok
• OpenRouter
• GLM
• MiniMax (supports both LLM and TTS)
• KiMi
• Tencent Cloud (ASR only)

### UI Interaction Improvements

This update significantly lowers the barrier for configuring AI-related features and greatly improves ease of use.

• All AI chat-related settings have been unified into the UI panel opened by pressing **T** while facing the maid; the corresponding tabs in the maid's original GUI have been removed
• The UI panel includes: provider settings, maid persona prompt editor, chat history viewer and deleter, LLM / TTS / language options, and provider configuration modules
• The panel displays real-time cumulative Token usage
• Provider configuration now includes an authentication mechanism, with full consideration for single-player, LAN, dedicated server host, and client scenarios — server administrators no longer need to worry about key and configuration security
• Provider configuration can now be fully modified in-game without manually editing JSON config files
• The chat input box supports using the up/down arrow keys to quickly recall previous inputs for re-editing
• A "None" option has been added to TTS provider selection, allowing players to disable speech synthesis on the client side

### AI Chat Functionality Refactor

• Prompt Optimization**
• The maid can now more accurately recognize player intent and call the correct tools
• Highly relevant contextual information is automatically injected into each conversation to improve instruction recognition efficiency

• Conversation Robustness Improvements**
• When a large model hallucinates or incorrectly calls a tool, the system will automatically trigger a retry mechanism to guide the model to self-correct
• Message history structure is validated before each conversation to prevent HTTP 400 errors (previously triggered frequently when using models such as DeepSeek)
• If the associated maid entity no longer exists, the conversation session will be immediately terminated to prevent erroneous calls

• Cache Hit Rate Optimization** (improving cache hit rate effectively reduces API costs and speeds up model responses)
• Conversation cache hit rate has been improved from approximately 50% to approximately 85%

• Tool Call Adjustments**
• Added more callable tools, including: toggling the maid's sit state, Home mode, work schedule, setting attack targets, etc.
• Increased the maximum number of rounds in a tool call chain and introduced multiple circuit-breaker mechanisms to support AI combining multiple tool calls for complex operations while preventing infinite loops that could cause abnormal Token consumption
• Some game context with rich content is now fetched on-demand via the tool call mechanism, reducing baseline Token usage
• Use the command /tlm ai_chat context to output all currently available game context information
• Use the command /tlm ai_chat tool to output all currently available tool lists

• Skill System**
• Added the Skill system: standard Skill files can be placed in a specified path within the config folder or data pack, and the system will inject them into the conversation context at the appropriate time
• A built-in default Skill is included, containing knowledge about the maid mod itself, enabling the maid to correctly answer questions about the mod
• Use the command /tlm ai_chat skill to output all currently loaded Skills

• Context Compression**
• When the conversation history reaches a certain length, the system will automatically compress and summarize the history, preserving conversation continuity while effectively reducing Token usage

• UI Feedback Improvements**
• When the maid executes a tool call, the chat bubble will refresh in real time to display the current tool call status, reducing player confusion during wait times
• Adjusted the maximum width of regular text chat bubbles to prevent overly long single lines from affecting readability

## New Content

### New Models

• Updated: K Snail model
• Added: Holy Kitsune, Elf Kitsune (Starfield), Survivor Kitsune (Rosemist), Mini Kitsune (White Polarbear), Tactical Kitsune (Sodaball Pixel)
• Added: Nian Gao Fox (Perfect Freeze)
• Added: Missing characters from Touhou Kinjokyou (FumoFumo)
• Updated: Reimu and Marisa models (CrystalSun)

### Sophisticated Backpacks Support

Added compatibility support for Sophisticated Backpacks: after placing a Sophisticated Backpack in the maid's Curios slot, the maid can interact with the backpack normally, including taking out and putting in items. (by CentaureaHO)

### Mini Maid Fairy

When a maid fairy spawns, there is now a **10%** chance to spawn a Mini Maid Fairy instead. The Mini Maid Fairy has a slightly higher flight speed than a regular maid fairy and drops double P-Points upon being killed.

## FallbackIngredient

Added the FallbackIngredient recipe ingredient type, used to implement differentiated crafting inputs in a multi-mod environment (the design concept is similar to the multi-mod adaptation approach of the Avaritia crafting table).

This ingredient type iterates through the fallbacks list in order and selects the first entry whose corresponding mod is installed as the actual crafting input, implementing logic such as "use item from mod A if installed, otherwise fall back to B".

• Usage Example:**

The following recipe demonstrates an altar recipe that uses the millstone from kaleidoscope_cookery if that mod is present, otherwise falls back to vanilla planks, while always requiring a diamond as a fixed ingredient:

``json
{
"type": "touhou_little_maid:altar_recipe",
"output": {
"item": "touhou_little_maid:bookshelf",
"count": 1
},
"power": 0.1,
"ingredients": [
{
// Required type parameter
"type": "touhou_little_maid:fallback_ingredient",
// Ordered list; the first entry whose mod is installed will be used as the actual input
"fallbacks": [
{
// Use the millstone from kaleidoscope_cookery if present
"modid": "kaleidoscope_cookery",
"value": {
"item": "kaleidoscope_cookery:millstone"
}
},
{
// Fallback: use vanilla planks (tag matching)
"modid": "minecraft",
"value": {
"tag": "minecraft:planks"
}
}
]
},
// Fixed ingredient: diamond (vanilla Ingredient syntax)
{
"tag": "forge:gems/diamond"
}
]
}
``

# Touhou Little Maid 1.5.0 Changelog

## New Features

### Snack Cabinet

• The snack cabinet provides 27 slots of storage space
• When block-type food is placed on top, it will render two types of display windows

### Maid Snacking Mechanic

• Maids will now place food from their inventory onto specific blocks
• Maids will now sneak food from specific blocks
• Supported blocks:
• Snack Cabinet from Touhou Little Maid
• All tables from Kaleidoscope Cookery
• Supported food sources:
• Vanilla cake
• Block-type food from Kaleidoscope Cookery
• Cakes from [JMC] Just More Cakes! (some effects will also be applied)
• Block-type food from Farmer's Delight: including feast-type food and three types of pies, may be compatible with some addons

### Soul Seal Owner Check Mechanism

• Initial soul spell will now bind to players
• A prompt will be displayed when the owner does not match

### New Maid Attributes

Fully integrated maid attributes from the Maid Attributes mod, now allowing more attribute adjustments (no changes by default). Thanks to 墨染琴弦

| ID | Name | Description |
| :--: | :---: | :--: |
| touhou_little_maid:maid_crossbow_attack_speed | Maid Crossbow Attack Speed | Speed multiplier for maid crossbow shooting |
| touhou_little_maid:maid_gun_attack_speed | Maid Gun Attack Speed | Speed multiplier for maid gun shooting (TaCZ/Excellent Front) (may not exceed the gun's maximum fire rate) |
| touhou_little_maid:maid_passive_use_shield_tick | Maid Shield Duration | Duration of a single shield raise by the maid |
| touhou_little_maid:maid_pickup_range | Maid Pickup Range | Range for maid to pick up dropped items/experience orbs/P points |
| touhou_little_maid:maid_shoot_cooldown | Maid Shooting Cooldown | Cooldown after a single shot (bow, crossbow) |
| touhou_little_maid:maid_trident_cooldown | Maid Trident Shooting Cooldown | Cooldown after throwing a trident |
| touhou_little_maid:maid_use_item_speed | Maid Item Use Speed | Speed multiplier for maid item usage |
| touhou_little_maid:maid_hunger | Maid Hunger | Not currently used by the mod, available for other mods to use |

• Maid melee attacks are now affected by weapon attack speed
• The distance at which players can open the maid GUI is now affected by the entity_reach attribute

### Pathfinding Teleport Block Blacklist

Added a block blacklist mechanism for maid pathfinding and teleportation, effectively preventing maids from teleporting or pathfinding onto dangerous blocks. Thanks to 炜尔 for helping add these

Currently added dangerous blocks from the following mods:

• Create: Mechanical Saw, Crushing Wheel
• Create Crafts & Additions: Barbed Wire
• The Bumblezone: Heavy Air, Windy Air
• Farmer's Delight: Stove
• Twilight Forest: Hedge, Fiery Block, Knightmetal Block
• Alex's Caves: Primal Magma
• Mekanism: Fusion Reactor Frame, SPS Casing
• Immersive Engineering: Razor Wire
• Iron's Spells 'n Spellbooks: Brazier, Soul Brazier
• Mob Grinding Utils: Spikes, Saw

### Iron's Spells Animation Compatibility

After the next version of Touhou Little Maid: Spell and other mods update, related animations will play when maids cast spells. Thanks to animator 艾雷克亚

This API can also be used by other mods to add more animations. Thanks to Gardel for designing the API. For usage, see: [#994](https://github.com/TartaricAcid/TouhouLittleMaid/pull/994)

### Curios Mod Compatibility

• Added configuration option to selectively disable Curios compatibility
• Curios mod only guarantees no serious issues like game crashes, usability is not guaranteed
• Over forty related mods have been tested with no crashes found. Thanks to 炜尔 for helping test
• Public link: [Tencent Docs - Touhou Little Maid Curios Compatibility Table](https://docs.qq.com/sheet/DSnFYbVFxQnpWSGhU?tab=BB08J2)

### Default Model Updates

• Synced different YSM fox sleeping animations. Thanks to 小莫莫
• Added Nine-tailed Wine Fox, fixed and updated Magic Wine Fox. Thanks to 星海境
• Added Wedding Wine Fox. Thanks to 羊毛 Official
• Added old Taisho Fox model. Thanks to 亚利特泽克西斯
• Added some new Touhou Project characters. Thanks to Cyra

## Improvements

### Maid AI Dialogue Optimization

Thanks to Minner2018

• Function call feature is now enabled by default, allowing maids to better understand and execute player commands
• Optimized command execution logic to avoid duplicate operations
• When switching work modes via AI dialogue, now supports switching between all work modes (not just attack modes), and will automatically select the correct tools
• Added the ability to toggle follow state via dialogue
• Improved accuracy of maid command recognition

### Maid Expression Update

Updated maid expressions. Thanks to 萌玖moe
<img src="https://s2.loli.net/2026/01/23/94e6hLCHmV8aFjb.jpg" style="width: 500px"></img>

### Immersive Melodies Mod Animation

• Now uses the same animation as YSM 2.6. Thanks to animator 星屑海螺
• Added partial molang support for Immersive Melodies mod

### Synced YSM Molang Functions and Variables

• Synced first-order and second-order functions
• Synced ysm.input_vertical and ysm.input_horizontal

### Bedrock Model Rendering

• Fixed rendering issues with Bedrock models
• Added support for uv_rotation parameter

### Other Improvements

• Accessory slots (both maid's own and Curios) now prioritize placing items in accessory slots when shift-clicking
• Altar construction check is more lenient, now works in any orientation as long as you click on the middle two wool blocks
• Enabled entity persistence, may resolve hard-to-reproduce maid entity loss issues
• Maids no longer take damage from berry bushes (but will still avoid them)
• Gohei durability increased from 300 to 1200 points

## Bug Fixes

• Fixed incorrect maid crafting output in Altar KJS. Thanks to XiaoDengPiaoPiao
• Fixed issue where maids and players would dismount from creepers when riding brooms
• Fixed issue where trumpet and bell could not recall mounted maids
• Fixed maid eating abnormal state issue ([#1017](https://github.com/TartaricAcid/TouhouLittleMaid/issues/1017)). Thanks to ethan_trum

## Other

• Added additional translations

# Touhou Little Maid 1.5.0 Changelog

## New Features

### Snack Cabinet

• The snack cabinet provides 27 slots of storage space
• When block-type food is placed on top, it will render two types of display windows

### Maid Snacking Mechanic

• Maids will now place food from their inventory onto specific blocks
• Maids will now sneak food from specific blocks
• Supported blocks:
• Snack Cabinet from Touhou Little Maid
• All tables from Kaleidoscope Cookery
• Supported food sources:
• Vanilla cake
• Block-type food from Kaleidoscope Cookery
• Cakes from [JMC] Just More Cakes! (some effects will also be applied)
• Block-type food from Farmer's Delight: including feast-type food and three types of pies, may be compatible with some addons

### Soul Seal Owner Check Mechanism

• Initial soul spell will now bind to players
• A prompt will be displayed when the owner does not match

### New Maid Attributes

Fully integrated maid attributes from the Maid Attributes mod, now allowing more attribute adjustments (no changes by default). Thanks to 墨染琴弦

| ID | Name | Description |
| :--: | :---: | :--: |
| touhou_little_maid:maid_crossbow_attack_speed | Maid Crossbow Attack Speed | Speed multiplier for maid crossbow shooting |
| touhou_little_maid:maid_gun_attack_speed | Maid Gun Attack Speed | Speed multiplier for maid gun shooting (TaCZ/Excellent Front) (may not exceed the gun's maximum fire rate) |
| touhou_little_maid:maid_passive_use_shield_tick | Maid Shield Duration | Duration of a single shield raise by the maid |
| touhou_little_maid:maid_pickup_range | Maid Pickup Range | Range for maid to pick up dropped items/experience orbs/P points |
| touhou_little_maid:maid_shoot_cooldown | Maid Shooting Cooldown | Cooldown after a single shot (bow, crossbow) |
| touhou_little_maid:maid_trident_cooldown | Maid Trident Shooting Cooldown | Cooldown after throwing a trident |
| touhou_little_maid:maid_use_item_speed | Maid Item Use Speed | Speed multiplier for maid item usage |
| touhou_little_maid:maid_hunger | Maid Hunger | Not currently used by the mod, available for other mods to use |

• Maid melee attacks are now affected by weapon attack speed
• The distance at which players can open the maid GUI is now affected by the entity_reach attribute

### Pathfinding Teleport Block Blacklist

Added a block blacklist mechanism for maid pathfinding and teleportation, effectively preventing maids from teleporting or pathfinding onto dangerous blocks. Thanks to 炜尔 for helping add these

Currently added dangerous blocks from the following mods:

• Create: Mechanical Saw, Crushing Wheel
• Create Crafts & Additions: Barbed Wire
• The Bumblezone: Heavy Air, Windy Air
• Farmer's Delight: Stove
• Twilight Forest: Hedge, Fiery Block, Knightmetal Block
• Alex's Caves: Primal Magma
• Mekanism: Fusion Reactor Frame, SPS Casing
• Immersive Engineering: Razor Wire
• Iron's Spells 'n Spellbooks: Brazier, Soul Brazier
• Mob Grinding Utils: Spikes, Saw

### Iron's Spells Animation Compatibility

After the next version of Touhou Little Maid: Spell and other mods update, related animations will play when maids cast spells. Thanks to animator 艾雷克亚

This API can also be used by other mods to add more animations. Thanks to Gardel for designing the API. For usage, see: [#994](https://github.com/TartaricAcid/TouhouLittleMaid/pull/994)

### Curios Mod Compatibility

• Added configuration option to selectively disable Curios compatibility
• Curios mod only guarantees no serious issues like game crashes, usability is not guaranteed
• Over forty related mods have been tested with no crashes found. Thanks to 炜尔 for helping test
• Public link: [Tencent Docs - Touhou Little Maid Curios Compatibility Table](https://docs.qq.com/sheet/DSnFYbVFxQnpWSGhU?tab=BB08J2)

### Default Model Updates

• Synced different YSM fox sleeping animations. Thanks to 小莫莫
• Added Nine-tailed Wine Fox, fixed and updated Magic Wine Fox. Thanks to 星海境
• Added Wedding Wine Fox. Thanks to 羊毛 Official
• Added old Taisho Fox model. Thanks to 亚利特泽克西斯
• Added some new Touhou Project characters. Thanks to Cyra

## Improvements

### Maid AI Dialogue Optimization

Thanks to Minner2018

• Function call feature is now enabled by default, allowing maids to better understand and execute player commands
• Optimized command execution logic to avoid duplicate operations
• When switching work modes via AI dialogue, now supports switching between all work modes (not just attack modes), and will automatically select the correct tools
• Added the ability to toggle follow state via dialogue
• Improved accuracy of maid command recognition

### Maid Expression Update

Updated maid expressions. Thanks to 萌玖moe
<img src="https://s2.loli.net/2026/01/23/94e6hLCHmV8aFjb.jpg" style="width: 500px"></img>

### Immersive Melodies Mod Animation

• Now uses the same animation as YSM 2.6. Thanks to animator 星屑海螺
• Added partial molang support for Immersive Melodies mod

### Synced YSM Molang Functions and Variables

• Synced first-order and second-order functions
• Synced ysm.input_vertical and ysm.input_horizontal

### Bedrock Model Rendering

• Fixed rendering issues with Bedrock models
• Added support for uv_rotation parameter

### Other Improvements

• Accessory slots (both maid's own and Curios) now prioritize placing items in accessory slots when shift-clicking
• Altar construction check is more lenient, now works in any orientation as long as you click on the middle two wool blocks
• Enabled entity persistence, may resolve hard-to-reproduce maid entity loss issues
• Maids no longer take damage from berry bushes (but will still avoid them)
• Gohei durability increased from 300 to 1200 points

## Bug Fixes

• Fixed incorrect maid crafting output in Altar KJS. Thanks to XiaoDengPiaoPiao
• Fixed issue where maids and players would dismount from creepers when riding brooms
• Fixed issue where trumpet and bell could not recall mounted maids
• Fixed maid eating abnormal state issue ([#1017](https://github.com/TartaricAcid/TouhouLittleMaid/issues/1017)). Thanks to ethan_trum

## Other

• Added additional translations

## 1.4.6 Changelog

• Fixed issue where maids couldn't traverse certain special blocks with collision volumes smaller than 0.5, such as various mod pipes (Thanks to @guapi-exe)
• Completely replaced with new emoji pack created by Nanaya
• Fixed texture issues with Taisho Maid Wine Fox (Thanks to @Tex_official)
• Fixed crash issues with JEI, REI, and EMI when opening maids with furnace and crafting table backpacks
• Fixed incorrect maid death notification messages
• Fixed compatibility issues with KubeJS 7.2 version (1.21.1 NeoForge, Thanks to @LootDust)
• Updated some translation texts

## 1.4.6 Changelog

• Fixed issue where maids couldn't traverse certain special blocks with collision volumes smaller than 0.5, such as various mod pipes (Thanks to @guapi-exe)
• Completely replaced with new emoji pack created by Nanaya
• Fixed texture issues with Taisho Maid Wine Fox (Thanks to @Tex_official)
• Fixed crash issues with JEI, REI, and EMI when opening maids with furnace and crafting table backpacks
• Fixed incorrect maid death notification messages
• Fixed compatibility issues with KubeJS 7.2 version (1.21.1 NeoForge, Thanks to @LootDust)
• Updated some translation texts

• Rolled back the neighbor node caching feature and removed related code to prevent the maid from suddenly stopping pathfinding and getting stuck
• The leash is now fixed to the maid's hand
• Added a new maid GIF emoji pack

• Rolled back the neighbor node caching feature and removed related code to prevent the maid from suddenly stopping pathfinding and getting stuck
• The leash is now fixed to the maid's hand
• Added a new maid GIF emoji pack

• Fixed crash issues that may occur due to cached reflections during pathfinding
• Added small fox model (Thanks to @Rou_Ti)

• Fixed crash issues that may occur due to cached reflections during pathfinding
• Added small fox model (Thanks to @Rou_Ti)

• Added MaidBackpackChangeEvent that triggers when maid backpack items are removed or equipped
• Added MaidBaubleChangeEvent that triggers when maid bauble items are removed or equipped
• Added hasBaubleItemInMaid method to ItemsUtil for O(1) efficiency quick judgment of bauble existence
• Fixed compatibility crash issue with Touhou Little Maid: Spell mod

• Added MaidBackpackChangeEvent that triggers when maid backpack items are removed or equipped
• Added MaidBaubleChangeEvent that triggers when maid bauble items are removed or equipped
• Added hasBaubleItemInMaid method to ItemsUtil for O(1) efficiency quick judgment of bauble existence
• Fixed compatibility crash issue with Touhou Little Maid: Spell mod

# TLM 1.4.2 Changelog

## Bug Fixes

• Fixed Gomoku game related issues
• Resolved crash when filling the entire Gomoku board in MC 1.21.1
• Fixed Kappa compass coordinate writing logic
• Added dimension consistency check when writing subsequent coordinates
• Fixed equipment interaction issues
• Resolved attribute not updating when Shift + clicking to equip/unequip armor
• Fixed model display issues
• Resolved YSM model animations not playing in statues and Garage Kits

## New Features

• Maid task list interface optimization (Thanks: @[sch246](https://github.com/TartaricAcid/TouhouLittleMaid/commits?author=sch246))
• Left-side task list now supports mouse wheel scrolling
• Maid pathfinding system performance optimization (Thanks: @小鱼飘飘)
• Added neighbor node caching mechanism to improve pathfinding efficiency
• Implemented item pickup delay and alignment functionality
• Optimized query performance for burning blocks
• Maid entity backup functionality
• Maid entity backup feature is now enabled by default for data security
• Complete bauble system redesign
• Bauble slots expanded to 30 slots, improving mod compatibility
• Enhanced bauble interface with rich methods and event mechanisms, supporting advanced features like attribute modification
• Full KubeJS compatibility support
• Adopted variable-length Map data structure for bauble information storage, significantly improving traversal performance
• Brand new bauble interface design with independent page layout (Thanks @YSBB for the new GUI design)
• Added favorability-based bauble slot unlocking mechanism
• Developer interface extensions
• Added MaidFavorabilityLevelChangeEvent favorability change event
• Added isHidden method to IMaidTask interface for task hiding functionality
• Chat bubble system redesign
• Support for custom kaomoji content via datapack touhou_little_maid:chat_bubble/kaomoji.json
• Support for reading PNG/GIF emoji from resource pack textures/chat_bubble/maid_emoji directory
• Support for custom emoji display size via filename suffix (e.g., -64x64, max 256px)
• Added configuration options for kaomoji and emoji weight, display frequency, etc.
• Model content updates
• Synchronized with YSM 2.5.x version new models: expanded Wine Fox and Sta Bo, added kluonoa model
• Chess game endgame system
• Cartographer houses and stronghold libraries randomly generate endgame items
• Board State items can be right-clicked on corresponding boards to set up endgames
• Item tooltips display endgame preview thumbnails
• Support for custom endgames via datapacks, add more endgames at the following locations:
• touhou_little_maid:board_states/chess.json - International Chess
• touhou_little_maid:board_states/gomoku.json - Gomoku
• touhou_little_maid:board_states/xiangqi.json - Chinese Xiangqi
• Chess games use standard FEN format description, can be exported using software like Chess Wizard
• Gomoku uses custom format, can arrange pieces with stick in Creative mode, then click the box with stick to export game data
• User interface optimization
• Added search functionality to maid model switching interface (Thanks: @[QiChenSn](https://github.com/QiChenSn))

# TLM 1.4.2 Changelog

## Bug Fixes

• Fixed Gomoku game related issues
• Resolved crash when filling the entire Gomoku board in MC 1.21.1
• Fixed Kappa compass coordinate writing logic
• Added dimension consistency check when writing subsequent coordinates
• Fixed equipment interaction issues
• Resolved attribute not updating when Shift + clicking to equip/unequip armor
• Fixed model display issues
• Resolved YSM model animations not playing in statues and Garage Kits

## New Features

• Maid task list interface optimization (Thanks: @[sch246](https://github.com/TartaricAcid/TouhouLittleMaid/commits?author=sch246))
• Left-side task list now supports mouse wheel scrolling
• Maid pathfinding system performance optimization (Thanks: @小鱼飘飘)
• Added neighbor node caching mechanism to improve pathfinding efficiency
• Implemented item pickup delay and alignment functionality
• Optimized query performance for burning blocks
• Maid entity backup functionality
• Maid entity backup feature is now enabled by default for data security
• Complete bauble system redesign
• Bauble slots expanded to 30 slots, improving mod compatibility
• Enhanced bauble interface with rich methods and event mechanisms, supporting advanced features like attribute modification
• Full KubeJS compatibility support
• Adopted variable-length Map data structure for bauble information storage, significantly improving traversal performance
• Brand new bauble interface design with independent page layout (Thanks @YSBB for the new GUI design)
• Added favorability-based bauble slot unlocking mechanism
• Developer interface extensions
• Added MaidFavorabilityLevelChangeEvent favorability change event
• Added isHidden method to IMaidTask interface for task hiding functionality
• Chat bubble system redesign
• Support for custom kaomoji content via datapack touhou_little_maid:chat_bubble/kaomoji.json
• Support for reading PNG/GIF emoji from resource pack textures/chat_bubble/maid_emoji directory
• Support for custom emoji display size via filename suffix (e.g., -64x64, max 256px)
• Added configuration options for kaomoji and emoji weight, display frequency, etc.
• Model content updates
• Synchronized with YSM 2.5.x version new models: expanded Wine Fox and Sta Bo, added kluonoa model
• Chess game endgame system
• Cartographer houses and stronghold libraries randomly generate endgame items
• Board State items can be right-clicked on corresponding boards to set up endgames
• Item tooltips display endgame preview thumbnails
• Support for custom endgames via datapacks, add more endgames at the following locations:
• touhou_little_maid:board_states/chess.json - International Chess
• touhou_little_maid:board_states/gomoku.json - Gomoku
• touhou_little_maid:board_states/xiangqi.json - Chinese Xiangqi
• Chess games use standard FEN format description, can be exported using software like Chess Wizard
• Gomoku uses custom format, can arrange pieces with stick in Creative mode, then click the box with stick to export game data
• User interface optimization
• Added search functionality to maid model switching interface (Thanks: @[QiChenSn](https://github.com/QiChenSn))

Fixed a crash caused by loading order issues when using kubejs simultaneously

# Version 1.4.0 Update Log

• Added compatibility for PatPat mod (Thanks: Unknown)

• Fixed offset issue with snowball throwing animation

• Fixed error issue with default model animation variables

• Completed compatibility with Superb Warfare

• Requires Superb Warfare version 0.8.7.1 or higher to use
• Maids can use firearms from Superb Warfare (except Stinger missiles)
• When maids run out of ammunition, they will try to use RGO grenades in their offhand (requires main hand to have a gun and offhand to have RGO grenade)
• After picking up a maid with a saddle, right-clicking on a vehicle allows the maid to directly ride in the driver's seat
• When players ride vehicles, nearby following maids can ride in passenger seats
• Maids in driver or passenger seats can attack using vehicle weapons or handheld weapons
• Weapons placed in the back decoration slot can be displayed on the maid's back or waist

• Optimized ranged attack AI mechanism

• Ranged attacks (including gun attacks) now consider distance to avoid maid back-and-forth issues

• In ranged mode, maids will prioritize attacking creatures that are currently damaging them

• The doMobLoot rule now affects Maid Fairy's power point drops

• Removed actuallyHurt method, fixed bug where maids would die instantly when hurt on arclight servers

• Added compatibility for minimap mods

• Compatible with Xaero's Minimap mod entity icons, now Maids, Fairy Maids, Brooms, Cushions, and Power Points have their own entity radar icons
• Compatible with Journey Map mod, when maids die, death coordinates are printed in chat for convenient waypoint addition in Journey Map

• Added maid backup mechanism, can automatically backup maids and quickly restore previously backed up maids in abnormal situations

• First need to enable maid auto-backup feature in touhou_little_maid-server.toml file (disabled by default)

``toml
# Whether to enable the maid backup mechanism, this mechanism will regularly backup all player's maid data on the server
MaidBackupEnable = false
# The interval time for backing up maid data in the maid backup mechanism (in seconds)
# Range: > 5
MaidBackupIntervalSeconds = 180
# Maximum number of backups per player when maid backup mechanism is enabled
# Range: 1 ~ 64
MaidBackupMaxCount = 3
`

• The game will then regularly backup maids in loaded chunks according to the settings

• Backup uses asynchronous mechanism to avoid main server thread lag
• Backup times are randomly distributed to avoid accumulating in the same tick causing lag

• Use the /tlm backup get <player> command to view all backup data for that player, click on displayed entries for further queries

• Finally gives the command initiator a maid photo containing backup data

• Modified melee damage logic, added events

• Now calls net.minecraft.world.item.Item#hurtEnemy to trigger things after melee combat (such as durability consumption)
• Added MaidHurtTarget.Pre and MaidHurtTarget.Post` events to trigger during melee combat

• Updated some models

• Three Cirno maid models and two statue cushion models

# Version 1.4.0 Update Log

• Added compatibility for PatPat mod (Thanks: Unknown)

• Fixed offset issue with snowball throwing animation

• Fixed error issue with default model animation variables

• Completed compatibility with Superb Warfare

• Requires Superb Warfare version 0.8.7.1 or higher to use
• Maids can use firearms from Superb Warfare (except Stinger missiles)
• When maids run out of ammunition, they will try to use RGO grenades in their offhand (requires main hand to have a gun and offhand to have RGO grenade)
• After picking up a maid with a saddle, right-clicking on a vehicle allows the maid to directly ride in the driver's seat
• When players ride vehicles, nearby following maids can ride in passenger seats
• Maids in driver or passenger seats can attack using vehicle weapons or handheld weapons
• Weapons placed in the back decoration slot can be displayed on the maid's back or waist

• Optimized ranged attack AI mechanism

• Ranged attacks (including gun attacks) now consider distance to avoid maid back-and-forth issues

• In ranged mode, maids will prioritize attacking creatures that are currently damaging them

• The doMobLoot rule now affects Maid Fairy's power point drops

• Removed actuallyHurt method, fixed bug where maids would die instantly when hurt on arclight servers

• Added compatibility for minimap mods

• Compatible with Xaero's Minimap mod entity icons, now Maids, Fairy Maids, Brooms, Cushions, and Power Points have their own entity radar icons
• Compatible with Journey Map mod, when maids die, death coordinates are printed in chat for convenient waypoint addition in Journey Map

• Added maid backup mechanism, can automatically backup maids and quickly restore previously backed up maids in abnormal situations

• First need to enable maid auto-backup feature in touhou_little_maid-server.toml file (disabled by default)

``toml
# Whether to enable the maid backup mechanism, this mechanism will regularly backup all player's maid data on the server
MaidBackupEnable = false
# The interval time for backing up maid data in the maid backup mechanism (in seconds)
# Range: > 5
MaidBackupIntervalSeconds = 180
# Maximum number of backups per player when maid backup mechanism is enabled
# Range: 1 ~ 64
MaidBackupMaxCount = 3
`

• The game will then regularly backup maids in loaded chunks according to the settings

• Backup uses asynchronous mechanism to avoid main server thread lag
• Backup times are randomly distributed to avoid accumulating in the same tick causing lag

• Use the /tlm backup get <player> command to view all backup data for that player, click on displayed entries for further queries

• Finally gives the command initiator a maid photo containing backup data

• Modified melee damage logic, added events

• Now calls net.minecraft.world.item.Item#hurtEnemy to trigger things after melee combat (such as durability consumption)
• Added MaidHurtTarget.Pre and MaidHurtTarget.Post` events to trigger during melee combat

• Updated some models

• Three Cirno maid models and two statue cushion models

# 1.3.8 Maid Mod Update Log

• Fixed incorrect UV mapping issue for single-sided textures in Geckolib models (particularly noticeable with pony models, thanks to @moepus)
• Removed drop item judgment in planting mode
• Optimized pathfinding judgment for dropped items, significantly reducing performance consumption when there are many unreachable dropped items
• Updated new textures created by kang
• Fixed crash issue caused by DamageSource being null
• Fixed bug where players couldn't interact with other blocks/entities after broom collision volume increased
• Added event for tombstone generation (MaidTombstoneEvent)
• Completed addition of snowball throwing animation, thanks to @映白L
• Fixed enchantment acquisition issue in 1.21.1, now Swift and Hindrance enchantments can be obtained through enchanting table, villager trading, and fishing. Ender Slayer is a treasure enchantment, only obtainable through villager trading and fishing

# 1.3.8 Maid Mod Update Log

• Fixed incorrect UV mapping issue for single-sided textures in Geckolib models (particularly noticeable with pony models, thanks to @moepus)
• Removed drop item judgment in planting mode
• Optimized pathfinding judgment for dropped items, significantly reducing performance consumption when there are many unreachable dropped items
• Updated new textures created by kang
• Fixed crash issue caused by DamageSource being null
• Fixed bug where players couldn't interact with other blocks/entities after broom collision volume increased
• Added event for tombstone generation (MaidTombstoneEvent)
• Completed addition of snowball throwing animation, thanks to @映白L
• Fixed enchantment acquisition issue in 1.21.1, now Swift and Hindrance enchantments can be obtained through enchanting table, villager trading, and fishing. Ender Slayer is a treasure enchantment, only obtainable through villager trading and fishing

# Maid Mod 1.3.7 Update Log

## 🤖 AI System Optimization

### AI Dialogue Function Fixes

• Communication Protocol Upgrade**: Switched to HTTP 1.1 for AI dialogue communication to resolve connection errors caused by some sites not supporting HTTP 2.0 (#833)
• Context Handling Optimization**: Improved the logic for sending AI conversation history to avoid 500 errors caused by the first sentence being a tool role

### AI Performance Improvements

• Dropped Item Detection Optimization**: When maids harvest crops, they now intelligently detect the number of dropped items within their working range. If there are more than 8, they will automatically stop working and give a prompt to prevent excessive item accumulation
• Retrieval Performance Boost**: Optimized the algorithm for maids to search for nearby dropped items, reducing server performance consumption by about 3%

## 🛠️ Feature Enhancements

### Maid Gravestone System Optimization

• Thanks to contributor: [QiChenSn](https://github.com/QiChenSn)*
• Smart Prompt**: Gives a clear message when the player's inventory is full
• Force Retrieve**: Supports Shift + Click to forcibly retrieve items regardless of inventory space

### Broom Flight System Overhaul

• Control Experience Optimization**
• Greatly reduced broom inertia and vertical shaking, significantly improving control convenience
• Improved collision detection to fix getting stuck in blocks when riding
• Control Method Improvements**
• Space and Shift keys control vertical ascent/descent
• Dismount shortcut changed to C key to avoid accidental crashes
• Functionality Enhancements**
• When the maid is not on the broom, players can still press E to open the inventory
• Supports speed effect bonus; broom speed increases when the player has a speed effect
• Switching maid work modes while riding no longer causes the maid to dismount
• Developer Support**: Added broom control interface for easier integration with other mods (Note: Not compatible with the old Maid Useful Task mod)

### New Content

• Colored Bed System** (*Thanks @kang*)
• Added 6 new bed colors: white, black, yellow, blue, green, purple (pink is the original color)
• Beds can be dyed using corresponding dyes
• Command Extensions**
• /tlm maid <maid> no_ai true/false: Toggle maid AI; set to true to keep the maid stationary
• /tlm maid <maid> xp <count>: Directly set maid experience points

## 🔧 Bug Fixes

• Changed yaml to shadow jar and relocated to avoid package name conflicts with other mods

### Storage & Synchronization

• Shrine System Fix**: Fixed storage and sync issues with shrines; film storage no longer malfunctions (*Thanks: [QiChenSn](https://github.com/QiChenSn)*)
• Inventory Compatibility**: Fixed issue where items were not consumed when right-clicking a boat with a cushion

### UI & Interaction

• Config UI Stability**: Fixed crashes in the in-game maid config interface
• Animation & Posture**: Fixed maids remaining in swimming posture when moving from water to a cushion or boat

### Work Mode Fixes

• Honey Collection System**: Fixed bug where honey level was incorrectly obtained from air in honey collection mode
• Attribute Retention**: Fixed some potion effects disappearing abnormally after maid death

## 🔗 Mod Compatibility

### New Compatibility

• Inventory Tweaks - ReFoxed**: Fixed item duplication bug
• Ponder Mod**: Supports querying altar placement rules
• Sophisticated Backpacks**: Backpacks with XP pumps and tanks can right-click to extract maid XP
• Sannomiya Story**: Supports rice harvesting via new ISpecialCropHandler interface (manual planting required)

### Security Improvements

• Attack Protection**: Snowballs thrown by maids will not be attacked by mobs (e.g., Iron Golems)

## 🎯 1.21.1 Version Adaptation

• Thanks to contributor: [QiChenSn](https://github.com/QiChenSn)*
• Fixed data reading error when placing shrine lantern items
• Fixed rendering disappearance of chessboards and entertainment blocks at special angles
• Planting Logic Optimization**: Fixed abnormal behavior of sugarcane being planted in water
• Leash Functionality**: Restored normal support for leashes
• Immersive Melodies & Simple Hat**: Added compatibility support
• Carry On Mod**: Prevented picking up maid mod blocks to avoid accidental movement

## 🛡️ Security & Configuration

### Food Safety System

• Global Blacklist**: Added #touhou_little_maid:maid_eat_blocklist_item item tag
• Dangerous Item Protection**: Added Sannomiya Story chili to the food blacklist to prevent maids from dying from accidental consumption

## 📝 Developer Updates

### API Extensions

• Event System**:
• MaidAndItemTransformEvent: Maid and item transformation event
• MaidWirelessIOEvent: Maid wireless item transfer event
• Interface Design**: Added ISpecialCropHandler interface to simplify special crop planting logic

## 🌍 Localization Updates

• Updated multi-language support: Japanese, Traditional Chinese, Vietnamese, Indonesian, and more

# Maid Mod 1.3.7 Update Log

## 🤖 AI System Optimization

### AI Dialogue Function Fixes

• Communication Protocol Upgrade**: Switched to HTTP 1.1 for AI dialogue communication to resolve connection errors caused by some sites not supporting HTTP 2.0 (#833)
• Context Handling Optimization**: Improved the logic for sending AI conversation history to avoid 500 errors caused by the first sentence being a tool role

### AI Performance Improvements

• Dropped Item Detection Optimization**: When maids harvest crops, they now intelligently detect the number of dropped items within their working range. If there are more than 8, they will automatically stop working and give a prompt to prevent excessive item accumulation
• Retrieval Performance Boost**: Optimized the algorithm for maids to search for nearby dropped items, reducing server performance consumption by about 3%

## 🛠️ Feature Enhancements

### Maid Gravestone System Optimization

• Thanks to contributor: [QiChenSn](https://github.com/QiChenSn)*
• Smart Prompt**: Gives a clear message when the player's inventory is full
• Force Retrieve**: Supports Shift + Click to forcibly retrieve items regardless of inventory space

### Broom Flight System Overhaul

• Control Experience Optimization**
• Greatly reduced broom inertia and vertical shaking, significantly improving control convenience
• Improved collision detection to fix getting stuck in blocks when riding
• Control Method Improvements**
• Space and Shift keys control vertical ascent/descent
• Dismount shortcut changed to C key to avoid accidental crashes
• Functionality Enhancements**
• When the maid is not on the broom, players can still press E to open the inventory
• Supports speed effect bonus; broom speed increases when the player has a speed effect
• Switching maid work modes while riding no longer causes the maid to dismount
• Developer Support**: Added broom control interface for easier integration with other mods (Note: Not compatible with the old Maid Useful Task mod)

### New Content

• Colored Bed System** (*Thanks @kang*)
• Added 6 new bed colors: white, black, yellow, blue, green, purple (pink is the original color)
• Beds can be dyed using corresponding dyes
• Command Extensions**
• /tlm maid <maid> no_ai true/false: Toggle maid AI; set to true to keep the maid stationary
• /tlm maid <maid> xp <count>: Directly set maid experience points

## 🔧 Bug Fixes

• Changed yaml to shadow jar and relocated to avoid package name conflicts with other mods

### Storage & Synchronization

• Shrine System Fix**: Fixed storage and sync issues with shrines; film storage no longer malfunctions (*Thanks: [QiChenSn](https://github.com/QiChenSn)*)
• Inventory Compatibility**: Fixed issue where items were not consumed when right-clicking a boat with a cushion

### UI & Interaction

• Config UI Stability**: Fixed crashes in the in-game maid config interface
• Animation & Posture**: Fixed maids remaining in swimming posture when moving from water to a cushion or boat

### Work Mode Fixes

• Honey Collection System**: Fixed bug where honey level was incorrectly obtained from air in honey collection mode
• Attribute Retention**: Fixed some potion effects disappearing abnormally after maid death

## 🔗 Mod Compatibility

### New Compatibility

• Inventory Tweaks - ReFoxed**: Fixed item duplication bug
• Ponder Mod**: Supports querying altar placement rules
• Sophisticated Backpacks**: Backpacks with XP pumps and tanks can right-click to extract maid XP
• Sannomiya Story**: Supports rice harvesting via new ISpecialCropHandler interface (manual planting required)

### Security Improvements

• Attack Protection**: Snowballs thrown by maids will not be attacked by mobs (e.g., Iron Golems)

## 🎯 1.21.1 Version Adaptation

• Thanks to contributor: [QiChenSn](https://github.com/QiChenSn)*
• Fixed data reading error when placing shrine lantern items
• Fixed rendering disappearance of chessboards and entertainment blocks at special angles
• Planting Logic Optimization**: Fixed abnormal behavior of sugarcane being planted in water
• Leash Functionality**: Restored normal support for leashes
• Immersive Melodies & Simple Hat**: Added compatibility support
• Carry On Mod**: Prevented picking up maid mod blocks to avoid accidental movement

## 🛡️ Security & Configuration

### Food Safety System

• Global Blacklist**: Added #touhou_little_maid:maid_eat_blocklist_item item tag
• Dangerous Item Protection**: Added Sannomiya Story chili to the food blacklist to prevent maids from dying from accidental consumption

## 📝 Developer Updates

### API Extensions

• Event System**:
• MaidAndItemTransformEvent: Maid and item transformation event
• MaidWirelessIOEvent: Maid wireless item transfer event
• Interface Design**: Added ISpecialCropHandler interface to simplify special crop planting logic

## 🌍 Localization Updates

• Updated multi-language support: Japanese, Traditional Chinese, Vietnamese, Indonesian, and more

• Added classical Chinese translation: @BeiDou114514
• Added compatibility with KubeJS, sample files can be found at: <https://github.com/TartaricAcid/TLM-KJS-Example>
• Modified altar recipe
• Maid related events
• Customized handheld item prompts
• Customized maid bauble bindings
• Customized work task: 6 preset Task templates are built-in: blank, melee, ranged, planting, walk to block, walk to entity
• Added MaidTaskEnableEvent event to facilitate other mod authors or integration authors to modify the enabling conditions of existing work modes
• Modified prompt words to alleviate the problem of repeated sentences
• Solved the problem that --- is always output at the end of tts
• Now the melee attack range is affected by the forge:entity_reach property
• Modified the defect of the old melee enemy recognition range: now it is linked to the work range, no longer a fixed 8 block
• Updated the texture made by kang
• Updated Vietnamese and Indonesian translations
• Modified model package loading logic, tried to adapt to kilt, thanks to shiroha233
• The danmaku fired by the maid no longer hurts any player

• Added classical Chinese translation: @BeiDou114514
• Added compatibility with KubeJS, sample files can be found at: <https://github.com/TartaricAcid/TLM-KJS-Example>
• Modified altar recipe
• Maid related events
• Customized handheld item prompts
• Customized maid bauble bindings
• Customized work task: 6 preset Task templates are built-in: blank, melee, ranged, planting, walk to block, walk to entity
• Added MaidTaskEnableEvent event to facilitate other mod authors or integration authors to modify the enabling conditions of existing work modes
• Modified prompt words to alleviate the problem of repeated sentences
• Solved the problem that --- is always output at the end of tts
• Now the melee attack range is affected by the forge:entity_reach property
• Modified the defect of the old melee enemy recognition range: now it is linked to the work range, no longer a fixed 8 block
• Updated the texture made by kang
• Updated Vietnamese and Indonesian translations
• Modified model package loading logic, tried to adapt to kilt, thanks to shiroha233
• The danmaku fired by the maid no longer hurts any player

• 1.21.1 Fixed the flag rendering error
• Added API to the maid GUI interface, which can add additional buttons quickly and easily
• Added more functions to the Brain, and can add additional Brain behaviors
• Added some API design for the adaptation of UmaLittleMaid
• Fixed the problem of the Industrial Foregoing Bio Capture Tool duplicating the maid
• Modified some rendering of chat bubbles, now the rendering will take into account the ambient light, and no longer have the light bulb problem
• Fixed the problem of home logic errors in other dimensions
• Modified AI prompt words
• Fixed various problems with the standby animation and sitting animation of the wine fox
• Updated the blue wine fox material, thanks @白帆小喵L
• Updated the translation text

• 1.21.1 Fixed the flag rendering error
• Added API to the maid GUI interface, which can add additional buttons quickly and easily
• Added more functions to the Brain, and can add additional Brain behaviors
• Added some API design for the adaptation of UmaLittleMaid
• Fixed the problem of the Industrial Foregoing Bio Capture Tool duplicating the maid
• Modified some rendering of chat bubbles, now the rendering will take into account the ambient light, and no longer have the light bulb problem
• Fixed the problem of home logic errors in other dimensions
• Modified AI prompt words
• Fixed various problems with the standby animation and sitting animation of the wine fox
• Updated the blue wine fox material, thanks @白帆小喵L
• Updated the translation text

Fixed altar construction error