一、核心前提：称号素材加载与基础配置
设置属性称号及头顶显示前，需先完成称号素材加载与基础参数配置，确保引擎能识别称号资源。核心操作集中在M2引擎控制器与服务端配置文件，无需复杂工具。
1. 称号素材加载步骤
第一步：准备称号素材，将称号对应的WIL格式素材文件（如ui1.wzl）放入客户端Data文件夹，素材需包含5个关联图片（1张外观显示图、2张界面显示图、2张激活显示图），可参考标准素材排列规则（690~739序号区间为默认称号素材位）。
第二步：在M2引擎中配置素材读取，启动M2Server.exe，点击顶部“选项”→“功能设置”→“其他控制”，找到“称号素材读取设置”，选择已放入的WIL文件序号，点击“保存设置”，确保素材被引擎识别。
2. 称号基础信息配置（物品数据库操作）
第一步：打开DBC2000数据库工具，进入HeroDB数据库的“物品”数据表，新增称号条目，核心字段配置如下：
- Name：填写称号名称（如“巅峰战神”“传世尊者”），将作为头顶显示与属性绑定的核心标识；
- Shape：设置称号唯一编号（如1001、1002），用于脚本触发与切换识别，需保持连续性；
- Color：设置称号颜色（0~255区间数值，如255为红色、66为绿色），控制头顶显示颜色；
- Reserved：控制是否显示称号名称，填写1时不显示数据库中的名称（仅显示素材自带名称），填写0时显示上述Name字段内容；
- Anicount：属性生效开关，大于0时无需激活称号即可叠加属性，等于0时仅激活为当前称号后才生效属性；
- Looks：填写称号素材在WIL文件中的开始位置序号（如690），确保素材正常显示；
- DuraMax：设置称号使用时长（单位：小时），填写0时为永久称号，无需续费。
第二步：补充属性字段（如攻击力、防御力等），在数据表对应属性列填写数值（如攻击力+50、生命值+1000），完成属性与称号的绑定，保存数据库配置。
二、属性称号生效设置：激活机制与脚本配置
属性称号需通过脚本设置获取条件，玩家满足条件后获得称号，属性自动叠加（或激活后叠加），核心脚本为NPC对话脚本与触发脚本。
1. 称号获取脚本配置（NPC触发示例）
第一步：进入服务端Mirserver\Mir200\Envir\NpcScript文件夹，打开目标NPC脚本文件（如“新手引导员.txt”），添加称号授予脚本：
(@main)
#IF
CHECKLEVEL > 50 // 设置获取条件（此处为等级大于50级）
NOT CHECKTITLE 巅峰战神 // 检查玩家是否未拥有该称号
#ACT
CONFERTITLE 巅峰战神 // 授予玩家“巅峰战神”称号
SENDMSG 6 恭喜获得属性称号【巅峰战神】，属性已自动生效！
#ELSEACT
SENDMSG 6 您已拥有该称号，或未满足获取条件！
第二步：保存脚本文件，重启M2引擎，NPC对话触发条件后即可完成称号授予与属性生效。若需删除称号，可使用脚本命令“DEPRIVETITLE 巅峰战神”（删除指定称号）或“DEPRIVETITLE ALL”（删除所有称号）。
2. 属性生效机制补充说明
- Anicount>0时：玩家获得称号后，属性直接叠加，无需额外操作；
- Anicount=0时：玩家获得称号后需激活为当前称号才生效属性，激活操作通过后续切换功能实现；
- 属性刷新：称号属性在玩家登录时自动加载，修改称号属性后需让玩家小退重新登录，确保属性同步更新。
三、头顶称号显示设置：SetIcon命令与位置调整
头顶称号通过SetIcon脚本命令实现显示，可控制显示位置、特效、可见范围，支持多称号叠加显示，核心是配置正确的脚本参数。
1. SetIcon命令格式与参数说明
命令格式：SetIcon 位置(0-9) WIL文件序号 图片序号 X Y 播放张数 播放效果 播放速度 是否仅自己可见
参数详解：
- 位置(0-9)：控制称号在头顶的显示层级，0为最底层，9为最顶层，支持10个称号同时显示；
- WIL文件序号：填写已加载的称号素材WIL文件序号（与M2素材配置一致）；
- 图片序号：称号素材在WIL文件中的具体序号（如690）；
- X/Y：控制称号在头顶的偏移位置（单位：像素），X为空默认0，Y为空默认0，常用配置为30 -30（横向偏移30、纵向向上偏移30，避免遮挡角色）；
- 播放张数：素材动画播放的图片数量，为空默认1（静态显示）；
- 播放效果：0为普通显示，1为特效显示；
- 播放速度：动画播放间隔（毫秒），为空默认300毫秒；
- 是否仅自己可见：0为所有人可见，1为仅自己可见。
2. 头顶称号显示脚本配置
第一步：进入服务端Mirserver\Mir200\Envir\MapQuest_def文件夹，打开QFunction-0.txt（全局触发脚本），添加登录触发脚本，确保玩家登录后自动显示已激活称号：
(@Login)
#IF
CHECKTITLE 巅峰战神 // 检查玩家拥有该称号
#ACT
SETICON 0 3 690 30 -30 1 0 300 0 // 显示“巅峰战神”头顶称号，所有人可见
#IF
CHECKTITLE 传世尊者
#ACT
SETICON 1 3 695 -30 -30 1 1 300 0 // 叠加显示第二个称号，带特效
第二步：若需隐藏称号，添加清除脚本：
(@隐藏称号)
#ACT
SETICON 0 -1 // 清除位置0的称号
SETICON 1 -1 // 清除位置1的称号
SENDMSG 6 头顶称号已隐藏！
第三步：保存脚本后，重启M2引擎，玩家登录或触发对应命令即可显示/隐藏头顶称号。
四、核心功能：头顶称号自由切换实现（两种方案）
自由切换功能核心是通过脚本控制不同称号的显示/隐藏与属性激活，推荐两种方案：NPC对话切换（适合新手）、命令触发切换（适合高效操作）。
方案一：NPC对话式自由切换（可视化操作）
第一步：在NPC脚本文件中添加切换菜单脚本，示例如下：
(@main)
#ACT
SENDMSG 6 请选择要显示的头顶称号：
SENDMSG 6 1. 巅峰战神 2. 传世尊者 3. 隐藏所有称号
#SAY
1.巅峰战神→@选择巅峰战神
2.传世尊者→@选择传世尊者
3.隐藏所有称号→@隐藏所有
第二步：添加对应选择分支脚本：
(@选择巅峰战神)
#IF
CHECKTITLE 巅峰战神 // 验证玩家是否拥有该称号
#ACT
SETICON 0 3 690 30 -30 1 0 300 0 // 显示巅峰战神称号
SETICON 1 -1 // 隐藏传世尊者称号
TITLECHANGED_1001 // 触发属性激活（1001为巅峰战神的Shape编号）
SENDMSG 6 已切换头顶称号为【巅峰战神】，属性已激活！
#ELSEACT
SENDMSG 6 您未拥有该称号，无法切换！
(@选择传世尊者)
#IF
CHECKTITLE 传世尊者
#ACT
SETICON 0 -1 // 隐藏巅峰战神称号
SETICON 1 3 695 -30 -30 1 1 300 0 // 显示传世尊者称号
TITLECHANGED_1002 // 触发属性激活（1002为传世尊者的Shape编号）
SENDMSG 6 已切换头顶称号为【传世尊者】，属性已激活！
#ELSEACT
SENDMSG 6 您未拥有该称号，无法切换！
(@隐藏所有)
#ACT
SETICON 0 -1
SETICON 1 -1
UNTITLED_1001 // 取消巅峰战神属性激活
UNTITLED_1002 // 取消传世尊者属性激活
SENDMSG 6 已隐藏所有头顶称号，属性已取消！
方案二：命令触发式自由切换（快捷操作）
第一步：在QFunction-0.txt中添加命令触发脚本，支持玩家通过聊天框输入命令切换：
(@Title1) // 切换巅峰战神命令
#IF
CHECKTITLE 巅峰战神
#ACT
SETICON 0 3 690 30 -30 1 0 300 0
SETICON 1 -1
TITLECHANGED_1001
SENDMSG 6 已切换至【巅峰战神】称号！
#ELSEACT
SENDMSG 6 未拥有该称号！
(@Title2) // 切换传世尊者命令
#IF
CHECKTITLE 传世尊者
#ACT
SETICON 0 -1
SETICON 1 3 695 -30 -30 1 1 300 0
TITLECHANGED_1002
SENDMSG 6 已切换至【传世尊者】称号！
#ELSEACT
SENDMSG 6 未拥有该称号！
(@TitleHide) // 隐藏称号命令
#ACT
SETICON 0 -1
SETICON 1 -1
UNTITLED_1001
UNTITLED_1002
SENDMSG 6 已隐藏所有称号！
第二步：在M2引擎中注册命令，点击“选项”→“游戏命令”→“管理命令”，新增三条命令：
- 命令名称：Title1，格式：@Title1，功能描述：切换巅峰战神称号；
- 命令名称：Title2，格式：@Title2，功能描述：切换传世尊者称号；
- 命令名称：TitleHide，格式：@TitleHide，功能描述：隐藏所有称号；
保存命令配置后，玩家在游戏聊天框输入对应@命令即可完成切换。
五、常见问题排查：称号不显示/属性不生效/切换失败
1. 称号不显示问题
现象：玩家拥有称号但头顶无显示。解决步骤：
- 检查素材加载：确认WIL文件序号与M2配置一致，素材序号未填错；
- 核对SetIcon参数：X/Y偏移值是否合理（建议用30 -30测试），WIL文件序号是否与素材匹配；
- 刷新脚本：重新保存QFunction-0.txt，重启M2引擎，让玩家小退重新登录。
2. 称号属性不生效问题
现象：切换称号后属性未叠加。解决步骤：
- 检查Anicount字段：若设为0，需确认已触发TITLECHANGED_XX脚本（XX为Shape编号）；
- 核对数据库属性：确保物品数据表中属性字段已填写数值，无空白或错误；
- 重新激活称号：让玩家先隐藏称号再重新切换，触发属性加载。
3. 称号切换失败问题
现象：输入命令或对话NPC无切换反应。解决步骤：
- 检查脚本语法：确认#IF、#ACT、#SAY等关键字无拼写错误，称号名称与数据库一致；
- 验证命令注册：在M2引擎命令管理中检查命令是否正确注册，格式是否带@；
- 检查称号权限：确认玩家已拥有对应称号，可通过CHECKTITLE命令在脚本中二次验证。
六、关键注意事项：避免配置失误
1. 素材一致性：客户端与服务端需使用相同的称号素材文件，否则会出现显示错乱；
2. 序号唯一性：称号Shape编号需唯一，不可与其他物品重复，避免触发错误脚本；
3. 脚本备份：修改NPC脚本或QFunction-0.txt前，备份原始文件，便于操作失误后回滚；
4. 数量限制：单个玩家最多支持30个称号，头顶同时显示最多10个（0-9位置），避免过多称号导致显示重叠。
