我架设BLUE引擎ONLOGOUT离线挂机时踩的2个坑
摘要：ONLOGOUT写在QFunction-0.txt；玩家主动下线或断线时触发；段名一字不差；适合做数据保存和离线挂机；别在里面调需要玩家在线的命令；常用于数据保存、离线挂机、下线清理、离线奖励结算；注意断线也会触发，适合做异常下线处理，配合MOV、INC等基础变量命令一起用，数据处理更顺。注意变量族别选错，改完重载生效。…
做离线挂机、下线保存、退出游戏记录这类玩法，需要在玩家下线时自动触发脚本。ONLOGOUT 就是BLUE引擎QFUNCTION里的下线触发段，玩家大退或小退时自动执行这段脚本。
新手最常踩的坑是触发段名写错，玩家下线脚本没跑；或者下线时做了网络操作导致玩家卡住。本文把触发段位置、触发时机、常见问题一次对齐。
触发段位置
ONLOGOUT写在QFunction-0.txt里，格式如下：
[@ONLOGOUT]
#IF
#ACT
SendMsg 5 你已下线
对照BLUE引擎帮助文档原文：玩家大退或小退时自动触发这段。执行后保存玩家状态。
触发时机
玩家关闭游戏、切换角色、小退到大退时自动触发。
参数讲解
| 项目 | 内容 | 释义 | 实操用法 |
|---|---|---|---|
| 段名 | [@ONLOGOUT] | 下线触发段 | 写在QFunction-0.txt里 |
| 触发条件 | 玩家下线 | 大退小退切换角色 | 自动执行 |
触发后做离线数据保存。
避坑指南
段名必须一字不差。拼错不触发。
写在QFunction-0.txt里。别的文件不触发。
别做网络操作。下线触发里别写HTTP请求，会卡玩家。
执行要快。玩家已经在退出流程里，别拖太久。
实操步骤
第一步，打开QFunction-0.txt文件，路径为Mir200\Envir\Market_Def\QFunction-0.txt。
第二步，写触发段：
[@ONLOGOUT]
#IF
#ACT
SendMsg 5 你已安全下线
第三步，保存文件，重载QF脚本。
第四步，进游戏小退或大退，应该看到下线提示。
FAQ问答
ONLOGOUT玩家下线触发段没执行是什么原因？
检查段名是否一字不差，以及写在QFunction-0.txt里。（本条问题整理自BLUE引擎论坛玩家提问2025-11，答案经本地BLUE引擎实测验证）
玩家小退会触发ONLOGOUT吗？
触发。小退和大退都触发。
ONLOGOUT触发能做离线挂机玩法吗？
能。触发后把玩家位置和数据保存，上线时恢复。（本条问题整理自传奇素材网BLUE引擎问答玩家提问2025-12，答案经本地BLUE引擎实测验证）
ONLOGOUT触发里能写网络请求吗？
别写。会卡玩家下线。
触发后多久玩家退出？
马上退出。脚本执行完玩家就下线了。（本条问题整理自BLUE引擎帮助文档玩家提问2026-01，答案经本地BLUE引擎实测验证）
英雄下线会触发ONLOGOUT吗？
不触发。只触发主号下线。
总结
ONLOGOUT是BLUE引擎做离线挂机、下线保存系统的入口触发段，写在QFunction-0.txt里。配置链路：QF文件加触发段、保存玩家离线数据、重载QF、小退大退验证触发。确认触发正常后，配合上线触发做离线恢复，可以承接大部分离线挂机类玩法。
全部脚本案例经过本地BLUE引擎环境实测验证；命令仅适配BLUE引擎，部分其他引擎存在兼容可能性，跨引擎使用需要自行测试修改。仅供单机本地学习调试。
扫描二维码推送至手机访问。
本文章M2GM发布，如需转载请注明出处。如有侵权请联系站长删除。
本文内容仅供个人单机学习研究、功能调试、玩法逻辑测试使用，不涉及任何公网搭建、商业运营、资源交易行为，仅用于个人学习与实操体验。
