传奇游戏脚本变量大全 GM常用变量功能详解与实战用法
在传奇私服运营、版本修改以及脚本开发过程中，变量是整个脚本逻辑的核心基础。无论是人物属性判定、物品掉落控制、活动时间限制，还是NPC对话交互，都需要依靠各类变量完成数据存储、条件判断与逻辑执行。本文整理最全的传奇脚本变量分类、语法规则、实战案例，帮助GM快速掌握变量用法，高效修改定制传奇版本。一、传…
在传奇私服运营、版本修改以及脚本开发过程中，变量是整个脚本逻辑的核心基础。无论是人物属性判定、物品掉落控制、活动时间限制，还是NPC对话交互，都需要依靠各类变量完成数据存储、条件判断与逻辑执行。本文整理最全的传奇脚本变量分类、语法规则、实战案例，帮助GM快速掌握变量用法，高效修改定制传奇版本。
一、传奇脚本变量基础概念与分类
传奇引擎中的变量，本质是用于临时或长期存储数据的内存载体，可存储数值、文本、状态标识等内容，所有脚本触发、判定、赋值逻辑都依托变量运行。根据作用范围、存储周期、使用场景，可分为三大核心类别，适配不同版本开发需求。
1.1 按作用域划分变量类型
人物私有变量：仅对当前玩家生效，数据随角色保存，下线不丢失。常用于记录玩家任务进度、专属次数、个人属性标记、充值记录等，是传奇活动脚本中使用率最高的变量类型。
全局公共变量：对全区所有玩家生效，数据服务器共享，重启服务器后重置（持久型除外）。主要用于全区活动倒计时、跨玩家数据联动、服务器状态标记、BOSS全局刷新控制等场景。
临时局部变量：仅在当前脚本段内生效，脚本执行完毕后立即销毁，不占用内存。多用于NPC单次对话判定、临时数值计算、条件临时标记，精简脚本冗余数据。
1.2 按数据类型划分变量类型
数值型变量：存储整数、浮点数值，支持加减乘除、大小对比运算。适配等级判定、血量魔力检测、元宝数量对比、次数限制等数值类逻辑。
字符型变量：存储文本、字符内容，无运算能力，仅用于赋值与匹配。常用于玩家名称记录、行会名称判定、自定义文本提示、物品备注存储等场景。
布尔型变量：仅包含真/假两种状态，轻量化无内存占用。主要用于开关类判定，如活动是否开启、玩家是否领取奖励、BOSS是否已刷新等二元逻辑。
二、主流传奇引擎通用脚本变量语法规范
目前市面上GOM、GE、LEG、BLUE主流传奇引擎，变量基础语法通用度达90%，仅部分专属变量存在引擎差异。统一规范写法可避免脚本报错、变量不生效、数据错乱等常见问题。
2.1 变量赋值标准语法
// 人物私有数值变量赋值
MOV A1 100 // 给玩家变量A1赋值100
INC A1 50 // 变量A1自增50
DEC A1 30 // 变量A1自减30
// 全局公共变量赋值
MOV G1 1 // 全区变量G1赋值1（开启状态）
MOV G1 0 // 全区变量G1赋值0（关闭状态）
// 字符变量赋值
MOV S1 传奇玩家 // 字符变量S1赋值文本内容
2.2 变量条件判定标准语法
// 数值条件判定
IF A1 >= 100 // 如果玩家变量A1大于等于100
#ACT
SENDMSG 7 你的积分达标，可领取奖励
#ENDIF
// 全局变量判定
IF G1 = 1
#ACT
OPENACT 全民攻城活动开启
#ENDIF
// 字符匹配判定
IF S1 = 行会盟主
#ACT
GIVE 盟主令牌 1
#ENDIF
2.3 语法使用核心禁忌
变量名称禁止使用中文、特殊符号，仅支持字母+数字组合；同一脚本内局部变量不可重名，避免数据覆盖；全局变量尽量集中管理，减少跨脚本重复调用导致的卡顿；持久型全局变量需定期清理冗余数据，防止服务器内存溢出。
三、GM高频使用传奇脚本变量大全（分类汇总）
人物信息变量
变量名称 | 说明 |
<$USERNAME> | 人物名称 |
<$GUILDNAME> | 行会名称 |
<$RANKNAME> | 行会职位名称 |
<$LEVEL> | 等级 |
<$AC> | 防御力 |
<$MAXAC> | 最高防御力 |
<$MAC> | 魔法防御力 |
<$MAXMAC> | 最高魔法防御力 |
<$DC> | 物理攻击力 |
<$MAXDC> | 最高物理攻击力 |
<$MC> | 魔法力 |
<$MAXMC> | 最高魔法力 |
<$SC> | 道术 |
<$MAXSC> | 最高道术 |
<$TC> | 刺术 |
<$MAXTC> | 最高刺术 |
<$EXP> | 当前经验值 |
<$MAXEXP> | 升级经验值 |
<$PKPOINT> | PK点数 |
<$CREDITPOINT> | 声望点数 |
<$GOLDCOUNT> | 金币数量 |
<$GOLDMAX> | 金币上限 |
<$GAMEGOLD> | 游戏币数 |
<$GAMEPOINT> | 游戏点数 |
<$HW> | 腕力 |
<$MAXHW> | 最高腕力 |
<$BW> | 背包重量 |
<$MAXBW> | 最高背包重量 |
<$WW> | 负重力 |
<$MAXWW> | 最高负重 |
<$HUNGER> | 饥饿程度 |
<$LOGINTIME> | 登录时间 |
<$LOGINLONG> | 登录时长 |
<$DRESS> | 衣服 |
<$WEAPON> | 武器 |
<$RIGHTHAND> | 蜡烛 |
<$HELMET> | 头盔 |
<$NECKLACE> | 项链 |
<$RING_R> | 右戒指 |
<$RING_L> | 左戒指 |
<$ARMRING_R> | 右手镯 |
<$ARMRING_L> | 左手镯 |
<$BUJUK> | 护身符 |
<$BELT> | 腰带 |
<$BOOTS> | 鞋子 |
<$CHARM> | 宝石 |
<$DRUM> | 鼓 |
<$PLATE> | 马牌 |
<$JADE> | 玉 |
<$ZHULI> | 斗笠 |
<$FASGUIN> | 时装(衣) |
<$FASGUIN_WEAPON> | 时装(武器) |
<$FASGUIN_RIGHTHAND> | 时装(勋章) |
<$FASGUIN_NECKLACE> | 时装(项链) |
<$FASGUIN_HELMET> | 时装(头盔) |
<$FASGUIN_ARMRINGL> | 时装(左手) |
<$FASGUIN_ARMRINGR> | 时装(右手) |
<$FASGUIN_RINGL> | 时装(左戒) |
<$FASGUIN_RINGR> | 时装(右戒) |
<$FASGUIN_BELT> | 时装(腰带) |
<$FASGUIN_BOOTS> | 时装(鞋) |
<$FASGUIN_ZHULI> | 时装(斗笠、面巾) |
<$ITEMRESERVED(位置)> | 预留装备位物品名;“位置”参数范围1-22 |
<$CUSTOM1> | 自定义装备1 |
<$CUSTOM2> | 自定义装备2 |
<$CUSTOM3> | 自定义装备3 |
<$CUSTOM4> | 自定义装备4 |
<$CUSTOM5> | 自定义装备5 |
<$CUSTOM6> | 自定义装备6 |
<$CUSTOM7> | 自定义装备7 |
<$CUSTOM8> | 自定义装备8 |
<$CUSTOM9> | 自定义装备9 |
<$CUSTOM10> | 自定义装备10 |
<$CUSTOM11> | 自定义装备11 |
<$CUSTOM12> | 自定义装备12 |
<$CUSTOM13> | 自定义装备13 |
<$CUSTOM14> | 自定义装备14 |
<$CUSTOM15> | 自定义装备15 |
<$CUSTOM16> | 自定义装备16 |
<$CUSTOM17> | 自定义装备17 |
<$CUSTOM18> | 自定义装备18 |
<$CUSTOM19> | 自定义装备19 |
<$CUSTOM20> | 自定义装备20 |
<$CASTLENAME> | 沙城名称 |
<$SFNAME> | 师傅名 |
<$BUYSHOP> | 商铺购买物品时，使用的元宝数 |
<$USERALLNAME> | 人物完整名称 |
<$MAPNAME> | 人物所在地图名称 |
<$KILLER> | 杀人者变量 |
<$KILLEREX> | 杀人者主体名称(无主体时输出自己名称) |
<$MONKILLER> | 怪物杀人变量 |
<$MAP> | 当前地图代码 |
<$QUERYYBDEALLOG> | 查看元宝交易记录 |
<$ALCOHOL> | 酒量 |
<$MEDICINEVALUE> | 药力值 |
<$GLORYPOINT> | 人物荣誉值 |
<$RANDOMNO> | 随机值变量 |
<$USERID> | 登录账号 |
<$IPADDR> | 人物IP地址 |
<$IPLOCAL> | 人物IP所属区域(需IP插件) |
<$X> | 人物X坐标 |
<$Y> | 人物Y坐标 |
<$DIRECTION> | 人物方向(0-7) |
<$MAXHP> | HP上限 |
<$HP> | HP值 |
<$MAXMP> | MP上限 |
<$MP> | MP值 |
<$GAMEDIAMOND> | 金刚石数 |
<$GAMEGIRD> | 灵符数 |
<$DEARNAME> | 配偶名变量 |
<$HWID> | 当前机器码 |
<$DBHWID> | 存储的机器码；可使用脚本命令SetDBHwId进行修改 |
<$HEARTLEVEL> | 心法等级 |
<$JOB> | 职业 |
<$GENDER> | 性别 |
<$NGLEVEL> | 内功等级 |
<$SKILLLEVEL(技能ID)> | 技能等级变量 |
<$POPULARITY> | 师门人气变量 |
<$JOBEX> | 输出职业名(战士、法师、道士、刺客) |
<$GENDEREX> | 输出性别名(男、女) |
<$KILLMONBURSTRATE> | 杀怪暴率倍数 |
<$KILLMONBURSTRATETIME> | 杀怪暴率倍数时间 |
<$PARALYSIS> | 麻痹强化 |
<$UNPARALYSIS> | 麻痹抗性 |
<$HEARTPOWER> | 神圣下限 |
<$HEARTMAXPOWER> | 神圣上限 |
<$HEARTAC> | 神圣防御 |
<$HEARTLUCK> | 神圣幸运 |
<$HEARTAVOIDINJURY> | 神圣伤害免伤万分比 |
<$MX> | 魔血 |
<$REALLYLEVEL> | 真气石总等级 |
<$MAXHPRATE(倍数)> | 血量上限比率(倍数值/100为实际倍数) |
<$MAXMPRATE(倍数)> | MP上限比率(倍数值/100为实际倍数) |
<$RELEVEL> | 转生等级 |
<$UNFIRERATE> | 火墙抗性 |
<$UNDRAGONRATE> | 合击抗性 |
<$UNHITRATE> | 近战抗性 |
<$UNBATTERRATE> | 连击抗性 |
<$UNMCRATE> | 魔法抗性 |
<$UNSCRATE> | 道术抗性 |
<$UNDRAGONSKILLRATE> | 龙神抗性 |
<$GOLDLEVEL> | 金元等级 |
<$WOODLEVEL> | 木元等级 |
<$WATERLEVEL> | 水元等级 |
<$FIRELEVEL> | 火元等级 |
<$SOILLEVEL> | 土元等级 |
<$ArmyRankLevel> | 军衔等级 |
<$LUCKY> | 幸运属性 |
<$LUCKYPOINT> | 幸运等级 |
<$SKILLLEVELEX(技能ID)> | 指定技能的强化等级 |
<$KILLMONEXPRATETIME> | 杀怪经验倍率时间(秒) |
<$ARMSCRITPOINT> | 武器暴击属性点 |
<$TEAM(X)> | 用于显示组队成员(需修改X参数),<$TEAM(0)>代表队长,成员从<$TEAM(1)>开始,<$TEAM(2)>,<$TEAM(3)> |
<$OLESERVERID> | 原服编号（跨服） |
<$MAPHUM> | 当前地图人数 |
<$POWERRATE> | 攻击力倍数 |
<$SCRIPTPARAM1> | 脚本点击触发带参数1 |
<$SCRIPTPARAM2> | 脚本点击触发带参数2 |
<$SCRIPTPARAM3> | 脚本点击触发带参数3 |
<$SCRIPTPARAM4> | 脚本点击触发带参数4 |
<$SCRIPTPARAM5> | 脚本点击触发带参数5 |
<$SCRIPTPARAM6> | 脚本点击触发带参数6 |
<$USEGAMEGOLD> | 玩家每次使用元宝时的数值 |
<$USEGAMEGIRD> | 玩家每次使用灵符时的数值 |
<$USEGAMEDIAMOND> | 玩家每次使用金刚石时的数值 |
<$USECREDITPOINT> | 玩家每次使用声望时的数值 |
<$USEGAMEPOINT> | 玩家每次使用游戏点时的数值 |
<$TEL> | [账号信息]电话 |
<$QUIZ> | [账号信息]问题1 |
<$ANSWER> | [账号信息]答案1 |
<$QUIZ2> | [账号信息]问题2 |
<$ANSWER2> | [账号信息]答案2 |
<$BIRTHDAY> | [账号信息]生日 |
<$TEL2> | [账号信息]移动电话 |
<$PASSWORD> | [账号信息]登陆密码 |
<$PASSWORD2> | [账号信息]登陆二级密码 |
<$SPREADNAME> | [账号信息]推广人信息 |
<$IDUSERNAME> | [账号信息]用户名 |
<$IDSSNO> | [账号信息]身份证 |
<$NGEXP> | 内功当前经验 |
<$NGMAXEXP> | 内功升级经验 |
<$BOXITEMS(位置)> | 首饰盒物品名,位置：0-5 |
<$INWARAREA> | 是否在攻城区域内(不判断攻城期)，0-不在 1-在 |
<$HITSPEED> | 攻速 |
<$ARMSCRIT> | 暴击 |
<$BREAKUPRATE> | 击破 |
<$GETPLAYMAPID(人物名称)> | 获取在线人物地图代码;例：<$GETPLAYMAPID(A1)>、<$GETPLAYMAPID(玩家名字)>;支持A、S变量解析 |
<$GETMAPID(地图名称)> | 输出指定地图的地图代码;例：<$GETMAPID(比奇省)> 输出“0”、<$GETMAPID(S0)>支持S变量解析、<$GETMAPID(-)>--输出当前地图ID |
<$GETMAPNAME(地图代码)> | 输出指定地图代码的地图名称;例：<$GETMAPNAME(0)> 输出“比奇省”、<$GETMAPNAME(S0)>支持S变量解析、<$GETMAPNAME(-)>--输出当前地图名 |
<$MAPHEIGHT(地图代码)> | 输出指定地图代码的地图高度;<$MAPHEIGHT(S0)>支持解析S变量解析,"-"表示当前地图 |
<$MAPWIDTH(地图代码)> | 输出指定地图代码的地图宽度;<$MAPWIDTH(S0)>支持解析S变量解析,"-"表示当前地图 |
<$MAPMON(地图代码)> | 输出指定地图代码的怪物数量;<$MAPMON(S0)>支持解析S变量解析,"-"表示当前地图 |
<$MIRRORMAPTIME(地图代码)> | 输出镜像地图有效时长(秒),地图非镜像地图时返回0;<$MIRRORMAPTIME(S0)>支持解析S变量解析,"-"表示当前地图 |
<$HEARTCRITRATE> | 神圣暴击概率 |
<$HEARTCRITPOWERATE> | 神圣暴击倍率 |
<$HITPOINT> | 准确 |
<$SPEEDPOINT> | 敏捷 |
<$DECDAMAGE> | 伤害吸收% |
<$PAYMODEMSG> | 点卡剩余时间; |
<$NH> | 当前内力值 |
<$MAXNH> | 内力值上限 |
<$BAGCOUNT> | 当前包裹里的物品数量(包含OK框的和摆摊物品) |
<$BAGMAXCOUNT> | 包裹允许存放的最大数量 |
<$WINEDRINK> | 醉酒度 |
<$SKILLNAME(技能ID)> | 按技能ID查询人物技能DB的名称 |
<$HEROSKILLNAME(技能ID)> | 按技能ID查询英雄技能DB的名称 |
<$MONRACE(怪物名)> | 按怪名查询怪DB中的种族 |
<$MONAPPR(怪物名)> | 按怪名查询怪DB中的形像代码 |
<$MONRECEIMG(怪物名)> | 按怪名查询怪DB中的种族图像 |
<$DRAGONDERATERATE> | 合击伤害减免比例(%) |
<$REVIVAL> | 复活属性可用状态(0-不可用 1-可用) |
<$REBIRTH> | 重生属性可用状态(0-不可用 1-可用) |
<$INCDRAGON> | 合击威力 |
<$TENACITY> | 韧性 |
<$HITSINGLESTOUT> | 物理单体坚韧 |
<$HITGROUPSTOUT> | 物理群体坚韧 |
<$MAGSINGLESTOUT> | 魔法单体坚韧 |
<$MAGGROUPSTOUT> | 魔法群体坚韧 |
<$HITMAGSTOUT> | 全能坚韧 |
<$SOULPOWER> | 魂力下限 |
<$MAXSOULPOWER> | 魂力上限 |
<$SOULPOWERAC> | 魂御 |
<$SOULPOWERLUCK> | 魂力幸运 |
<$SOULAVOIDINJURY> | 魂力免伤万分比 |
<$SOULCRITRATE> | 魂力暴击概率 |
<$SOULCRITPOWERATE> | 魂力暴击倍率 |
<$SOULTENACITY> | 魂力韧性 |
<$SOULHITMAGSTOUT> | 魂力坚韧 |
<$WUXING> | 五行属性(0-无 1-金 2-木 3-水 4-火 5-土) |
<$WUXINGNAME> | 五行属性名称 |
<$TEAM(X)> | 组队成员名字，<$TEAM(0)>代表队长,成员从<$TEAM(1)>开始 |
<$TEAMCOUNT> | 组队成员数量 |
<$GENERATEID> | 主体生产ID;生成规则:1.时间(15位) 2.角色类型(1位 1-主体 2-主将 3-副将) 3.角色DB索引(10位) 4.DBServer端口(5位) 5.自增序号(3位) |
<$ADDDAMAGEPOINT> | 附加伤害比例‰(物品Need-110属性) |
<$UNBURSTRATE> | 防爆 |
<$PERMISSION> | 人物权限值 |
<$ATTATCKMODE> | 人物攻击模式 |
<$ATTATCKMODENAME> | 人物攻击模式名称 |
<$ADDDAMAGERATE> | 伤害附加% |
<$ABSORBNHPOINT> | 内功吸收 |
<$ATTACKSPEED> | 攻击速度（CHANGESPEED命令设置） |
<$SPELLSPEED> | 魔法速度（CHANGESPEED命令设置） |
<$HONGMOSUITE> | 虹魔吸血 |
<$KILLMONEXPRATE> | 杀怪经验倍数 |
英雄信息
变量名称 | 说明 |
<$HERONAME> | 英雄名称 |
<$HEROLEVEL> | 英雄等级 |
<$HEROEXP> | 英雄当前经验 |
<$HEROMAXEXP> | 英雄升级所需经验 |
<$HERONGLEVEL> | 英雄内功等级 |
<$HERODRESS> | 衣服 |
<$HEROWEAPON> | 武器 |
<$HERORIGHTHAND> | 蜡烛 |
<$HEROHELMET> | 头盔 |
<$HERONECKLACE> | 项链 |
<$HERORING_R> | 右戒指 |
<$HERORING_L> | 左戒指 |
<$HEROARMRING_R> | 右手镯 |
<$HEROARMRING_L> | 左手镯 |
<$HEROBUJUK> | 护身符 |
<$HEROBELT> | 腰带 |
<$HEROBOOTS> | 鞋子 |
<$HEROCHARM> | 宝石 |
<$HEROZHULI> | 斗笠 |
<$HERODRUM> | 鼓 |
<$HEROPLATE> | 马牌 |
<$HEROJADE> | 玉 |
<$HEROFASGUIN> | 时装(衣) |
<$HEROFASGUIN_WEAPON> | 时装(武器) |
<$HEROFASGUIN_RIGHTHAND> | 时装(勋章) |
<$HEROFASGUIN_NECKLACE> | 时装(项链) |
<$HEROFASGUIN_HELMET> | 时装(头盔) |
<$HEROFASGUIN_ARMRINGL> | 时装(左手) |
<$HEROFASGUIN_ARMRINGR> | 时装(右手) |
<$HEROFASGUIN_RINGL> | 时装(左戒) |
<$HEROFASGUIN_RINGR> | 时装(右戒) |
<$HEROFASGUIN_BELT> | 时装(腰带) |
<$HEROFASGUIN_BOOTS> | 时装(鞋) |
<$HEROFASGUIN_ZHULI> | 时装(斗笠、面巾) |
<$HEROITEMRESERVED(位置)> | 预留装备位物品名;“位置”参数范围1-22 |
<$HEROCUSTOM1> | 自定义装备1 |
<$HEROCUSTOM2> | 自定义装备2 |
<$HEROCUSTOM3> | 自定义装备3 |
<$HEROCUSTOM4> | 自定义装备4 |
<$HEROCUSTOM5> | 自定义装备5 |
<$HEROCUSTOM6> | 自定义装备6 |
<$HEROCUSTOM7> | 自定义装备7 |
<$HEROCUSTOM8> | 自定义装备8 |
<$HEROCUSTOM9> | 自定义装备9 |
<$HEROCUSTOM10> | 自定义装备10 |
<$HEROCUSTOM11> | 自定义装备11 |
<$HEROCUSTOM12> | 自定义装备12 |
<$HEROCUSTOM13> | 自定义装备13 |
<$HEROCUSTOM14> | 自定义装备14 |
<$HEROCUSTOM15> | 自定义装备15 |
<$HEROCUSTOM16> | 自定义装备16 |
<$HEROCUSTOM17> | 自定义装备17 |
<$HEROCUSTOM18> | 自定义装备18 |
<$HEROCUSTOM19> | 自定义装备19 |
<$HEROCUSTOM20> | 自定义装备20 |
<$HEROHEARTLEVEL> | 心法等级 |
<$HEROHP> | 生命值 |
<$HEROMAXHP> | 生命值上限 |
<$HEROMP> | 魔法力 |
<$HEROMAXMP> | 魔法力上限 |
<$HEROAC> | 防御力 |
<$HEROMAXAC> | 最高防御力 |
<$HEROMAC> | 魔法防御力 |
<$HEROMAXMAC> | 最高魔法防御力 |
<$HERODC> | 攻击力 |
<$HEROMAXDC> | 最高攻击力 |
<$HEROMC> | 魔法力 |
<$HEROMAXMC> | 最高魔法力 |
<$HEROSC> | 道术 |
<$HEROMAXSC> | 最高道术 |
<$HEROTC> | 刺术 |
<$HEROMAXTC> | 最高刺术 |
<$HEROJOB> | 职业 |
<$HEROGENDER> | 性别 |
<$HEROSKILLLEVEL(技能ID)> | 技能等级变量 |
<$HEROJOBEX> | 输出英雄职业名(战士、法师、道士) |
<$HEROGENDEREX> | 输出英雄性别名(男、女) |
<$HEROPARALYSIS> | 英雄麻痹强化 |
<$HEROUNPARALYSIS> | 英雄麻痹抗性 |
<$HEROHEARTPOWER> | 英雄神圣下限 |
<$HEROHEARTMAXPOWER> | 英雄神圣上限 |
<$HEROHEARTAC> | 英雄神圣防御 |
<$HEROHEARTLUCK> | 英雄神圣幸运 |
<$HEROHEARTAVOIDINJURY> | 英雄神圣伤害免伤万分比 |
<$HEROMX> | 英雄魔血 |
<$HEROREALLYLEVEL> | 英雄真气石总等级 |
<$HEROMAXHPRATE(倍数)> | 英雄HP上限比率(倍数值/100为实际倍数) |
<$HEROMAXMPRATE(倍数)> | 英雄MP上限比率(倍数值/100为实际倍数) |
<$HEROUNFIRERATE> | 火墙抗性 |
<$HEROUNDRAGONRATE> | 合击抗性 |
<$HEROUNHITRATE> | 近战抗性 |
<$HEROUNBATTERRATE> | 连击抗性 |
<$HEROUNMCRATE> | 魔法抗性 |
<$HEROUNSCRATE> | 道术抗性 |
<$HEROUNDRAGONSKILLRATE> | 龙神抗性 |
<$HEROGOLDLEVEL> | 金元等级 |
<$HEROWOODLEVEL> | 木元等级 |
<$HEROWATERLEVEL> | 水元等级 |
<$HEROFIRELEVEL> | 火元等级 |
<$HEROSOILLEVEL> | 土元等级 |
<$HeroArmyRankLevel> | 军衔等级 |
<$HEROALCOHOL> | 英雄酒量 |
<$HEROLUCKY> | 幸运属性 |
<$HEROLUCKYPOINT> | 幸运等级 |
<$HEROSKILLLEVELEX(技能ID)> | 指定技能的强化等级 |
<$HEROARMSCRITPOINT> | 英雄武器暴击属性点 |
<$HERORELEVEL> | 英雄转生等级 |
<$HEROMAPNAME> | 英雄所在地图名称 |
<$HEROMAP> | 英雄当前地图代码 |
<$HEROX> | 英雄X坐标 |
<$HEROY> | 英雄Y坐标 |
<$HERODIRECTION> | 英雄方向(0-7) |
<$HEROPOWERRATE> | 英雄攻击力倍数 |
<$HERONGEXP> | 英雄内功当前经验 |
<$HERONGMAXEXP> | 英雄内功升级经验 |
<$HEROBOXITEMS(位置)> | 英雄首饰盒物品名,位置：0-5 |
<$HEROHITSPEED> | 英雄攻速 |
<$HEROARMSCRIT> | 英雄暴击 |
<$HEROBREAKUPRATE> | 英雄击破 |
<$HEROHEARTCRITRATE> | 英雄神圣暴击概率 |
<$HEROHEARTCRITPOWERATE> | 英雄神圣暴击倍率 |
<$HEROHITPOINT> | 英雄准确 |
<$HEROSPEEDPOINT> | 英雄敏捷 |
<$HERODECDAMAGE> | 英雄伤害吸收% |
<$HERONH> | 英雄当前内力值 |
<$HEROMAXNH> | 英雄内力值上限 |
<$HEROWINEDRINK> | 英雄醉酒度 |
<$ANGER> | 英雄当前怒气值 |
<$MAXANGER> | 怒气值上限 |
<$HERODRAGONDERATERATE> | 英雄合击伤害减免比例(%) |
<$HEROKILLMONBURSTRATE> | 英雄杀怪暴率倍数 |
<$HEROREVIVAL> | 英雄复活属性可用状态(0-不可用 1-可用) |
<$HEROREBIRTH> | 英雄重生属性可用状态(0-不可用 1-可用) |
<$HEROINCDRAGON> | 英雄合击威力 |
<$HEROTENACITY> | 英雄韧性 |
<$HEROHITSINGLESTOUT> | 英雄物理单体坚韧 |
<$HEROHITGROUPSTOUT> | 英雄物理群体坚韧 |
<$HEROMAGSINGLESTOUT> | 英雄魔法单体坚韧 |
<$HEROMAGGROUPSTOUT> | 英雄魔法群体坚韧 |
<$HEROHITMAGSTOUT> | 英雄全能坚韧 |
<$HEROSOULPOWER> | 英雄魂力下限 |
<$HEROMAXSOULPOWER> | 英雄魂力上限 |
<$HEROSOULPOWERAC> | 英雄魂御 |
<$HEROSOULPOWERLUCK> | 英雄魂力幸运 |
<$HEROSOULAVOIDINJURY> | 英雄魂力免伤万分比 |
<$HEROSOULCRITRATE> | 英雄魂力暴击概率 |
<$HEROSOULCRITPOWERATE> | 英雄魂力暴击倍率 |
<$HEROSOULTENACITY> | 英雄魂力韧性 |
<$HEROSOULHITMAGSTOUT> | 英雄魂力坚韧 |
<$HEROWUXING> | 英雄五行属性(0-无 1-金 2-木 3-水 4-火 5-土) |
<$HEROWUXINGNAME> | 英雄五行属性名称 |
<$HEROGENERATEID> | 英雄生产ID |
<$HEROADDDAMAGEPOINT> | 英雄附加伤害比例‰(物品Need-110属性) |
<$HEROUNBURSTRATE> | 英雄防爆 |
<$HEROADDDAMAGERATE> | 英雄伤害附加% |
<$HEROABSORBNHPOINT> | 英雄内功吸收 |
<$HEROATTACKSPEED> | 英雄攻击速度（CHANGESPEED命令设置） |
<$HEROSPELLSPEED> | 英雄魔法速度（CHANGESPEED命令设置） |
<$HEROHONGMOSUITE> | 英雄虹魔吸血 |
<$HEROKILLMONEXPRATE> | 英雄杀怪经验倍数 |
商人相关变量
变量名称 | 说明 |
<$PRICERATE> | 价格倍数 |
<$UPGRADEWEAPONFEE> | 升级武器价格 |
<$USERWEAPON> | 手里拿的武器的名字 |
<$DEALGOLDPLAY> | 交易对像 |
沙城堡变量
变量名称 | 说明 |
<$CASTLEGOLD> | 城堡的总黄金 |
<$TODAYINCOME> | 城堡当天收入 |
<$CASTLEDOORSTATE> | 城堡的门状态 |
<$REPAIRDOORGOLD> | 修理城门费用 |
<$REPAIRWALLGOLD> | 修理皇宫城墙费用 |
<$GUARDFEE> | 聘用流动护卫费用 |
<$ARCHERFEE> | 聘用弓箭守卫费用 |
酒馆二卷变量
变量名称 | 说明 |
<$GUILDFOUNTAIN> | 行会泉水仓库 |
<$MEDICINEVALUE> | 药力值 |
<$ALCOHOL> | 酒量 |
天地结晶变量
变量名称 | 说明 |
<$GETCRYSTALEXP> | 天地结晶可提取的经验 |
<$GETCRYSTALNGEXP> | 天地结晶可提取的内功经验 |
<$CRYSTALEXP> | 天地结晶当前的经验 |
<$CRYSTALNGEXP> | 天地结晶当前的内功经验 |
<$CRYSTALLEVEL> | 天地结晶等级 |
服务器信息及参数
变量名称 | 说 明 |
<$SERVERNAME> | 服务器名字 |
<$SERVERIP> | 服务器IP地址 |
<$SERVERID> | 服务器区号 |
<$WEBSITE> | 游戏网址 |
<$BBSSITE> | 论坛网址 |
<$CLIENTDOWNLOAD> | 客户端程序下载地址 |
<$QQ> | 联系QQ号 |
<$PHONE> | 联系电话号码 |
<$BANKACCOUNT0> | 银行帐号信息 |
<$BANKACCOUNT1> | 银行帐号信息 |
<$BANKACCOUNT2> | 银行帐号信息 |
<$BANKACCOUNT3> | 银行帐号信息 |
<$BANKACCOUNT4> | 银行帐号信息 |
<$BANKACCOUNT5> | 银行帐号信息 |
<$BANKACCOUNT6> | 银行帐号信息 |
<$BANKACCOUNT7> | 银行帐号信息 |
<$BANKACCOUNT8> | 银行帐号信息 |
<$BANKACCOUNT9> | 银行帐号信息 |
<$USERCOUNT> | 在线人数 |
<$DATETIME> | 当前日期时间 |
<$HIGHLEVELINFO> | 最高等人物信息 |
<$HIGHPKINFO> | 最高PK点数人物信息 |
<$HIGHDCINFO> | 最高攻击力人物信息 |
<$HIGHMCINFO> | 最高魔法力人物信息 |
<$HIGHSCINFO> | 最高道术人物信息 |
<$HIGHTCINFO> | 最高刺术人物信息 |
<$GAMEGOLDNAME> | 游戏币名称 |
<$GAMEDIAMONDNAME> | 金刚石名称 |
<$GAMEGIRDNAME> | 灵符名称 |
<$GAMEPOINTNAME> | 游戏点名称 |
<$MACRUNTIME> | 服务器运行天数 |
<$SERVERRUNTIME> | 服务器运行时间 |
<$DATE> | 显示格式，X月Y日 |
<$MAXLEVEL> | 主体限制等级("选项"->"参数设置"->"升级经验"->等级经验限制，设置值) |
<$HEROMAXLEVEL> | 英雄限制等级 |
<$WEEK> | 服务器当前星期几,显示格式：星期四 |
<$TIME> | 服务器当前时间,格式：hh:mm:ss |
<$STRTIME(变量)> | 输出时间格式X天X时X分X秒，只能操作整数型人物变量(G I N S)，用于怪刷新倒计时显示 |
<$TIMESTAMP> | 服务器当前时间戳(UTC日期值) |
<$ONLINECOUNT> | 服务器在线真实人数(不含离线挂机、假人数) |
<$HOUR> | 当前时间小时 |
<$MIN> | 当前时间分 |
<$SEC> | 当前时间秒 |
<$DATEEX> | 输出年月日，格式：yyyymmdd |
<$DATEEX1> | 输出年月日，格式：yyyy-mm-dd |
<$YEAR> | 输出年，格式：yyyy |
<$MONTH> | 输出月，格式：mm |
<$DAY> | 输出日，格式：dd |
<$WEEKOF> | 计算当前日期是一年中的第几周 |
<$PATH> | 输出M2所在文件路径,例:D:\Mirserver\Mir200\；注意NPC窗口显示时会默认“\”为换行 |
<$MAXNGLEVEL> | 内功等级上限 |
<$MAXHEARTLEVEL> | 心法等级上限 |
四、总结
传奇脚本变量是版本定制、活动开发、BUG修复的核心基础，熟练掌握人物变量、全局变量、属性变量的分类与用法，能够大幅提升GM的版本修改效率。本文汇总的传奇脚本变量大全覆盖全场景常用变量，搭配标准化语法与实战案例，帮助开发者快速搭建规范、无漏洞的传奇游戏脚本逻辑。
