传奇脚本全局变量使用说明 分类、核心命令及实操实例详解

传奇脚本中的全局变量，是实现跨脚本数据共享、角色状态持久化的核心工具，掌握其分类与使用方法，能大幅提升脚本开发效率。

全局变量的核心特性的是“全局可见”，即一个变量在某一脚本中定义或赋值后，在整个脚本系统的其他脚本里都能调用，且数据会一直保留至引擎重启或主动清除。这与仅在单个脚本内生效的局部变量有本质区别。

按作用对象划分，全局变量主要分为角色绑定型、地图绑定型和系统通用型三类，不同类型适用场景差异明显。

角色绑定型全局变量，前缀多为“HUMAN_”，仅对特定角色生效，数据与角色ID绑定，角色离线后重新上线数据仍保留。常用变量如“HUMAN_GOLD”对应角色金币数量，“HUMAN_LEVEL”对应角色等级，无需手动定义即可直接调用，适合记录角色专属属性。若需自定义角色变量，格式为“SetHGlobalVar 角色ID 变量名 数值”，例如“SetHGlobalVar 10001 VIPLevel 3”，代表给ID为10001的角色设置VIP等级为3。

地图绑定型全局变量，前缀多为“MAP_”，数据与地图ID绑定，作用范围仅限对应地图内的所有角色。常用变量如“MAP_MONSTERCOUNT”记录当前地图怪物总数，适合实现“清图任务”“地图人数限制”等功能。自定义时使用“SetMGlobalVar 地图ID 变量名 数值”命令，比如“SetMGlobalVar 201 BossRefresh 1”，表示201号地图的BOSS已刷新，值“1”代表已刷新，“0”代表未刷新。

系统通用型全局变量，无固定前缀，作用范围覆盖整个脚本系统，所有角色和地图均可调用，适合记录全服性数据。例如记录全服活动开启状态，可自定义变量“ActivityOpen”，赋值命令为“SetGlobalVar ActivityOpen 1”，全服脚本都能通过“GetGlobalVar ActivityOpen”获取该变量值，判断活动是否开启。

全局变量的核心操作命令包括赋值、取值和清除三类，需熟练掌握格式与用法。赋值命令根据变量类型对应使用SetHGlobalVar（角色）、SetMGlobalVar（地图）、SetGlobalVar（系统）；取值命令对应为GetHGlobalVar、GetMGlobalVar、GetGlobalVar，格式为“变量=GetXXXVar 参数1 参数2”，例如“当前金币=GetHGlobalVar 10001 HUMAN_GOLD”；清除命令为ClearHGlobalVar、ClearMGlobalVar、ClearGlobalVar，格式为“ClearXXXVar 参数1 参数2”，如“ClearGlobalVar ActivityOpen”可清除全服活动状态变量。

使用时需注意三点：一是变量命名避免使用特殊符号，建议用字母+数字组合，如“Task_Progress”而非“任务进度”；二是角色和地图变量需准确传入角色ID或地图ID，否则会导致数据错乱；三是系统变量若长期不用需及时清除，避免占用引擎资源。

实操实例：实现“全服首杀BOSS奖励”功能，可设置系统变量“FirstKillBoss”，初始值为0。当有角色击杀BOSS时，脚本判断“GetGlobalVar FirstKillBoss”是否为0，若是则发放奖励，并执行“SetGlobalVar FirstKillBoss 1”，后续击杀的角色检测到变量值为1则不再发放奖励，高效实现全服唯一奖励逻辑。