传奇全套脚本变量大全人物/英雄/内力/服务器变量使用教程【附实操案例】

玩传奇私服架设、传奇脚本修改、自定义游戏功能的玩家和GM，日常开发中最核心的基础就是掌握各类游戏变量。传奇游戏所有自定义功能，包括属性触发、装备判定、奖励发放、怪物机制、沙城规则、英雄联动等，全部依托官方内置变量实现。本文整理最新传奇完整脚本变量大全，涵盖人物常量变量、英雄专属变量、内力连击变量、天地结晶变量、服务器全局变量等全品类内容，同时搭配可直接套用的实操脚本案例，解决新手GM不会用变量、变量调用报错、功能脚本失效等常见问题，适配996、GOM、GEE等主流传奇引擎。

一、传奇脚本变量基础使用规则

在传奇引擎脚本编写中，变量分为人物常量、人物自定义变量、英雄专属变量、系统全局变量四大类，不同变量的调用格式、使用场景、生效规则完全不同，新手必须先掌握基础规范，避免脚本运行出错。

1、人物私人常量：固定格式前缀C.，全局永久生效，数据保存人物数据库，下线不重置，调用格式为<$C.变量名>，多用于攻击触发、死亡触发、交易判定、属性读取等场景。

2、人物私人变量：以<$CSTR(S1)>、<$STR(A1)>等格式呈现，分为临时变量和永久变量，部分变量下线清空数据，常用于自定义数值记录、任务标记、次数统计。

3、英雄专属变量：所有英雄变量统一前缀H.，基于人物变量衍生，专门用于读取、修改英雄属性、装备、状态，仅对召唤/已创建英雄生效。

4、全局系统变量：服务器、地图、时间、沙城、组队等公共数据变量，全服通用，无人物、英雄绑定限制，适配全服功能脚本开发。

二、传奇人物完整变量大全（含实操脚本案例）

人物变量是传奇脚本使用频率最高的变量体系，涵盖账号信息、属性数值、装备外观、游戏资源、状态坐标、战斗数据等所有人物相关数据，适用于个人任务、属性判定、装备检测、PK机制、爆率调整等各类脚本场景。

2.1 人物账号与基础信息变量

该类变量主要用于读取玩家注册信息、登录信息、角色基础标识，常用于账号绑定验证、新手福利判定、登录奖励脚本开发。

核心变量包含：<$USERACCOUNT>登录帐号、<$USERNAME>人物名称、<$USERALLNAME>人物完整名称、<$PASSWORD>注册账号密码、<$BIRTHDAT>注册生日、<$QUIZ1>/<$QUIZ2>注册密保问题、<$ANSWER1>/<$ANSWER2>密保答案、<$EMAIL>绑定邮箱、<$IDPHONE>注册电话、<$MOBILEPHONE>绑定手机、<$ACCOUNTUSERNAME>注册用户名、<$LOGINTIME>登录时间、<$LOGINLONG>登录时长、<$IPADDR>玩家登录IP地址。

2.2 人物属性与战斗数值变量

属性变量是战斗脚本、属性buff、装备加成、战力判定的核心，可精准读取人物攻防、血量、幸运、攻速等所有战斗属性，支持自定义属性触发机制。

核心变量包含：<$LEVEL>人物等级、<$HP>当前生命值、<$MAXHP>生命上限、<$MAXMP>魔法上限、<$AC>防御力、<$MAXAC>最高防御力、<$MAC>魔法防御力、<$MAXMAC>最高魔法防御、<$DC>物理攻击力、<$MAXDC>最大物攻、<$MC>魔法力、<$MAXMC>最大魔法、<$SC>道术、<$MAXSC>最大道术、<$HIT>准确、<$SPD>敏捷、<$HITSPD>攻速、<$LUCK>幸运值、<$POWERRATE>当前攻击倍数、<$POWERRATETIME>倍数剩余时长、<$PKPOWER>攻击威力、<$RELEVEL>转生等级。

2.3 人物资源与状态变量

该类变量用于管控玩家游戏资源、负重状态、PK状态、经验进度，适配元宝充值、金币消耗、等级升级、PK惩罚等脚本功能。

核心变量包含：<$EXP>当前经验、<$MAXEXP>升级经验、<$GetExp>当前获得经验、<$GOLDCOUNT>金币数量、<$GAMEGOLD>游戏币数量、<$GAMEPOINT>游戏点数、<$GAMEDIAMOND>金刚石、<$GAMEGIRD>灵符、<$GAMEGLORY>人物荣誉值、<$PKPOINT>PK点数、<$CREDITPOINT>声望点数、<$HW>腕力、<$MAXHW>最大腕力、<$BW>背包重量、<$MAXBW>背包最大负重、<$WW>负重力、<$MAXWW>最大负重、<$HUNGER>饥饿程度、<$KILLMONEXPRATE>杀怪经验倍数、<$KILLMONBURSTRATE>爆率倍数。

2.4 人物装备与外观变量

装备变量可读取玩家全身装备、时装、特效配饰信息，支持装备检测、套装触发、外观改名、装备星级统计等功能，是装备专属buff脚本的核心变量。

核心变量包含：<$DRESS>衣服、<$WEAPON>武器、<$HELMET>头盔、<$NECKLACE>项链、<$RING_R>右戒指、<$RING_L>左戒指、<$ARMRING_R>右手镯、<$ARMRING_L>左手镯、<$BUJUK>护身符、<$BELT>腰带、<$BOOTS>鞋子、<$CHARM>宝石、<$HAT>斗笠、<$DRUM>军鼓、<$HORSE>马牌、<$SHIELD>盾牌、<$SDRESS>时装衣服、<$SWEAPON>时装武器，同时对应全套<$G_XXX>装备改名变量，可读取装备自定义名称。

2.5 坐标、地图与场景变量

场景变量用于判定玩家所在地图、坐标、游戏时间，适配地图专属福利、定点触发、跨地图限制、限时活动等脚本开发。

核心变量包含：<$MAP>当前地图代码、<$MapTitle>当前地图名称、<$X>人物X坐标、<$Y>人物Y坐标、<$DIR>人物朝向、<$UTCNOW>北京时间时间戳、<$UTCNOW8>世界时间戳、<$YEAR>年份、<$MONTH>月份、<$DAY>日期、<$HOUR>小时、<$MINUTE>分钟、<$SECOND>秒、<$STATSERVERTIME>M2启动时间、<$RUNDATETIME>开区间隔时间。

2.6 战斗目标与怪物交互变量

专门用于攻击、被攻击、杀怪触发脚本，可读取目标怪物、敌对玩家的血量、坐标、名称等数据，适配专属打怪buff、反伤、吸血、斩杀等功能。

核心变量包含：<$KILLMONNAME>/<$KILLMONNAMEEX>击杀怪物名称、<$KILLMONX>/<$KILLMONY>怪物坐标、<$KILLMONNAME_MAXHP>怪物最大血量、<$ATTACKMONSTER_HP>目标剩余血量、<$ATTACKMONSTER_MAXHP>目标总血量、<$ATTACKMONSTER_HPRATE>目标血量百分比、<$C.HP>攻击目标血量、<$C.X>/<$C.Y>目标坐标、<$CURRRTARGETNAME>当前攻击目标名称。

2.7 人物状态与特殊功能变量

涵盖组队、师徒、沙城、合区、伤害吸收、装备星级等特殊数据，适配社交玩法、沙城特权、合区补偿、属性加成脚本。

核心变量包含：<$GUILDNAME>行会名称、<$RANKNAME>行会职位、<$OWNERGUILD>沙巴克管理行会、<$CASTLENAME>沙城名称、<$LORD>沙城管理员、<$CASTLEGAMEGOLD>沙城税收元宝、<$STNAME>师傅名称、<$TDNAME1~~5>徒弟名称、<$TEAM0~~TEAMX>组队成员信息、<$GROUPMEMBERCOUNT>组队人数、<$HFCOUNT>合区次数、<$HFTIME>合区时间、<$SUCKDAMAGE>/<$SUCKDAMAGEPOINT>伤害吸收值、<$UPGRADECOUNT>全身装备星级总和、<$StarcountX>单件装备星级、<$BAGNILCOUNT>背包空格数量。

2.8 人物变量实操套用脚本（可直接复制使用）

【脚本功能】玩家等级达到50级，自动发放1000元宝、50万金币等级福利，仅触发一次

#IF
CHECKLEVELEX >= 50
CHECKVAR HUMAN S1 = 0
#ACT
GAMEGOLD + 1000
GOLDCOUNT + 500000
MOV S1 1
SENDMSG 6 恭喜你等级达到50级，成功领取等级专属福利！
#ELSEACT
SENDMSG 6 等级不足或已领取过该福利！

【脚本解析】通过<$LEVEL>判定玩家等级，利用<$CSTR(S1)>变量记录领取状态，搭配<$GAMEGOLD>、<$GOLDCOUNT>资源变量实现福利发放，规避重复领取问题。

三、传奇英雄专属变量大全（含实操案例）

英雄变量是传奇英雄脚本开发的核心，所有变量均以H.为前缀，完美适配英雄属性修改、英雄装备判定、英雄buff触发、合击机制、英雄血量监测等功能，兼容所有带英雄版本的传奇服务端。

3.1 英雄基础属性变量

可精准读取英雄等级、攻防、血量、魔法、道术等核心属性，用于英雄战力判定、等级同步、属性加成脚本。

核心变量：<$H.LEVEL>英雄等级、<$H.HP>英雄当前血量、<$H.MAXHP>英雄血量上限、<$H.MAXMP>英雄魔法上限、<$H.AC>/<$H.MAXAC>英雄防御、<$H.MAC>/<$H.MAXMAC>英雄魔防、<$H.DC>/<$H.MAXDC>英雄物攻、<$H.MC>/<$H.MAXMC>英雄魔法、<$H.SC>/<$H.MAXSC>英雄道术、<$H.EXP>/<$H.MAXEXP>英雄经验、<$H.HIT>英雄准确、<$H.SPD>英雄敏捷、<$H.HITSPD>英雄攻速。

3.2 英雄装备与状态变量

覆盖英雄全身装备、时装、负重、PK状态、伤害吸收等数据，支持英雄套装效果、装备破损检测、专属属性触发。

核心变量：<$H.DRESS>英雄衣服、<$H.WEAPON>英雄武器、<$H.HELMET>英雄头盔、全套<$H.G_XXX>装备改名变量、<$H.WW>/<$H.MAXWW>英雄负重、<$H.PKPOINT>英雄PK值、<$H.SUCKDAMAGE>/<$H.SUCKDAMAGEPOINT>英雄伤害吸收、<$H.UPGRADECOUNT>英雄装备星级总和。

3.3 英雄场景与特殊变量

用于判定英雄所在地图、坐标、职业、性别，适配英雄地图限制、职业专属buff、跨地图同步状态。

核心变量：<$H.MAP>英雄地图代码、<$H.MapTitle>英雄地图名称、<$H.X>/<$H.Y>英雄坐标、<$H.JOB>英雄职业、<$H.GENDER>英雄性别、<$H.NAME>英雄名称、<$DRANGONHEARTVALUE>英雄怒气值。

3.4 英雄变量实操套用脚本

【脚本功能】英雄等级≥40级时，为人物增加10点全属性buff

#IF
CHECKHEROEXIST
CHECKHEROLEVELEX >= 40
#ACT
ADDDC 10
ADDMC 10
ADDSC 10
SENDMSG 6 你的英雄等级达标，激活人物全属性+10buff！
#ELSEACT
SENDMSG 6 未召唤英雄或英雄等级不足40级！

四、传奇内力、连击与天地结晶变量

该类变量适配传奇内功版本、连击版本、结晶养成版本，是中高版本传奇自定义养成功能的核心变量，可实现内功升级、连击触发、结晶经验提取等功能。

4.1 人物内力变量

包含：<$NH>当前内力、<$MAXNH>内力上限、<$NGLEVEL>内功等级、<$NGEXP>当前内功经验、<$NGMAXEXP>内功升级所需经验、<$GETNGEXP>当前获取内功经验。

4.2 英雄内力与连击变量

包含：<$H.NH>英雄内力、<$H.MAXNH>英雄内力上限、<$H.NGLEVEL>英雄内功等级、<$H.NGEXP>英雄内功经验、<$HEROPULSEXP>英雄经络经验、<$HEROGETNGEXP>英雄获得内功经验。

4.3 天地结晶变量

专门用于结晶经验提取、等级升级脚本，包含：<$CRYSTALLEVEL>结晶等级、<$CRYSTALEXP>结晶当前经验、<$CRYSTALNGEXP>结晶内功经验、<$GETCRYSTALEXP>可提取人物经验、<$GETCRYSTALNGEXP>可提取内功经验。

五、传奇宝宝、组队与战斗辅助变量

针对传奇召唤宝宝、诱惑怪物、组队作战场景设计，可精准管控宝宝属性、数量、状态，实现宝宝专属攻击、血量回血、数量限制等自定义功能。

核心变量：<$SLAVECOUNT>当前宝宝总数、<$TAMMINGSLAVECOUNT>已诱惑宝宝数量、<$MAXTAMMINGSLAVECOUNT>最大可诱惑数量、<$SLAVE(X).NAME>第X只宝宝名称、<$SLAVE(X).HP>/<$SLAVE(X).MaxHP>宝宝血量、<$SLAVE(X).DC1/DC2>宝宝攻击力、<$SLAVE(X).AC1/AC2>宝宝防御力、<$SLAVE(X).MS>宝宝移动速度、<$SLAVE(X).AS>宝宝攻击间隔。

六、传奇服务器全局变量大全

服务器变量为全服通用变量，不绑定单个玩家，用于读取服务器配置、在线数据、榜单信息，适配全服公告、在线奖励、战力榜单、服务器信息展示脚本。

核心变量：<$SERVERNAME>服务器名称、<$SERVERIP>服务器IP、<$WEBSITE>游戏官网、<$BBSSITE>论坛地址、<$CLIENTDOWNLOAD>客户端下载链接、<$QQ>联系QQ、<$PHONE>联系电话、<$USERCOUNT>当前在线人数、<$DATETIME>服务器当前时间、<$GAMEGOLDNAME>游戏币自定义名称、<$HIGHLEVELINFO>全服最高等级信息、<$HIGHDCINFO>最高物攻玩家信息、<$HIGHMCINFO>最高魔法玩家信息、<$HIGHSCINFO>最高道术玩家信息。

七、传奇脚本变量常见使用误区与避坑技巧

1、变量前缀区分：人物常量必须加C.，英雄变量必须加H.，缺少前缀会导致脚本读取数据失效，触发功能异常。

2、临时与永久变量区分：<$SUCKDAMAGEPOINT>、自定义STR临时变量下线清空，而<$C.HP>、<$SUCKDAMAGE>数据永久保存，需根据脚本需求选择对应变量。

3、场景触发限制：部分目标变量（如C.XXX怪物目标变量）仅在攻击、死亡、杀怪触发脚本中生效，普通NPC脚本无法调用。

4、变量格式规范：所有变量符号、大小写、格式必须严格匹配，传奇引擎变量区分格式错误，细微偏差会直接导致脚本不运行。

八、通用多功能变量组合脚本（全站通用）

【脚本功能】检测玩家穿戴武器，根据武器类型给予对应属性加成

#IF
CHECKITEMWTYPE 1
#ACT
ADDMAXDC 20
SENDMSG 6 你佩戴物理武器，最大物攻提升20点！
BREAK
#IF
CHECKITEMWTYPE 2
#ACT
ADDMAXMC 20
SENDMSG 6 你佩戴魔法武器，最大魔法提升20点！
BREAK
#IF
CHECKITEMWTYPE 3
#ACT
ADDMAXSC 20
SENDMSG 6 你佩戴道术武器，最大道术提升20点！