Promaid

Promaid v1.2.4（1.21.1 NeoForge） 开发者不玩多人 / 没做服务端优化 / 请理解。

本版与 1.20.1 Forge 版（同为 v1.2.4）功能对齐，差异只在少数原版机制上（主要是 1.21.1 独有的重锤，以及本版修掉的右键蛋糕崩服是 1.21.1 专属）。有问题欢迎提 Issue：https://github.com/fadersketch/Promaid-mod/issues

Minecraft 1.21.1 · NeoForge 21.1.250 前置：车万女仆 Touhou Little Maid ≥ 1.5.0（NeoForge 1.21.1 版；实测 1.5.3-neoforge+mc1.21.1）——纯独立前置，不对任何其他模组做专属联动 附件：promaid-1.2.4-neoforge-1.21.1.jar（直接放入 mods 文件夹） 升级提示：安装前请删除 mods 目录里的旧 promaid-1.2.3-neoforge-1.21.1.jar（含它的三次重传，文件名相同）/ promaid-1.2.2-neoforge-1.21.1.jar / promaid-1.2.1-neoforge-1.21.1.jar / promaid-1.2.0-neoforge-1.21.1.jar——两个 jar 的 modId 相同，同时加载会导致启动失败 存档说明：1.21.1 存档与 1.20.1 不互通；1.21.1 内部沿用 maid_smart 命名空间，v1.1.x / v1.2.x 存档无缝升级 其他模组武器天然可用：武器判定基于原版攻击力属性，模组武器照常参与自动装备与伤害计算，无需专门适配 一句话：三叉戟不止能捅人，还能当燃料（外加一颗 1.21.1 的雷被拆了） 激流三叉戟现在可以当「飞行推进剂」——起飞、空袭的盘旋抬升与俯冲下扎、飞行跟随，四条链路都能烧它；力度照「玩家在水里放激流那一记」并按附魔等级放大（I / II / III 行程约 17 / 25 / 33 格），而不是像烟花那样持续推。

同时修掉三条：远程空袭「拿着枪一枪不放」（两处病根，并新增「远程开火」诊断行）、右键蛋糕掉线 / 崩服（1.21.1 专属，本版最要紧的一条）、守家（home）模式的两条（issue #22：农场女仆不再在田里到处乱转、打完怪「驻守」不再变成「跟随」）；还有一条嘴上功夫：「我卡住了，快喘不过气了」改成真吃到超过 4 点窒息伤害才说。另有一处口径变化：压缩盒里的带附魔物品一律禁入——那个开关和自定义清单都删掉了，详见第三节。

如果你现在装的是 v1.2.3 的三次重传包：本版是新版本号（不再是同名覆盖），下面第二节最后一条列了 v1.2.3 那批修复——如果你手上还是 v1.2.3 首发版，请务必换成本版。

一、新功能

1. 激流三叉戟当「飞行推进剂」 四条链路共用一套实现：起飞（空袭 + 飞行跟随）、空袭的盘旋抬升、俯冲下扎。近战那一记「旋转冲击」一字未动——那里要的就是原版那一口的爆发力。 力度不打折，补的是"玩家那份空气阻力"：点火那一口 v ← v×0.5 + 视线 × 原版力度（原版力度 = 3.0×(1+等级)/4，I 1.5 / II 2.25 / III 3.0 格/tick），随后水平速度每 tick ×0.92（= 0.91 ÷ 0.99，把玩家在雨里的空气阻力补在滑翔自己的 0.99 之上）。行程于是回到玩家的量级：I ≈ 17 格 / II ≈ 25 格 / III ≈ 33 格。 老版"一下子飞出 100 多格"是什么：力度其实和玩家一样，但她在滑翔——鞘翅阻力只有 0.99/tick，同一口 3.0 能飘 3.0 ÷ (1 − 0.99) = 300 格。现在补上阻力，落点也就准了（旧版还"在旧速度上加一份视线速度"，转弯时两份速度直接相加，轨迹像醉汉走路）。 取材范围：主手 → 副手 → 背包三处都找（六百三十八 一度收成"只认背包"，六百四十 已按反馈改回）；耐久就扣在真正用到的那一件上。 想更省更稳：combat.riptideFlightScale（默认 1.0 = 就是玩家那一口）往 0.1 调即可全局打折。 验收：latest.log 搜 激流起飞 / 空袭·激流，那一行会写清「力度 3.00 格/tick，照玩家雨里那一记；水平衰减约 N tick、行程约 33 格」。
2. 精妙背包 / 旅行者背包适配 她自己的背包装得下就装自己的；装不下时，多出来的那一份再往她身上那件"额外容器"（精妙背包 / 旅行者背包）里塞一遍。接线覆盖六条"收东西"的链路：统一的还物出口、砍树收方块、挖矿收方块、搭路方块回收、追踪方块回收，以及农场连锁收割的掉落兜底（GitHub issue #20 报的就是这一处）。 反过来也能取：她自己的背包里没有时，去额外容器里把匹配的东西搬进她的背包（找材料 / 拿食物 / 取建材都会先看那里面）；运行日志搜「额外容器」能看到每一笔（限频 2 秒），飞行缺件诊断那一行也拆成了「身上激流三叉戟=」与「额外容器激流三叉戟=」两项。 顺序照抄 TLM 自己的拾取：先放"已经装着同类物品"的容器，再放任何容器——不然会出现"背包里明明有半组、却新开一格"的分裂观感。 生效条件（先说清楚，免得当成"没生效"）：需要 Curios 在场 + TLM 的「女仆饰品」功能开启 + 背包真的戴在她饰品栏里。一件都不满足时 getContainers 只返回"她自己"那一项 → 行为与旧版一字不差（1.21.1 侧同样走 TLM 的公开容器 API，签名与 1.20.1 版一致）。 开关 misc.backpackOverflow（默认开）：关掉 = 只用自己的背包（旧行为）。
3. 飞行跟随新增省料开关 flightFollow.trident（默认开 = 照原版每次推进扣 1 点耐久），与「消耗烟花」「消耗鞘翅耐久」凑成同一档三个开关。只管飞行跟随——空袭的起飞 / 抬升 / 俯冲是战斗动作，照旧扣耐久。 二、修复 女仆放床爆炸后原地留下「一格水」而不是火（1.20.1 专属，实测六百五十）：病根是一行 SRG 名写错。空袭的床在起爆那一刻会先把放下去的两格床拆掉，而拆床那一支写的是 Blocks.f_49990_——它其实是 minecraft:water（1.20.1 SRG 实证：f_49990_ = register("water", new LiquidBlock(Fluids.WATER, …))；本模组「落地水 / 岩浆放水」也正是拿它当水用），空气的 SRG 名是 f_50016_。于是这一炸拆完床，原地留下的是一格水；而原版爆炸点火那一步的判据恰好是「那一格是空气」——被水占住自然点不着，看上去就成了「不产生火而是水」。现在改回 Blocks.f_50016_（1.21.1 / NeoForge 树同一行本来就是对的，Mojmap 写的 Blocks.AIR，本次未动它）。只有 1.20.1 的床链路受影响：重生锚走的是另一个分支（removeBlock）、末地水晶底座是「留着 → 到期回收」，都不走这一支。 右键蛋糕掉线 / 崩服（1.21.1 专属，本版最要紧的一条）：1.21.1 的"蛋糕可食用"移植时注错了方法——注入 Item.use 却把返回值写成布尔值，而它的真实返回是 InteractionResultHolder，于是右键蛋糕（尤其对着空气点）直接崩服 / 被踢出世界。现在改用 1.21.1 自己的机制：加载期给 minecraft:cake 挂上食物数据组件（营养 14 / 饱和 0.6 / 1.6 秒），不再注入任何方法。喂女仆蛋糕、把蛋糕当食物，一切照旧。 远程空袭「拿着枪一枪不放」（粉丝反馈 + 日志实证：26 秒一枪未放）。两条病根： 空中开火被 TLM 的"枪型交战距离带"卡死——旧版把 TLM 用来挑目标的距离档（手枪/霰弹/冲锋枪一档、狙击一档）当成了"这一发能不能打出去"的判据；而空袭是"绕目标盘旋且停在她上方"，3D 距离天生落在那些带外，于是每一 tick 都被挡回去。现在与 TLM 自家逐条对齐：视线由上层统一判，开火只看冷却（射程仍由上层把着：枪械 16 格、弓弩 24 格）。 地面远战分支压根不调开火那一句——她落地等重新起飞的那几秒会举着枪一直不放（现场那条 ranged kite … dist=2.6 就是它，随后被打死）。现在地面分支在返回前也补一次开火，节奏仍由内部冷却表管着，不会连发。 顺带新增「远程开火」诊断行（节流 2 秒）：以前"她为什么不射"在日志里完全查不到，现在每一档都会印出来。 守家（home）模式下农场女仆「在田里到处乱转」（issue #22 第一条）：病根是我们自己——旧版给守家女仆写了一份"没有移动目标就去家附近找个随机点走"的巡逻，每 0.25 秒直连导航改一次目的地，会直接覆盖掉原版农场任务正在走的路径（原版农场一次没找到活会安静等 6~12 秒，那段空隙正好被随机巡逻铺满，看起来就像"一格格走过去检查地"）。现在农场这条链路完全交回原版：平常站着（或按「空闲散步」走走），作物成熟了才走过去收/种——与跟随模式的表现一致（反馈里对"正常"的定义）。宰杀任务没有牲畜可杀时仍由我们带着闲逛（原版那边没有"自己找活"的能力）。顺带：锄地也不再抢路——她正被任务带着去收/种某一格时不再半路改道，只在站定/没有目标的间隙锄。 打完怪「驻守」变成「跟随」、回不去（issue #22 第二条）：战斗结束时还原"战斗前的模式"，那段代码把快照删在了读取之前——getBoolean 读不到键就返回 false，于是"还原"实际执行的是"把驻守关掉"，每打一场架就把守家的女仆变成跟随（排班中的女仆不走这条，所以现象是"有概率"）。现在改成先还原、后清标记，并且没有快照就完全不动她的设置；还原成功时运行日志里会写一行「战斗前模式已还原：驻守（home）=开/跟随」，可对账。 「我卡住了，快喘不过气了」变成了口头禅：那句话原来只按几何判定播报——头部那一格不是空气、形状够"实"就喊。她挤过窄缝、被方块顶一下、上下坡抬头、垫块瞬间位移滞后都能瞬时命中，一点血都没掉也照喊"喘不过气"；而每次自保会话进场又会重置"已播报"标记，于是反复说。现在改成先记账、再开口：只统计原版窒息伤害（in_wall），累计超过 4 点（5 秒窗口）才播报——真被闷住 0.25 秒就到门槛，没掉血则一个字都不说。只改"说不说"，不改"做什么"：挪位置、强制顶出、岩浆上下文保护全部原样保留；说与不说都会在运行日志分类「窒息」里留一行，可对账。 烧制 / 酿造没有目标时不再"把自己冻在原地"（粉丝反馈）：找不到炉子时旧版把她设成"彻底静止"，而那时随机散步是关的、其他移动驱动又都不管她 → 永久站住。现在三个"无目标"分支改为边走边找（每 2 秒在周围 8 格内挑一个闲逛点，受活动范围钳制；扫到就绑定、走过去坐下干活）；绑定并到达工作方块之后照旧站桩坐下，那才是"在干活"。 激流推进剂的四条连带修复（随第一条一起）：起飞时窜高、没起飞就炸风爆、落地愣一下、飞行跟随的朝向与"解除推进矢量"（现在会连衰减窗口一起收掉），以及远程空袭认不认它当燃料；六百四十二 又把力度整体 ×1.3（上一版实测偏慢，激流 III 甚至比俯冲自己飞还慢）——形状 / 水阻力 / 收手阈值 / 旋转时长一字不动。 骑乘或坐下时不再搭方块（护栏统一）：这条护栏原来散在三处、口径还不一样（挖矿只判骑乘、搭路另有一份坐姿判定、伐木与自保一处都没有）。现在对所有搭方块行为生效，判据统一。1.21.1 专属：手持重锤时收翅猛击按重锤下落加成结算那一套（重锤猛击 / 风刃 / 专属落地水）本版照旧，不受本次改动影响。 农场「收获物自动收集」写着关、收割产物却直接进背包（issue #22 第三条，实测六百四十九）：不是开关失灵，是那句说明写错了。查了两条链：① 我们自己的三处收割入口（原版目标格 / 3×3 整片 / BFS 连锁）在拾取前都用这个开关门控，线上 jar 的字节码里也能查到该字段引用；② 真正的原因在前置模组本体——反汇编车万女仆 1.5.3 的 TaskNormalFarm.harvest，产物走的是 EntityMaid.dropResourcesToMaidInv(...)，车万女仆收割时本来就把产物直接放进女仆背包（issue #20 反馈者描述的也正是这个机制）。所以把这一项改名为「农场掉落物立即拾取」并改写说明：它真正管的是"我们做连锁/整片收割时，要不要顺手把收割点附近散落的掉落物也立即捡掉"（默认仍是关 = 等她路过再捡）。行为一个字没改，改的只是说法；关着时收割产物照旧进背包、散落物等她路过捡，背包满了才掉地（精妙背包 / 旅行者背包会再接一层）。 v1.2.3 那批修复（如果你手上的是 v1.2.3 首发版或某次重传，请换成本版）：收放魂符丢血量上限与装备（issue #18）、着火连吃金苹果（issue #17）、法术冷却被多乘 20 倍（issue #16）、图纸三条（issue #12 / #14 / #15）、搭路刷物品（生存可刷，issue #19）、熔炉产物写进隐藏格子、法术任务下不再动她的主手——这些散在 v1.2.3 的三次重传附件里（文件名相同、内容不同）；本版把它们全部收进同一个新版本号，不会再出现"同名不同内容"。 三、口径变化（装之前看一眼） 压缩盒：带附魔的物品一律不能放入（原来是"默认拦、可以关掉"）。理由没变——①盒子只有 5 格，而附魔物品不可堆叠（不同附魔组合互相不是同一件东西），很快就满，它的定位是"大批材料的压缩仓"而不是装备库；②以前报的"附魔类物品存进去会消失"正出在这一类上。把开关关掉 = 把这些坑重新打开，所以这次干脆写死： 配置里的「禁入带附魔的物品」开关与「禁入清单」（自定义黑名单）两个选项已删除，配置面板原位留了一条只读说明「禁入规则」； 老存档配置里如果还留着 refuseEnchanted / refuseList 两行，不再被读取（也不影响启动，不用手动去删）； 压缩盒那一页现在只剩两条可调：女仆背包延伸、每格上限。 （1.21.1 侧判断"带附魔"多一条路：附魔书把附魔存在 STORED_ENCHANTMENTS 组件里，isEnchanted() 看不见它，所以按物品类型判。） 激流三叉戟的取材范围是"主手 → 副手 → 背包"三处（曾经有一版收成"只认背包"，已按反馈改回）；耐久扣在真正用到的那一件上。 接战时工作范围临时扩圈、散步默认速度 0.4 等原有口径不变。 四、手册与文档 「压缩盒」章按新口径重写（禁入那一条、可调的两条、自检那一行）； 「战斗与自保」章补两处：① 战斗还原会连「驻守 / 跟随」与她当时的作息一起还原（没记录过快照就完全不动她的设置）；② 「窒息/卡墙」那条写明只有真吃到超过 4 点窒息伤害才喊，自救动作照旧； 「农场与杂项功能」章补两条：驻守（home）模式的农场不再到处乱转（含旧版为什么会乱转的一句话根因）、锄地不抢路； 「这是什么」章新增 v1.2.4 起新增功能速览（激流三叉戟当推进剂、精妙背包 / 旅行者背包适配、骑乘或坐下不搭方块、烧制酿造不再冻住、远程空袭开火修复、右键蛋糕崩服修复、压缩盒禁入写死、驻守农场不再乱转、打完怪不再丢驻守、窒息不再当口头禅）； 游戏内自检 /maid_smart box check [女仆] 的段落名改为「禁入判据」，并新增一条：用反射确认那两个配置字段确实已经不存在。 主要功能一览 空袭（近战/远程两种飞行攻击模式 + 空袭轰炸；1.21.1 手持重锤时收翅猛击按重锤下落加成结算，飞得越高这一锤越狠） · 激流三叉戟（旋转冲击 / 飞行推进剂） · 重锤猛击（1.21.1 专属） · 战斗模式分类表 · 压缩盒 · 排班表（全女仆日程调度：早/晚/全天班次、6 段任务编排、当前时段高亮、一键集合、自动在家模式） · 建造系统（81 套内置蓝图 + 外部图纸/LLM 生成/AI 设计器、工地线框投影与 Z 键旋转、工头模式、进度持久化、缺料自动替代、区块内箱子取料、机械蓝图） · 挖矿（矿表白名单、连锁采集、透视感知、发呆看门狗） · 伐木（模组原木自动识别、随手补种、骨粉催熟） · 烧制 / 酿造（什么能烧就烧、多女仆多炉、药剂手册批量/定向酿造） · 农场（连锁收获/批量种植、耕地标记制、锄地索敌、作物骨粉） · 宰杀任务 · 战斗与自保（回血阶梯、逃生手段、保命道具优先、致死自动回魂符、女仆自动复活、环境伤害软处理、主动切换战斗+自动还原） · 主人免伤三层防护 · 被动技能（落地水/落地雪、岩浆放水、主人死亡传送、搭路、飞行跟随） · 单兵战术 · 贴身辅助（自动投喂/治疗/盾牌，喂食喂水走物品自己的路径） · 武器与工具自动切换（DPS 评分，兼容其他模组武器） · 指标石 · AI 记忆（段落/关系/画像/工作笔记 + 日/3日/周/月记忆日记 + 人格种子 + 睡一觉整理） · 主动对话 / 工作播报 / 自主决策 / 回复反馈学习 · 感知与情绪（PAD 模型） · 21 个 AI 工具（对话直接下命令） · TTS 语音（内置日语语音包 / 系统朗读 / 缓存 / 音量） · 冷却可视化 HUD · 床铺互通 · 交互（摸摸头/抱抱、蛋糕互动、女仆互助、手持光源、宠物保护） · 女仆安全与区块保载 · 运行日志 · 内置 33 章手册 · 全部功能游戏内配置面板逐项开关（7 大类 / 31 小类）

测试环境声明 模组 关系 测试通过的版本 Touhou Little Maid（车万女仆） 必装前置 1.5.3-neoforge+mc1.21.1 车万女仆：万法皆通（touhou_little_maid_spell） 软联动（法术兼容，非必需） 1.21.1 NeoForge 版 其他版本（含更新/更旧的 TLM）未必兼容，请以实际测试为准。除上述前置与法术软联动外，不对其他模组声明联动兼容性。

已知情况 只玩单人：开发者不玩多人，未做服务端优化。多人服务器上若有异常，欢迎反馈但请多谅解； 有粉丝报过「投喂蛋糕时女仆在前方小范围快速移动」：我们的投喂链路一行位移都没写，暂时没能定位。如果你也遇到，欢迎把 latest.log 里投喂那一刻前后 10 秒的片段发到 issue，并顺手用一个**原版食物（比如面包）**喂她做对照——这样能分清是"蛋糕那条链路"还是"喂食/站位"本身； 1.21.1 与 1.20.1 的差异：1.21.1 多一块重锤相关内容（重锤猛击、风刃、专属落地水），另外本版修掉的右键蛋糕崩服是 1.21.1 独有的移植问题（1.20.1 版没有这条）。 反馈 问题与建议请到 GitHub Issues：https://github.com/fadersketch/Promaid-mod/issues （本版的守家（home）模式两条——农场里到处乱转、打完怪丢驻守——对应 issue #22；精妙背包 / 旅行者背包适配对应 issue #20；远程空袭开火与右键蛋糕崩服来自粉丝在评论区的反馈，两条都带日志实证；窒息口头禅来自开发者本人的游玩反馈。）