传奇封魔谷申讨脚本命令：[@gcks]标签执行逻辑完整实现

传奇“封魔谷申讨”脚本中，[@gcks]（申讨封魔谷）标签是核心触发节点。在“CHECKITEM 圣招令 1”的判定基础上，后续执行命令需实现“扣除凭证、记录申请、流程提示、时间限制、全服公告”五大核心功能，确保玩法闭环与玩家体验。以下是详细编写逻辑与完整脚本。

一、[@gcks]执行命令的核心编写逻辑

结合前置对话中“圣招令为申请凭证、1小时时间限制、击杀主导者获玉玺、剑圣对话成谷主”的规则，执行命令需遵循“验证唯一性→扣除物品→信息记录→流程指引→全服通知”的顺序，避免出现“重复申请、凭证未扣、信息混乱”等问题。核心逻辑拆解如下：

1. 唯一性验证：防止同一时间多人申请，需判定当前是否已有申请者，避免封魔谷玩法冲突。

2. 凭证处理：扣除“圣招令”并记录扣除日志，作为申请生效的核心凭证。

3. 信息绑定：将申请者角色名、申请时间与“1小时时限”绑定，为后续超时判定做准备。

4. 流程指引：明确告知申请者下一步“前往封魔殿找圣将”的目标，及时间节点（19点整封魔城刷主导者）。

5. 全服公示：通过地图广播与全服消息，宣告申请生效，营造竞技氛围并提醒其他玩家参与或围观。

编写时需使用传奇脚本通用命令（适配GOM、GEE、HERO等主流引擎），同时预留“超时失效”“重复申请拦截”等防异常逻辑，确保玩法稳定。

二、分模块执行命令编写与说明

以下按功能模块拆解执行命令，每个模块附带命令作用与适配说明，便于根据服务端引擎灵活调整。

1. 前置验证：拦截重复申请与异常情况

在扣除圣招令前，需先验证“是否已有申请者”“申请者是否为特殊状态”，避免资源浪费与玩法冲突。核心命令如下：

#IF
CHECKITEM 圣招令 1
;判定当前是否已有申请（通过自定义列表记录申请者）
CHECKLISTEMPTY 封魔谷申请者 ;自定义列表名，用于存储当前申请者
;判定申请者是否处于战斗状态（避免战斗中申请）
CHECKFIGHTING
#ACT
;若处于战斗状态，提示并终止脚本
SENDMSG 2 战斗中无法申请申讨封魔谷，请先脱离战斗！
RETURN
#ELSEACT
;若已有申请者，提示并终止脚本
SENDMSG 2 当前已有玩家申请申讨封魔谷，请等待本次活动结束后再试！
SENDMSG 2 当前申请者：<$LIST(封魔谷申请者,1)/FCOLOR=69>
RETURN

说明：“CHECKLISTEMPTY”通过自定义列表判断唯一性，“CHECKFIGHTING”避免玩家在战斗中误操作；“<$LIST(封魔谷申请者,1)>”可调用列表中第一位申请者名称，提升提示清晰度。

2. 核心操作：扣除凭证与绑定申请信息

验证通过后，执行“扣除圣招令”“记录申请者信息”“绑定1小时时限”三大核心操作，这是申请生效的关键环节：

#IF
;复用前文验证条件（确保逻辑连贯）
CHECKITEM 圣招令 1
CHECKLISTEMPTY 封魔谷申请者
NOT CHECKFIGHTING
#ACT
;1. 扣除圣招令（申请凭证）
DELITEM 圣招令 1
;2. 记录申请者信息至自定义列表（格式：角色名|申请时间）
WRITELIST 封魔谷申请者 <$USERNAME>|<$HOUR>:<$MINUTE>
;3. 为申请者绑定1小时时间限制（自定义计时器名称）
SETTIMER <$USERID> 封魔谷申请时限 3600 ;3600秒=1小时
;4. 记录操作日志（便于后台查询）
WRITELOG 封魔谷申讨日志 <$USERNAME>(<$USERID>)于<$HOUR>:<$MINUTE>消耗圣招令1个，成功申请申讨封魔谷
;5. 申请者个人提示（明确扣除信息）
SENDMSG 2 成功消耗1个圣招令，申讨封魔谷申请已生效！

说明：“SETTIMER”命令为申请者单独绑定计时器，避免超时后仍能参与后续流程；“WRITELIST”与“WRITELOG”分别用于玩家端信息管理与后台记录，双重保障数据可追溯。

3. 流程指引：明确后续目标与时间节点

申请生效后，需通过多轮提示告知申请者关键信息，包括“当前进度、下一步目标、时间节点、最终奖励”，避免玩家流程混淆：

;接上文#ACT后续命令
;1. 分条提示核心流程（使用换行符\n实现清晰排版）
SENDMSG 2 【申讨流程指引】1. 立即前往封魔殿找到圣将，获取圣招令对应的任务线索；
SENDMSG 2 【申讨流程指引】2. 今日19点整，封魔城原安全区将刷新主导者，需准时参与击杀；
SENDMSG 2 【申讨流程指引】3. 击杀主导者后可获得开国玉玺，此为成为谷主的核心道具；
;2. 强调时间限制（调用计时器剩余时间）
SENDMSG 2 【重要提醒】你需在1小时内完成前期准备，超时后申请将自动失效！剩余时间：<$TIMER(<$USERID>,封魔谷申请时限)>秒
;3. 提示最终奖励与条件
SENDMSG 2 【谷主条件】携带开国玉玺与封魔堡剑圣对话，并支付500万金币，即可成为封魔谷谷主！

说明：“<$TIMER(用户ID,计时器名称)>”可实时显示剩余时间，提升玩家紧迫感；分条提示采用“【标题】内容”格式，符合传奇游戏玩家的阅读习惯。

4. 全服公示：营造氛围并同步信息

为增强玩法互动性，需通过“地图广播”与“全服消息”同步申请信息，让其他玩家知晓当前申讨状态，核心命令如下：

;接上文#ACT后续命令
;1. 封魔谷地图广播（红色字体，仅封魔谷玩家可见）
SENDMAPMSG 封魔谷 255 0 0 【封魔公告】玩家<$USERNAME/FCOLOR=69>已消耗圣招令，正式申请申讨封魔谷！
SENDMAPMSG 封魔谷 255 0 0 【封魔公告】今日19点整，封魔城原安全区将刷新主导者，欢迎各位玩家参与！
;2. 全服彩色提示（黄色字体，所有玩家可见）
SENDMSG 7 【全服通知】<$USERNAME>发起封魔谷申讨申请，19点整封魔城将上演巅峰对决，敬请关注！
;3. 同步更新当前谷主提示（若有需要，可清空原谷主信息，待新谷主产生后更新）
;CLEARLIST 封魔谷当前谷主 ;若需临时清空原谷主记录，可启用此命令
SENDMSG 7 【全服通知】封魔谷申讨通道已开启，新谷主将在活动结束后诞生！

说明：“SENDMAPMSG”后三个数字分别对应字体红、绿、蓝三色值（255,0,0为红色），“SENDMSG 7”为全服黄色消息，通过颜色区分信息重要性；广播内容包含申请者名称与时间节点，信息完整且简洁。

5. 异常处理：超时失效与重复申请拦截补充

为避免玩法漏洞，需补充“超时自动失效”与“重复申请拦截”的脚本逻辑，可通过独立函数实现，关联[@gcks]标签：

;超时失效处理函数（独立于[@gcks]，通过计时器触发）
FUNCTION 封魔谷申请超时(USERID)
;获取申请者名称
USERNAME = GETUSERNAME USERID
;从列表中移除申请者
DELETELIST 封魔谷申请者 <$USERNAME>
;向申请者发送超时提示
SENDMSG 2 USERID 【申讨超时】你的封魔谷申讨申请已超时（1小时时限已到），请重新消耗圣招令申请！
;全服提示（可选，增强透明度）
SENDMSG 7 【封魔公告】<$USERNAME>的封魔谷申讨申请已超时，当前申讨通道已开放，欢迎其他玩家申请！
END FUNCTION

;重复申请拦截补充（在[@gcks]开头添加）
#IF
;判定申请者是否在1小时内申请过（通过日志记录判断）
CHECKLOG 封魔谷申讨日志 <$USERNAME> <$HOUR-1>:00 <$HOUR>:<$MINUTE>
#ACT
SENDMSG 2 1小时内仅可申请1次封魔谷申讨，请稍后再试！
RETURN

说明：“FUNCTION”定义的超时处理函数，需在“SETTIMER”命令后关联（部分引擎用“TIMERFUNC”命令），确保超时后自动执行；“CHECKLOG”通过日志时间范围判断重复申请，避免玩家频繁消耗道具。

三、[@gcks]标签完整脚本示例（适配多引擎）

以下是整合所有模块后的完整脚本，包含“验证-扣除-记录-指引-公告-异常拦截”全流程，标注不同引擎的适配差异，可直接复制使用并按需调整：

[@main]
<$USERNAME>,你想成为封魔谷的"<谷主/FCOLOR=69>"吗?,\

如果你可以在<封魔殿的圣将/FCOLOR=69>那里找到<圣招令/FCOLOR=253>,然后带给我,\

那么我将在当天晚上<19点整/FCOLOR=253>在封魔城(原安全区)引出背后的<主导者/FCOLOR=253>,杀死主导者后,你可以获得<开国玉玺/FCOLOR=253>\

谁带着<开国玉玺/FCOLOR=253>与封魔堡里面的<剑圣对话/FCOLOR=253>并给予他<500W金币/FCOLOR=253>\
那么您就将成为封魔谷的"<谷主/FCOLOR=69>",切记你只有1个小时的时间.\

当前封魔谷谷主是:<$NATIONNAME> \ \

<申讨封魔谷/@gcks> --申请攻打封魔只需要<圣招令/FCOLOR=253>.

[@gcks]
#IF
;1. 基础凭证验证
CHECKITEM 圣招令 1
;2. 重复申请拦截（1小时内仅1次）
NOT CHECKLOG 封魔谷申讨日志 <$USERNAME> <$HOUR-1>:00 <$HOUR>:<$MINUTE>
;3. 无当前申请者
CHECKLISTEMPTY 封魔谷申请者
;4. 非战斗状态
NOT CHECKFIGHTING
#ACT
;1. 扣除申请凭证
DELITEM 圣招令 1
;2. 记录申请者信息与日志
WRITELIST 封魔谷申请者 <$USERNAME>|<$HOUR>:<$MINUTE>
WRITELOG 封魔谷申讨日志 <$USERNAME>(<$USERID>)于<$HOUR>:<$MINUTE>消耗圣招令1个，申讨申请生效
;3. 绑定1小时时限（GOM/GEE用SETTIMER，HERO用TIMERSET）
;GOM/GEE引擎：
SETTIMER <$USERID> 封魔谷申请时限 3600
TIMERFUNC <$USERID> 封魔谷申请时限 封魔谷申请超时 ;关联超时函数
;HERO引擎替换为：
;TIMERSET <$USERID> 封魔谷申请时限 3600
;TIMERLINK <$USERID> 封魔谷申请时限 封魔谷申请超时
;4. 申请者个人指引
SENDMSG 2 成功消耗1个圣招令，申讨封魔谷申请已生效！
SENDMSG 2 【流程指引】1. 前往封魔殿找圣将获取线索；2. 19点整封魔城原安全区刷主导者；3. 击杀后获开国玉玺；
SENDMSG 2 【时间提醒】1小时时限内完成准备，剩余时间：<$TIMER(<$USERID>,封魔谷申请时限)>秒
SENDMSG 2 【谷主条件】携带开国玉玺+500万金币，与封魔堡剑圣对话即可成为谷主！
;5. 地图与全服公告
;GOM/GEE引擎（封魔谷地图ID通常为5，可通过@当前地图查询）：
SENDMAPMSG 5 255 0 0 【封魔公告】<$USERNAME/FCOLOR=69>已发起封魔谷申讨，19点整主导者降临封魔城！
;HERO引擎替换为：
;MAPMSG 5 255 0 0 【封魔公告】<$USERNAME>已发起封魔谷申讨，19点整主导者降临封魔城！
SENDMSG 7 【全服通知】<$USERNAME>正式申请申讨封魔谷，19点整封魔城巅峰对决，欢迎参与！
#ELSEACT
;根据不同失败原因提示
#IF
NOT CHECKITEM 圣招令 1
#SAY
你未携带<圣招令/FCOLOR=253>，无法申请申讨封魔谷！\
请先前往封魔殿找到圣将获取该道具。
#ELSEIF
CHECKLOG 封魔谷申讨日志 <$USERNAME> <$HOUR-1>:00 <$HOUR>:<$MINUTE>
#SAY
1小时内仅可申请1次封魔谷申讨，\
请等待时限结束后再试！
#ELSEIF
NOT CHECKLISTEMPTY 封魔谷申请者
#SAY
当前已有玩家<$LIST(封魔谷申请者,1)/FCOLOR=69>申请申讨封魔谷，\
请等待本次活动结束后再提交申请。
#ELSE
#SAY
战斗中无法申请申讨封魔谷，\
请先脱离战斗状态！
#ENDIF

;超时处理函数（需放在脚本末尾或独立脚本文件中）
FUNCTION 封魔谷申请超时(USERID)
USERNAME = GETUSERNAME USERID
DELETELIST 封魔谷申请者 <$USERNAME>
SENDMSG 2 USERID 【申讨超时】你的封魔谷申讨申请已失效（1小时时限已到），需重新消耗圣招令申请！
SENDMSG 7 【封魔公告】<$USERNAME>的封魔谷申讨申请已超时，当前申讨通道已开放！
END FUNCTION

四、脚本调试与引擎适配要点

1. 核心调试技巧

- 命令验证：通过“@测试申讨”自定义命令快速触发[@gcks]标签，无需携带圣招令即可测试逻辑，示例：
OnCommand "@测试申讨"
;强制跳转到[@gcks]标签，忽略物品验证
GOTO @gcks_test
End OnCommand

[@gcks_test]
;此处复制[@gcks]的#ACT命令，删除CHECKITEM条件，用于快速调试
#ACT
SENDMSG 2 测试模式：申讨申请流程触发
;后续复制完整#ACT命令...

- 日志查询：通过服务端“Log”目录下的“封魔谷申讨日志”，查看申请者信息与操作时间，定位“扣除失败”“记录异常”等问题。

- 计时器测试：将“3600秒”改为“60秒”（1分钟），快速验证超时函数是否正常执行，避免等待1小时调试。

2. 不同引擎适配差异

功能需求

GOM/GEE引擎命令

HERO引擎命令

设置计时器

SETTIMER 玩家ID 计时器名 秒数

TIMERSET 玩家ID 计时器名 秒数

关联超时函数

TIMERFUNC 玩家ID 计时器名 函数名

TIMERLINK 玩家ID 计时器名 函数名

地图广播

SENDMAPMSG 地图ID 红 绿 蓝 内容

MAPMSG 地图ID 红 绿 蓝 内容

获取剩余时间

<$TIMER(玩家ID,计时器名)>

<$USERTIMER(玩家ID,计时器名)>

3. 注意事项

- 自定义列表（如“封魔谷申请者”）需在服务端“列表配置”中提前创建，避免脚本无法识别。

- 封魔谷地图ID需通过游戏内“@当前地图”命令查询，确保“SENDMAPMSG”广播仅在目标地图生效。

- “500万金币”的支付逻辑需在“剑圣对话”脚本中补充，可关联“CHECKGOLD 5000000”与“REDUCEGOLD 5000000”命令。

五、延伸功能：新增“申讨状态查询”与“转让申请”

为提升脚本实用性，可在[@main]标签中新增“状态查询”与“转让申请”功能，完善玩法体验：

[@main]
;在原有内容后添加
<查询申讨状态/@checkgck> --查看当前申请与剩余时间\
<转让申请资格/@transfergck> --将申请资格转让给他人（需消耗50万金币）\

[@checkgck]
#IF
CHECKLISTEMPTY 封魔谷申请者
#SAY
当前无玩家申请封魔谷申讨，\
你可携带圣招令发起申请！
#ELSE
#SAY
当前申讨申请者：<$LIST(封魔谷申请者,1)/FCOLOR=69>\
申请时间：<$LIST(封魔谷申请者,1,2)/FCOLOR=253>（格式：角色名|时间）\
若为你本人申请，剩余时限：<$TIMER(<$USERID>,封魔谷申请时限)>秒
#ENDIF

[@transfergck]
#IF
CHECKLIST 封魔谷申请者 <$USERNAME> ;判定为当前申请者
CHECKGOLD 500000 ;转让需50万金币
#ACT
REDUCEGOLD 500000
DELETELIST 封魔谷申请者 <$USERNAME>
SENDMSG 2 你已消耗50万金币转让申讨资格，当前申请通道已开放！
SENDMSG 7 【封魔公告】<$USERNAME>已转让封魔谷申讨资格，欢迎其他玩家申请！
#ELSEACT
#IF
NOT CHECKLIST 封魔谷申请者 <$USERNAME>
#SAY
你并非当前申讨申请者，无法转让资格！
#ELSE
#SAY
金币不足50万，无法转让申讨资格！
#ENDIF

总结

[@gcks]标签的执行命令编写，核心是围绕“申请-流程-结果”构建闭环，通过“验证-扣除-记录-指引-公告”五大模块确保逻辑完整。实际使用中，需结合服务端引擎调整命令语法，通过调试日志定位异常，并补充“状态查询”“超时处理”等延伸功能，提升玩家体验与玩法稳定性。脚本可直接适配主流传奇引擎，修改地图ID与道具名称后即可投入使用。