全局变量是支撑传奇脚本跨场景数据持久化的核心载体，区别于仅在当前脚本片段生效的局部变量，它可以在全服所有地图、所有玩家、所有功能模块之间共享数据，不会因为脚本执行结束、玩家下线或者地图重启就自动清空，是实现全服计数、跨场景状态标记、公共资源管控等核心玩法的基础。
全局变量的核心分类与命名规则
按照作用范围和存储特性，全局变量可以分为三类，每一类都有对应的固定命名前缀，不能随意混用。
第一类是服务器级全局变量，命名前缀为G，格式为G+自定义变量名，这类变量的作用范围覆盖整个游戏服务器，所有在线玩家、所有地图场景都可以读取和修改同一个变量值，不会因为单个玩家的操作被重置，适合用来存储全服公共数据，比如全服BOSS刷新次数、沙城占领状态、全服活动累计参与人数这类跨所有角色的公共信息。
第二类是角色绑定全局变量，命名前缀为HUMAN，格式为HUMAN+自定义变量名，这类变量会和玩家的角色数据绑定，永久存储在角色数据库中，玩家下线再上线后变量值不会丢失，不同玩家的同名称变量相互独立互不干扰，适合用来存储单个玩家的长期进度数据，比如玩家累计挖矿时长、专属任务完成状态、永久属性加成计数这类和单个角色深度绑定的信息。
第三类是游戏场景级全局变量，命名前缀为MAP，格式为MAP+自定义变量名，这类变量的作用范围仅限定在指定地图内，只有在对应地图中的脚本逻辑才能读取和修改该变量，不同地图的同名称变量完全隔离，适合用来做单地图内的专属状态管控，比如专属副本的剩余通关时间、地图内BOSS的存活标记、地图专属资源的剩余刷新数量这类仅在单地图内生效的场景数据。
全局变量的基戳写操作规范
所有全局变量的赋值操作都需要在对应脚本文件的逻辑段内执行，不能跨文件随意定义，基础赋值指令统一使用MOV，读取变量值时可以直接将变量名嵌入到脚本的判断逻辑或者消息推送语句中。
服务器级全局变量的赋值格式为MOVG变量名数值，比如MOVG@WorldBossCount0，就是将全服BOSS击杀计数的全局变量初始化为0，读取时可以直接在条件判断中使用，比如CHECKG@WorldBossCount>10，用来校验全服累计击杀BOSS数量是否达到10次。
角色绑定全局变量的赋值格式为MOVHUMAN变量名数值，比如MOVHUMAN@TotalMineTime0，就是将当前触发脚本的玩家的累计挖矿时长初始化为0，读取时可以直接关联玩家的个人操作，比如CHECKHUMAN@TotalMineTime>3600，用来校验该玩家的累计挖矿时长是否超过3600秒。
地图级全局变量的赋值格式为MOVMAP(地图编号)变量名数值，比如MOVMAP(3)@BossAlive1，就是将编号为3的地图内的BOSS存活标记设置为1，代表BOSS当前处于存活状态，读取时需要指定对应的地图编号，比如CHECKMAP(3)@BossAlive==1，用来校验该地图内的BOSS是否还未被击杀。
全局变量的持久化与生命周期管控
不同类型的全局变量拥有不同的生命周期，需要通过对应的指令来控制数据的持久化存储，避免服务器重启后数据丢失。
服务器级全局变量默认不会自动写入数据库，服务器重启后所有变量值会被清空，需要在QManage.txt的服务器启动初始化段内加入SAVEGLOBAL指令，才能将所有服务器级全局变量写入到服务端的Global.DB数据库文件中，服务器下次启动时会自动读取该文件恢复所有变量值，不需要手动重新初始化。
角色绑定全局变量会自动跟随玩家的角色数据存储，玩家每次下线时系统会自动将所有HUMAN前缀的变量值写入角色数据库，不需要额外添加持久化指令，只有当玩家角色被删除时，对应的所有角色绑定全局变量才会被同步清除。
地图级全局变量默认仅在服务器运行期间生效，服务器重启后所有地图变量会被重置为初始值，如果需要长期保留某张地图的变量状态，可以在地图配置文件中开启变量持久化开关，指定对应的MAP变量自动写入独立的MapVar.DB文件，实现跨服务器重启的数据保留。
全局变量的常见使用场景与避坑要点
全服公共玩法场景下，使用服务器级全局变量可以实现全服共享的计数逻辑，比如全服累计击杀一定数量怪物后触发全服掉落加成活动，只需要在怪物死亡触发脚本中添加INCG@AllKillCount1指令，每次怪物死亡就给全局计数加1，当变量值达到设定阈值时自动触发全服公告和掉落倍率修改，不需要为每个玩家单独配置计数逻辑。
个人长期进度场景下，使用角色绑定全局变量可以实现不受下线影响的个人数据记录，比如挖矿玩法中记录玩家的累计挖矿次数，每次玩家成功挖到矿石时执行INCHUMAN@MineCount1，后续可以直接通过该变量判断玩家是否满足挖矿称号的激活条件，不需要额外搭建独立的数据库表存储数据。
单地图专属管控场景下，使用地图级全局变量可以避免不同地图之间的逻辑冲突，比如多个副本地图同时刷新同类型BOSS时，每个地图用独立的MAP变量标记BOSS存活状态，不会出现一个地图的BOSS死亡后影响其他地图状态的问题，大幅降低多副本玩法的脚本冲突概率。
使用全局变量时需要避开几个常见错误，一是不能给不同类型的变量使用完全相同的自定义名称，否则会出现变量读取优先级冲突，导致逻辑判断失效；二是不要在循环逻辑中无限制修改全局变量，避免出现变量数值溢出导致脚本死循环；三是修改全局变量时要添加对应的权限校验逻辑，避免玩家通过触发异常脚本随意修改公共全局变量，破坏游戏玩法的平衡性。
全局变量的核心分类与命名规则
按照作用范围和存储特性，全局变量可以分为三类，每一类都有对应的固定命名前缀，不能随意混用。
第一类是服务器级全局变量，命名前缀为G，格式为G+自定义变量名，这类变量的作用范围覆盖整个游戏服务器，所有在线玩家、所有地图场景都可以读取和修改同一个变量值，不会因为单个玩家的操作被重置，适合用来存储全服公共数据，比如全服BOSS刷新次数、沙城占领状态、全服活动累计参与人数这类跨所有角色的公共信息。
第二类是角色绑定全局变量，命名前缀为HUMAN，格式为HUMAN+自定义变量名，这类变量会和玩家的角色数据绑定，永久存储在角色数据库中，玩家下线再上线后变量值不会丢失，不同玩家的同名称变量相互独立互不干扰，适合用来存储单个玩家的长期进度数据，比如玩家累计挖矿时长、专属任务完成状态、永久属性加成计数这类和单个角色深度绑定的信息。
第三类是游戏场景级全局变量，命名前缀为MAP，格式为MAP+自定义变量名，这类变量的作用范围仅限定在指定地图内，只有在对应地图中的脚本逻辑才能读取和修改该变量，不同地图的同名称变量完全隔离，适合用来做单地图内的专属状态管控，比如专属副本的剩余通关时间、地图内BOSS的存活标记、地图专属资源的剩余刷新数量这类仅在单地图内生效的场景数据。
全局变量的基戳写操作规范
所有全局变量的赋值操作都需要在对应脚本文件的逻辑段内执行，不能跨文件随意定义，基础赋值指令统一使用MOV，读取变量值时可以直接将变量名嵌入到脚本的判断逻辑或者消息推送语句中。
服务器级全局变量的赋值格式为MOVG变量名数值，比如MOVG@WorldBossCount0，就是将全服BOSS击杀计数的全局变量初始化为0，读取时可以直接在条件判断中使用，比如CHECKG@WorldBossCount>10，用来校验全服累计击杀BOSS数量是否达到10次。
角色绑定全局变量的赋值格式为MOVHUMAN变量名数值，比如MOVHUMAN@TotalMineTime0，就是将当前触发脚本的玩家的累计挖矿时长初始化为0，读取时可以直接关联玩家的个人操作，比如CHECKHUMAN@TotalMineTime>3600，用来校验该玩家的累计挖矿时长是否超过3600秒。
地图级全局变量的赋值格式为MOVMAP(地图编号)变量名数值，比如MOVMAP(3)@BossAlive1，就是将编号为3的地图内的BOSS存活标记设置为1，代表BOSS当前处于存活状态，读取时需要指定对应的地图编号，比如CHECKMAP(3)@BossAlive==1，用来校验该地图内的BOSS是否还未被击杀。
全局变量的持久化与生命周期管控
不同类型的全局变量拥有不同的生命周期，需要通过对应的指令来控制数据的持久化存储，避免服务器重启后数据丢失。
服务器级全局变量默认不会自动写入数据库，服务器重启后所有变量值会被清空，需要在QManage.txt的服务器启动初始化段内加入SAVEGLOBAL指令，才能将所有服务器级全局变量写入到服务端的Global.DB数据库文件中，服务器下次启动时会自动读取该文件恢复所有变量值，不需要手动重新初始化。
角色绑定全局变量会自动跟随玩家的角色数据存储，玩家每次下线时系统会自动将所有HUMAN前缀的变量值写入角色数据库，不需要额外添加持久化指令，只有当玩家角色被删除时，对应的所有角色绑定全局变量才会被同步清除。
地图级全局变量默认仅在服务器运行期间生效，服务器重启后所有地图变量会被重置为初始值，如果需要长期保留某张地图的变量状态，可以在地图配置文件中开启变量持久化开关，指定对应的MAP变量自动写入独立的MapVar.DB文件，实现跨服务器重启的数据保留。
全局变量的常见使用场景与避坑要点
全服公共玩法场景下，使用服务器级全局变量可以实现全服共享的计数逻辑，比如全服累计击杀一定数量怪物后触发全服掉落加成活动，只需要在怪物死亡触发脚本中添加INCG@AllKillCount1指令，每次怪物死亡就给全局计数加1，当变量值达到设定阈值时自动触发全服公告和掉落倍率修改，不需要为每个玩家单独配置计数逻辑。
个人长期进度场景下，使用角色绑定全局变量可以实现不受下线影响的个人数据记录，比如挖矿玩法中记录玩家的累计挖矿次数，每次玩家成功挖到矿石时执行INCHUMAN@MineCount1，后续可以直接通过该变量判断玩家是否满足挖矿称号的激活条件，不需要额外搭建独立的数据库表存储数据。
单地图专属管控场景下，使用地图级全局变量可以避免不同地图之间的逻辑冲突，比如多个副本地图同时刷新同类型BOSS时，每个地图用独立的MAP变量标记BOSS存活状态，不会出现一个地图的BOSS死亡后影响其他地图状态的问题，大幅降低多副本玩法的脚本冲突概率。
使用全局变量时需要避开几个常见错误，一是不能给不同类型的变量使用完全相同的自定义名称，否则会出现变量读取优先级冲突，导致逻辑判断失效；二是不要在循环逻辑中无限制修改全局变量，避免出现变量数值溢出导致脚本死循环；三是修改全局变量时要添加对应的权限校验逻辑，避免玩家通过触发异常脚本随意修改公共全局变量，破坏游戏玩法的平衡性。