传奇脚本变量大全 M2引擎自定义变量用法属性详解
传奇脚本制作中，M2引擎变量是核心基础要素，熟练掌握各类传奇系统变量的属性、存储规则及使用禁忌，能够有效规避脚本报错、优化脚本逻辑、搭建稳定的传奇游戏功能体系。本文全面整理传奇M2引擎所有官方脚本变量类型、使用方法、限制规则及专属常量用法，是传奇脚本开发、版本修改的实用参考手册。一、传奇脚本全类型程…
传奇脚本制作中，M2引擎变量是核心基础要素，熟练掌握各类传奇系统变量的属性、存储规则及使用禁忌，能够有效规避脚本报错、优化脚本逻辑、搭建稳定的传奇游戏功能体系。本文全面整理传奇M2引擎所有官方脚本变量类型、使用方法、限制规则及专属常量用法，是传奇脚本开发、版本修改的实用参考手册。
一、传奇脚本全类型程序变量说明
传奇M2引擎内置多组专属传奇脚本变量，主要分为私人变量、全局变量两大类，不同脚本变量的保存规则、重置条件、使用场景完全不同，下面为大家详细拆解各类M2变量的完整参数与实操用法：
1.1 私人数字变量（P0-P999）
专属特性：数字型私人变量，触发对话框重置自动归0，仅在当前NPC对话流程生效。
核心用法：该传奇脚本变量无NPC跨传递属性，适合作为临时变量重复调用，支持加减、赋值、随机取值等各类脚本运算。搭配goto命令可实现仿for循环效果，随机取值性能可媲美RANDOM指令，是传奇脚本临时运算场景中最常用的变量。
1.2 摇筛子变量（D0-D999）
专属特性：数字型私人变量，人物下线不保存，全局NPC通用传递，取值范围与P变量一致。
核心用法：兼具人物私有变量属性与P变量的运算功能，唯一限制为人物下线后数据自动清空。可搭配各类记录类脚本变量使用，打造专属个人隐私游戏属性，拓展各类个性化传奇游戏功能。
1.3 地图切换变量（M0-M999）
专属特性：数字型私人变量，人物下线不保存，玩家切换地图后自动清空数据。
1.4 小退归零变量（N0-N999）
专属特性：数字型私人变量，人物下线不保存，角色小退游戏后数值归0。
重要禁忌：N98、N99两组变量为地图鼠标坐标专属变量，数值实时动态变动，禁止在脚本中使用，否则会引发脚本逻辑错乱、功能失效等问题。
1.5 字符小退变量（S0-S999）
专属特性：字符型私人变量，人物下线不保存，角色小退游戏后数据归零。
1.6 全局重置变量（I0-I999）
专属特性：数字型全局变量，数据不可保存，服务器重启后自动重置为0，全服通用生效。
1.7 全局可存数字变量（G0-G999）
专属特性：数字型全局变量，支持数据持久化保存，文件存储路径：Mir200/GlobalVal.ini。
核心用法：该M2引擎变量独立于人物属性之外，属于服务器全局专属脚本变量，全服所有玩家操作均可改变变量数值，全服NPC通用传递，适配传奇游戏全服通用功能、全局数据统计等开发场景。
1.8 全局可存字符变量（A0-A999）
专属特性：字符型全局变量，支持数据持久化保存，文件存储路径：Mir200/GlobalVal.ini，取值范围与D变量一致。
核心用法：无人物属性绑定限制，服务器全局唯一，全服NPC通用数据传递，是传奇脚本中存储全局字符类配置、公告文本、全局标识的核心变量。
1.9 人物永久数字变量（U0-U254）
专属特性：数字型私人变量，数据永久保存，存储于人物数据库Mir.db。
数值限制：取值范围为正负21亿，适用于人物专属数值记录、累计数据统计等长期生效的游戏功能。
1.10 人物永久字符变量（T0-T254）
专属特性：字符型私人变量，数据永久保存，存储于人物数据库Mir.db。
字符限制：单变量最大长度200字符，1个字母计1字符，1个汉字计2字符，适合存储人物专属文本信息、备注标识、自定义标签等内容。
1.11 每日重置数字变量（J0-J254）
专属特性：数字型私人变量，数据存储于人物数据库Mir.db，每日凌晨12点自动重置数值。
使用技巧：服务器合区、关停维护时，建议避开00:00重置节点，避免变量数据异常丢失，数值最大范围为正负21亿。
二、传奇脚本变量自定义命名禁忌
用户自定义传奇脚本变量时，禁止以P、D、M、N、S、I、G、A、U、T、J作为变量开头字符，避免与M2引擎系统内置脚本变量冲突，引发脚本识别错误、功能异常、数据错乱等问题，保障传奇脚本稳定运行。
三、传奇脚本常量<$CONST(X)>用法详解
在传奇脚本编写中，部分地图名称、标识字符与系统脚本变量前缀重合，M2引擎会默认优先识别为变量，极易导致传奇脚本运行报错。引擎专属常量指令<$CONST(X)>可完美解决该问题，作用为将X强制识别为固定常量字符，而非系统脚本变量。
3.1 脚本使用示例
[@main]
#Act
MOV N0 3
;常规写法易出现识别歧义：无法判定N0是变量数值还是地图名称
;常量固定写法，精准指定地图名称
MAP <$CONST(N0)>
;指令含义：直接传送到名称为N0的游戏地图
四、传奇脚本变量显示指令用法
传奇脚本内置专属变量显示指令，可单独展示全局变量、当前对象变量数据，两种指令适配不同传奇脚本开发场景，能够精准调取各类M2变量数值，方便开发者调试脚本。
4.1 通用变量显示指令
格式：<$STR(S0)>、<$STR(G0)>
4.2 当前对象变量显示指令
格式：<$CSTR(S0)>、<$CSTR(G0)>
五、传奇脚本变量核心使用总结
传奇脚本开发中，临时对话运算优先选用P变量，单人短期临时数据选用D变量，地图联动逻辑适配M变量，小退重置功能适配N、S变量，服务器全局配置使用G、A变量，人物永久数据记录选用U、T变量，每日刷新功能适配J变量。合理搭配各类M2脚本变量，同时严格规避变量命名、坐标变量使用禁忌，可最大程度保障传奇脚本的稳定性与兼容性。
