1.5.3 更新日志

• 为智能体的异步工具调用增加了备用机制，确保最终结果始终在主线程中返回。
• 修复了背包缓存中因循环引用导致的内存泄漏问题（#1096），感谢 @CentaureaHO。
  • 新增对旅行者背包（Traveler's Backpack）的兼容性支持。
• 修复了两个网站相关的问题：
  • 修复了与 DeepSeek 网站的兼容性问题；现已支持新版 v4 API。
  • 修复了与 Fish Audio 网站的兼容性问题；文本转语音（TTS）功能将不再触发 400 错误。
• 修改了默认大语言模型（LLM）网站的提示语，改为引导玩家注册 DeepSeek 账户。
• 调整了上下文压缩机制：由原先按对话轮次检测，改为按 token 数量检测，大幅提升了长任务中的逻辑连贯性。
• 修正了部分提示语。
• 修正了默认模型的 Molang 表达式。
• 更新了部分翻译（#1094）。

1.5.3 更新日志

• 为智能体的异步工具调用增加了备用机制，确保最终结果始终在主线程中返回。
• 修复了背包缓存中因循环引用导致的内存泄漏问题（#1096），感谢 @CentaureaHO。
  • 新增对旅行者背包（Traveler's Backpack）的兼容性支持。
• 修复了两个网站相关的问题：
  • 修复了与 DeepSeek 网站的兼容性问题；现已支持新版 v4 API。
  • 修复了与 Fish Audio 网站的兼容性问题；文本转语音（TTS）功能将不再触发 400 错误。
• 修改了默认大语言模型（LLM）网站的提示语，改为引导玩家注册 DeepSeek 账户。
• 调整了上下文压缩机制：由原先按对话轮次检测，改为按 Token 数量检测，大幅提升了长任务中的逻辑连贯性。
• 修正了部分提示语。
• 修正了默认模型的 Molang 表达式。
• 更新了部分翻译（#1094）。

小女仆 1.5.2 更新

• 修复：酒狐缺失铁魔法动画的问题
• 新增：Minecraft Wiki 查询工具，女仆 AI 聊天现在可以调用该网站来查询信息
• 调整：工具调用现在支持异步阻塞执行
• 优化：精简提示词以减少 token 使用量
• 优化：聊天气泡中的工具调用字段现在支持翻译字符串，以提供更友好的显示
• 优化：在耗时较长的工具调用期间会显示更友好的提示字符串
• 优化：新增了额外的翻译条目

小女仆 1.5.2 更新

• 修复：酒狐缺失铁魔法动画
• 新增：Minecraft Wiki 查询工具，女仆 AI 聊天现在可以调用该网站来查找信息
• 调整：工具调用现已支持异步阻塞执行
• 优化：精简提示词以减少 token 使用量
• 优化：聊天气泡中的工具调用字段现已支持翻译字符串，显示更加友好
• 优化：在耗时较长的工具调用期间显示更友好的提示字符串
• 优化：新增了更多翻译条目

1.5.1 车万女仆 — 更新日志

错误修复

女仆行为修复

• 修复：女仆在进食时会偷走自己的食物，导致进食动画无限循环
• 修复：当女仆手持来自“沉浸式奏乐”的乐器时右键点击会导致乐器掉落
• 修复：女仆死亡时 Curios 饰品未能正确掉落（由 CentaureaHO 修复）
• 修复：安装 Accessorify 模组后，女仆吃完食物后食物完全消失
• 修复：AI 聊天中人格系统提示过长导致游戏崩溃

模型与渲染修复

• 修复：某些默认模型问题——低生命值时“新娘狐妖”模型无法正常渲染

Create 模组兼容性修复

• 修复：破坏 Create 的旋转展示方块时会额外掉落一个小雕像物品
• 修复：女仆乘坐 Create 座椅时不会随整体结构方向一同旋转

方块与物品修复

• 修复：零食柜被破坏时未掉落其内部物品

模组兼容性修复

• 修复：在 NeoForge 1.21.1 下无法通过饰品栏翻页
• 修复：与 Alex 的洞穴共存时扫帚碰撞箱异常（由 CentaureaHO 修复）
• 修复：扫帚骑乘功能与 Leawind 的第三人称模组冲突（由 CentaureaHO 修复）

AI / 网络接口修复

• 修复：SiliconFlow 语音识别返回 HTTP 422 错误
• 修复：使用新版模型（如 GPT-4.5）配合更新后的 OpenAI API 时出现的多项兼容性问题

性能优化

• 优化：重构了物品形态的渲染逻辑，显著降低小雕像和座椅的渲染耗时
• 优化：改进了女仆属性值的显示逻辑，防止因数值溢出导致 UI 显示异常

AI Agent 更新

本次更新对女仆的 AI 聊天功能进行了大幅重构，基于主流 Agent 架构设计原则进行了系统性优化。目前仅 车万女仆：纸短情长 附加包存在已知兼容性崩溃问题，其余附加包均兼容。

供应器支持更新

• 更新 Aliyun、SiliconFlow、OpenAI 等供应器的模型列表至最新版本
• 移除腾讯混元（Tencent Hunyuan）供应器
• 新增以下默认供应器：
  • Gemini
  • Grok
  • OpenRouter
  • GLM
  • MiniMax（同时支持 LLM 与 TTS）
  • KiMi
  • 腾讯云（仅支持 ASR）

UI 交互改进

本次更新大幅降低了 AI 相关功能的配置门槛，显著提升易用性。

• 所有 AI 聊天相关设置现已统一整合至面对女仆时按下 T 键打开的 UI 面板中；原女仆 GUI 中对应标签页已被移除
• UI 面板包含：供应器设置、女仆人格提示编辑器、聊天历史查看与删除、LLM / TTS / 语言选项、供应器配置模块
• 面板实时显示累计 Token 使用量
• 供应器配置现已包含身份验证机制，并充分考虑单人游戏、局域网、专用服务器主机及客户端等场景——服务器管理员无需再担心密钥与配置的安全问题
• 供应器配置现在可完全在游戏内修改，无需手动编辑 JSON 配置文件
• 聊天输入框支持使用上下方向键快速调取先前输入内容以重新编辑
• TTS 供应器选择中新增“无”选项，允许玩家在客户端禁用语音合成

AI 聊天功能重构

• 提示优化

  • 女仆现在能更准确地识别玩家意图并调用正确的工具
  • 每次对话中会自动注入高度相关的上下文信息，提升指令识别效率

• 对话鲁棒性改进

  • 当大模型产生幻觉或错误调用工具时，系统将自动触发重试机制，引导模型自我修正
  • 每次对话前都会验证消息历史结构，防止 HTTP 400 错误（此前在使用 DeepSeek 等模型时频繁触发）
  • 若关联的女仆实体已不存在，对话会话将立即终止，防止错误调用

• 缓存命中率优化（提高缓存命中率可有效降低 API 成本并加快模型响应速度）

  • 对话缓存命中率从约 50% 提升至约 85%

• 工具调用调整

  • 新增多款可调用工具，包括：切换女仆坐姿状态、家园模式、工作时间表、设置攻击目标等
  • 增加工具调用链的最大轮数，并引入多重断路器机制，支持 AI 组合多个工具调用执行复杂操作，同时防止无限循环导致 Token 异常消耗
  • 部分内容丰富的游戏上下文现在通过工具调用机制按需获取，降低基础 Token 使用量
  • 使用命令 /tlm ai_chat context 输出当前所有可用的游戏上下文信息
  • 使用命令 /tlm ai_chat tool 输出当前所有可用的工具列表

• 技能系统

  • 新增技能系统：标准技能文件可放置于配置文件夹或数据包内的指定路径，系统将在适当时机将其注入对话上下文中
  • 内置一个默认技能，包含关于女仆模组自身的知识，使女仆能正确回答有关模组的问题
  • 使用命令 /tlm ai_chat skill 输出当前所有已加载的技能

• 上下文压缩

  • 当对话历史达到一定长度时，系统将自动压缩并总结历史内容，在保持对话连贯性的同时有效减少 Token 使用量

• UI 反馈改进

  • 女仆执行工具调用时，聊天泡泡将实时刷新以显示当前工具调用状态，减少玩家等待时的困惑
  • 调整普通文本聊天泡泡的最大宽度，防止过长的单行内容影响可读性

新内容

新模型

• 更新：K 蜗牛模型
• 新增：圣洁狐妖、精灵狐妖（星空）、幸存者狐妖（蔷薇迷雾）、迷你狐妖（白北极熊）、战术狐妖（苏打球像素）
• 新增：年糕狐（完美冻结）
• 新增：东方金蛇乡（FumoFumo）中缺失的角色
• 更新：灵梦与魔理沙模型（太阳晶体）

精妙背包支持

新增对精妙背包（Sophisticated Backpacks）的兼容支持：将精妙背包放入女仆的 Curios 饰品栏后，女仆可正常与其交互，包括取出和放入物品。（由 CentaureaHO 实现）

迷你女仆妖精

女仆妖精生成时，现在有 10% 的几率生成为迷你女仆妖精。迷你女仆妖精的飞行速度略高于普通女仆妖精，被击杀时掉落双倍 P 点数。

回退原料（FallbackIngredient）

新增 FallbackIngredient 配方原料类型，用于在多模组环境中实现差异化的合成输入（设计理念类似于 Avaritia 工作台的多模组适配方案）。

该原料类型会按顺序遍历 fallbacks 列表，并选择第一个对应模组已安装的条目作为实际合成输入，实现“若安装了模组 A 则使用其物品，否则回退至 B”的逻辑。

使用示例：

以下配方展示了一个祭坛配方：若安装了 kaleidoscope_cookery 模组，则使用其磨石；否则回退至原版木板；同时始终需要钻石作为固定原料：

{
  "type": "touhou_little_maid:altar_recipe",
  "output": {
    "item": "touhou_little_maid:bookshelf",
    "count": 1
  },
  "power": 0.1,
  "ingredients": [
    {
      // 必需的类型参数
      "type": "touhou_little_maid:fallback_ingredient",
      // 有序列表；将使用第一个已安装模组对应的条目作为实际输入
      "fallbacks": [
        {
          // 若存在 kaleidoscope_cookery 模组，则使用其磨石
          "modid": "kaleidoscope_cookery",
          "value": {
            "item": "kaleidoscope_cookery:millstone"
          }
        },
        {
          // 回退方案：使用原版木板（使用标签匹配）
          "modid": "minecraft",
          "value": {
            "tag": "minecraft:planks"
          }
        }
      ]
    },
    // 固定原料：钻石（使用原版 Ingredient 语法）
    {
      "tag": "forge:gems/diamond"
    }
  ]
}

1.5.1 车万女仆 — 更新日志

错误修复

女仆行为修复

• 修复：女仆进食时偷吃自己的食物，导致进食动画无限循环
• 修复：当女仆手持《沉浸式奏乐》乐器时右键点击会导致乐器掉落
• 修复：女仆死亡时Curios饰品未正确掉落（由CentaureaHO修复）
• 修复：安装Accessorify后，女仆进食完毕食物完全消失
• 修复：AI聊天中因角色系统提示过长导致游戏崩溃

模型与渲染修复

• 修复：特定默认模型问题——低生命值时婚嫁狐妖模型无法正常渲染

Create模组兼容性修复

• 修复：破坏Create旋转展示台方块会额外掉落一个小雕像物品
• 修复：女仆乘坐Create座椅时不会随整体结构方向旋转

方块与物品修复

• 修复：破坏零食柜时其内容物未正常掉落

模组兼容性修复

• 修复：NeoForge 1.21.1下Curios饰品栏无法翻页
• 修复：与《Alex的洞穴》共存时扫帚碰撞箱异常（由CentaureaHO修复）
• 修复：扫帚骑乘与《Leawind的第三人称》冲突（由CentaureaHO修复）

AI/网络接口修复

• 修复：SiliconFlow语音识别返回HTTP 422错误
• 修复：使用更新后的OpenAI API及较新模型（如GPT-4.5）时的多个兼容性问题

性能优化

• 优化：重构物品形态渲染逻辑，显著减少小雕像和座椅的渲染时间
• 优化：改进女仆属性值显示逻辑，防止数值溢出导致UI显示异常

AI代理更新

本次更新对女仆的AI聊天功能进行了大幅重构，基于主流Agent架构设计原则进行了系统性优化。目前仅车万女仆：纸短情长附加包存在已知兼容性崩溃，其余附加包均兼容。

供应器支持更新

• 更新Aliyun、SiliconFlow、OpenAI等供应器的模型列表至最新版本
• 移除腾讯混元供应器
• 新增以下默认供应器：
  • Gemini
  • Grok
  • OpenRouter
  • GLM
  • MiniMax（同时支持LLM和TTS）
  • KiMi
  • 腾讯云（仅ASR）

UI交互改进

本次更新大幅降低AI相关功能配置门槛，显著提升易用性。

• 所有AI聊天相关设置统一整合至面对女仆时按T键打开的UI面板中；原女仆GUI中的对应标签页已移除
• UI面板包含：供应器设置、女仆角色提示编辑器、聊天历史查看与删除、LLM/TTS/语言选项及供应器配置模块
• 面板实时显示累计Token用量
• 供应器配置新增身份验证机制，全面考虑单人游戏、局域网、专用服务器主机及客户端场景——服务器管理员无需再担心密钥与配置安全问题
• 供应器配置现可完全在游戏内修改，无需手动编辑JSON配置文件
• 聊天输入框支持使用上下箭头键快速调取先前输入进行重新编辑
• TTS供应器选择新增“无”选项，允许玩家在客户端禁用语音合成

AI聊天功能重构

• 提示优化

  • 女仆现在能更准确识别玩家意图并调用正确工具
  • 自动向每次对话注入高度相关的上下文信息，提高指令识别效率

• 对话鲁棒性改进

  • 当大模型产生幻觉或错误调用工具时，系统将自动触发重试机制引导模型自我修正
  • 每次对话前验证消息历史结构，防止HTTP 400错误（此前使用DeepSeek等模型时频繁触发）
  • 若关联女仆实体已不存在，立即终止对话会话，防止错误调用

• 缓存命中率优化（提高缓存命中率可有效降低API成本并加速模型响应）

  • 对话缓存命中率从约50%提升至约85%

• 工具调用调整

  • 新增多项可调用工具，包括：切换女仆坐姿状态、家园模式、工作日程、设置攻击目标等
  • 增加工具调用链最大轮数并引入多重断路机制，支持AI组合多项工具调用进行复杂操作，同时防止无限循环导致Token异常消耗
  • 部分内容丰富的游戏上下文现通过工具调用机制按需获取，降低基础Token用量
  • 使用命令/tlm ai_chat context输出当前所有可用游戏上下文信息
  • 使用命令/tlm ai_chat tool输出当前所有可用工具列表

• 技能系统

  • 新增技能系统：标准技能文件可放置于配置文件夹或数据包指定路径内，系统将在适当时机将其注入对话上下文
  • 内置默认技能，包含女仆模组自身知识，使女仆能正确回答关于模组的问题
  • 使用命令/tlm ai_chat skill输出当前已加载的所有技能

• 上下文压缩

  • 当对话历史达到一定长度时，系统将自动压缩并摘要历史，保持对话连续性的同时有效减少Token用量

• UI反馈改进

  • 女仆执行工具调用时，聊天气泡将实时刷新显示当前工具调用状态，减少玩家等待时的困惑
  • 调整普通文本聊天气泡最大宽度，防止过长单行影响可读性

新增内容

新模型

• 更新：K蜗牛模型
• 新增：圣洁狐妖、精灵狐妖（星域）、幸存者狐妖（蔷薇迷雾）、迷你狐妖（白北极熊）、战术狐妖（苏打球像素）
• 新增：年糕狐（完美冻结）
• 新增：《东方深秘录》缺失角色（FumoFumo）
• 更新：灵梦与魔理沙模型（太阳晶体）

精妙背包支持

新增对精妙背包的兼容支持：将精妙背包放入女仆的Curios槽位后，女仆可正常与背包互动，包括取出和放入物品。（由CentaureaHO实现）

迷你女仆妖精

女仆妖精生成时，现在有**10%**概率改为生成迷你女仆妖精。迷你女仆妖精飞行速度略高于普通女仆妖精，被击杀时掉落双倍P点。

回退配方成分

新增FallbackIngredient配方成分类型，用于在多模组环境中实现差异化合成输入（设计理念类似于Avaritia工作台的多模组适配方案）。

此成分类型按顺序遍历fallbacks列表，选择首个对应模组已安装的条目作为实际合成输入，实现“若安装模组A则使用其物品，否则回退至B”的逻辑。

使用示例：

以下配方演示了一个祭坛配方：若存在kaleidoscope_cookery模组则使用其磨石，否则回退至原版木板，同时始终需要钻石作为固定成分：

{
  "type": "touhou_little_maid:altar_recipe",
  "output": {
    "item": "touhou_little_maid:bookshelf",
    "count": 1
  },
  "power": 0.1,
  "ingredients": [
    {
      // 必需的类型参数
      "type": "touhou_little_maid:fallback_ingredient",
      // 有序列表；首个对应模组已安装的条目将作为实际输入
      "fallbacks": [
        {
          // 若存在kaleidoscope_cookery则使用其磨石
          "modid": "kaleidoscope_cookery",
          "value": {
            "item": "kaleidoscope_cookery:millstone"
          }
        },
        {
          // 回退值：使用原版木板（标签匹配）
          "modid": "minecraft",
          "value": {
            "tag": "minecraft:planks"
          }
        }
      ]
    },
    // 固定成分：钻石（原版Ingredient语法）
    {
      "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

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

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

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). Thanks to ethan_trum

---

Other

• Added additional translations

1.4.6 更新日志

• 修复了女仆无法通过某些碰撞体积小于0.5的特殊方块的问题，例如各种模组管道（感谢 @guapi-exe）
• 完全替换为由Nanaya制作的新emoji包
• 修复了大正女仆酒狐的材质问题（感谢 @Tex_official）
• 修复了在打开带有自动熔炉和工作台背包的女仆时与JEI、REI和EMI相关的崩溃问题
• 修复了女仆死亡通知消息不正确的问题
• 修复了与KubeJS 7.2版本（1.21.1 NeoForge，感谢 @LootDust）的兼容性问题
• 更新了一些翻译文本

1.4.6 更新日志

• 修复了女仆无法穿越某些碰撞体积小于0.5的特殊方块的问题，例如各种模组管道（感谢 @guapi-exe）
• 完全替换为 Nanaya 制作的新表情包
• 修复了大正女仆·酒狐的材质问题（感谢 @Tex_official）
• 修复了打开带有自动熔炉和工作台背包的女仆时，与JEI、REI和EMI相关的崩溃问题
• 修复了女仆死亡通知消息错误的问题
• 修复了与 KubeJS 7.2 版本的兼容性问题（1.21.1 NeoForge，感谢 @LootDust）
• 更新了一些翻译文本

• 回滚了邻居节点缓存功能，并移除了相关代码，以防止女仆在寻路时突然停止并卡住
• 牵引绳现在固定在女仆的手上
• 添加了一套新的女仆GIF表情包

• 回滚了邻居节点缓存功能，并移除了相关代码，以防止女仆突然停止寻路并卡住
• 牵引绳现在固定在女仆的手上
• 新增了一套女仆GIF表情包

• 修复了由于寻路过程中缓存反射可能导致的崩溃问题
• 添加了小型狐狸模型（感谢 @Rou_Ti）

TLM 1.4.2 更新日志

错误修复

• 修复五子棋游戏相关问题
  • 修复在 MC 1.21.1 中填满整个五子棋棋盘时导致崩溃的问题
• 修复卡帕指南针坐标写入逻辑
  • 在写入后续坐标时增加维度一致性检查
• 修复装备交互问题
  • 修复使用 Shift + 点击穿脱盔甲时属性未更新的问题
• 修复模型显示问题
  • 修复 YSM 模型动画在雕像和手办模式中无法播放的问题

新功能

• 女仆任务列表界面优化（感谢：@sch246）
  • 左侧任务列表现在支持鼠标滚轮滚动
• 女仆寻路系统性能优化（感谢：@小鱼飘飘）
  • 新增邻居节点缓存机制，提升寻路效率
  • 实现物品拾取延迟与对齐功能
  • 优化燃烧方块的查询性能
• 女仆实体备份功能
  • 女仆实体自动备份功能现已默认开启，以增强数据安全性
• 完全重制饰品系统
  • 饰品槽位扩展至30个，提高与其他模组的兼容性
  • 增强饰品接口，提供丰富的方法与事件机制，支持属性修改等高级功能
  • 全面支持 KubeJS
  • 采用变长 Map 数据结构存储饰品信息，显著提升遍历性能
  • 全新设计的饰品界面，拥有独立页面布局（感谢 @YSBB 提供的新 GUI 设计）
  • 新增基于好感度解锁饰品槽位的机制
• 开发者接口扩展
  • 新增 MaidFavorabilityLevelChangeEvent 好感度变化事件
  • 在 IMaidTask 接口中添加 isHidden 方法，支持任务隐藏功能
• 聊天气泡系统重制
  • 支持通过数据包自定义颜文字内容：touhou_little_maid:chat_bubble/kaomoji.json
  • 支持从资源包的 textures/chat_bubble/maid_emoji 目录读取 PNG/GIF 格式的表情图
  • 支持通过文件名后缀设置自定义表情尺寸（如 -64x64，最大 256px）
  • 新增配置选项，可调节颜文字与表情的权重、显示频率等
• 模型内容更新
  • 同步 YSM 2.5.x 版本新增模型：扩展了 Wine Fox 和 Sta Bo，新增 kluonoa 模型
• 棋类游戏残局系统
  • 制图师房屋与要塞图书馆将随机生成残局物品
  • 右键点击对应棋盘上的“局面状态”物品即可布置残局
  • 物品提示信息中显示残局预览缩略图
  • 支持通过数据包自定义残局，在以下路径添加更多残局：
    • touhou_little_maid:board_states/chess.json — 国际象棋
    • touhou_little_maid:board_states/gomoku.json — 五子棋
    • touhou_little_maid:board_states/xiangqi.json — 中国象棋
  • 国际象棋使用标准 FEN 格式描述，可通过“棋灵王”等软件导出
  • 五子棋使用自定义格式，可在创造模式中用木棍摆放棋子，再用木棍点击箱子导出对局数据
• 用户界面优化
  • 女仆模型切换界面新增搜索功能（感谢：@QiChenSn）

• 新增 MaidBackpackChangeEvent，当女仆背包物品被移除或装备时触发
• 新增 MaidBaubleChangeEvent，当女仆饰品物品被移除或装备时触发
• 在 ItemsUtil 中添加 hasBaubleItemInMaid 方法，用于 O(1) 时间复杂度快速判断女仆是否拥有指定饰品
• 修复了与模组 "Touhou Little Maid: Spell" 的兼容性崩溃问题

TLM 1.4.2 更新日志

错误修复

• 修复五子棋游戏相关问题
  • 修复在 MC 1.21.1 中填满整个五子棋棋盘时导致崩溃的问题
• 修复Kappa指南针坐标写入逻辑
  • 在写入后续坐标时增加维度一致性检查
• 修复装备交互问题
  • 修复使用 Shift + 点击穿脱盔甲时属性未更新的问题
• 修复模型显示问题
  • 修复YSM模型在雕像和手办中动画无法播放的问题

新功能

• 女仆任务列表界面优化（感谢：@sch246）
  • 左侧任务列表现在支持鼠标滚轮滚动
• 女仆寻路系统性能优化（感谢：@小鱼飘飘）
  • 新增邻居节点缓存机制，提升寻路效率
  • 实现物品拾取延迟与对齐功能
  • 优化燃烧方块的查询性能
• 女仆实体备份功能
  • 默认开启女仆实体备份功能，以增强数据安全性
• 完全重制饰品系统
  • 饰品槽位扩展至30个，提高与其他模组的兼容性
  • 增强饰品界面，提供丰富的方法与事件机制，支持属性修改等高级功能
  • 全面支持 KubeJS
  • 采用变长 Map 数据结构存储饰品信息，显著提升遍历性能
  • 全新设计的饰品界面，拥有独立页面布局（感谢 @YSBB 提供的新GUI设计）
  • 新增基于好感度解锁饰品槽位的机制
• 开发者接口扩展
  • 新增 MaidFavorabilityLevelChangeEvent 好感度变化事件
  • 在 IMaidTask 接口中添加 isHidden 方法，支持任务隐藏功能
• 聊天气泡系统重制
  • 支持通过数据包自定义颜文字内容：touhou_little_maid:chat_bubble/kaomoji.json
  • 支持从资源包的 textures/chat_bubble/maid_emoji 目录读取 PNG/GIF 格式的表情图
  • 支持通过文件名后缀自定义表情显示尺寸（例如 -64x64，最大 256px）
  • 新增配置选项，可设置颜文字与表情的权重、显示频率等
• 模型内容更新
  • 同步 YSM 2.5.x 版本新增模型：扩充“酒狐”与“Sta Bo”，新增 kluonoa 模型
• 棋类游戏残局系统
  • 制图师房屋与要塞图书馆将随机生成残局物品
  • 右键点击对应棋盘上的“局面状态”物品即可布置残局
  • 物品提示信息中显示残局预览缩略图
  • 支持通过数据包自定义残局，在以下位置添加更多残局：
    • touhou_little_maid:board_states/chess.json — 国际象棋
    • touhou_little_maid:board_states/gomoku.json — 五子棋
    • touhou_little_maid:board_states/xiangqi.json — 中国象棋
  • 国际象棋使用标准 FEN 格式描述，可通过“棋灵王”等软件导出
  • 五子棋使用自定义格式，可在创造模式下用木棍摆放棋子，再用木棍点击箱子导出棋局数据
• 用户界面优化
  • 在女仆模型切换界面中新增搜索功能（感谢：@QiChenSn）

• 新增 MaidBackpackChangeEvent，当女仆背包物品被移除或装备时触发
• 新增 MaidBaubleChangeEvent，当女仆饰品物品被移除或装备时触发
• 在 ItemsUtil 中添加 hasBaubleItemInMaid 方法，用于 O(1) 效率快速判断饰品是否存在
• 修复与东方小魅魔：符卡模组（Touhou Little Maid: Spell）的兼容性崩溃问题

版本 1.4.0 更新日志

• 新增对 PatPat 模组的兼容性支持（感谢：Unknown）

• 修复了投掷雪球时动画偏移的问题

• 修复了默认模型动画变量的错误问题

• 完成与 Superb Warfare 模组的兼容

  • 需要 Superb Warfare 版本 0.8.7.1 或更高版本才能使用
  • 女仆可以使用来自 Superb Warfare 的枪械（Stinger 导弹除外）
  • 当女仆弹药耗尽时，若主手持枪且副手持 RGO 手榴弹，则会尝试投掷 RGO 手榴弹
  • 使用马鞍拾起女仆后，右键点击载具可让女仆直接坐入驾驶位
  • 玩家乘坐载具时，附近跟随的女仆可自动进入乘客座位
  • 处于驾驶或乘客座位的女仆可使用载具武器或手持武器进行攻击
  • 放置在背部装饰槽的武器将显示在女仆的背部或腰部

• 优化远程攻击 AI 机制

  • 远程攻击（包括枪械攻击）现在会考虑距离因素，避免女仆来回移动的问题
  • 在远程模式下，女仆将优先攻击正在伤害她们的目标

• doMobLoot 游戏规则现在会影响女仆妖精（Maid Fairy）的能量点掉落

• 移除 actuallyHurt 方法，修复了在 arclight 服务器上受伤即死的 Bug

• 新增对小地图模组的兼容支持

  • 兼容 Xaero's Minimap 模组的实体图标，现在女仆、妖精女仆、扫帚、坐垫和能量点均拥有独立的雷达图标
  • 兼容 JourneyMap 模组，当女仆死亡时，聊天栏将打印死亡坐标，便于在 JourneyMap 中添加路径点

• 新增女仆备份机制，可自动备份女仆数据，并在异常情况下快速恢复之前备份的数据

  • 首先需在 touhou_little_maid-server.toml 文件中启用女仆自动备份功能（默认关闭）

    # 是否启用女仆备份机制，该机制将定期备份服务器上所有玩家的女仆数据
    MaidBackupEnable = false
    # 女仆备份机制中备份女仆数据的时间间隔（单位：秒）
    # 范围：> 5
    MaidBackupIntervalSeconds = 180
    # 启用女仆备份机制后每位玩家最多保存的备份数量
    # 范围：1 ~ 64
    MaidBackupMaxCount = 3
    

  • 游戏将根据设置定期异步备份已加载区块中的女仆数据

    • 备份采用异步机制，避免阻塞服务器主线程造成卡顿
    • 备份时间随机分布，防止集中在同一游戏刻导致延迟

  • 使用 /tlm backup get <player> 命令查看指定玩家的所有备份数据，点击条目可进一步查询详情

  • 最终会给予命令执行者一张包含备份信息的女仆照片

• 修改近战伤害逻辑并新增事件

  • 现在调用 net.minecraft.world.item.Item#hurtEnemy 方法以触发近战攻击后的相关行为（如耐久消耗）
  • 新增 MaidHurtTarget.Pre 和 MaidHurtTarget.Post 事件，在近战攻击过程中触发

• 更新部分模型

  • 新增三种琪露诺（Cirno）女仆模型及两种雕像坐垫模型

版本 1.4.0 更新日志

• 添加了对 PatPat 模组的兼容性（感谢：Unknown）

• 修复了投掷雪球动画的偏移问题

• 修复了默认模型动画变量的错误问题

• 完成了与 Superb Warfare 模组的兼容

  • 需要 Superb Warfare 版本 0.8.7.1 或更高版本才能使用
  • 女仆可以使用来自 Superb Warfare 的枪械（Stinger 导弹除外）
  • 当女仆弹药耗尽时，若主手持枪且副手持 RGO 手榴弹，则会尝试投掷 RGO 手榴弹
  • 使用马鞍拾起女仆后，右键点击载具可让女仆直接进入驾驶员座位
  • 玩家乘坐载具时，附近跟随的女仆可自动进入乘客座位
  • 处于驾驶员或乘客座位的女仆可使用载具武器或手持武器进行攻击
  • 放置在背部装饰槽中的武器将显示在女仆的背部或腰部

• 优化了远程攻击 AI 机制

  • 远程攻击（包括枪械攻击）现在会考虑距离因素，避免女仆来回移动的问题
  • 在远程模式下，女仆将优先攻击正在对其造成伤害的生物

• doMobLoot 规则现在会影响女仆妖精（Maid Fairy）的能量点掉落

• 移除了 actuallyHurt 方法，修复了在 arclight 服务器上受伤时女仆立即死亡的 Bug

• 新增对小地图模组的兼容支持

  • 兼容 Xaero's Minimap 模组的实体图标，现在女仆、妖精女仆、扫帚、坐垫和能量点均拥有独立的雷达图标
  • 兼容 JourneyMap 模组，当女仆死亡时会在聊天栏输出死亡坐标，便于在 JourneyMap 中添加路径点

• 新增女仆备份机制，可在异常情况下自动备份女仆数据，并快速恢复之前备份的女仆

  • 首先需在 touhou_little_maid-server.toml 文件中启用女仆自动备份功能（默认关闭）

    # 是否启用女仆备份机制，该机制将定期备份服务器上所有玩家的女仆数据
    MaidBackupEnable = false
    # 女仆备份机制中备份女仆数据的时间间隔（单位：秒）
    # 范围：> 5
    MaidBackupIntervalSeconds = 180
    # 启用女仆备份机制后每位玩家最多保存的备份数量
    # 范围：1 ~ 64
    MaidBackupMaxCount = 3
    

  • 游戏将根据设置定期异步备份已加载区块内的女仆数据

    • 备份采用异步机制，避免阻塞主服务器线程导致卡顿
    • 备份时间随机分布，防止多个备份集中在同一刻造成性能波动

  • 使用 /tlm backup get <player> 命令查看指定玩家的所有备份数据，点击条目可进一步查询详情

  • 最终会向命令执行者发放一张包含备份信息的女仆照片

• 修改近战伤害逻辑并新增事件

  • 现在调用 net.minecraft.world.item.Item#hurtEnemy 来触发近战攻击后的相关行为（如耐久消耗）
  • 新增 MaidHurtTarget.Pre 和 MaidHurtTarget.Post 事件，在近战攻击过程中触发

• 更新部分模型

  • 新增三种琪露诺女仆模型和两种雕像坐垫模型