常用变量与变量标签

这页集中收录脚本里最常查的一批变量与变量标签，优先解决“先找到该用哪个变量”。

本页大量出现的 H.、T. 只是「英雄对象」「目标对象」的前缀标记，不是变量名的一部分，实际写脚本时必须补全为完整的 <$H.变量名>、<$T.变量名>：

H. = 英雄对象，完整写法 <$H.变量名>，例如 <$H.MAXHP> 读取英雄的生命值上限。
T. = 目标对象，完整写法 <$T.变量名>，例如 <$T.MAXHP> 读取目标的生命值上限。
表格里写成 H. T. <$MAXHP> 这样的并列，只表示「这个变量同时有英雄版和目标版」，不要连写成 <$H.T.MAXHP>，这种写法无效。
既没有 H. 也没有 T. 的变量，直接写 <$变量名> 读取当前主体对象。

常见前缀

不带前缀时，默认读取主体对象。
H. 用来读取英雄对象。
T. 用来读取目标对象。
不是每个标签都支持 H. 或 T.；以下表格会直接标出支持对象。

当前对象常用属性

标签	含义	说明
`H.` `T.` `<$HP>`	生命值	读取当前生命值；目标版读取目标当前生命值。
`H.` `T.` `<$MAXHP>`	最高生命值	读取生命值上限。
`H.` `T.` `<$MP>`	魔法值	读取当前魔法值；目标版读取目标当前魔法值。
`H.` `T.` `<$MAXMP>`	最高魔法值	读取魔法值上限。
`H.` `T.` `<$AC>`	防御	读取防御下限相关值。
`H.` `T.` `<$MAXAC>`	最高防御	读取防御上限相关值。
`H.` `T.` `<$MAC>`	魔御	读取魔御下限相关值。
`H.` `T.` `<$MAXMAC>`	最高魔御	读取魔御上限相关值。
`H.` `T.` `<$DC>`	攻击	读取攻击下限相关值。
`H.` `T.` `<$MAXDC>`	最高攻击	读取攻击上限相关值。
`H.` `T.` `<$MC>`	魔法	读取魔法下限相关值。
`H.` `T.` `<$MAXMC>`	最高魔法	读取魔法上限相关值。
`H.` `T.` `<$SC>`	道术	读取道术下限相关值。
`H.` `T.` `<$MAXSC>`	最高道术	读取道术上限相关值。
`H.` `T.` `<$HIT>`	准确	读取准确属性值。
`H.` `T.` `<$SPD>`	速度	读取速度属性值。
`H.` `<$LUCKPOINT>`	幸运值	读取当前对象幸运值；英雄版读取英雄幸运值。

成长、负重与资源

标签	含义	说明
`H.` `<$EXP>`	当前经验	读取当前经验值。
`H.` `<$MAXEXP>`	升级经验值	读取当前等级所需经验值。
`H.` `<$PKPOINT>`	PK 点数	读取 PK 点数。
`H.` `<$CREDITPOINT>`	声望点数	读取声望点数。
`H.` `<$HEROCREDITPOINT>`	荣誉值	读取荣誉值。
`H.` `<$HW>`	腕力	读取当前腕力。
`H.` `<$MAXHW>`	最高腕力	读取腕力上限。
`H.` `<$BW>`	背包重量	读取当前背包重量。
`H.` `<$MAXBW>`	最高背包重量	读取背包重量上限。
`H.` `<$WW>`	负重力	读取当前负重。
`H.` `<$MAXWW>`	最高负重	读取负重上限。
`H.` `T.` `<$LEVEL>`	等级	读取当前等级；英雄版读取英雄级别，目标版读取目标等级。
`H.` `<$GOLDCOUNT>`	金币	读取当前金币数量。
`H.` `<$GAMEGOLD>`	元宝	读取当前元宝数量。
`H.` `<$NIMBUS>`	灵气值	读取灵气值。
`H.` `<$GAMEPOINT>`	游戏点	读取当前游戏点数量。
`H.` `<$GAMEDIAMOND>`	金刚石数	读取当前金刚石数量。
`H.` `<$GAMEGIRD>`	灵符	读取当前灵符数量。
`H.` `<$HUNGER>`	饥饿程度	读取当前饥饿值。
`H.` `<$LOGINTIME>`	登录时间	读取本次登录时间。
`H.` `<$LOGINLONG>`	登录时长	读取累计在线时长。

穿戴与装备名称

标签	含义	说明
`H.` `<$DRESS>`	身上衣服名称	读取当前穿戴衣服的名称。
`H.` `<$WEAPON>`	身上武器名称	读取当前武器名称。
`H.` `<$RIGHTHAND>`	蜡烛	读取右手位道具名称。
`H.` `<$HELMET>`	头盔	读取头盔名称。
`H.` `<$HELMETEX>`	斗笠	读取斗笠名称。
`H.` `<$NECKLACE>`	项链	读取项链名称。
`H.` `<$RING_R>`	戒指左	读取左戒指名称。
`H.` `<$RING_L>`	戒指右	读取右戒指名称。
`H.` `<$ARMRING_R>`	手镯左	读取左手镯名称。
`H.` `<$ARMRING_L>`	手镯右	读取右手镯名称。
`H.` `<$BUJUK>`	符、毒	读取符或毒位道具名称。
`H.` `<$BELT>`	腰带	读取腰带名称。
`H.` `<$BOOTS>`	鞋子	读取鞋子名称。
`H.` `<$CHARM>`	宝石	读取宝石名称。
`H.` `<$DRUM>`	军鼓	读取军鼓名称。
`H.` `<$HORSE>`	马牌	读取马牌名称。
`H.` `<$FASHION>`	时装	读取时装名称。

物品与背包变量

变量	含义	说明
`H.` `<$ITEMCOUNT(物品名)>`	背包物品数量	读取人物背包里指定物品的数量；英雄版写作 `<$H.ITEMCOUNT(物品名)>`。
`H.` `<$ITEM(物品ID)>`	展示物品	主要用于展示背包、身上装备与怪物掉落物品，参数为物品 ID，客户端鼠标指向物品图标即可看到属性展示，需要同时更新客户端。
`<$DLGITEMNAME>`	点击后可得到的物品名	读取对话框里点击后可得到的物品名称。
`<$RANDOMNO>`	随机值变量	读取一个随机值。
`<$CURITEMINDEX>`	当前将出产物品的 ID	等于 `Setup` 中的 `ItemNumberEx`。
`<$ITEMID(n)Json>`	物品 ID 的 JSON 描述	`n` 为物品 ID，返回形如 `{"DateTime":"2022-11-12T22:33:44","ServerID":123,"Sequence":456}` 的对象。
`<$ITEMID(n)Sequence>`	物品产生序列号	返回物品产生的序列号。
`<$ITEMID(n)ServerID>`	物品产生的服务器 ID	返回物品产生的服务器 ID。
`<$ITEMID(n)ISO8601>`	物品产生日期时间	返回物品产生的日期时间。
`<$ITEMID(n)UNIXTIME>`	物品产生时间戳	返回物品产生的 Unix 时间戳。

物品框变量

变量	含义	说明
`<$BoxItemID0~19>`	物品框 0~19 的物品 ID	取下对应物品框的物品后，该框的物品 ID 为 `0`。
`<$BoxItemName0~19>`	物品框 0~19 的物品名	取下对应物品框的物品后，该框的物品名为空。
`<$BoxItemCount0~19>`	物品框 0~19 的物品数量	取下对应物品框的物品后，该框的物品数量为 `0`。
`<$STR(S_RemovedBoxItemID0~19)>`	移除物品框 0~19 的物品 ID	即时变量，只能在参考说明里使用。
`<$STR(S_RemovedBoxItemName0~19)>`	移除物品框 0~19 的物品名	同上。
`<$STR(M_RemovedBoxItemCount0~19)>`	移除物品框 0~19 的物品数量	同上。

地图与位置

标签	含义	说明
`H.` `T.` `<$CURRENTMAPDESC>`	当前地图名称信息	读取当前地图名称，如“盟重省”。
`H.` `T.` `<$CURRENTMAP>`	当前地图编号	读取当前地图编号。
`H.` `T.` `<$CURRENTX>`	当前坐标 X	读取当前坐标 X。
`H.` `T.` `<$CURRENTY>`	当前坐标 Y	读取当前坐标 Y。
`<$MAPWIDTH>`	当前地图的宽	读取当前地图的宽。
`<$MAPHEIGHT>`	当前地图的长	读取当前地图的长。
`<$MapMonCnt(地图名.怪物名)>`	地图怪物数量	地图无效返回 `-1`，怪物无效或不参与数量统计返回 `-2`；只有怪物表 `StatMask` 包含 `1` 的怪物才会被统计。

系统与服务器信息

标签	含义	说明
`<$SERVERNAME>`	服务器名称	读取当前服务器名称。
`<$SERVERIP>`	服务器 IP	读取当前服务器 IP。
`<$WEBSITE>`	网站	读取 `String.ini` 中配置的网站地址。
`<$BBSSITE>`	论坛	读取 `String.ini` 中配置的论坛地址。
`<$CLIENTDOWNLOAD>`	下载	读取 `String.ini` 中配置的下载地址。
`<$QQ>`	QQ	读取 `String.ini` 中配置的 QQ 信息。
`<$PHONE>`	电话	读取 `String.ini` 中配置的电话信息。
`<$BANKACCOUNT0-9>`	银行信息	读取 `String.ini` 中配置的银行信息项。
`<$GAMEGOLDNAME>`	游戏币名称	读取当前服的游戏币名称。
`<$GAMEPOINTNAME>`	游戏点名称	读取当前服的游戏点名称。
`<$USERCOUNT>`	在线人数	读取当前在线人数。
`<$ONLINEHUMNUM>`	当前引擎在线人数	读取当前引擎在线人数。
`<$OFFLINEHUMNUM>`	当前引擎离线人数	读取当前引擎离线人数。
`<$TOTALHUMNUM>`	总在线人数	多引擎下的总在线人数。
`<$MACRUNTIME>`	服务器运行天数	读取服务器已运行天数。
`<$SERVERRUNTIME>`	服务器运行时间	读取服务器累计运行时间。
`<$DATETIME>`	服务器时间	读取当前服务器时间。
`<$UNIXTIME>`	当前时间戳	读取当前 UTC 时间戳。
`H.` `<$HIGHLEVELINFO>`	最高级别信息	读取服务器最高级别相关信息。
`H.` `<$HIGHPKINFO>`	最高 PK 值	读取服务器最高 PK 相关信息。
`H.` `<$HIGHDCINFO>`	最高攻击	读取服务器最高攻击相关信息。
`H.` `<$HIGHMCINFO>`	最高魔法	读取服务器最高魔法相关信息。
`H.` `<$HIGHSCINFO>`	最高道术	读取服务器最高道术相关信息。
`<$HIGHONLINEINFO>`	在线最长时间玩家的信息	读取在线时长最高玩家相关信息。

账号与机器码变量

变量	含义	说明
`<$ADID>`	推广 ID	登录器配置器中增加“推广 ID”的填写，最多 14 字节（7 个汉字）；用法见登录器推广 ID。
`<$TOTPKEY>`	二级密码长度	读取二级密码长度。
`<$HWID>`	个人机器码	个人机器码旧变量。
`<$HWIDLITE>`	个人数字机器码	个人数字（9 位）机器码变量。
`<$MACHINEID>`	服务器机器码	读取服务器机器码。
`<$SERVERID>`	服务器 ID	保证 ID 唯一的前提是不同服务器的 `Setup` 参数中 `serverid` 唯一。
`<$UID>`	临时型 ID	临时型 ID 系统，随机生成一次 ID，可用于交易网站上的订单 ID。
`<$EMAIL>`	邮箱	读取账号资料中的邮箱。
`<$BIRTHDAY>`	生日	读取账号资料中的生日。
`<$PHONE2>`	电话	读取账号资料中的电话。
`<$MOBILEPHONE>`	手机号码	读取账号资料中的手机号码。
`<$QUIZ>`	问题 1	读取账号资料中的第一个问题。
`<$ANSWER>`	答案 1	读取账号资料中第一个问题的答案。
`<$QUIZ2>`	问题 2	读取账号资料中的第二个问题。
`<$ANSWER2>`	答案 2	读取账号资料中第二个问题的答案。

目标与事件上下文

标签	含义	说明
`H.` `T.` `<$USERNAME>`	人物名称	读取人物名称；英雄版读取英雄名字。
`T.` `<$USERID>`	人物 ID	读取人物 ID。
`H.` `<$HUMANSHOWNAME>`	人物名字全称	读取带附加展示信息的人物全称（可包含行会封号、结婚对象、师徒名等）。
`H.` `<$IPADDR>`	IP 地址	读取当前角色 IP 地址。
`H.` `<$IPLOCAL>`	IP 地区信息	读取当前角色 IP 对应地区信息。
`<$DEALGOLDPLAY>`	元宝交易对象	读取当前元宝转账流程中与你交易的对方名称；配合元宝转账脚本使用。
`H.` `<$GENDER>`	人物性别	读取性别信息。
`H.` `<$JOB>`	职业	读取职业信息。
`H.` `T.` `<$MONKILLER>`	杀人怪物变量	读取杀人怪物名称或 ID。
`H.` `T.` `<$KILLER>`	杀人者名称	读取杀人者名称或 ID。
`H.` `<$DECEDENT>`	被杀者名称	读取被杀者名称。
`<$TARINFO_STATID>`	目标伤害统计 ID	读取当前目标对应的伤害统计 ID。
`<$TARINFO_RACE>`	目标角色的种族	读取当前目标的 Race 值。
`<$TARINFO_ISHERO>`	目标是否为英雄单位	读取当前目标是否为英雄单位。
`<$TARINFO_ISSLAVE>`	目标是否为随从	读取当前目标是否为随从。
`<$TARINFO_CX>`	目标坐标 X	读取当前目标所在坐标的 X 值。
`<$TARINFO_CY>`	目标坐标 Y	读取当前目标所在坐标的 Y 值。
`<$TARINFO_ISHUMAN>`	目标是否为人物	`0` 表示怪物，`1` 表示人物。
`<$TARINFO_NAME>`	目标名称	读取当前目标名称。
`<$TARINFO_FNAME>`	目标全名	读取当前目标全名。
`<$ATTINFO_SKILLID>`	攻击使用技能 ID	读取本次攻击或技能调用使用的技能 ID。
`<$ATTINFO_RACE>`	攻击者 Race	读取攻击者 Race 值。
`<$ATTINFO_ISHERO>`	攻击者是否为英雄单位	读取攻击者是否为英雄单位。
`<$ATTINFO_ISHUMAN>`	攻击者是否为人物	`0` 表示怪物，`1` 表示人物。
`<$ATTINFO_MNAME>`	攻击者主人名称	读取攻击者主人名称；没有主人时通常为空。
`<$ATTINFO_HITTYPE>`	攻击类型	`0` 表示普通，`1` 表示暴击。
`<$ATTINFO_DAMAGE>`	本次伤害值	读取本次攻击触发的伤害值。
`<$ATTINFO_NAME>`	攻击者名称	读取攻击者名称。
`<$ATTINFO_FNAME>`	攻击者全名	读取攻击者全名。
`<$MAGICLEVEL(1~255)>`	获取技能等级	按技能 ID 读取普通技能等级；返回 `-1` 表示技能未学习或其它错误。
`<$UNITYPOWERRATE>`	合击威力倍率	读取合击威力倍率。
`<$PARAM(N)>`	参数	按序号读取当前流程传入参数。
`<$NPCEXECUTECOUNT>`	当前 NPC 被执行的次数	读取当前 NPC 已被执行次数。
`<$TIMESTAMP>`	当前格式化日期时间	读取当前格式化日期时间。
`<$CURTITLENAME>`	当前使用称号	读取当前正在使用的称号；称号配置见称号称谓设置。
`<$MONDROPRATE>`	杀怪个人爆率变量	读取当前个人爆率相关值。
`<$CURITEMID>`	获取当前物品的 ID	在 Give、GiveEx、GiveOK、GM 制造物品等流程中读取当前物品 ID。

动态统计值

写法	含义	说明
`<$STAT(统计ID).字段>`	读取动态统计值	按统计 ID 和字段名读取对应统计结果。

#SAY
当前 DPS：<$STAT($TARINFO_STATID).DPS>

<$STAT(...)...> 适合先拿到统计 ID，再按字段读取统计结果。
当前可确认的典型入口是 <$TARINFO_STATID>，常用于目标伤害统计相关场景。
圆括号内支持固定变量内嵌；不适合再套类似 $STR(M1) 这种动态写法。

开关与状态变量

变量	含义	说明
`<$AllowGroup>`	允许组队	读取是否允许组队。
`<$BanShout>`	允许群聊（队伍）	读取是否允许群聊。
`<$HearWhisper>`	允许私聊	读取是否允许私聊。
`<$AllowDeal>`	允许交易	读取是否允许交易。
`<$AllowGuild>`	允许加入行会	读取是否允许加入行会。
`<$HearGuildChat>`	允许行会聊天	读取是否允许行会聊天。
`<$AllowGroupRecall>`	允许天地合一	读取是否允许天地合一。
`<$AllowGuildRecall>`	允许行会合一	读取是否允许行会合一。
`<$AttackMode>`	攻击模式	读取攻击模式变量，取值 `0~6`。
`<$ClientSwitches[0~7]>`	客户端开关	`0` 目前是客户端自动挂机复选框状态，其他暂未用到。
`H.` `<$REVIVALCD>`	复活冷却	多少秒后人物可以复活：`-1` 表示不能复活，`0` 表示可以立即复活，其他正数表示 n 秒后被杀可以复活（对方没有反复活技能时）；英雄版读取英雄的复活冷却。
`<$TELEPORTCD>`	传送冷却	允许传送的倒计时：`-1` 表示不能传送，`0` 表示可以立即传送，其他正数表示 n 秒后可以传送。
`<$BATTLEMODECD>`	战斗状态持续时间	毫秒战斗状态持续时间变量。
`H.` `<$AbilMakeStoneRate>`	石化能力几率	读取人物石化能力几率，英雄版读取英雄的石化能力几率。
`H.` `<$AbilMakeStoneTime>`	石化能力时间	读取人物石化能力时间，英雄版读取英雄的石化能力时间。
`<$H.LOYALTY>`	英雄忠诚度	读取英雄忠诚度。
`<$H.UnityEnergy>`	英雄怒气值	读取英雄怒气值。

以上允许类变量可参考 Command.ini 内同名命令。

倍率变量

变量	含义	说明
`<$KillMonExpRate>`	杀怪经验倍率	获取人物杀怪经验倍率。
`<$KillMonExpRateSecs>`	杀怪经验倍率剩余秒数	读取杀怪经验倍率的剩余秒数。
`<$PropRate[0~6]>`	属性倍数比率	各属性倍数比率，对应 `StatusRate` 命令。
`<$PropRateSecs[0~6]>`	属性倍数比率剩余秒数	读取各属性倍数比率的剩余秒数。
`<$PowerRate>`	攻击力百分比倍率	读取攻击力百分比倍率。
`<$PowerRateSecs>`	攻击力百分比倍率剩余秒数	读取攻击力百分比倍率的剩余秒数。

以上倍率利用 Calc 命令可以算出浮点数倍数。

时间与日期变量

变量	含义	说明
`<$YEAR>`	年	读取当前年份。
`<$MONTH>`	月	读取当前月份。
`<$DAY>`	日	读取当前日期。
`<$HOUR>`	时	读取当前小时。
`<$MINUTE>`	分	读取当前分钟。
`<$SECOND>`	秒	读取当前秒数。
`<$MILLISECONDS>`	毫秒	读取当前毫秒。
`<$DATE>`	日期	读取 `<$DATETIME>` 分离出来的日期部分。
`<$TIME>`	时间	读取 `<$DATETIME>` 分离出来的时间部分。

转生变量

标签	含义	说明
`H.` `<$RELEVEL>`	转生级别	读取当前人物转生级别；英雄版读取英雄转生级别。

配套检查命令见检查转生等级。

行会与城堡变量

标签	含义	说明
`<$GUILDNAME>`	行会名称	读取当前行会名称。
`<$RANKNAME>`	行会职位名称	读取当前角色在行会中的职位名称。
`<$GUILDHUMCOUNT>`	行会人数	读取当前行会人数。
`<$GUILDBUILDPOINT>`	行会建筑度	读取当前行会建筑度。
`<$GUILDAURAEPOINT>`	行会人气度	读取当前行会人气度。
`<$GUILDSTABILITYPOINT>`	行会安定度	读取当前行会安定度。
`<$GUILDFLOURISHPOINT>`	行会繁荣度	读取当前行会繁荣度。
`<$CASTLEGOLD>`	城堡金币数	读取城堡当前金币数。
`<$TODAYINCOME>`	每天的收入	读取城堡每日收入。
`<$CASTLEDOORSTATE>`	城门状态	读取当前城门状态。
`<$REPAIRDOORGOLD>`	修理城门的费用	读取修理城门所需费用。
`<$REPAIRWALLGOLD>`	修理皇宫城墙的费用	读取修理皇宫城墙所需费用。
`<$GUARDFEE>`	雇佣守卫费用	读取雇佣守卫所需费用。
`<$ARCHERFEE>`	雇佣弓箭手费用	读取雇佣弓箭手所需费用。
`<$GUARDRULE>`	守卫状态	读取守卫状态。
`<$OWNERGUILD>`	城堡所属行会	读取当前城堡所属行会。
`<$LORD>`	城堡所属行会的老大	读取当前城堡所属行会会长名称。
`<$CASTLENAME>`	城堡名称	读取城堡名称。
`<$GUILDWARFEE>`	申请行会战需要金币数	读取申请行会战所需金币。
`<$BUILDGUILDFEE>`	建立行会所需的金币数	读取建立行会所需金币。
`<$REQUESTCASTLELIST>`	攻城列表	读取当前攻城申请列表。
`<$REQUESTCASTLEWARITEM>`	攻城需要的物品	读取申请攻城所需物品。
`<$REQUESTCASTLEWARDAY>`	多少天后攻城	读取距离攻城还剩多少天。
`<$REQUESTBUILDGUILDITEM>`	允许建立行会的物品	读取建立行会所需物品。
`<$CASTLEWARDATE>`	攻城的日期	读取攻城日期。
`<$LISTOFWAR>`	攻城的时间表	读取攻城时间表。
`<$CASTLECHANGEDATE>`	占领日期	读取当前占领日期。
`<$CASTLEWARLASTDATE>`	最后一次攻城战的日期	读取最近一次攻城战日期。
`<$CASTLEGETDAYS>`	占领天数	读取当前占领持续天数。

商人与交易变量

变量	含义	说明
`<$PRICERATE>`	价格倍数	读取商人 NPC 的价格倍数。
`<$UPGRADEWEAPONFEE>`	升级武器的价格	读取升级武器所需价格。
`<$USERWEAPON>`	手上拿的武器的名称	读取手上拿的武器名称，供商人 NPC 使用。
`<$QUERYYBDEALLOG>`	元宝寄售交易记录	寄售人不在线、交易成功后，使用此变量回收已交易的元宝。

个人保存型变量

写法	含义	说明
`INTS 0 = 1`	写入个人保存型变量	按序号设置角色保存值。
`CHECKINTS 0 = 1`	检查个人保存型变量	判断指定槽位是否满足条件。
`<$INTS0>`	读取个人保存型变量	直接读取当前槽位值。
`<$H.INTS0>`	读取英雄个人保存型变量	直接读取英雄对应槽位值。
`<$STR(P/G/D/M/I/S/H)>`、`<$H.STR(P/G/D/M/I/S/H)>`	读取全局变量	英雄写法与人物写法一致；支持扣除操作，其中的全局变量不要频繁使用，否则会造成服务器卡顿。写法见变量操作。
`<$HUMAN(XX)>`、`<$H.HUMAN(XX)>`	读取自由变量	定义为内存操作时会自动保存，否则不自动保存；支持扣除操作，不要高频使用，否则有效率问题。
`<$GUILD(XX)>`	读取行会自定义变量	读取行会自定义变量的显示方式。
`<$GLOBAL(XX)>`	读取全局自定义变量	读取全局自定义变量的显示方式。

如果你要保存任务进度、累计次数、长期状态，优先看这组。

看完整说明： INTS

会员与自由加点变量

变量	含义	说明
`H.` `<$MEMBRETYPE>`	会员类型	读取当前人物会员类型；英雄版读取英雄会员类型。
`H.` `<$MEMBRELEVEL>`	会员等级	读取当前人物会员等级；英雄版读取英雄会员等级。
`<$BONUSPOINT>`	剩余自由点数	读取当前人物剩余的自由加点点数。

已加各项点数用 <$BONUSABIL_属性> 读取，把某项属性 +1 需要多少自由点用 <$BONUSTICK_属性> 读取，两者一一对应：

属性	变量	说明
防御（AC）	`<$BONUSABIL_AC>` / `<$BONUSTICK_AC>`	前者读取该属性上已经分配的自由点数，后者读取增加 1 点所需自由点数。
魔御（MAC）	`<$BONUSABIL_MAC>` / `<$BONUSTICK_MAC>`	同上。
攻击（DC）	`<$BONUSABIL_DC>` / `<$BONUSTICK_DC>`	同上。
魔法（MC）	`<$BONUSABIL_MC>` / `<$BONUSTICK_MC>`	同上。
道术（SC）	`<$BONUSABIL_SC>` / `<$BONUSTICK_SC>`	同上。
生命（HP）	`<$BONUSABIL_HP>` / `<$BONUSTICK_HP>`	同上。
魔法值（MP）	`<$BONUSABIL_MP>` / `<$BONUSTICK_MP>`	同上。
准确（HIT）	`<$BONUSABIL_HIT>` / `<$BONUSTICK_HIT>`	同上。
躲避（SPD）	`<$BONUSABIL_SPD>` / `<$BONUSTICK_SPD>`	同上。
双倍加点（X2）	`<$BONUSABIL_X2>` / `<$BONUSTICK_X2>`	读取双倍加点累计值；该项为未启用状态。

<$BONUSTICK_AC> 这类变量返回的是“需要多少自由点”，例如显示 X/17 表示需要 17 点自由点才能 +1 点 AC 值，AC 上下限会自动分配。

配套命令写法见自由加点命令 BonusAbil，会员等级的检查与调整见会员等级命令。

坐标记忆变量

标签	含义	说明
`<$TAGMAPNAME0~6>`	目标地图名	读取第 `0~6` 格记录的地图名。
`<$TAGX0~6>`	目标坐标 X	读取第 `0~6` 格记录的坐标 X。
`<$TAGY0~6>`	目标坐标 Y	读取第 `0~6` 格记录的坐标 Y。

记录与回传的完整写法见坐标记录脚本，命令见 TAGMAPINFO 与 TAGMAPMOVE。

天地结晶变量

标签	含义	说明
`<$GCEPAYMENT>`	天地结晶开启元宝	读取提取天地结晶经验所需支付的元宝数。
`<$COLLECTEXP>`	天地结晶当前经验	读取天地结晶中当前储存的经验。
`<$COLLECTIPEXP>`	天地结晶当前内功经验	读取天地结晶中当前储存的内功经验。
`<$GAINCOLLECTEXP>`	当前能提取的经验	读取本次可以提取的经验值。
`<$GAINCOLLECTIPEXP>`	当前能提取的内功经验	读取本次可以提取的内功经验值。

配套触发与收费写法见释放天地结晶触发，地图参数见天地结晶地图参数。

宝石等级变量

标签	含义	说明
`H.` `<$GEMSTONELEVEL>`	全身宝石等级	读取当前人物全身宝石等级合计；英雄版读取英雄的全身宝石等级。该值由 `Envir\SkillPowerOfGemLevel.txt`（全身宝石等级技能威力配置表）配套使用。

镶嵌界面入口见宝石镶嵌界面，回调见新增宝石镶嵌系统。

仓库客户端指令变量

标签	含义	说明
`<$CMD_STORAGESETPASSWORD>`	修改密码	写入 NPC 文本后生成可点击的指令入口，对应 `Command.ini` 中的同名配置项。
`<$CMD_STORAGECHGPASSWORD>`	设置密码	同上。
`<$CMD_STORAGELOCK>`	锁定仓库	同上。
`<$CMD_STORAGEUNLOCK>`	解锁仓库	同上。

用法示例（注意 @ 与变量之间的连接写法）：

修改密码：@<$CMD_STORAGESETPASSWORD>\
设置密码：@<$CMD_STORAGECHGPASSWORD>\
锁定仓库：@<$CMD_STORAGELOCK>\
解锁仓库：@<$CMD_STORAGEUNLOCK>\

ISLOCKPASSWORD、PASSWORDERRORCOUNT、CLEARPASSWORD 等配套命令见仓库锁定检查。

同组还有一批同类变量，都对应 Command.ini 里的同名配置项，写法与用法和上面完全一致：

变量	含义	说明
`<$CMD_DATE>`	对应 `Command.ini` 的 `DATE` 项	例：`DATE=服务器时间` 时，该变量显示为“服务器时间”。
`<$CMD_ALLOWMSG>`	对应 `Command.ini` 的 `ALLOWMSG` 项	显示该项配置的文本，下同。
`<$CMD_LETSHOUT>`	对应 `Command.ini` 的 `LETSHOUT` 项	同上。
`<$CMD_LETTRADE>`	对应 `Command.ini` 的 `LETTRADE` 项	同上。
`<$CMD_LETGUILD>`	对应 `Command.ini` 的 `LETGUILD` 项	同上。
`<$CMD_ENDGUILD>`	对应 `Command.ini` 的 `ENDGUILD` 项	同上。
`<$CMD_BANGUILDCHAT>`	对应 `Command.ini` 的 `BANGUILDCHAT` 项	同上。
`<$CMD_AUTHALLY>`	对应 `Command.ini` 的 `AUTHALLY` 项	同上。
`<$CMD_AUTH>`	对应 `Command.ini` 的 `AUTH` 项	同上。
`<$CMD_AUTHCANCEL>`	对应 `Command.ini` 的 `AUTHCANCEL` 项	同上。
`<$CMD_USERMOVE>`	对应 `Command.ini` 的 `USERMOVE` 项	同上。
`<$CMD_SEARCHING>`	对应 `Command.ini` 的 `SEARCHING` 项	同上。
`<$CMD_ALLOWGROUPCALL>`	对应 `Command.ini` 的 `ALLOWGROUPCALL` 项	同上。
`<$CMD_GROUPRECALLL>`	对应 `Command.ini` 的 `GROUPRECALLL` 项	同上。
`<$CMD_ATTACKMODE>`	对应 `Command.ini` 的 `ATTACKMODE` 项	同上。
`<$CMD_REST>`	对应 `Command.ini` 的 `REST` 项	同上。
`<$CMD_UNLOCK>`	对应 `Command.ini` 的 `UNLOCK` 项	同上。

攻击过滤掩码变量

标签	含义	说明
`<$ATTACKFILTERMASK>`	当前过滤掩码整值	读取当前对象的攻击过滤掩码整值。
`<$ATTACKFILTERMASK位>`	指定位的开关值	按位读取攻击过滤掩码的某一位；当前可见范围为 `8~31`，返回 `0` 或 `1`。

看配套命令：修改攻击过滤掩码

临时属性与附加属性

标签	含义	说明
`H.` `<$ABILITIES位置>`	临时属性当前值	读取 `SetAbility` 指定位置当前保存的数值。
`H.` `<$ABILTTL位置>`	临时属性剩余时间	读取 `SetAbility` 指定位置的剩余秒数。`0` 表示不存在，小于 `0` 表示暂停中的剩余时间，大于 `0` 表示运行中的剩余时间。
`H.` `T.` `<$ABILITYADDPOINT类别>`	附加点数	读取 `AbilityAdd` 在指定类别上的附加点数。当前可见范围为 `0~31`。
`H.` `T.` `<$ABILITYADDTIME类别>`	附加剩余时间	读取 `AbilityAdd` 在指定类别上的剩余时间，单位为秒。当前可见范围为 `0~31`。

ABILITIES 用来读数值，ABILTTL 用来读剩余时间。
持续秒数 = -1 进入暂停状态后，ABILTTL 会返回负数；恢复计时后会重新变回正数。
16~21 这组增加类类别依次为：16 增加攻击、17 增加魔法、18 增加道术、19 增加攻击速度、20 增加 HP、21 增加 MP；它们与对应食品附加属性存在冲突，读取结果前要先确认当前对象是否同时吃了同类食品。

看位置范围： SetAbility 位置表

看类别范围： AbilityAdd 类型表

动态取值相关入口

<$STR(...)>：看变量操作

<$JSON(...)>：看 JSON 专题

<ACD=ID>：看设置自身效果

<$LoopCursor>：NPC 循环执行时的当前循环游标变量，获取效率比自定义的游标变量稍高。