一、核心前提：素材准备与引擎适配
1. 必备素材与工具
核心素材：红黄蓝三色钻石图标素材（动态/静态均可，建议PNG格式，尺寸24*24像素适配头顶显示），需提前整理为WIL格式文件（传奇脚本通用素材格式）。工具：WIL编辑器（用于导入素材至补丁）、服务端配套引擎（GOM/GEE/Blue均可，主流为GOM引擎，脚本语法通用）、文本编辑器（记事本/Notepad++）、引擎主控程序（M2主程序）。
素材处理：用WIL编辑器将三色钻石图标导入服务端补丁包（如Data文件夹下的UI.pak），记录每张图标对应的WIL文件序号、图片序号（从零开始计数），后续脚本需精准调用这些参数，避免显示异常。
2. 引擎适配说明
头顶钻效果依赖引擎“顶戴花翎”功能，核心命令为SETICON，该命令在GOM、GEE、Blue引擎中均支持，仅参数格式略有差异，新手优先选用GOM引擎，兼容性最强，脚本无需过多调整。启动M2主程序，进入“查看-列表信息（二）-WIL资源”，确认导入的钻石素材所在WIL文件序号已正确加载，无报错提示。
二、红黄蓝钻脚本核心编写（分场景示例）
脚本核心逻辑：通过SETICON命令设置头顶图标，按“位置-文件序号-图片序号-坐标-播放参数-可见性”配置，不同颜色钻石占用不同位置（0-9可选，同一位置仅显示一个图标），支持触发条件（物品、等级、指令）灵活设置。
1. 指令触发型（输入命令激活，新手首选）
适用场景：玩家输入指定命令后激活对应颜色钻石，关闭命令可取消，操作简单易测试。脚本文件路径：服务端\Mir200\Envir\QuestDiary\通用脚本\QFunction-0.txt（全局生效）。
脚本代码（三色分别配置）：
// 激活头顶黄钻（位置0，WIL序号10，图片序号0，静态显示）
(@YellowDiamond)
#ACT
SETICON 0 10 0 0 -30 1 0 300 0
#SAY
头顶黄钻已激活，所有人可见。
// 取消头顶黄钻
(@CancelYellow)
#ACT
SETICON 0 -1
#SAY
头顶黄钻已取消。
// 激活头顶红钻（位置1，WIL序号10，图片序号1）
(@RedDiamond)
#ACT
SETICON 1 10 1 0 -30 1 0 300 0
#SAY
头顶红钻已激活，所有人可见。
// 取消头顶红钻
(@CancelRed)
#ACT
SETICON 1 -1
#SAY
头顶红钻已取消。
// 激活头顶蓝钻（位置2，WIL序号10，图片序号2）
(@BlueDiamond)
#ACT
SETICON 2 10 2 0 -30 1 0 300 0
#SAY
头顶蓝钻已激活，所有人可见。
// 取消头顶蓝钻
(@CancelBlue)
#ACT
SETICON 2 -1
#SAY
头顶蓝钻已取消。
参数说明：SETICON后依次为位置（0-9，不重复）、WIL文件序号、图片序号、X坐标（左右微调）、Y坐标（上下微调，-30为头顶合适位置）、播放张数（1为静态）、播放效果（0普通）、播放速度（300毫秒，静态可忽略）、可见性（0所有人可见）。
2. 物品触发型（持有指定物品激活）
适用场景：玩家持有对应道具（如黄钻徽章、红钻令牌）时自动激活，丢弃道具取消，增强玩法关联性。脚本路径同上，新增代码如下：
// 持有黄钻徽章激活黄钻
(@CheckYellow)
#IF
CheckItem 黄钻徽章 1
#ACT
SETICON 0 10 0 0 -30 1 0 300 0
#SAY
检测到黄钻徽章，已激活头顶黄钻。
#ELSESAY
未持有黄钻徽章，无法激活黄钻。
// 丢弃道具取消黄钻（需搭配登录脚本）
(@Login)
#IF
CheckItem 黄钻徽章 0
#ACT
SETICON 0 -1
红钻、蓝钻物品触发脚本可按此格式复制，替换物品名称、位置、图片序号即可。
3. 登录自动激活型（指定角色/等级激活）
适用场景：特定等级、职业或GM账号登录后自动激活，用于身份标识。脚本路径：服务端\Mir200\Envir\QuestDiary\登录脚本\Login.txt，代码如下：
// GM账号登录自动激活三色钻
#IF
ISADMIN
#ACT
SETICON 0 10 0 0 -30 1 0 300 0
SETICON 1 10 1 0 -30 1 0 300 0
SETICON 2 10 2 0 -30 1 0 300 0
#SAY
GM账号登录，已激活头顶三色钻。
// 等级达到80级激活黄钻
#IF
LEVEL > 79
#ACT
SETICON 0 10 0 0 -30 1 0 300 0
三、脚本部署与调试步骤
1. 脚本部署流程
第一步：将编写好的脚本复制到对应路径文件（QFunction-0.txt/Login.txt），保存文件时选择ANSI编码，避免中文乱码导致脚本失效。第二步：启动M2主程序，点击“脚本-重新加载所有脚本”，加载完成无报错即部署成功；若提示语法错误，核对代码格式（如#IF、#ACT是否大写，参数是否完整）。第三步：将导入钻石素材的补丁包复制到客户端根目录，覆盖原有文件，确保客户端与服务端素材一致。
2. 常见问题调试
问题1：头顶无显示。排查方向：WIL文件序号、图片序号是否填写正确，可在M2主程序WIL资源中重新核对；坐标是否合适，Y坐标可调整为-25至-35之间，避免超出显示范围；脚本是否重新加载，素材补丁是否正确覆盖客户端。
问题2：图标显示偏移/模糊。调试方法：X坐标（左右）、Y坐标（上下）微调，数值增加向右/向下移动，减少向左/向上移动；模糊则更换高清素材，确保尺寸适配，播放张数与素材数量一致。
问题3：取消命令无效。解决方案：取消脚本中SETICON后参数需填写对应位置+(-1)，确保位置与激活时一致；若自动激活脚本无效，核对触发条件（如等级、物品是否满足），登录脚本需重新登录游戏生效。
四、实操注意要点
1. 位置规划：红黄蓝钻需占用不同位置（0、1、2），避免同一位置覆盖，预留3-9位置供其他头顶效果使用，后续新增效果无需修改现有脚本。
2. 备份原则：修改脚本前备份原文件，若脚本出错可快速恢复，避免影响服务端整体运行；素材导入后也需备份WIL文件，防止误删。
3. 动态效果设置：若使用动态钻石素材，需将播放张数改为素材总张数（如8张动态图填8），播放速度调整为200-500毫秒，播放效果设为0或1（出现黑边改1，异常改0）。
4. 权限控制：非GM专属效果需添加权限判断，避免玩家随意激活，可在#IF下添加ISADMIN（GM）、ISGUILDMASTER（行会会长）等条件，精准控制激活权限。
五、拓展玩法建议
1. 钻效果关联属性：在激活脚本#ACT中添加属性加成命令（如GiveExp 10000，AddMaxLife 200），让头顶钻不仅有外观效果，还能提升角色实力，增强玩法吸引力。
2. 时效型钻效果：搭配变量设置时效，如激活后持续24小时自动取消，需添加时间判断脚本，通过变量记录激活时间，登录时检测是否过期。
3. 组合显示效果：不同颜色钻可组合显示（如同时激活三色），调整坐标让图标呈横向排列，打造专属身份标识，适配GM、VIP等不同角色定位。
