传奇HERO引擎自动攻沙与NPC奖励脚本详解 附实操步骤

一、前期准备工作

1. 必备文件与工具

需准备完整HERO引擎传奇服务端（含Mirserver文件夹，推荐放置磁盘根目录，如D:\Mirserver，路径忌中文与特殊字符）、引擎控制器（服务端自带，如GameCenter.exe）、脚本编辑器（记事本、Notepad++均可，推荐后者便于查看语法）、元宝物品编号（通过服务端“物品数据库”查询，默认元宝编号多为1001，以自身服务端为准）。

提前备份服务端Mirserver\Mir200\Script文件夹（脚本核心存放目录），避免编写失误覆盖原有文件，导致服务端异常。

2. 基础参数确认

核对HERO引擎版本，确保脚本语法适配（不同版本HERO脚本指令略有差异，以自身引擎说明为准）；确认攻沙核心参数：沙巴克地图编号（默认3）、皇宫地图编号（默认350）、攻沙开启时长（常规设1小时，可按需调整）。

查询开区时间记录方式，HERO引擎默认通过“服务端启动时间”计算开区天数，无需额外配置时间插件，脚本将通过引擎自带时间变量判断攻沙场次。

二、自动攻沙脚本编写（核心步骤）

1. 攻沙时间触发脚本（控制开启时机）

第一步：新建触发脚本。打开服务端Mirserver\Mir200\Script文件夹，新建文本文件，重命名为“AutoAttackSand.txt”，双击打开后粘贴以下脚本（附详细注释，可直接复制使用）：

# 自动攻沙时间触发脚本（HERO引擎专属）
# 脚本功能：开区4天开启首次攻沙，后续每日固定时间开启
# 定义攻沙开启时间（默认每日20:00-21:00，可修改时、分参数）
#define AttackSand_Hour 20
#define AttackSand_Minute 0
#define AttackSand_Duration 60 # 攻沙持续时长（单位：分钟）

# 判断开区天数，触发首次攻沙
# $SERVEROPENDAY 为HERO引擎自带变量，代表开区天数
#if $SERVEROPENDAY = 4
#act
MapSetSandAttack 3 1 # 开启沙巴克（3为沙巴克地图编号，1为开启状态）
MapSetSandAttackTime 3 $AttackSand_Hour $AttackSand_Minute $AttackSand_Duration # 设置攻沙时长
SendMsg 0 255 0 0 【系统】开区4天首次攻沙开启！20:00-21:00占领皇宫即可夺冠！ # 全服公告
#endif

# 后续每日自动开启攻沙（开区4天后生效）
#if $SERVEROPENDAY > 4
#act
MapSetSandAttack 3 1
MapSetSandAttackTime 3 $AttackSand_Hour $AttackSand_Minute $AttackSand_Duration
SendMsg 0 255 0 0 【系统】每日攻沙开启！20:00-21:00占领皇宫即可领取奖励！ # 全服公告
#endif

# 攻沙结束自动关闭
#if $HOUR = 21 && $MINUTE = 0
#act
MapSetSandAttack 3 0 # 关闭沙巴克攻沙状态
SendMsg 0 255 0 0 【系统】今日攻沙结束！占领皇宫的行会可前往NPC处领取奖励！
#endif

第二步：关联触发脚本。打开Mirserver\Mir200\Script\QuestDiary.txt（引擎主触发文件），在文件末尾添加以下内容，让引擎加载自动攻沙脚本：

# 加载自动攻沙脚本
#include D:\Mirserver\Mir200\Script\AutoAttackSand.txt

保存文件后，关闭脚本编辑器，无需重启服务端，引擎将自动读取新增配置。

2. 攻沙胜负判断脚本（判定占领行会）

新建文本文件，重命名为“SandAttackWinner.txt”，粘贴以下脚本（核心判定皇宫内行会归属，附注释）：

# 攻沙胜负判断脚本
# 功能：攻沙结束后，判定皇宫内唯一行会为获胜方，记录行会ID
#define PalaceMap 350 # 皇宫地图编号（默认350，以自身服务端为准）

# 攻沙结束后执行判定（21:00触发）
#if $HOUR = 21 && $MINUTE = 0
#act
# 获取皇宫内所有行会ID，筛选唯一存在的行会（即占领方）
GetMapGuildList $PalaceMap GuildList
# 判断行会列表是否唯一，确认获胜方
if $GuildListCount = 1
then
SetVar SandWinnerGuild $GuildList1 # 记录获胜行会ID到变量
SendMsg 0 255 0 0 【系统】恭喜[$GuildList1]行会获得本次攻沙胜利！
else
SendMsg 0 255 0 0 【系统】本次攻沙无获胜行会，无奖励发放！
endif
#endif

同样在QuestDiary.txt末尾添加加载指令：#include D:\Mirserver\Mir200\Script\SandAttackWinner.txt，保存即可。

三、NPC奖励脚本编写（分场次设置奖励）

1. 奖励NPC脚本核心编写

新建文本文件，重命名为“SandRewardNPC.txt”，粘贴以下脚本（分首次攻沙10000元宝、后续3000元宝，附详细注释）：

# 攻沙奖励NPC脚本（HERO引擎）
# NPC名称：沙巴克奖励使者（可自定义）
# 奖励领取条件：获胜行会成员，每日限领1次
# 元宝物品编号：1001（需替换为自身服务端元宝编号）
#define YuanBaoID 1001
#define FirstReward 10000 # 首次攻沙奖励（10000元宝）
#define DailyReward 3000 # 后续每日攻沙奖励（3000元宝）

# NPC对话触发
#if [@Main]
#act
# 显示对话菜单
SendMsg $USERID 255 0 0 【沙巴克奖励使者】恭喜你！本次攻沙已结束！
SendMsg $USERID 255 0 0 1.领取攻沙奖励（获胜行会专属）
SendMsg $USERID 255 0 0 2.退出对话
SetMenu 1 2

# 玩家选择“领取攻沙奖励”
#if [@Menu1]
#act
# 判断玩家所在行会是否为获胜行会
if $USERGUILD != $SandWinnerGuild
then
SendMsg $USERID 255 0 0 【沙巴克奖励使者】你所在行会未获得本次攻沙胜利，无法领取！
goto @Main # 返回主对话
endif
# 判断是否已领取奖励（避免重复领取）
if $USERVAR(SandReward) = 1
then
SendMsg $USERID 255 0 0 【沙巴克奖励使者】你已领取本次攻沙奖励，明日可再次领取！
goto @Main
endif
# 判断是否为首次攻沙（开区4天），发放对应奖励
if $SERVEROPENDAY = 4
then
Give $YuanBaoID $FirstReward # 发放10000元宝
SendMsg $USERID 255 0 0 【沙巴克奖励使者】恭喜领取首次攻沙奖励10000元宝！
else
Give $YuanBaoID $DailyReward # 发放3000元宝
SendMsg $USERID 255 0 0 【沙巴克奖励使者】恭喜领取每日攻沙奖励3000元宝！
endif
# 标记已领取奖励（当日有效，次日自动重置）
SetUserVar SandReward 1
goto @Main

# 玩家选择“退出对话”
#if [@Menu2]
#act
SendMsg $USERID 255 0 0 【沙巴克奖励使者】感谢光临，下次攻沙再见！
CloseMenu # 关闭对话菜单

2. 奖励NPC加载与参数设置

第一步：加载奖励脚本。在QuestDiary.txt末尾添加加载指令：#include D:\Mirserver\Mir200\Script\SandRewardNPC.txt，保存文件。

第二步：设置NPC领取限制（可选）。若需限制奖励领取时间（如攻沙结束后24小时内领取），可在SandRewardNPC.txt中添加时间判断指令，示例如下（插入到[@Menu1]指令下）：

# 限制领取时间（攻沙结束后24小时内）
#if $HOUR < 21 && $SERVEROPENDAY = $LastAttackSandDay
#act
goto @RewardCheck # 进入奖励领取判定
#else
SendMsg $USERID 255 0 0 【沙巴克奖励使者】本次攻沙奖励领取已结束，请等待下次攻沙！
goto @Main
#endif

第三步：确认元宝编号。打开服务端“物品数据库”（通常为Mirserver\Mir200\Envir\Items.txt），搜索“元宝”关键词，找到对应“物品编号”，替换脚本中“YuanBaoID”后的数值，确保奖励正常发放。

四、脚本测试与故障排查

1. 脚本测试步骤

第一步：启动服务端，通过引擎控制器查看脚本加载状态（无报错提示即加载成功）；第二步：修改脚本中“$SERVEROPENDAY”变量为4，模拟首次攻沙场景，查看20:00是否触发攻沙公告；第三步：创建测试行会，占领皇宫后，21:00查看是否判定获胜行会；第四步：登录获胜行会账号，与奖励NPC对话，测试是否正常领取10000元宝；第五步：修改“$SERVEROPENDAY”为5，重复测试每日攻沙奖励（3000元宝）发放。

2. 常见故障排查

（1）自动攻沙未触发

核心原因：脚本路径错误或变量设置错误。解决方法：核对AutoAttackSand.txt路径与QuestDiary.txt中加载指令一致；确认“$SERVEROPENDAY”变量是否正常（可通过引擎控制台输入“查看变量 $SERVEROPENDAY”查询）；检查攻沙时间参数（Hour、Minute）是否正确。

（2）奖励无法领取

排查三点：一是元宝编号错误，重新核对物品数据库中的元宝编号；二是获胜行会ID记录失败，检查SandAttackWinner.txt中“GetMapGuildList”指令是否正确；三是玩家已领取奖励，通过引擎控制台输入“清除变量 $USERVAR(SandReward)”重置领取状态。

（3）脚本加载报错

原因：脚本语法错误（如缺失#、endif等指令）或引擎版本不适配。解决方法：逐行核对脚本语法，确保指令闭合；参考自身HERO引擎脚本手册，替换不兼容指令；若报错提示“变量未定义”，检查变量是否添加“$”前缀。

（4）攻沙结束无获胜判定

原因：皇宫地图编号错误或地图内存在多个行会成员。解决方法：核对皇宫地图编号（默认350），与服务端MapInfo.txt中一致；攻沙结束前确保皇宫内仅存在一个行会成员，避免判定失败。

五、脚本编写关键要点（避坑指南）

1. 脚本路径全程忌中文、空格，否则引擎无法加载，导致自动攻沙与奖励功能失效。

2. 编写脚本时，所有指令需区分大小写（HERO引擎脚本指令默认小写，变量需加$前缀），避免语法错误。

3. 首次攻沙与每日攻沙的奖励数值，可通过修改脚本中“FirstReward”“DailyReward”后的数值调整，无需改动其他指令。

4. 若服务端有多个沙巴克地图，需修改脚本中“MapSetSandAttack”后的地图编号，确保与自身服务端一致。

5. 定期备份脚本文件（AutoAttackSand.txt、SandAttackWinner.txt、SandRewardNPC.txt），避免服务端更新后丢失配置。

六、脚本拓展设置（可选）

1. 新增攻沙预热公告

在AutoAttackSand.txt中添加预热公告指令，示例如下（攻沙开启前30分钟触发）：

# 攻沙预热公告（开启前30分钟）
#if $SERVEROPENDAY >=4 && $HOUR = 19 && $MINUTE = 30
#act
SendMsg 0 255 0 0 【系统】温馨提示：今日攻沙将于20:00开启，占领皇宫即可领取丰厚元宝奖励！
#endif

2. 获胜行会额外福利设置

若需为获胜行会添加额外福利（如行会成员属性加成），可在SandAttackWinner.txt中添加以下指令：

# 获胜行会成员属性加成（持续24小时）
#if $GuildListCount = 1
#act
SetGuildBuff $GuildList1 1 10 # 行会成员攻击+10，持续24小时
SendMsg 0 255 0 0 【系统】[$GuildList1]行会获得攻沙胜利，全体成员攻击+10（持续24小时）！
#endif

按以上步骤编写脚本，即可实现HERO引擎自动攻沙与NPC奖励功能，全程聚焦实操，脚本可直接复制使用，只需核对少量参数（元宝编号、地图编号）即可适配自身服务端。新手可按流程逐步操作，重点核对脚本加载指令与变量设置，确保功能正常生效。