2025.12.08 [刚子新三端]TXT基础课程,常量

羽翼

脚本常量与系统变量应用教程

课程链接

一、课程核心要点

本课程重点讲解996引擎中的三大类系统常量：脚本常量、装备常量和触发类常量，这些是引擎官方封装好的可直接调用的数据接口。

二、常量分类详解

1. 脚本常量（系统常量）

位于帮助文档“脚本常量”章节，封装了游戏基础数据：

常用常量示例：

• NAME：当前角色名称
• USERNAME：登录账号（新/老三端返回值不同）
• USERID：角色唯一ID
• RUNTIME：服务器运行天数（本地测试显示46000+，正式服为实际天数）
• IPADDRESS：IP地址
• CLIENTTYPE：客户端载体类型（判断PC/手机端）
• JOB：职业（0战士/1法师/2道士）
• GENDER：性别（0/1表示）
• DAMAGE：最近一次伤害值（需在攻击触发中使用）
• ATTACKTARGETX/Y：当前攻击目标坐标
• ATTACKTARGETHITPOINTS：目标总血量
• BACKPACKEMPTYCELLCOUNT：背包空格数量
• LOGINTIME：本次登录时间
• ONLINELONGTIME：本次在线时长
• MAPNAME：当前地图名
• MAPID：当前地图ID
• X/Y：当前坐标

属性值常量（重点掌握）：

• ATTR：通用属性值常量
• 配合属性ID使用，无需记忆具体属性常量名
• 示例：ATTR(1)获取生命值，ATTR(3)获取攻击下限，ATTR(4)获取攻击上限

2. 装备常量

通过 ITEMNAME(位置)格式调用，位置编号参考装备栏：

• 0：衣服
• 1：武器
• 2：勋章
• 3：项链
• 4：头盔
• 等...

应用场景： 装备强化、属性检测等脚本

3. 触发类常量

在不同触发字段下返回不同值，需注意上下文：

常用触发字段示例：

• 攻击触发：获取伤害值、目标信息
• 穿戴触发：ITEMNAME、ITEMIDX、装备位置
• 拾取触发：物品名称、唯一ID
• 双击触发：使用物品的IDX和数量
• 死亡触发：掉落物品信息

三、新旧三端差异提醒

• USERNAME常量：新三端返回注册账号，老三端返回账号唯一ID
• 职业/性别表示方式可能不同（数字vs中文）
• 使用时需注意版本兼容性

四、常量使用技巧

1. 查询方法

• 帮助文档搜索“常量”
• 实战中通过 SENDMSG打印测试返回值
• 注意常量在不同触发环境下的不同含义

2. 实用场景

• 背包检测：回收功能前检查 BACKPACKEMPTYCELLCOUNT
• 设备适配：通过 CLIENTTYPE区分PC/手机界面
• 时间控制：利用 GAMEDAY等做开服活动
• 属性获取：统一使用 ATTR函数避免记忆大量常量名

3. 注意事项

• 触发类常量只在对应触发字段内有效
• 装备改名时需使用 ITEMNAMEEX常量
• 群体技能攻击时区分主目标/当前目标常量
• 重要数据（如在线时长统计）需结合变量记录

五、教学建议

1. 掌握核心：重点记忆 ATTR、NAME、ITEMNAME、MAPNAME等高频率常量
2. 理解原理：明确常量是引擎封装的数据接口
3. 实战为主：多写多测试，自然掌握常用常量
4. 学会查阅：不要求背诵，但要知道如何快速查找所需常量

通过本课学习，学员应能熟练调用引擎常量优化脚本编写，提高开发效率。课后建议针对不同触发字段测试常量返回值，加深理解。