传奇检测人物在线命令教程 全套checkonline脚本用法
一、传奇检测人物在线命令简介 在传奇版本脚本制作、功能定制以及NPC对话编写过程中，人物在线检测是高频使用的基础功能，能够精准判断玩家、英雄、游戏角色及服务器对应账号是否处于在线状态，是实现NPC交互、权限判定、功能触发、状态提示等玩法的核心脚本指令。熟练掌握checkonline…
一、传奇检测人物在线命令简介
在传奇版本脚本制作、功能定制以及NPC对话编写过程中，人物在线检测是高频使用的基础功能，能够精准判断玩家、英雄、游戏角色及服务器对应账号是否处于在线状态，是实现NPC交互、权限判定、功能触发、状态提示等玩法的核心脚本指令。熟练掌握checkonline相关脚本写法，能够帮助传奇GM快速搭建各类个性化游戏功能，优化游戏交互体验，完善服务器基础脚本逻辑。
本文将详细梳理传奇服务端中各类检测人物在线的标准脚本命令，包含普通玩家、英雄角色、专属游戏账号、服务器变量角色等不同场景的写法，所有脚本代码格式规整、可直接复制适配各类传奇版本，适配绝大多数传奇服务端内核。
二、基础人物在线检测脚本（玩家主体）
该脚本为传奇最基础的在线检测指令，主要用于检测当前操作NPC的游戏玩家是否在线，是传奇脚本中使用率最高的在线检测代码，适用于绝大多数基础交互场景。
[@main]
#IF
checkonline
#SAY
在线
脚本逻辑说明：触发NPC对应功能后，系统自动检测当前访问玩家的在线状态，若玩家处于在线状态，界面弹出“在线”提示文字，可根据游戏需求自行修改提示内容。
三、传奇英雄在线检测脚本
传奇游戏中英雄是玩家核心搭档角色，专属的英雄在线检测脚本可精准判定玩家召唤英雄的在线状态，常用于英雄专属功能解锁、英雄状态提示、双人玩法触发等场景。
[@main]
#IF
H.checkonline
#SAY
你的英雄在线
脚本逻辑说明：通过H前缀定向识别英雄角色，独立检测英雄在线状态，不与玩家主体状态冲突，精准适配传奇英雄版本的各类功能开发需求。
四、游戏专属账号在线检测脚本
针对传奇游戏专属游戏账号角色，可使用专属检测脚本，精准判定指定游戏账号的在线状态，适用于专属账号福利、专属功能权限判定等定制化场景。
[@main]
#IF
gameofmir.checkonline
#SAY
gameofmir在线
脚本逻辑说明：定向检测gameofmir专属游戏账号在线状态，针对性强，适合服务器专属定制角色的状态检测需求，适配各类定制版传奇服务端。
五、服务器变量角色在线检测脚本
传奇服务器支持变量角色在线检测，可通过S1变量实现动态角色状态判定，灵活适配多角色、多账号批量检测、动态提示等进阶脚本玩法，是进阶传奇脚本开发的常用代码。
[@main]
#IF
S1.checkonline
#SAY
<$STR(S1)>在线
脚本逻辑说明：借助S1服务器变量动态读取对应角色信息，自动检测该变量绑定角色的在线状态，并动态展示角色在线提示，灵活性极高，可适配各类进阶定制功能。
六、传奇在线检测脚本使用注意事项
1、所有检测人物在线脚本均适配主流传奇服务端内核，代码无冗余，可直接复制粘贴使用，无需修改基础格式。
2、不同前缀的checkonline指令对应不同检测主体，切勿混用，玩家主体用基础指令、英雄用H前缀、变量角色用S1前缀，避免检测失效。
3、可根据游戏玩法需求，自由修改#SAY后的提示文字，搭配其他脚本指令，可实现离线拦截、在线福利发放、状态权限限制等拓展功能。
