实现攻城结束5分钟后沙城主自动弹窗领奖励，点击后全服彩色提示，需依托服务端脚本文件、触发机制及命令组合，核心围绕攻城结束触发、延时执行、弹窗控制、全服广播四大模块，以下是分步骤详细实现流程，适配主流传奇服务端引擎。
一、前期准备与文件定位
首先明确服务端核心文件路径，所有脚本操作均在对应目录下完成，无需改动核心程序，仅通过配置脚本实现功能。
1. 核心目录：服务端根目录下\mir200\envir\，该目录存储所有脚本、NPC配置及触发规则文件，是功能实现的核心路径。
2. 关键文件：QFunction-0.lua（触发接口文件，用于绑定攻城结束事件）、NPC脚本文件（自定义沙城主奖励弹窗逻辑）、Merchant.txt（NPC配置文件，用于注册弹窗关联NPC）。
3. 前提条件：确认服务端支持攻城结束触发事件（castlewarend）、延时跳转命令（Delaygoto）及全服彩色广播命令（GuildNoticeMsg），主流引擎均默认支持此类基础命令。
二、攻城结束触发与延时机制实现
此步骤核心是绑定攻城结束事件，设置5分钟延时，确保攻城结束后不立即触发弹窗，而是等待指定时间再执行后续逻辑。
1. 绑定攻城结束事件：打开\mir200\envir\QFunction-0.lua文件，该文件用于定义各类事件触发接口，在文件末尾添加攻城结束触发逻辑，优先使用引擎原生接口确保稳定性。
脚本代码示例：
function castlewarend()
-- 攻城结束后执行延时跳转，300秒对应5分钟，绑定至自定义奖励段落
Delaygoto (Grobal) 300 @SandReward
end
说明：castlewarend为引擎原生攻城结束触发接口，无需额外定义；Delaygoto为延时跳转命令，Grobal参数表示全服生效，300为延时秒数，@SandReward为自定义奖励逻辑段落，需在后续NPC脚本中定义。
2. 保存并加载文件：修改完成后保存QFunction-0.lua，通过服务端控制台输入命令@reloadlua刷新脚本，使触发接口生效，无需重启服务端。
三、沙城主弹窗领取奖励脚本编写
通过自定义NPC脚本，实现沙城主身份校验、自动弹窗、奖励发放逻辑，同时绑定领取后全服彩色提示功能，需创建独立NPC脚本文件存储逻辑。
1. 创建NPC脚本文件
在\mir200\envir\npc_def\目录下新建文本文件，命名为“沙城主奖励-3.txt”（“3”为沙巴克地图编号，需与实际地图编号一致，避免弹窗异常），文件内编写核心逻辑脚本。
2. 核心脚本逻辑编写
脚本分为身份校验、弹窗提示、奖励发放、全服广播四个部分，采用条件判断语句确保仅沙城主可领取奖励，避免普通玩家触发。
完整脚本示例及说明：
(@SandReward)
#IF
-- 校验是否为沙巴克城主，双城主模式下自动适配两名角色
CheckCastleOwner
#ACT
-- 自动弹出领取对话框，换行符用\实现多行显示
#SAY 攻城奖励已发放至沙城主专属通道\
点击领取即可获取对应奖励，领取后全服公告\
<领取奖励/@GetReward>\<关闭/@exit>
#ELSEACT
-- 非沙城主角色不弹窗，无任何提示，避免干扰普通玩家
break
(@GetReward)
#IF
-- 二次校验城主身份，防止恶意调用接口领取
CheckCastleOwner
#ACT
-- 发放奖励，可根据需求替换为元宝、道具等，示例为发放元宝与道具
GiveGameGold 1888 -- 发放元宝，数值可自定义
Give 攻城专属勋章 1 -- 发放专属道具，道具名需与服务端数据库一致
-- 全服彩色广播，参数1为前景色，参数2为背景色，参数3为广播内容
GuildNoticeMsg 255 233 【沙城荣耀】恭喜<$USERNAME>领取沙城主奖励，彰显沙城霸主风采！
-- 领取后关闭对话框，避免重复领取
@exit
#ELSESAY
您非沙城主，无法领取此奖励！<关闭/@exit>
3. 脚本关键命令说明
（1）CheckCastleOwner：引擎原生命令，自动校验当前角色是否为沙巴克城主，双城主模式下可同时识别两名城主，无需额外配置。
（2）GuildNoticeMsg：全服彩色广播命令，参数1（255）为前景色（红色），参数2（233）为背景色（浅蓝），可根据需求调整颜色参数，省略第四参数默认全服可见；<$USERNAME>为变量，自动替换为领取奖励的城主名称。
（3）Give/GiveGameGold：奖励发放命令，Give用于发放道具，需确保道具名与服务端数据库完全一致；GiveGameGold用于发放元宝，数值直接填写具体数量。
四、NPC注册与脚本生效配置
新建的NPC脚本需在Merchant.txt中注册，确保服务端识别脚本关联的NPC，使弹窗逻辑正常触发，无需添加实体NPC模型，仅需后台注册即可。
1. 打开注册文件：定位至\mir200\envir\Merchant.txt，该文件用于注册交易型、任务型NPC，支持后台脚本关联，添加如下内容：
沙城主奖励 3 338 321 0 8 0 0 0 0 0
参数说明：依次为NPC名称（需与脚本文件名前缀一致）、地图编号（3为沙巴克地图编号）、坐标（沙巴克安全区坐标，可自定义）、范围（0为无范围限制）、外观代码（8为隐藏模型，不显示实体NPC）、后续参数均填0即可。
2. 刷新NPC配置：保存Merchant.txt后，通过服务端控制台输入命令@reloadnpc，刷新NPC列表，使注册的沙城主奖励NPC生效，此时脚本已完成全部配置。
五、测试与问题排查
配置完成后需进行实测，确保各环节正常运行，重点排查延时准确性、弹窗权限、奖励发放及广播效果。
1. 测试流程：发起攻城并结束攻城，等待5分钟后，使用沙城主账号登录，检查是否自动弹出领取对话框；点击领取后，确认背包内奖励是否到账，全服玩家是否看到彩色提示。
2. 常见问题排查：
（1）无弹窗：检查QFunction-0.lua中castlewarend接口是否正确编写，延时参数是否为300；确认Merchant.txt中NPC地图编号与沙巴克地图编号一致，输入@reloadlua和@reloadnpc重新加载。
（2）普通玩家可弹窗：检查脚本中CheckCastleOwner命令是否添加，二次校验环节是否缺失，确保仅沙城主满足条件触发弹窗。
（3）无彩色广播：核对GuildNoticeMsg命令参数是否正确，颜色参数需在引擎支持范围内，避免超出数值导致广播失效；检查服务端是否禁用全服广播命令。
（4）奖励重复领取：脚本中领取后通过@exit关闭对话框，且二次校验身份，可有效避免重复领取，若仍存在问题，可添加变量标记，领取后设置变量值，通过变量判断限制领取次数。
六、扩展优化方向
1. 奖励自定义：可在@GetReward段落中添加更多奖励命令，如发放专属称号、技能书、强化材料等，结合CheckLevel、CheckJob等命令，实现按职业、等级发放差异化奖励。
2. 颜色参数调整：GuildNoticeMsg命令支持多种颜色组合，如前景色252（黄色）、背景色0（黑色），可根据游戏整体风格调整广播颜色，增强视觉效果。
3. 领取时限设置：在@SandReward段落中添加延时关闭逻辑，使用Delaygoto命令设置10分钟领取时限，超时未领取则自动关闭弹窗，提示城主重新触发领取。
4. 奖励记录留存：添加日志命令，领取奖励后记录城主名称、领取时间、奖励内容至服务端日志文件，便于后台核对与管理。
综上，通过绑定攻城结束触发事件、设置延时逻辑、编写城主专属弹窗脚本及注册NPC，即可实现需求功能。整个流程无需改动服务端核心程序，仅通过脚本配置完成，适配多数主流传奇引擎，操作过程中需确保命令格式正确、参数准确，加载脚本后实测验证各环节效果，即可正常投入使用。
