传奇脚本变量大全 人物英雄服务器变量使用教程

在传奇版本搭建、脚本修改、功能开发过程中，脚本变量是核心基础要素，所有人物属性、英雄数据、服务器状态、道具信息的调取与修改，都需要依靠各类专属变量实现。本文整理最全的传奇脚本变量合集，包含人物、英雄、内力、连击、服务器等全类型变量，附带详细使用规则与实操案例，方便传奇开发者快速查阅使用。一、传奇脚本…

在传奇版本搭建、脚本修改、功能开发过程中，脚本变量是核心基础要素，所有人物属性、英雄数据、服务器状态、道具信息的调取与修改，都需要依靠各类专属变量实现。本文整理最全的传奇脚本变量合集，包含人物、英雄、内力、连击、服务器等全类型变量，附带详细使用规则与实操案例，方便传奇开发者快速查阅使用。

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

传奇脚本中当前对象的常量与变量有固定调用格式，区分专属常量与自定义变量，适配攻击触发、被攻击触发、死亡触发、角色信息查看等各类脚本触发场景。

1、当前对象私人常量：统一在参数前加 C. 调用，适配各类角色状态调取场景；

2、当前对象私人变量：使用 <$CSTR(S1)> 格式调取，普通自身变量查看使用 <$STR(S1)>，二者仅相差前缀C标识；

3、适用场景：攻击触发、被攻击触发、角色死亡触发、出售角色信息查询等绝大多数传奇脚本触发逻辑。

常量示例：<$C.HP>、<$C.PKPOINT>、<$C.GOLDCOUNT>、<$C.GAMEGOLD>

变量示例：<$CSTR(S1)>、<$CSTR(A1)>、<$CSTR(T1)>、<$CSTR(U1)>、<$CHUMAN(QQQQ)>、<$CGUILD(WWWW)>

二、人物信息全套脚本变量

人物信息变量主要用于调取传奇角色的基础属性、装备、状态、坐标、游戏数据等信息，是传奇脚本开发中使用频率最高的变量类型。

2.1 人物基础属性变量

<$USERNAME>：人物名称

<$GUILDNAME>：行会名称

<$RANKNAME>：行会职位名称

<$LEVEL>：等级

<$HP>：生命值

<$AC>：防御力

<$MAXAC>：最高防御力

<$MAC>：魔法防御力

<$MAXMAC>：最高魔法防御力

<$DC>：物理攻击力

<$MAXDC>：最高物理攻击力

<$MC>：魔法力

<$MAXMC>：最高魔法力

<$SC>：道术

<$MAXSC>：最高道术

<$EXP>：当前经验值

<$MAXEXP>：升级经验值

<$MAXHP>：HP上限

<$MAXMP>：MP上限

<$DIR>：人物朝向方向

2.2 人物游戏数值变量

<$PKPOINT>：PK点数

<$CREDITPOINT>：声望点数

<$GOLDCOUNT>：金币数量

<$GAMEGOLD>：游戏币数

<$GAMEPOINT>：游戏点数

<$HW>：腕力

<$MAXHW>：最高腕力

<$BW>：背包重量

<$MAXBW>：最高背包重量

<$WW>：负重力

<$MAXWW>：最高负重

<$HUNGER>：饥饿程度

<$LOGINTIME>：登录时间

<$LOGINLONG>：登录时长

2.3 人物装备与时装变量

<$DRESS>：衣服

<$WEAPON>：武器

<$RIGHTHAND>：蜡烛

<$HELMET>：头盔

<$NECKLACE>：项链

<$RING_R>：右戒指

<$RING_L>：左戒指

<$ARMRING_R>：右手镯

<$ARMRING_L>：左手镯

<$BUJUK>：护身符

<$BELT>：腰带

<$BOOTS>：鞋子

<$CHARM>：宝石

<$HAT>：斗笠

<$DRUM>：军鼓

<$HORSE>：马牌

<$SHIELD>：盾牌

<$SDRESS>：时装衣服

<$SWEAPON>：时装武器

2.4 人物伤害吸收变量

<$SUCKDAMAGE>：伤害吸收值，通过USEBONUSPOINT脚本命令增加，数据保存至人物数据库，下线不清除

<$SUCKDAMAGEPOINT>：伤害吸收值，通过SETSUCKDAMAGE脚本命令增加，下线自动清空

2.5 装备改名专属变量

此类变量用于调取玩家自定义改名后的装备名称，适配装备改名、装备展示脚本功能：

<$G_DRESS>：改名后衣服名称

<$G_WEAPON>：改名后武器名称

<$G_RIGHTHAND>：改名后蜡烛名称

<$G_HELMET>：改名后头盔名称

<$G_NECKLACE>：改名后项链名称

<$G_RING_R>：改名后右戒指名称

<$G_RING_L>：改名后左戒指名称

<$G_ARMRING_R>：改名后右手镯名称

<$G_ARMRING_L>：改名后左手镯名称

<$G_BUJUK>：改名后护身符名称

<$G_BELT>：改名后腰带名称

<$G_BOOTS>：改名后鞋子名称

<$G_CHARM>：改名后宝石名称

<$G_HAT>：改名后斗笠名称

<$G_DRUM>：改名后军鼓名称

<$G_HORSE>：改名后马牌名称

<$G_SHIELD>：改名后盾牌名称

<$G_SDRESS>：改名后时装衣服名称

<$G_SWEAPON>：改名后时装武器名称

2.6 地图、沙城与进阶人物变量

<$CASTLENAME>：沙城名称

<$GAMEDIAMOND>：金刚石数量

<$GAMEGIRD>：灵符数量

<$MAP>：当前地图代码

<$RELEVEL>：转生等级

<$STATSERVERTIME>：M2引擎启动时间

<$RUNDATETIME>：服务器开区间隔时间

<$KILLER>：杀人者信息变量

<$RANDOMNO>：随机数值变量

<$X>：人物X坐标

<$Y>：人物Y坐标

<$USERALLNAME>：人物完整名称

<$GAMEGLORY>：人物荣誉值

<$MapTitle>：当前地图名称

<$GetExp>：人物当前获取经验值

<$CASTLEGAMEGOLD>：沙城税收元宝数值

<$USERID>：人物登录账号

<$KILLMONNAME>：击杀怪物名称（宝宝服建议使用新版变量）

<$KILLMONX>、<$KILLMONY>：击杀怪物坐标

<$HIT>：人物准确值

<$SPD>：人物敏捷值

<$HITSPD>：人物攻速值

<$LUCK>：幸运值

2.7 时间、组队与师徒变量

<$YEAR>：当前年份

<$MONTH>：当前月份

<$DAY>：当前日期

<$HOUR>：当前小时

<$MINUTE>：当前分钟

<$SECOND>：当前秒数

<$TEAM0>至<$TEAMX>：组队成员信息，TEAM0为队长，后续为队员

<$STNAME>：师徒名称变量

2.8 经验、状态与元素属性变量

<$KILLMONEXPRATE>：杀怪经验倍数

<$KILLMONEXPRATETIME>：经验倍数持续时长

<$GAMEGOLDEX>：新版游戏点数

<$REVIVALTIME>：复活间隔时间

<$REVIVALTIMEEX>：复活倒计时

<$POWERRATE>：当前攻击力倍数

<$POWERRATETIME>：攻击力倍数剩余时长

<$GROUPMEMBERCOUNT>：当前组队人数

<$VALUE1>至<$VALUE17>：人物17项元素属性常量

<$SCREENWIDTH>：游戏分辨率宽度

<$SCREENHEIGHT>：游戏分辨率高度

2.9 账号注册信息变量

<$PASSWORD>：注册账号密码

<$BIRTHDAT>：注册生日信息

<$QUIZ1>：注册问题1

<$ANSWER1>：注册答案1

<$QUIZ2>：注册问题2

<$ANSWER2>：注册答案2

<$EMAIL>：注册邮箱

<$IDPHONE>：注册固定电话

<$MOBILEPHONE>：注册手机号

<$ACCOUNTUSERNAME>：注册用户名

2.10 掉落/拾取物品变量

适配人物捡取、掉落物品的属性调取，是物品脚本、掉落定制核心变量：

<$CURRTEMNAME>：当前拾取/掉落物品名称

<$G_CURRTEMNAME>：当前拾取/掉落物品改名后名称

<$CURRTEMSTDMODE>：物品DB字段StdMode数值

<$CURRTEMSHAPE>：物品DB字段Shape数值

<$CURRTEMANICOUNT>：物品DB字段AniCount数值

<$CURRTEMLOOKS>：物品DB字段Looks数值

<$CURRTEMDURA>：物品当前持久值

<$CURRTEMDURAMAX>：物品最大持久值

<$CURRTEMINDEX>：物品DB字段Idx数值

<$CURRTEMCOLOR>：物品DB字段Color数值

2.11 英雄、目标与战斗相关变量

<$CURRHERONAME>：已召唤英雄名称，未召唤则为空

<$HERONAME>：账号英雄名称，未创建则为空

<$DEPUTYHERONAME>：副将英雄名称，未创建则为空

<$MONFLAG>、<$C.MONFLAG>：怪物标识变量，最大值65535

<$PKPOWER>：人物当前攻击威力

<$KILLMONNAME_MAXHP>：击杀怪物最大血量

<$C.X>：攻击目标X坐标

<$C.Y>：攻击目标Y坐标

<$C.HP>：攻击目标当前血量

<$C.MAXHP>：攻击目标血量上限

<$CURRRSLAVENAME>：当前宝宝名称（宝宝攻击、死亡触发生效）

<$CURRRTARGETNAME>：当前攻击目标名称（全战斗触发通用）

<$GAMEPROMOTIONFLAG>：推广标识

<$UPGRADECOUNT>：人物装备加星总数量

<$NPCNAME>：当前交互NPC名称

2.12 宝宝、分身与在线数据变量

<$SLAVECOUNT>：人物宝宝数量

<$HUMCLONECOUNT>：人物分身数量

<$TAMMINGSLAVECOUNT>：已诱惑宝宝数量（不含技能召唤）

<$MAXTAMMINGSLAVECOUNT>：最大可诱惑宝宝数量

<$C.TAMMINGSLAVECOUNT>：当前角色已诱惑宝宝数

<$C.MAXTAMMINGSLAVECOUNT>：当前角色最大诱惑宝宝上限

<$RecallRemainingTime>：延时召回剩余秒数

<$C.RecallRemainingTime>：目标延时召回剩余秒数

<$SHOPNAME>：玩家摊位名称

<$BATTLEATTACKHUM>：主动攻击战斗状态时长

<$BATTLESTRUCKHUM>：被攻击战斗状态时长

<$REALLYCOUNT>：真实在线人数

<$DUMMYCOUNT>：假人在线人数

<$OFFLINECOUNT>：离线挂机人数

<$HEROCOUNT>：在线英雄数量

<$KILLMONNAMEEX>：人物+宝宝击杀怪物名称（宝宝服专用）

<$KILLMONXEX>、<$KILLMONYEX>：人物+宝宝击杀怪物坐标

<$LASTKILLER>：最后一击攻击者名称

2.13 时间戳、地图与服务器路径变量

<$TIMEUNIX>：毫秒级时间戳

<$TIMEUNIXS>：秒级时间戳

<$TIMEUNIX9>：9位毫秒时间戳（适配CD计算）

<$KILLMONDBNAME>：击杀怪物数据库名称（含数字）

<$MAPWIDTH>：当前地图宽度

<$MAPHEIGHT>：当前地图高度

<$IPADDR>：玩家IP地址

<$IPLOCAL>：IP对应归属地区

<$GameDirectory>：服务端根目录

<$M2Directory>：M2引擎程序目录

三、英雄信息全套脚本变量

传奇英雄变量统一以 H. 为前缀，用于调取英雄的属性、装备、状态、坐标等数据，所有英雄专属变量均可对应人物变量使用逻辑，适配英雄升级、装备判定、战斗脚本开发。

3.1 英雄基础属性变量

<$H.USERNAME>：英雄名称

<$H.LEVEL>：英雄等级

<$H.HP>：英雄生命值

<$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.MAXHP>：英雄血量上限

<$H.MAXMP>：英雄魔法上限

<$H.DIR>：英雄朝向

<$H.PKPOINT>：英雄PK点数

<$H.HW>：英雄腕力

<$H.MAXHW>：英雄最高腕力

<$H.BW>：英雄背包重量

<$H.MAXBW>：英雄最高背包重量

<$H.WW>：英雄负重力

<$H.MAXWW>：英雄最高负重

<$H.HUNGER>：英雄饥饿程度

3.2 英雄伤害吸收变量

<$H.SUCKDAMAGE>：英雄伤害吸收值，通过H.USEBONUSPOINT增加，下线数据保留

<$H.SUCKDAMAGEPOINT>：英雄伤害吸收值，通过专属脚本命令增加，下线数据清空

3.3 英雄装备与时装变量

<$H.DRESS>：英雄衣服

<$H.WEAPON>：英雄武器

<$H.RIGHTHAND>：英雄蜡烛

<$H.HELMET>：英雄头盔

<$H.NECKLACE>：英雄项链

<$H.RING_R>：英雄右戒指

<$H.RING_L>：英雄左戒指

<$H.ARMRING_R>：英雄右手镯

<$H.ARMRING_L>：英雄左手镯

<$H.BUJUK>：英雄护身符

<$H.BELT>：英雄腰带

<$H.BOOTS>：英雄鞋子

<$H.CHARM>：英雄宝石

<$H.HAT>：英雄斗笠

<$H.DRUM>：英雄军鼓

<$H.HORSE>：英雄马牌

<$H.SHIELD>：英雄盾牌

<$H.SDRESS>：英雄时装衣服

<$H.SWEAPON>：英雄时装武器

3.4 英雄改名装备变量

<$H.G_DRESS>：英雄改名衣服名称

<$H.G_WEAPON>：英雄改名武器名称

<$H.G_RIGHTHAND>：英雄改名蜡烛名称

<$H.G_HELMET>：英雄改名头盔名称

<$H.G_NECKLACE>：英雄改名项链名称

<$H.G_RING_R>：英雄改名右戒指名称

<$H.G_RING_L>：英雄改名左戒指名称

<$H.G_ARMRING_R>：英雄改名右手镯名称

<$H.G_ARMRING_L>：英雄改名左手镯名称

<$H.G_BUJUK>：英雄改名护身符名称

<$H.G_BELT>：英雄改名腰带名称

<$H.G_BOOTS>：英雄改名鞋子名称

<$H.G_CHARM>：英雄改名宝石名称

<$H.G_HAT>：英雄改名斗笠名称

<$H.G_DRUM>：英雄改名军鼓名称

<$H.G_HORSE>：英雄改名马牌名称

<$H.G_SHIELD>：英雄改名盾牌名称

<$H.G_SDRESS>：英雄改名时装衣服名称

<$H.G_SWEAPON>：英雄改名时装武器名称

3.5 英雄进阶状态变量

<$H.MAP>：英雄当前地图代码

<$H.RELEVEL>：英雄转生等级

<$H.X>：英雄X坐标

<$H.Y>：英雄Y坐标

<$H.USERALLNAME>：英雄完整名称

<$H.MapTitle>：英雄所在地图名称

<$HeroGetExp>：英雄当前获得经验

<$H.HIT>：英雄准确值

<$H.SPD>：英雄敏捷值

<$H.HITSPD>：英雄攻速值

<$HEROGENDER>：英雄性别

<$HEROJOB>：英雄职业

<$HEROLEVEL>：英雄级别

<$HERONAME>：英雄名字

<$HMapTitle>：英雄地图名称

<$HMAP>：英雄地图编号

<$HX>：英雄前X坐标

<$HY>：英雄前Y坐标

<$H.PKPOWER>：英雄当前攻击威力

<$H.UPGRADECOUNT>：英雄装备加星总数

<$H.VALUE1>至<$H.VALUE11>：英雄11项元素属性常量

四、天地结晶脚本变量

专门用于传奇天地结晶功能开发，支持结晶经验提取、等级判定、内功经验调取等脚本需求：

<$GETCRYSTALEXP>：天地结晶可提取人物经验

<$GETCRYSTALNGEXP>：天地结晶可提取内功经验

<$CRYSTALEXP>：天地结晶当前人物经验值

<$CRYSTALNGEXP>：天地结晶当前内功经验值

<$CRYSTALLEVEL>：天地结晶当前等级

五、人物内力与内功脚本变量

适配传奇内功系统、内力恢复、内功升级等功能脚本开发：

<$NH>：人物当前内力值

<$MAXNH>：人物内力上限

<$NGEXP>：人物当前内功经验

<$NGMAXEXP>：人物内功升级所需经验

<$NGLEVEL>：人物内功等级

六、英雄内力脚本变量

英雄内功内力变量统一携带H.前缀，对应人物内功变量逻辑，适配英雄内功系统开发：

<$H.NH>：英雄当前内力值

<$H.MAXNH>：英雄内力上限

<$H.NGEXP>：英雄当前内功经验

<$H.NGMAXEXP>：英雄内功升级经验

<$H.NGLEVEL>：英雄内功等级

七、连击系统脚本变量

用于传奇连击、经络升级、内功经验获取等专属功能脚本：

<$NGLEVEL>：当前内功等级

<$HEROPULSEXP>：英雄经络经验

<$GETNGEXP>：人物当前获取内功经验

<$HEROGETNGEXP>：英雄当前获取内功经验

八、国家系统脚本变量

适配传奇国家玩法、国家人数统计等脚本功能：

<$NATIONNAME>：国家名称

<$NATIONPEOPLE>：国家在线人数

九、服务器全局脚本变量

服务器变量为全局通用变量，可调取服务器配置、在线数据、榜单信息等全局参数：

<$SERVERNAME>：服务器名称

<$SERVERIP>：服务器IP地址

<$WEBSITE>：游戏官网地址

<$BBSSITE>：游戏论坛地址

<$CLIENTDOWNLOAD>：客户端下载地址

<$QQ>：客服QQ

<$PHONE>：客服电话

<$BANKACCOUNT0-9>：10组银行账号信息

<$GAMEGOLDNAME>：游戏币自定义名称

<$USERCOUNT>：服务器在线总人数

<$DATETIME>：服务器当前时间

<$HIGHLEVELINFO>：服务器最高等级玩家信息

<$HIGHPKINFO>：服务器最高PK值玩家信息

<$HIGHDCINFO>：服务器最高攻击力玩家信息

<$HIGHMCINFO>：服务器最高魔法力玩家信息

<$HIGHSCINFO>：服务器最高道术玩家信息