角色与英雄
检查英雄是否在线
检查当前角色的英雄是否处于在线状态。
命令用途
CheckHeroOnline 用于检查当前角色的英雄是否在线。
命令名
CheckHeroOnline
调用格式
CheckHeroOnline
返回或影响
- 这是检查型命令，只能在条件判断流程中使用。
- 当当前角色的英雄在线时，
#IF条件成立。 - 当英雄不在线时，条件不成立。
- 该命令只检查英雄在线状态，不负责判断当前角色是否已经拥有英雄；这类前置条件通常应先用
HaveHero判断。
示例
基础用法
#IF
CheckHeroOnline
#SAY
英雄在线。
#ELSEACT
MessageBox "你还没有召唤出英雄。"
BREAK
这段写法用于先判断英雄当前是否在线，再决定是否允许继续进入后续英雄功能流程。
常见变体
#IF
HaveHero
CheckHeroOnline
#SAY
失败，英雄在线时不能改名。
<关闭/@exit>
#ACT
SendMsg 0 "英雄在线时不能改名。"
BREAK
这类写法用于在涉及英雄改名、删除、转职等操作前，先判断角色是否拥有英雄，再限制英雄在线时直接执行敏感操作。
注意事项
CheckHeroOnline只判断英雄是否在线，不等于“是否拥有英雄”。如果角色可能根本没有英雄，建议先写HaveHero。- 这类判断常用于执行
H.前缀命令之前，避免在英雄不在线时直接进入后续流程。 - 如果你的业务只要求“拥有英雄”而不要求“当前在线”，不要把
CheckHeroOnline当成拥有英雄的替代判断。