Promaid

Promaid v1.3.0-beta（1.20.1 Forge + 1.21.1 NeoForge） Latest @fadersketch fadersketch released this 30 minutes ago · 1 commit to main since this release v1.3.0-beta c3a1327 Promaid v1.3.0-beta — 发布声明 Minecraft 1.20.1 · Forge 47.4.x ｜ Minecraft 1.21.1 · NeoForge 21.1.x（两个 jar 同批发布）

开发者为单人、不玩多人、没做服务端优化，请理解。

一个前置：车万女仆 Touhou Little Maid ≥ 1.5.0 —— 纯独立前置，不对任何其他模组做专属联动。

安装前请删掉 mods 里的旧 promaid-*.jar（同一个 modId，同时存在会启动失败）。 旧存档无缝升级：物品 / 任务 / 蓝图 / 记忆 / 排班沿用 maid_smart 命名空间。

这一版是 v1.2.4 之后的第一个大版本（beta）。下面是新功能，然后是本次要交代的两处开发者声明。

一句话 这一版补了两个新道具——武装拴绳（你挂到会飞的女仆身下，当武装直升机的二号位开火）和骑乘指挥棒（让女仆骑坐骑 / 载具 / 龙跟着你走）；卓越前线的载具从此能真正交给女仆开、也能替她开火；飞行载具（直升机 / 飞艇 / 固定翼 / 汤姆6）各接各的飞法，空中炮艇真的会起飞了；并新增「投弹安全高度」——基洛夫投弹前会先拉高，免得把自己也炸进去。可以自己骑扫帚。

一、新功能

1. 武装拴绳（二号位 · 挂在飞行女仆身下开火）★ 全新 粉丝点单的武装直升机玩法：女仆当一号位（她飞、她开火），你当二号位（挂在她身下开火）。 道具是 【武装拴绳】（合成：拴绳 + 铁锭 ×2），用法和原版拴绳一样——拿着它右击女仆。

什么时候能绑： ① 扫帚模式——她已经骑在扫帚上时右击她（或你坐在扫帚驾驶位上右击她）→ 你从扫帚上下来、挂到她的二号位（这一档要求她先飞起来，地面上挂着会把人拖进地里）；

② 空袭模式（近战 / 远程）——随时能绑：她还没起飞时先进入牵绳档（你自由活动、她跟着你走，绳子照画），等她真的起飞才把你挂到二号位，她落地满 2 秒再把你放下、回到牵绳。

归属规则：只认主人；一只女仆同时只挂一人；你同时只能牵一只——绑第二只时会自动把第一只完整松开。

怎么解：再右击一次，或者按潜跳下鞍。绑定态右击她 = 解除并坐回扫帚驾驶位；在扫帚驾驶位上右击她 = 换到二号位——这两半互逆，来回切就是「我开 / 她开」两种坐法（换座时走原版「玩家插队」规则，她全程没下过鞍）。

绳子不会自己断：落地不会自动放人；只有落水超过 0.6 秒才把你放下来。解除瞬间人在空中，给 5 秒摔伤豁免；挂着时你和女仆同款免伤（卡墙 / 挤墙 / 摔落 / 撞墙）。

画面三件事：① 第一人称半透明（只对「你 + 第一人称」把她和那把扫帚画成半透明，默认透明度 0.1、可调、填 1.0 就是关掉；第三人称与别的玩家看到的一切照旧不透明）； ② 金色描边（被绳子选中、还没正式起飞的她身上有金色发光描边，正式起飞那一刻解除）； ③ 白色丝带——用的是原版拴绳同款的丝带几何（24 段三角带 + 编织明暗 + 两端光照插值），隔远不再消失、两端按帧插值、正下方也不会叠成一条竖线。

左上角蓝色「绑定中」：拴着时屏幕左上角多一行「◆ 绑定中 <她的名字> 牵绳 / 二号位」——牵绳表示你自由活动、她跟着你走；二号位表示你正吊在她下面。

数值：悬挂距离（你脚底到她脚底的垂直距离，默认 2.6 格，可调 0.56.0；她站在地上时改成水平拉开这么远并肩站着）；扫帚额外下沉（默认 0.3 格）；拉扯（默认开，绷紧时真的拉她，分档照搬原版拴绳——超过 6 格照抄原版那一记冲量，26 格补一个「朝你接近的速度上限」；原版超过 10 格会撒手，我们的绳子不会断）。

二号位开火：挂着时照常射击（弓 / 弩 / 枪械都行）——她打她的目标、你打你瞄的，各自独立。

拴绳操控（默认开，仅空袭档）：她此刻没有目标时，只要你手里拿着武装拴绳，你的视线就是她的机头——平视 = 平飞不掉高、抬头 = 爬升、低头 = 下降，速度固定 ≈6 格/秒。有敌人时不接管（控制权交回空袭链路）。

1.21.1 树专属：二号位重锤猛击（重锤是 1.21 才有的东西，1.20.1 没有这一条；只对空袭档生效，扫帚档不开这个后门）。

1. 骑乘指挥棒（让女仆骑坐骑 / 载具 / 龙）★ 全新 道具是 【骑乘指挥棒】（合成：拴绳 + 木棍）。让女仆骑上坐骑、跟着你走。

顺序固定：先右击坐骑、再右击女仆（反过来会被回一句「先用骑乘棒右击坐骑，再来右击我」——「先选女仆」那条路实机不可靠，已刻意堵死）。

手持指挥棒的三种操作：右击 = 选中 / 配对 / 解除；左击 = 主驾 ↔ 副驾换座（多座载具专用）；空手右击女仆开的载具 = 坐进空着的副驾。手里拿着指挥棒时绝对不会登乘。

原版坐骑：马 / 驴 / 骡 / 骷髅马 / 僵尸马 / 猪 / 炽足兽 / 骆驼…判据是「能不能上鞍」这个原版接口，不写死实体 id，别的模组坐骑零适配。

一位主人可同时带多条链路；一只坐骑同时只服务一位女仆。

她骑上去之后，近战 / 远程的走位原样还原（走位意图不变，只是把「她走」换成「坐骑走」）。

1. 卓越前线载具：女仆能开、能打 ★ 重点 驾驶：坐在**驾驶位（座位 0）**就能开（它的引擎认「第一乘客」，不要求是玩家）。 开火：把目标同时写进炮塔与武器位的 AI 目标，用载具自己的炮弹打；她自己背包里对得上的子弹会搬进载具的弹药容器（每 0.5 秒按需搬）。当前弹种没弹时会自动换弹种 / 换炮。 地面载具接敌会绕圈（半径按车速与车体自适应，撞墙自动调头），不再「往敌人身上一撞就完事」。

开陆地载具不再把主人撞倒：停车距离按车体半宽自动放大（坦克约 3~4 格），与「跟随停下距离」取大。

真刹车：进停车带就清输入 + 把油门 / 转向 / 目标速度三件一起归零 + 每拍给动量打阻尼，不再一路漂移。

1. 飞行载具：四种各接各的路 ★ 重点 卓越前线的飞行载具按引擎分成四类，各接各的路（面板「骑飞行载具·悬停与盘旋」对四类都生效）：

直升机：航向 / 俯仰走鼠标通道、高度走总距；跟随时比主人高三格悬停、接敌时升到敌人上方绕圈。 固定翼 / 空中炮艇（AC-130H / A-10 等）：没有竖直输入轴，不能悬停——改用引擎自带的盘旋（loiter），她会停在原地绕圈、不再一路飞走。 飞艇（基洛夫 / 极恶乐魂等）：并入直升机的空战电路，接敌时会自己升到敌人上方。 汤姆6：原本油门与姿态只写给玩家、女仆一动不动；现在直接写推力 + 俯仰 + 机头，她会飞、会跟着你走。 急停四类通用：到点抹平水平速度 + 每 0.5 秒收一次 + 水平速度钳进包络（竖直分量不碰）。 空中炮艇（AC-130H）真的会起飞了：它是「要跑道助跑」的真飞机，没有初速就永远起不来；现在贴地时每拍写一个抬头角 + 补一点竖直速度把 onGround 顶掉，离地后交回引擎自己的盘旋。 四类都不再把机头掰向敌人（命中由炮弹末制导兜）。 5. 投弹安全高度：基洛夫先拉高再投 ★ 新 开（面板「骑飞行载具·悬停与盘旋 → 投弹安全高度」，默认 20 格）。

她骑飞行载具、且这一下要往下投弹时：机身会被抬到「目标高度 + 这个格数」，并且没爬到位就按住这一发不投。基洛夫那颗航空炸弹的爆炸半径是 42 格，贴地投弹等于把她自己也圈进爆心——这一档就是「先拉高再丢」那道闸。填 0 = 关掉。

1. 扫帚模式 —— 骑着扫帚飞着打 给女仆一把车万女仆的扫帚 + 任意远程武器，把她的任务切成**「扫帚模式」**，她自己把扫帚取出来踩在脚下、骑上去，用主手武器在空中打。

只有你手动指定才会进这个模式——被怪袭击时她不会自己换上扫帚。

齐备三件 扫帚：主手 / 副手 / 背包 / 精妙背包里都行；世界里已经放着的那把扫帚实体，她也会走过去骑上； 远程武器：弓 / 弩 / 御币 / 三叉戟 / 枪械都行； 弹药：弓弩要箭；枪械要对得上手里那把枪的子弹（由枪械 mod 自己判，不是「有任意子弹就算」）；御币 / 三叉戟 / 能量枪不消耗。 缺哪一件她会在头顶气泡里说清，并原地待命——不会自己冲上去挥拳头。

怎么飞、怎么打 接敌：先爬到敌人上方 12 格（可调 2~32，顶头就按实际高度），然后绕着敌人开火。开火链路与远程空袭完全同款——射程、视线、冷却、换弹一模一样。

绕圈不是死圈：半径在「盘旋距离」与「离敌最远距离」之间随机缓动，旋向按 UUID 对半（一半顺着绕、一半逆着绕），转速每 3 秒缓慢游走。离敌最近距离（默认 6 格）保证近战怪摸不到她；接敌时与同伴的间距放宽到 4 格。三件事合起来——半径随机 + 旋向对半 + 间距拉开——多只女仆不会落在同一条射线上互相串击。两个端点由你定，中间才随机。 没敌人时：开着守家 → 沿工作范围的边缘盘旋巡逻（默认离地 8 格，可调，顶头自动压低；敌人在圈外她不追出去）；没开守家 → 跟着你飞（跟随起手 / 收手距离默认 6 / 3 格，所以是贴着你飞，不是隔二十多格才跟过来）；没事干就落回地面待命，不会一直挂在半空——顺着脚下探地降到离地约 1.6 格，探不到地（虚空 / 高出地形太多）就照旧悬停，绝不往下扎。

锁敌：与两种空袭共用同一个索敌器——以她为圆心、半径 50 格的球发现目标；打起来之后锁定不再按 50 格丢，只要目标还活着、还能打、没越出守家范围，拉到 128 格都继续瞄着，而且锁定期间不再要求视线（飞高之后被树叶挡一下就丢目标，是旧版最大的毛病）。 牵引绳：离参照点超过 100 格（可调，0 = 关闭）就连人带扫帚一起传送回来，并在聊天栏说一句。参照点 = 非守家时是你，守家时是工作区圈心——守家时你走多远都不会把她拽走，拉回来的是家 / 岗位。排班表的「召她过来 / 一键集合」现在也认扫帚，会连人带扫帚一起搬过来；搬不动（跨维度等）也会先让她收工、把她传送回来、她自己再骑上，不会只回一句「没办法传送」。

空中避障 不钻一格死洞：卡墙脱困按她自己的身体判格（窒息的是她、不是扫帚），一格死洞不进、刚去过的空气格 5 秒内不再进，一个合格格子都没有就原地不动，绝不把她按进方块里； 真被闷住立刻脱离：扫帚贴墙滑动时位移不算零，旧的「连续 0.6 秒没动」永远攒不满——所以现在直接用原版那道「这一 tick 要不要扣她窒息伤害」的判据，为真就立刻退到能容下她的空气格；

泡进岩浆或被点着立刻传送出去：岩浆每秒 4 点、她只有 20 血，等不起扫帚那种有时长的转向脱困；

不叠罗汉、不贴地：多只女仆绕圈的起点按各自 UUID 错开，跟随 / 守家巡逻的高度都先过一道「她放得下吗」，有天花板就压到放得下的最高一格。

这个模式下的限制（重要） 她是骑乘状态（骑在扫帚上），所以在这个模式里：

只能用主手武器打——她的输出就是这一件； 不会施法。法术（含位移类法术）只在空袭 / 飞行跟随里放，那两个行为明确拒绝「乘客状态」；想让她放法术，请把任务换成空袭； 不会放 TNT / 末地水晶 / 重生锚 / 床。轰炸那一套对扫帚模式强制关闸（起手、投掷、以及在飞的那一段三处都拦，已经放下去的方块会回滚进背包）。

和武装拴绳一起玩 她骑着扫帚飞、你拿武装拴绳右击她，就挂到她身下当二号位，一起开火。详见「武装拴绳」一节。

参数在哪调 手册 → ⚙ 模组详细配置 →移动与行为 → 扫帚模式，共十三项：总开关、盘旋距离、离敌最远距离、离敌最近距离、悬停高度、接敌爬升高度、牵引绳距离、平时是否跟随主人、守家时是否绕工作范围盘旋、守家盘旋高度、跟随起手距离、跟随收手距离、卡墙脱困。填完点「保存并返回」立即生效。

1. 手册重写 + 其它内容 内置手册重写「骑乘指挥棒」整章：旧版把历年修复叙事全堆在正文里（561 行，读起来像第二份更新日志），本版只讲当前功能（130 行）；补上了此前描述不准的绑定顺序与左击换座。 扫帚模式 / 空袭：接敌机动每场换、随机环绕与旋向、防叠罗汉、危险方块主动绕开、锁敌口径并入「发现 50 格 / 维持 128 格」。 仿创造飞行并入（含 PR #24 的本地修复版）+「有创造飞行能力就禁用搭路」。 鞘翅外观做成通解（自推鞘翅、YSM 模型、饰品栏里的鞘翅也算空袭三件套）。 二、修复（挑要紧的） 跨维度跟随导致整合服务端崩溃（Exception in server tick loop，边遍历原版实体表边把女仆跨维度传送 → fastutil 迭代器越界）。 复活后建模变幽灵：自动复活之后自己补三枪实体包。 面板排版在窄窗口下比一页还高、把翻页/保存按钮压住。 守家（home）模式两条（issue #22）：农场女仆在田里到处乱转、打完怪「驻守」变成「跟随」。 **「我卡住了，快喘不过气了」**改成真吃到超过 4 点窒息伤害才说。 收放魂符丢血量上限与装备、着火连吃金苹果、法术冷却被多乘 20 倍、图纸三条、搭路刷物品等一批。 三、开发者声明 一、六台载具被列入黑名单，骑乘指挥棒选不中 卓越前线（Superb Warfare）里有六台载具，女仆一律骑不上、也不去骑：

Ju-87 斯图卡轰炸机 A-10 雷电二攻击机 AC-130H 空中炮艇 KV-16 幽灵战斗机 汤姆 F6F 迷你快艇 拿骑乘指挥棒右击它们，女仆会回一句：「这架 XXX 操作门槛太高（或只认玩家来开），我驾驭不了～」

为什么拉黑——两类原因，都不在女仆这一侧：

操作要求太高（Ju-87 / A-10 / AC-130H / KV-16）：这四台全是固定翼。固定翼没有竖直轴，高度只能由「速度 + 俯仰」积分出来——起飞要助跑、盘旋要维持速度。把这套东西交给「去某个点」这一层意图，结果必然是要么一头栽地、要么一路飞走。玩家自己飞都得练，女仆没有「练」这件事。 代码上直接认准玩家（汤姆 F6F / 迷你快艇）：汤姆 F6F 的油门与姿态**整段只写给「乘客是玩家」**那一支，女仆是生物、压根进不去；迷你快艇只有一个座位、走的是水面物理。这两台的驾驶逻辑开发者做不出来，与其继续打补丁，不如照实承认——认人，不给她开。 其余载具一律不受影响：坦克 / 装甲车 / 直升机 / 飞艇（基洛夫等）照旧能骑、能开、能打。 旧存档里如果已经让她坐上了这六台，她会每拍自检并自动解绑。

二、冰火传说的龙：能挂上去，但不建议 龙可以绑——女仆会被摆到龙给玩家的那个鞍位上（她不是乘客，龙的行动会转成跟随你，传送只传她不传龙）。 但观感上十分违和：摆位靠公式硬算，龙飞起来、转身的时候，能明显看出错位与不自然。 所以不推荐大家这么做。 开发者的原意是做「女仆真正乘坐在龙上」并操纵它，但冰火传说龙的代码防护太强，很难让女仆骑上去并操纵，最后只能退成这个「挂在鞍位上」的折中方案。这里如实交代，而不是包装成完成品。 四、装之前看一眼 版本号：mods.toml 里仍写 1.3.0；平台上的版本号与标题写作 1.3.0-beta（beta 渠道）。 两个 jar：promaid-1.3.0-forge-1.20.1.jar / promaid-1.3.0-neoforge-1.21.1.jar，按你的加载器选一个。 完整逐条日志见仓库 CHANGELOG.md。