传奇服务端中，竞技类活动的领奖NPC脚本是活动闭环的关键环节。玩家完成竞技挑战后，需要通过NPC领仍应奖励，而脚本需要精确处理条件判断、变量读取、奖励发放和防重复领取等逻辑。以下基于GOM引擎的脚本语法，提供几种典型竞技领奖场景的完整实现方案。
##基于杀怪数量的竞技领奖脚本
这类脚本适用于竞技场杀怪竞赛模式。核心逻辑是通过个人变量记录玩家在竞技地图中的杀怪数量，根据数量阈值发放不同档次的随机奖励。脚本中使用了`CHECKVARHUMAN`读取个人变量`竞技杀怪`，通过`CheckMonMap`判断竞技地图中的怪物是否全部清理完毕。
```plaintext
[@main]
等待怪物全部杀完之后方可领取奖励...\
您当前杀死怪物总数为：<$HUMAN(竞技杀怪)>只\
杀死100只怪物随机奖励：龙神装备<领取/@领1>\
杀死70只怪物随机奖励：传说装备<领取/@领2>\
杀死40只怪物随机奖励：皓月装备<领取/@领3>\
杀死20只怪物随机奖励：雁翎装备<领取/@领4>\
[@领1]
#IF
CheckMonMapHH0010
#ACT
MESSAGEBOX怪物还没有清理完毕无法领取奖励.
CLOSE
BREAK
#IF
CHECKVARHUMAN竞技杀怪<100
#ACT
MESSAGEBOX你没有杀死100只怪物无法领取奖励.
CLOSE
BREAK
#ELSEACT
GetRandomName..\QuestDiary\游戏服务\龙神装备.txtS99
GIVE<$STR(S99)>1
CALCVARHUMAN竞技杀怪=0
SAVEVARHUMAN竞技杀怪..\QuestDiary\宠物系统\竞技杀怪Save.txt
SENDMSG0〖竞技广场〗勇士[%s]获得杀怪奖励：<$STR(S99)>
MAPMOVE3333333
```
上述脚本中，`CheckMonMapHH0010`用于检测竞技地图HH001中是否还有存活的怪物，参数0表示不区分怪物类型。当检测结果为真时，弹出提示并阻止领取。`GetRandomName`命令从外部文本文件中随机抽取一个装备名称存入字符变量S99，然后通过`GIVE`命令发放给玩家。领取完成后将`竞技杀怪`变量清零并保存，防止重复领取。
不同档位的领奖标签结构完全一致，只需修改对应的装备文件路径和杀怪数量阈值。这种结构便于扩展，如需增加更多档位，复制标签并修改参数即可。
##排名制竞技领奖脚本
排名制竞技活动的领奖逻辑更为复杂，需要判断玩家是否为最后存活者。群英争霸类脚本通过`CHECKMAPHUMANCOUNT`统计指定地图中的玩家数量，当地图内只剩一名玩家时方可领奖。
```plaintext
[@main]
只有剩下最后一名成员才可以获得奖励\
有一名以上玩家将不可以得到奖励\
领取奖励将在比赛结束后，45分到50分内领取!\
过了这段时间或者还没有将敌人杀光将不能领取\
不在规定时间内将不能领取!\
<我要领取奖励/@我要领取>\
<返回盟重/@mengzhong>\
[@我要领取]
#IF
CHECKMAPHUMANCOUNTqunying=1
#ACT
SENDMSG0群英争霸大赛正在进行中，请参加比赛的玩家赶快进入，奖励非常好！
goto@lingqu
#ELSESAY
难道地图里只有你一个人吗？？？\
[@lingqu]
#IF
hour1919
min4550
#act
goto@lingqu2
break
#IF
hour2121
min4550
#act
goto@lingqu2
break
#ELSESAY
领取时间还没到或者超过了领取时间.不能领取奖励！\
[@lingqu2]
#IF
checknamelist..\QuestDiary\重要数据\群英争霸领奖名单.txt
#act
goto@guanya
mapmovet225
#ELSEACT
give5000元宝1
give霸者印记1
give挑战证明书1
SENDMSG0恭喜玩家〖%s〗成为群英争霸大赛冠军，获得许多好东东！！！
addnamelist..\QuestDiary\重要数据\群英争霸领奖名单.txt
mapmove3330330
```
时间限制部分使用了多个`#IF`段落叠加时间条件，每个时段判断独立执行。`hour`和`min`命令分别获取当前的小时和分钟数，配合范围参数实现时间段校验。领奖名单通过`checknamelist`和`addnamelist`命令读写外部文本文件，已领取奖励的玩家会被记录在案，再次尝试领取时将跳转到`@guanya`标签，提示已被查处并关押。
##全服挑战类竞技领奖脚本
全服挑战模式采用全局变量控制活动状态，使用G133变量记录活动冷却倒计时。领奖条件包括：活动冷却时间少于19分钟、地图内仅剩一名玩家、且玩家处于NPC可交互范围内。
```plaintext
[@main]
#IF
smallG13319
CheckMapHumanCounttzqf=1
CheckInMapRangetzqf33351
#say
快来领取你的奖励！\
<领取奖励/@领奖>\
#elseact
MESSAGEBOX年轻人走进点来！你离我太远了或者当前地图不只你一个人吧
[@领奖]
#ACT
muln2g13480000
gamegold+<$STR(n2)>
movg1340
mapmove3333333
SendCenterMsg180251全服挑战获胜者为「<$USERNAME>」获得<$STR(n2)>元宝.130
```
奖励金额由进入挑战地图的玩家总数乘以固定金额计算得出。变量G134记录参与人数，通过`mul`命令将G134乘以80000存入数字变量n2，再用`gamegold`命令发放等额元宝。`CheckInMapRange`用于检测玩家与NPC的距离，防止远程领取。
##脚本编写中的关键变量与命令
竞技领奖脚本的编写需要掌握几个核心概念。个人变量方面，`CHECKVARHUMAN`用于读取玩家个人变量，`CALCVARHUMAN`用于修改变量值，`SAVEVARHUMAN`将变量持久化保存到文件。全局变量如G133、G134用于控制活动状态和记录参与数据，这类变量对所有玩家共享。
常用命令速查：
|命令|用途|
|------|------|
|CheckMonMap|检测地图内是否还有怪物|
|CheckMapHumanCount|统计地图内玩家数量|
|GetRandomName|从文本文件随机抽取名称|
|GIVE|发放物品给玩家|
|GAMEGOLD|增加玩家元宝|
|SENDMSG|发送全服公告|
|addnamelist/checknamelist|读写领奖名单，防重复|
|MOV/CALCVAR|变量赋值与运算|
##防重复领取机制设计
防止重复领取是领奖NPC脚本必须处理的问题。常见方案有三种。第一种是名单记录法，使用`addnamelist`将已领取玩家的名字写入文本文件，下次领取时通过`checknamelist`检查，如在名单中则拒绝发放。第二种是变量清零法，领取后将个人变量归零，再次领取时条件判断失败。第三种是全局冷却法，通过全局变量记录活动状态，在冷却期内NPC不提供领奖选项。
实际开发中建议将名单记录法与变量清零法结合使用，名单记录防止同账号多角色重复领取，变量清零防止同一角色反复领取。
##脚本调试注意事项
在编写和调试竞技领奖脚本时，需要关注几个常见问题。地图编号必须与实际服务端中的地图文件对应，`CheckMonMap`和`CheckMapHumanCount`命令中的地图编号错误会导致检测失效。变量保存路径需要提前创建对应目录，否则`SAVEVAR`命令执行失败会导致变量丢失。时间判断段的顺序需要注意，引擎按从上到下的顺序执行条件判断，一旦某个条件满足就会执行对应的ACT段并跳过后续判断，因此时间段的排列顺序会影响最终的执行结果。装备文件中的物品名称必须与服务端数据库中的物品名完全一致，包括标点符号和空格，否则`GIVE`命令会提示物品不存在。
##基于杀怪数量的竞技领奖脚本
这类脚本适用于竞技场杀怪竞赛模式。核心逻辑是通过个人变量记录玩家在竞技地图中的杀怪数量，根据数量阈值发放不同档次的随机奖励。脚本中使用了`CHECKVARHUMAN`读取个人变量`竞技杀怪`，通过`CheckMonMap`判断竞技地图中的怪物是否全部清理完毕。
```plaintext
[@main]
等待怪物全部杀完之后方可领取奖励...\
您当前杀死怪物总数为：<$HUMAN(竞技杀怪)>只\
杀死100只怪物随机奖励：龙神装备<领取/@领1>\
杀死70只怪物随机奖励：传说装备<领取/@领2>\
杀死40只怪物随机奖励：皓月装备<领取/@领3>\
杀死20只怪物随机奖励：雁翎装备<领取/@领4>\
[@领1]
#IF
CheckMonMapHH0010
#ACT
MESSAGEBOX怪物还没有清理完毕无法领取奖励.
CLOSE
BREAK
#IF
CHECKVARHUMAN竞技杀怪<100
#ACT
MESSAGEBOX你没有杀死100只怪物无法领取奖励.
CLOSE
BREAK
#ELSEACT
GetRandomName..\QuestDiary\游戏服务\龙神装备.txtS99
GIVE<$STR(S99)>1
CALCVARHUMAN竞技杀怪=0
SAVEVARHUMAN竞技杀怪..\QuestDiary\宠物系统\竞技杀怪Save.txt
SENDMSG0〖竞技广场〗勇士[%s]获得杀怪奖励：<$STR(S99)>
MAPMOVE3333333
```
上述脚本中，`CheckMonMapHH0010`用于检测竞技地图HH001中是否还有存活的怪物，参数0表示不区分怪物类型。当检测结果为真时，弹出提示并阻止领取。`GetRandomName`命令从外部文本文件中随机抽取一个装备名称存入字符变量S99，然后通过`GIVE`命令发放给玩家。领取完成后将`竞技杀怪`变量清零并保存，防止重复领取。
不同档位的领奖标签结构完全一致，只需修改对应的装备文件路径和杀怪数量阈值。这种结构便于扩展，如需增加更多档位，复制标签并修改参数即可。
##排名制竞技领奖脚本
排名制竞技活动的领奖逻辑更为复杂，需要判断玩家是否为最后存活者。群英争霸类脚本通过`CHECKMAPHUMANCOUNT`统计指定地图中的玩家数量，当地图内只剩一名玩家时方可领奖。
```plaintext
[@main]
只有剩下最后一名成员才可以获得奖励\
有一名以上玩家将不可以得到奖励\
领取奖励将在比赛结束后，45分到50分内领取!\
过了这段时间或者还没有将敌人杀光将不能领取\
不在规定时间内将不能领取!\
<我要领取奖励/@我要领取>\
<返回盟重/@mengzhong>\
[@我要领取]
#IF
CHECKMAPHUMANCOUNTqunying=1
#ACT
SENDMSG0群英争霸大赛正在进行中，请参加比赛的玩家赶快进入，奖励非常好！
goto@lingqu
#ELSESAY
难道地图里只有你一个人吗？？？\
[@lingqu]
#IF
hour1919
min4550
#act
goto@lingqu2
break
#IF
hour2121
min4550
#act
goto@lingqu2
break
#ELSESAY
领取时间还没到或者超过了领取时间.不能领取奖励！\
[@lingqu2]
#IF
checknamelist..\QuestDiary\重要数据\群英争霸领奖名单.txt
#act
goto@guanya
mapmovet225
#ELSEACT
give5000元宝1
give霸者印记1
give挑战证明书1
SENDMSG0恭喜玩家〖%s〗成为群英争霸大赛冠军，获得许多好东东！！！
addnamelist..\QuestDiary\重要数据\群英争霸领奖名单.txt
mapmove3330330
```
时间限制部分使用了多个`#IF`段落叠加时间条件，每个时段判断独立执行。`hour`和`min`命令分别获取当前的小时和分钟数，配合范围参数实现时间段校验。领奖名单通过`checknamelist`和`addnamelist`命令读写外部文本文件，已领取奖励的玩家会被记录在案，再次尝试领取时将跳转到`@guanya`标签，提示已被查处并关押。
##全服挑战类竞技领奖脚本
全服挑战模式采用全局变量控制活动状态，使用G133变量记录活动冷却倒计时。领奖条件包括：活动冷却时间少于19分钟、地图内仅剩一名玩家、且玩家处于NPC可交互范围内。
```plaintext
[@main]
#IF
smallG13319
CheckMapHumanCounttzqf=1
CheckInMapRangetzqf33351
#say
快来领取你的奖励！\
<领取奖励/@领奖>\
#elseact
MESSAGEBOX年轻人走进点来！你离我太远了或者当前地图不只你一个人吧
[@领奖]
#ACT
muln2g13480000
gamegold+<$STR(n2)>
movg1340
mapmove3333333
SendCenterMsg180251全服挑战获胜者为「<$USERNAME>」获得<$STR(n2)>元宝.130
```
奖励金额由进入挑战地图的玩家总数乘以固定金额计算得出。变量G134记录参与人数，通过`mul`命令将G134乘以80000存入数字变量n2，再用`gamegold`命令发放等额元宝。`CheckInMapRange`用于检测玩家与NPC的距离，防止远程领取。
##脚本编写中的关键变量与命令
竞技领奖脚本的编写需要掌握几个核心概念。个人变量方面，`CHECKVARHUMAN`用于读取玩家个人变量，`CALCVARHUMAN`用于修改变量值，`SAVEVARHUMAN`将变量持久化保存到文件。全局变量如G133、G134用于控制活动状态和记录参与数据，这类变量对所有玩家共享。
常用命令速查：
|命令|用途|
|------|------|
|CheckMonMap|检测地图内是否还有怪物|
|CheckMapHumanCount|统计地图内玩家数量|
|GetRandomName|从文本文件随机抽取名称|
|GIVE|发放物品给玩家|
|GAMEGOLD|增加玩家元宝|
|SENDMSG|发送全服公告|
|addnamelist/checknamelist|读写领奖名单，防重复|
|MOV/CALCVAR|变量赋值与运算|
##防重复领取机制设计
防止重复领取是领奖NPC脚本必须处理的问题。常见方案有三种。第一种是名单记录法，使用`addnamelist`将已领取玩家的名字写入文本文件，下次领取时通过`checknamelist`检查，如在名单中则拒绝发放。第二种是变量清零法，领取后将个人变量归零，再次领取时条件判断失败。第三种是全局冷却法，通过全局变量记录活动状态，在冷却期内NPC不提供领奖选项。
实际开发中建议将名单记录法与变量清零法结合使用，名单记录防止同账号多角色重复领取，变量清零防止同一角色反复领取。
##脚本调试注意事项
在编写和调试竞技领奖脚本时，需要关注几个常见问题。地图编号必须与实际服务端中的地图文件对应，`CheckMonMap`和`CheckMapHumanCount`命令中的地图编号错误会导致检测失效。变量保存路径需要提前创建对应目录，否则`SAVEVAR`命令执行失败会导致变量丢失。时间判断段的顺序需要注意，引擎按从上到下的顺序执行条件判断，一旦某个条件满足就会执行对应的ACT段并跳过后续判断，因此时间段的排列顺序会影响最终的执行结果。装备文件中的物品名称必须与服务端数据库中的物品名完全一致，包括标点符号和空格，否则`GIVE`命令会提示物品不存在。