TML_Avaritia_addon

TML_Avaritia_addon

一个小型附属模组，让东方小女仆模组的女仆能够真正使用 Re:Avaritia 的武器和护甲。

项目	值
当前版本	0.1.0
加载器	Forge 1.20.1 (47.1.3+)；NeoForge 1.20.1
Java	17
许可证	MIT

---

功能特性

近战

• 无尽之剑：触发近战时的无尽之剑效果（秒杀 + 范围伤害）；伤害通过 MaidHurtTarget.Pre 事件传递，并使用 setCanceled(true)。
• 8格近战范围：通过 Mixin 扩展女仆的近战范围，使剑类武器能在更远的距离生效。

远程

• 无尽之弓：发射箭矢弹幕；开启追踪模式后，发射追踪箭矢。
• 无尽弩：发射箭矢弹幕；开启多重射击模式后，单次射击发射5支呈扇形散开的箭矢。
• 无尽三叉戟：可正确触发雷电打击效果。

武器模式切换界面

• 为弓/弩提供独立的女仆“武器攻击模式切换”任务设置界面，用于切换追踪/多重射击模式。
• 模式数据以 {mode:{...}} 的形式写入武器的 NBT 中，与原版 Avaritia 模式系统保持一致。

无尽护甲 – 女仆被动适应

• 头盔：夜视（可配置）+ 水下呼吸
• 胸甲：持续清除负面效果
• 护腿：抗火
• 靴子：步高 1.0625（可直接走上1格方块）+ 移动速度加成（通过 MOVEMENT_SPEED 属性修饰符实现；装备/卸下时立即生效，不会干扰女仆 AI 的寻路）
• 移动速度/游泳/疾跑倍率均可配置。

---

前置要求

项目	版本
Minecraft	1.20.1
Forge	47.1.3+
Java	17
东方小女仆	1.5.3（Forge 1.20.1）
Re:Avaritia	1.4.0+（Forge 1.20.1）

客户端和服务端都必须安装本模组及两个前置模组。如果缺少任一前置，Forge 将在启动时报错并拒绝加载本模组。

关于 Avaritia 兼容性：本模组仅针对 “Re:Avaritia” 分支进行适配，不代表与其它 Avaritia 分支兼容。

---

加载器与版本兼容性

加载器	状态
Forge 1.20.1 (47.1.3+)	✅ 完全支持
NeoForge 1.20.1	✅ 已在 47.1.106 上验证可用
NeoForge（其他版本）	⚠️ 未测试；NeoForge 可原生加载部分 Forge 模组，因此大概率可用

---

安装方法

1. 安装 Minecraft 1.20.1 + Forge 47.1.3+（NeoForge 1.20.1 亦可；参见“加载器与版本兼容性”）
2. 安装前置模组：东方小女仆 1.5.3、Avaritia: Reborn 1.4.0+
3. 将本模组的 jar 文件放入 mods/ 文件夹
4. 启动游戏

---

配置

配置文件位于 config/tml_avaritia_addon-common.toml。主要选项：

键	默认值	描述
maid_sword_aoe	true	无尽之剑攻击是否造成范围伤害（女仆版横扫攻击）
force_kill_mode	false	强制女仆的无尽之剑进入斩杀/处决模式（默认关闭）
maid_melee_reach	8.0	女仆持无尽武器时的近战距离（格，范围3–16）
infinity_armor_night_vision	true	无尽护甲头盔：夜视
boot_speed_base	0.1	无尽靴子速度（≈ 女仆基础移动速度的2倍，与玩家穿靴子时的倍率相同）
boot_speed_swimming_multiplier	1.2	靴子游泳倍率
boot_speed_sprinting_multiplier	0.2	靴子疾跑倍率（TLM 女仆默认不会疾跑，因此此倍率保持休眠状态）

boot_speed_flying/sneaking/backward/strafing_multiplier 仅保留以镜像 Re-Avaritia 的配置；目前未使用。

---

从源码构建

要求：JDK 17

# 1. 将两个前置模组的 jar 放入 libs/ 目录（文件名必须与 build.gradle 中的 flatDir 坐标匹配）：
#    - touhoulittlemaid-1.5.3-forge-mc1.20.1.jar
#    - Re-Avaritia-forge-1.20.1-1.4.0-release.jar
#    （libs/ 已被 gitignore 忽略且不会提交；GitHub Actions 会自动从上游 Releases 下载）

./gradlew build        # 构建输出在 build/libs/
./gradlew runClient    # 启动开发客户端

---

已知限制

• 投出的三叉戟不会自动收回：女仆投出的无尽三叉戟不会像玩家那样自动返回（忠诚附魔对女仆无效）；命中后会插在地上。
• 部分仅限玩家的效果不适用于女仆（例如三叉戟的潮涌能量模式等）。
• 疾跑倍率已接入逻辑，但 TLM 女仆 AI 永远不会设置疾跑状态，因此该倍率默认处于休眠状态。

---

许可证与鸣谢

本模组代码以 MIT 许可证 发布，版权所有 © 2026 qinmadara。参见 LICENSE。

本模组依赖并引用了以下开源项目：

项目	许可证	版权
东方小女仆	代码：MIT / 素材：CC BY-NC-SA 4.0	© tartaric_acid
Re:Avaritia	代码：MIT / 素材：CC BY-NC-SA 4.0	© cnlimiter（Nova Committee）

• 本模组仅在编译/运行时引用上述模组的公共 API，不捆绑它们任何代码或素材。
• 本模组是非官方附属模组，与东方小女仆或 Re:Avaritia 的作者无关联。

---

AI 使用声明

• 本模组在开发过程中使用了大量 AI 辅助，包括：代码生成与重构、缺陷排查、代码审查和文档编写（包括本 README）。
• 所有 AI 生成的代码在集成前均经过人工审查、修改和游戏内测试；最终代码以 MIT 许可证发布。
• AI 用于提升开发效率；代码质量、功能正确性和许可证合规性由项目作者负责。