传奇M2引擎全变量详解｜私人/全局/标识变量用法+常量脚本案例大全

前言

在传奇版本搭建、M2引擎脚本编写、传奇NPC脚本开发、传奇任务脚本修改的过程中，变量是核心基础核心组件，几乎所有自定义功能、任务系统、地图传送、属性判定、福利发放等脚本功能，都需要依托M2引擎各类变量实现数据存储、判定、传递与重置。很多传奇GM、脚本新手在搭建版本、修改脚本时，经常遇到传奇脚本变量冲突、自定义变量不生效、地图名称变量识别错误、变量下线清空异常、全局数据不保存等问题，核心原因就是对M2引擎各类变量的属性、生效范围、重置规则、使用场景掌握不透彻。

本文将全方位拆解传奇M2引擎所有官方变量，包含私人数字变量、私人字符变量、全局可保存变量、定时重置变量、个人标识布尔变量等所有类型，详解各类变量的生效规则、存储路径、适用场景，同时补充大量可直接套用的传奇脚本实操案例，讲解最新的CONST常量用法，彻底解决变量识别异常问题，适配所有单机传奇、外网传奇、复古传奇、高爆传奇等版本的脚本开发需求。

一、传奇M2引擎变量基础分类与核心规则

传奇M2引擎官方内置多套专属变量体系，所有变量按照生效范围、存储方式、重置机制、数据类型分为私人变量、全局变量、个人标识变量三大类，不同变量的适配场景完全不同，不可混用，否则会出现脚本失效、数据错乱、功能BUG等问题。

同时引擎有专属命名规范，所有自定义变量名称禁止以P、D、M、N、S、I、G、A、U、T、J开头，避免与系统内置变量冲突，这是新手最容易踩的脚本误区。除此之外，引擎新增<$CONST(X)>常量用法，专门解决变量名与地图名、道具名、NPC名重合导致的脚本识别错误问题，下文将结合实操案例详细讲解。

二、M2引擎私人变量完整详解（含用法+场景）

私人变量是传奇脚本中使用频率最高的变量类型，主要用于单会话、临时数据、人物专属数据存储，大部分私人变量下线不保存、小退清空、地图切换重置，仅部分专属私人变量支持人物数据库永久保存、定时自动重置，适配临时判定、单次任务、限时福利、人物专属数据记录等场景。

2.1 临时会话变量：P0-P99（数字型）

变量属性：纯数字型私人变量，仅在当前NPC对话窗口生效，对话关闭、切换其他NPC、页面跳转时自动归0，无数据留存，取值范围跟随M2引擎最大值适配，兼容所有传奇版本。

核心使用场景：主要用于NPC临时运算、循环判定、单次随机取值、临时数据对比，是传奇脚本中模拟for循环效果的核心变量，常与GOTO跳转命令、RANDOM随机命令搭配使用，无跨NPC传递性，重复利用率极高，不会产生数据残留BUG。

实操脚本案例：NPC临时数值累加循环判定

[@main]
#Act
MOV P0 0
[@loop]
#IF
SMALL P0 5
#ACT
INC P0 1
SENDMSG 6 当前循环次数：<$STR(P0)>
GOTO @loop
#ELSEACT
SENDMSG 6 循环执行完毕，临时变量P0自动归零
Break

2.2 全局临时变量：D0-D99（数字型）

变量属性：数字型私人变量，人物在线状态下，全服务器所有NPC通用传递数据，取值范围与P变量一致，人物下线后自动清空数据，无留存记录。

核心使用场景：兼顾临时运算和跨NPC数据传递需求，可搭配 namelist变量、000标识变量实现临时数据留存，常用于在线限时任务、多次NPC交互判定、在线状态数据统计等功能，是衔接多NPC脚本功能的核心临时变量。

2.3 地图切换变量：M0-M99（数字型）

变量属性：数字型私人变量，人物在线、小退状态下数据可保留，切换游戏地图瞬间自动清空归零，下线不保存数据。

核心使用场景：专门用于单地图专属功能判定，比如地图内限时buff、地图专属掉落判定、单地图任务进度记录，人物离开地图后数据自动重置，避免跨地图功能异常。

2.4 小退重置变量：N0-N999（数字型）、S0-S999（字符型）

变量属性：N系列为数字型、S系列为字符型私人变量，人物小退、重新登录后自动归0/清空，全程下线不保存、切换地图不重置，仅小退操作触发数据清空。

核心使用场景：适合单轮登录有效功能，比如每日单次领取福利、单登录次数统计、临时字符备注记录，玩家小退重登后功能重置，无需手动清空变量，适配日常简易脚本功能开发。

2.5 全局重置变量：I0-I999（数字型）

变量属性：全局数字型变量，无人物绑定属性，服务器重启后自动全部归零，全程不可手动保存数据，所有玩家操作共用一套变量数据。

核心使用场景：用于服务器单日总次数统计、全服活动次数限制、服务器运行状态判定，比如全服每日BOSS击杀上限、全服福利领取总次数，服务器重启后自动重置统计数据。

2.6 人物永久保存变量：U0-U499、T0-T499

变量属性：U系列为数字型、T系列为字符型私人变量，数据永久保存在人物数据库，下线、小退、换地图均不重置，数字变量取值范围为正负21亿，字符变量最大支持8000字符（1字母=1字符，1汉字=2字符）。

核心使用场景：用于永久人物数据记录，比如玩家累计充值额度、永久任务进度、专属称号备注、人物永久属性记录，是传奇个性化脚本、会员专属功能的核心变量。

2.7 每日重置变量：J0-J499、Z0-Z499

变量属性：J系列为数字型、Z系列为字符型私人变量，数据保存至人物数据库，每日凌晨12点自动重置归零，合区、关停服务器需错开0点时段，避免数据异常清空；Z系列字符变量最大支持200字符。

核心使用场景：专门用于每日限定功能，比如每日副本次数、每日签到记录、每日福利领取、每日任务进度，无需手动编写重置脚本，引擎自动每日清零，大幅简化日常活动脚本开发难度。

三、M2引擎全局公共变量详解（G/A系列）

G系列、A系列变量是传奇服务器级全局变量，不属于任何单个玩家，为全服公共数据，所有玩家操作都会同步修改变量数据，是实现全服公告、全服活动、公共数据统计的核心变量。

3.1 G0-G499（数字型全局可保存变量）

存储方式：数据永久保存至服务器Mir200/GlobalVal.ini配置文件，服务器重启、合区均不丢失数据，全服NPC通用、全玩家共享数据。

使用场景：全服累计数据统计、公共功能开关、全服BOSS刷新次数记录、服务器运营数据记录，比如全服累计击杀怪物数量、全服活动开启状态、公共道具兑换次数统计。

3.2 A0-A999（字符型全局可保存变量）

存储方式：字符型全局变量，数据同步保存至Mir200/GlobalVal.ini文件，全服通用传递，无人物专属属性。

使用场景：全服公共字符备注、活动公告内容存储、公共参数配置，比如临时全服活动说明、限时地图开放备注、公共兑换码记录。

四、M2引擎个人标识变量（布尔型专属变量）

个人标识变量是传奇任务脚本中最常用的极简变量，属于可保存布尔型私人变量，共1000个可用标识（000-999），仅存在0、1两种状态，0代表未完成、未开启、未触发，1代表已完成、已开启、已触发。

核心优势：数据读写占用服务器资源极低，下线永久保存，专门适配各类单次任务、专属权限、功能触发判定，是传奇主线任务、支线任务、会员权限、隐藏功能解锁的核心变量。

标准实操案例：单次任务触发判定

[@main]
#IF
CHECK [008] 0
#ACT
SET [008] 1
SENDMSG 6 恭喜你完成专属任务，任务标识已永久记录
Break
#ELSEACT
SENDMSG 6 你已完成该任务，无需重复操作

重要禁忌：个人标识变量不支持表格式常量嵌套写法，禁止使用check [<$cfg_biaoming(1_1)>] 0、set [<$cfg_biaoming(1_1)>] 1这类嵌套代码，会直接导致脚本报错、功能失效。

五、M2引擎CONST常量用法（解决变量识别BUG）

在传奇脚本编写中，经常会遇到地图名称、NPC名称、道具名称与系统变量名重合的问题，比如地图名N0、P1，引擎会优先识别为系统变量，导致地图传送、道具调用失败。引擎新增的<$CONST(X)>常量用法可完美解决该问题，被CONST包裹的内容会被识别为纯常量字符，不会被解析为系统变量。

5.1 核心语法规则

<$CONST(X)>中X为任意自定义字符（地图名、NPC名、道具名），引擎强制将其判定为常量文本，规避变量解析冲突。

5.2 完整实操脚本案例

案例1：变量名同名地图传送（修复传送报错）

[@main]
#Act
MOV N0 3
MAP <$CONST(N0)>
SENDMSG 6 成功传送到名称为【N0】的专属地图

案例2：常量与变量混合赋值展示

[@main]
#Act
MOV A1 $CONST(T140)
SENDMSG 6 变量值：<$STR(A1)>--常量文本：<$CONST(T140)>

六、M2引擎变量标准展示语法

编写传奇脚本时，变量数值展示有固定标准语法，区分普通变量和当前对象变量，混用会导致数值无法正常读取：

1. 通用变量展示语法：<$STR(S0)>、<$STR(G0)>，适用于所有全局、私人变量数值调取展示；

2. 当前对象变量展示语法：<$CSTR(S0)>、<$CSTR(G0)>，精准调取当前交互人物的变量数据，适配多玩家同时交互场景。

七、传奇脚本变量使用避坑总结

1. 临时功能优先使用P/D/M/N/S系列变量，无数据残留，避免服务器数据堆积；

2. 每日限时功能首选J/Z定时重置变量，无需手动编写重置脚本，降低BUG概率；

3. 全服公共数据统计统一使用G/A全局变量，数据永久保存，全服同步生效；

4. 任务判定、权限解锁优先使用000-999个人标识变量，读写高效、稳定性强；

5. 遇到变量名与地图/NPC/道具名冲突时，必须使用CONST常量语法，修复脚本识别异常；

6. 严格遵守变量命名规则，禁止使用系统变量前缀自定义脚本变量。