传奇LFM2翎风引擎脚本详解 SETOFFLINEPLAY 安全区离线挂机命令配置手册

admin

说明：开启该命令后，玩家在**安全区内下线**，人物不会立刻从地图消失，原地保留并进入离线挂机，持续按安全区规则累积收益；次日上线人物仍停留在下线点位。
SETOFFLINEPLAY 是 LFM2 引擎数据保存类脚本开关，专门实现【下线保留人物、安全区离线挂机】逻辑。
文档基于引擎官方帮助文档整理，附带实测步骤、示例、排错与 FAQ，供脚本调试、开服配置参考。

一、离线挂机核心机制
离线挂机核心特点：**下线不消失、仅安全区内生效、下线后自动执行挂机逻辑**
触发时机：玩家主动点下线
触发前提：下线瞬间人物位于引擎标记的安全区
和在线挂机区别：在线挂机是账号保持登录；该功能是玩家下线断开连接，角色实体留在地图挂机，二者可共存
生效边界：野外、危险区域下线，不触发离线挂机，人物正常消失

二、SETOFFLINEPLAY 命令格式
该命令属于纯状态开关，仅支持 `ON / OFF` 两个参数，无额外数值。
SETOFFLINEPLAY ON/OFF


脚本标准示例：
#IF
#ACT
SETOFFLINEPLAY ON
#SAY 你已经开启了安全区下线自动挂机
执行位置：可写在 NPC 对话段、登录触发段；在哪一段执行，就在该动作链更新玩家开关状态

| 参数 | 效果说明 |
| ON | 开启离线挂机，安全区下线后人物原地挂机保留 |
| OFF | 关闭离线挂机，恢复原版逻辑，下线人物直接消失 |
状态判定规则：以**最后一次执行**的开关为准，无内置查询变量，排查时全局检索脚本执行顺序即可。
⚠️ 本命令只控制挂机开关，不会修改地图安全区标记；安全区范围由引擎地图配置决定。

三、完整配置步骤
1. 在【登录触发段 / 专属 NPC 对话段】写入 `SETOFFLINEPLAY ON` 开启指令
2. 配套 `#SAY` 提示文字，告知玩家功能生效，避免误以为角色卡丢
3. 保存脚本，在 M2 引擎内**重载脚本**
4. 测试：账号站在安全区执行下线，观察角色是否留在原地挂机
5. 如需关闭：新增触发段执行 `SETOFFLINEPLAY OFF`，重载脚本即可

四、避坑指南（高频失效原因）
坑 1：在危险区 / 野外下线，期待角色保留
离线挂机**强制要求安全区作为前置条件**。野外下线直接走原生下线逻辑、人物消失，不属于 BUG。测试务必在安全区内下线验证。
坑 2：开关被后续脚本覆盖
SETOFFLINEPLAY 为状态型开关。如果登录脚本开 ON，后续其他 NPC、登录后置脚本执行了 OFF，最终状态以后面那条为准。
排查方案：全局搜索脚本内所有 `SETOFFLINEPLAY`，梳理执行先后顺序。

五、高频 FAQ
1. 开启 SETOFFLINEPLAY，玩家下线会发生什么？
玩家在安全区主动下线，角色留在原地进入离线挂机，持续获取安全区挂机收益；下次登录角色还在原地。危险区域下线，人物正常消失，不触发挂机。
2. 已经开了 ON，下线人物依旧消失？
优先两点排查：①下线位置是否是引擎识别的安全区；②是否存在后续脚本执行 SETOFFLINEPLAY OFF 覆盖开关。确认后重载脚本复测。
3. SETOFFLINEPLAY 离线挂机 和 在线自动挂机的区别？
在线挂机：账号保持在线，角色在线执行挂机；
SETOFFLINEPLAY 离线挂机：玩家主动断开下线，角色实体留在安全区挂机。两者可以同时存在，离线挂机有安全区硬性限制。
4. 如何判断当前是 ON 还是 OFF？
命令本身没有查询接口，以脚本最后一次执行的指令为准。只写 ON、没有任何 OFF 执行，则永久保持开启。
5. 哪些地图可以生效？危险区下线怎么处理？
仅引擎标记为安全区的区域生效；危险区、野外下线，角色正常消失，不会挂机保留。
6. 关闭离线挂机需要重启引擎吗？
不需要重启引擎。写入 `SETOFFLINEPLAY OFF`，保存脚本，M2 重载脚本立即生效。也可以单独做 NPC 按钮，给指定玩家单独关闭。
7. SETOFFLINEPLAY 和 CheckOffline 是什么关系？
SETOFFLINEPLAY：**写指令，设置离线挂机开关
CheckOffline：**检测指令，判断角色当前是否处于离线挂机状态
搭配使用：先用 SETOFFLINEPLAY 开启功能，后续奖励、计数脚本用 CheckOffline 识别挂机角色。

六、要点总结
命令：`SETOFFLINEPLAY ON` 开启 / `SETOFFLINEPLAY OFF` 关闭
硬性前提：仅**安全区内下线**才会保留角色挂机
状态规则：最后执行的开关覆盖前面，排查失效优先检索脚本执行顺序
重载脚本即可生效，无需重启引擎

本示例来自 LFM2 引擎官方帮助文档，经过本地实测可用，正式服上线前请务必自测！