玩家完整流程

本页可直接作为玩家教程和管理员验收脚本。所有测试都应使用普通权限账号，并记录余额、装备券、邮箱数量和对局前后库存。

1. 大厅准备

1. 清空原版背包、装备栏及副手。
2. 用 /fkescape shop 或右键商店 NPC 打开商店。
3. 购买一份背包档位权益；需要时购买装备券。
4. 使用 /fkescape mailbox 先领取历史撤离物资。

同一玩家只能持有一份待消费背包权益。已有权益时按同档报名不会重复扣费；成功进入游戏服后才消费权益。/fkescape join 不写档位时优先采用上次档位，首次使用默认档位。

预期结果： 购买成功后余额只减少一次；重复点击同一装备券不会重复拥有。

常见坑： 报名要求原版库存为空。因此大厅商店发到原版背包的食物、医疗与增益品不能直接带入战局；局内消耗品应主要投放到战利品池。

2. 报名与匹配

执行 /fkescape join [small|medium|large|huge]，或右键报名 NPC。排队期间玩家仍在大厅，可用 /fkescape leave 取消。

报名会检查库存、余额、背包档位以及是否有可用游戏服。人数达到要求后，系统会把本轮玩家送入同一台游戏服。

预期结果： 人数不足时不转服；达到阈值后同批成员进入同一台游戏服。非空背包玩家被明确拒绝。

3. 游戏服准入与选装

玩家到达目标服并等待其他成员。进入选装阶段后选择一张已拥有的装备券；菜单关闭时可用 /fkescape equipment 重开。

装备券可来自商店购买记录或永久权限。每局只能选一张。购买券会跨成功对局保留，但死亡、主动离开或行动失败会撤销全部购买券；权限券不会被撤销。

预期结果： 只能看到已拥有的券；发放命令全部作用于当前玩家；无票直连者不能参与。

常见坑： 发放命令失败、MMOItems ID 不存在、选装时间过短。租借装备若被移入战术背包或保险箱，当前版本允许带出；必须把它计入经济设计，不能假设插件会拦截。

游戏服会占用快捷栏最后三格作为功能入口：倒数第三格只在尚未完成选装时显示“装备选择”，倒数第二格打开战术背包，最后一格打开保险库。功能道具不能移动、丢弃、交换到副手或带入任何网格；离场和结算时会被删除。等待队员阶段会显示保险库入口，但保险库要到选装阶段初始化后才能打开。

玩家未打开任何容器或菜单时，可按“潜行 + 副手键”（默认 Shift + F）打开战术万用菜单。普通副手键仍执行原版换手；玩家重绑副手键后，万用菜单快捷键也会随之变化。已打开 GUI 时不会接管该组合键。

4. 行动、搜刮与网格

进入 RUNNING 后：

• /fkescape pack 打开战术背包；保险库通过快捷栏或战术万用菜单单独打开。
• 右键配置坐标上的容器打开战利品网格。
• 物品可在网格中放置和旋转；保险箱按权限选择最高档。
• 资源区决定战利品等级、伤势倍率与 Boss 规则。
• 同一容器被占用时其他玩家不能同时搜刮。

战术背包只属于本局；保险箱长期保存。曾拥有高档保险箱后权限降低，会只读打开旧尺寸，恢复权限后才能继续操作。

预期结果： 容器首次打开按对应池生成物品；战术背包与保险箱的物品归属清晰，不出现在原版跨服同步中。

5. 伤势、医疗与增益

战斗伤害会按 injuries.yml 的全局概率、伤势权重、属性效果和当前区域倍率判定。持续流血会周期扣血。专用医疗品按 MMOItems TYPE:ID 匹配，可治疗指定类型、止血并有使用时间。

增益物品必须由 FKEscape 商店或战利品生成，普通 /give 得到的同材质物品不带插件身份。增益只在行动阶段右键生效，成功应用后消耗一个。

预期结果： HUD/提示显示伤势；正确医疗品完成读条后移除对应状态；错误物品不治疗。

常见坑： 把默认金苹果当作伤势医疗品、MythicLib 属性名写错、效果等级误认为从 1 开始（药水配置从 0 开始）。

6. 撤离

进入撤离区后自动开始倒计时。普通 TIMED 点始终按配置开放；条件点可要求击杀特定 Boss，并按全局或击杀者个人解锁。

倒计时期间离开区域或受击会中断。受击中断后通常要先离开再重新进入。条件 Boss 本局生成失败时，对应撤离点会被标记不可用，因此地图必须至少提供一个普通撤离点。

预期结果： BossBar 显示撤离进度；满足条件并完整留在区域后成功；离区和受击不会误结算。

7. 结算、邮箱与失败

成功撤离时，战术背包中的物资批量写入邮箱，同时删除本局背包网格；之后清除原版局内装备并送回大厅。回大厅执行 /fkescape mailbox，背包有空间时点击领取。

死亡、行动中主动离开、掉线超时或回合超时均为失败：战术背包清空，不进入邮箱；保险箱保留；购买装备券按规则撤销。

只有战术背包会进入邮箱

留在原版背包的战利品不会撤离；放进保险箱的物品也不会进入邮件，而是继续留在保险箱。

邮箱领取先尝试放入原版背包，成功后才删除邮件。背包满时应保留邮件。邮箱目前不会自动过期。

一局验收记录模板

时点	余额	背包权益	购买券	邮箱数	原版库存	战术背包	保险箱
报名前					空	无
扣款后					空	无
进入游戏		已消费			选装装备	空
撤离后					已清空	已删除	保留
领取后					获得邮件物品	无	保留

至少再做一局死亡测试和一局掉线超时测试，确认失败路径不会生成邮件或恢复权益。