传奇自定义全局变量功能详解 变量扩展使用教程
一、传奇自定义变量功能核心介绍传奇引擎自定义变量功能打破了传统固定变量的使用限制，支持多类型、多场景变量自由扩展，涵盖个人私有变量、全局公共变量、地图专属变量三大类，全方位满足传奇脚本制作、NPC功能开发、游戏数据统计等各类定制需求。该功能适配各类传奇版本，变量使用灵活、数据读写稳定，是传奇开发者搭…
一、传奇自定义变量功能核心介绍
传奇引擎自定义变量功能打破了传统固定变量的使用限制，支持多类型、多场景变量自由扩展，涵盖个人私有变量、全局公共变量、地图专属变量三大类，全方位满足传奇脚本制作、NPC功能开发、游戏数据统计等各类定制需求。该功能适配各类传奇版本，变量使用灵活、数据读写稳定，是传奇开发者搭建个性化游戏功能的核心工具。
相较于传统固定变量，全新的自定义变量体系支持超范围拓展，突破常规0~99的变量数值限制，同时区分临时变量与持久化变量、个人变量与全局变量，搭配专属读写、运算、检测命令，可实现游戏排名、数据存档、玩家属性统计、地图专属机制等多种自定义功能。
二、各类自定义变量拓展规则及特性
2.1 个人私有M、S变量
传奇个人变量包含数值变量M和字符变量S，常规数值范围为0~99，超出该范围可自动自由扩展。M、S变量后缀可自定义任意字符，为保证脚本稳定性与读取效率，自定义字符长度建议控制在20字节以内。
专属规则：针对自由扩展的M变量，SUM命令运算结果统一存储在M99999999变量中。
使用示例：
数值变量赋值：Mov M测试整数1 12345
字符变量赋值：Mov S测试字符1 字符串1
变量调取显示：<$STR(M测试整数1)>、<$STR(S测试字符1)>
2.2 全局公共G、A变量
全局变量G、A同样支持超0~99范围自动扩展，属于全服公共变量，核心特性为服务器关闭后数据可自动保存，适合用于全服排名、公共数据统计、跨玩家数据共享等场景。
专属规则：针对自由扩展的G变量，SUM命令运算结果统一存储在G99999999变量中，基础使用语法与M、S个人变量完全一致。
2.3 地图专属E、F变量
新增地图专属自定义变量，其中E为地图整数变量、F为地图字符串变量，变量数据精准绑定玩家当前所在地图，仅对当前地图执行的命令生效。
核心特性：服务器关闭后数据不保存，属于临时地图变量，适合制作地图专属buff、地图限时任务、单地图数据统计等临时功能。
专属规则：SUM命令针对E变量的运算结果，统一存储在E99999999变量中，使用语法兼容所有自定义变量通用格式。
三、传奇自定义变量完整使用步骤
传奇自定义全局变量、个人变量的使用分为六大核心步骤，从变量声明、数据读取、数据保存、变量检测到数值运算、内容显示，流程规范统一，可直接套用至各类传奇脚本开发场景。
3.1 变量声明（基础必备）
变量声明是使用自定义变量的前提，需提前定义变量类型、归属类型，系统方可识别并分配变量内存。其中STRING代表字符变量声明，INTEGER代表数字变量声明；HUMAN为私有个人变量（单玩家独立数据），GLOBAL为公共全局变量（全服共享数据）。
变量声明代码示例：
VAR STRING HUMAN bluem2
VAR INTEGER HUMAN 395973
VAR STRING GLOBAL 财富第一名
VAR INTEGER GLOBAL 第一财富值
重要注意事项：全局变量声明与普通个人变量不同，需在引擎启动生效，必须将全局变量声明编写在QManage NPC的[@OnStart]段内，引擎启动后将自动执行该段代码，完成全局变量初始化。
全局变量初始化完整示例：
[@OnStart]
#IF
#ACT
VAR STRING GLOBAL 财富第一名
LOADVAR GLOBAL 财富第一名 ..\QUESTDIARY\数据文件\排名\自定义全局变量数据.TXT
3.2 变量数据读取
通过LOADVAR命令可读取本地文本文件中存储的变量数据，支持个人变量、全局变量批量读取，实现游戏数据重启不丢失。
变量读取代码示例：
LOADVAR HUMAN bluem2 ..\QUESTDIARY\数据文件\网站\BLUEM2.TXT
LOADVAR HUMAN 395973 ..\QUESTDIARY\数据文件\网站\395973.TXT
LOADVAR GLOBAL 财富第一名 ..\QUESTDIARY\数据文件\排名\自定义全局变量数据.TXT
LOADVAR GLOBAL 第一财富值 ..\QUESTDIARY\数据文件\排名\自定义全局变量数据.TXT
3.3 变量数据保存
数据修改完成后，通过SAVEVAR命令可将变量最新数据保存至本地指定路径文本文件，搭配CALCVAR运算命令，可实现变量数据自动更新、持久化存储。
变量保存代码示例：
CALCVAR HUMAN 395973 + 5
SAVEVAR HUMAN 395973 ..\QUESTDIARY\数据文件\网站\395973.TXT
CALCVAR GLOBAL 财富第一名 = <$USERNAME>
SAVEVAR GLOBAL 财富第一名 ..\QUESTDIARY\数据文件\排名\自定义全局变量数据.TXT
全局变量标准存档格式（TXT文件）：
[GLOBAL]
财富第一名=395973
财富第二名=空
财富第三名=空
财富第四名=空
财富第五名=空
财富第六名=空
财富第七名=空
财富第八名=空
财富第九名=空
财富第十名=空
第一财富值=0
第二财富值=0
第三财富值=0
第四财富值=0
第五财富值=0
第六财富值=0
第七财富值=0
第八财富值=0
第九财富值=0
第十财富值= 0
3.4 变量条件检测
利用CHECKVAR命令可检测变量数值、字符状态，搭配条件判断语句，可实现触发专属游戏功能，支持大于、小于、等于、大于等于多种判断格式，同时支持变量嵌套检测。
变量检测代码示例：
#IF
CHECKVAR HUMAN 395973 = 5 ;支持格式( > < = ? ) ?代表等于或大于
#ACT
sendmsg 7 等于5
#IF
CHECKVAR HUMAN 395973 = <$STR(M2)> ;支持变量嵌套判断
#ACT
sendmsg 7 等于5
3.5 数字类变量运算
CALCVAR命令支持数字变量多种运算方式，包含加减乘除、赋值操作，可自由修改自定义数值变量数据，运算后可搭配保存命令实现数据更新存档。
数字变量运算代码示例：
CALCVAR HUMAN 395973 = 0 ;支持( + - * / = )运算格式
SAVEVAR HUMAN 395973 ..\QUESTDIARY\数据文件\网站\395973.TXT
3.6 变量内容显示
游戏界面调取变量内容可使用专属显示语法，区分个人私有变量与全局公共变量，语法简洁、调用稳定，适配游戏弹窗、界面展示、公告提示等场景。
变量显示语法示例：
个人私有变量显示：<$HUMAN(395973)>
全局公共变量显示：<$GLOBAL(财富第一名)>
四、功能总结
传奇自定义全局变量功能彻底突破传统变量的使用局限，个人M/S变量、全局G/A变量、地图E/F变量分工明确，分别适配个人专属数据、全服公共数据、地图临时数据三大核心场景。完整的变量声明、读写、运算、检测、显示体系，能够满足传奇版本开发中绝大多数自定义功能需求，是制作排行榜、数据存档、专属任务、地图机制等功能的核心脚本工具，兼容性强、操作简单、稳定性高。
