传奇CheckTime指令教程 时间段剩余时间检测脚本用法
摘要：本文详解传奇ESP插件核心CheckTime指令，涵盖指令功能、5个参数释义、完整可运行脚本示例及逐行解析，分享限时活动、时效道具、封禁解除等实战场景用法，同时汇总常见报错排查方法，帮助传奇GM快速掌握时间段剩余时间检测脚本的编写与应用技巧。…
一、CheckTime指令功能概述
CheckTime是传奇ESP插件专属的时间检测核心指令，主要用于服务端脚本中检测指定时间段的剩余时间，精准判断当前时间与目标结束时间的差值，广泛适配限时活动、道具时效、权限管控、定时刷新等传奇版本常用场景，是GM定制时效类功能的核心脚本命令。
该指令支持自定义时间对比逻辑与差值判定，可将时间相差秒数赋值给变量，灵活实现时效到期提醒、活动启停、权限封禁解除等个性化功能，兼容性覆盖全版本ESP插件，适配GOM传奇引擎。
二、CheckTime指令语法与参数详解
指令原型：CheckTime
功能定位：检测自定义时间段剩余时间，生成时间差变量用于脚本逻辑判定
参数明细（共5个必填参数）
参数一：当前时间
填写系统当前时间变量，通用取值为<$TIME>，直接调用服务器实时时间，无需手动格式化。
参数二：结束时间
自定义时效截止时间，支持YYYY-MM-DD-HH:MM:SS标准时间格式，可通过MOV命令赋值给字符串变量调用。
参数三：运算符号
支持三种对比逻辑，分别为>（大于）、=（等于）、<（小于），用于判定当前时间与结束时间的先后关系。
参数四：判断数值
固定填写数字0，作为时间对比的基准阈值，常规场景无需修改。
参数五：相差秒数（变量类型）
自定义字符变量（如D1、S3等），指令执行后会自动将两个时间的差值（秒为单位）存入该变量，可后续调用输出或判定。
三、完整可运行脚本示例解析
以下为适配现时活动场景的实测脚本，可直接复制至传奇服务端NPC脚本、功能触发脚本中使用，兼容所有ESP插件正式版与测试版。
示例脚本（限时活动时间检测）
;适用各种现时活动等场景
#ACT
MOV S1 2019-05-07-00:00:00
MOV S2 <$TIME>
#IF
CheckTime <$STR(S1)> <$TIME> > 0 D1
#ACT
SENDMSG 6 输出变量值：<$STR(S1)> <$STR(S2)> <$STR(D1)>
脚本逐行解析
1. ;适用各种现时活动等场景：脚本注释，标注该脚本的适用场景，不参与程序执行；
2. #ACT：执行指令标识，后续命令为主动执行操作，无需玩家触发条件；
3. MOV S1 2019-05-07-00:00:00：定义字符串变量S1，赋值为活动截止时间；
4. MOV S2 <$TIME>：定义字符串变量S2，赋值为服务器当前实时时间；
5. #IF：条件判断标识，后续语句为判定条件，满足后执行#ACT区块内容；
6. CheckTime <$STR(S1)> <$TIME> > 0 D1：核心时间检测命令，判断当前时间是否大于截止时间，时间差值存入变量D1；
7. SENDMSG 6：向玩家发送系统提示消息，输出截止时间、当前时间、时间差三个变量数据。
四、主流应用场景与使用技巧
1. 限时活动管控
设置活动起止时间，通过CheckTime判定当前是否处于活动时段，未到时间隐藏活动入口，超时后关闭活动报名、奖励领取功能，精准管控活动周期。
2. 道具时效限制
结合人物变量存储道具过期时间，登录时调用CheckTime检测时间差，超时后自动回收道具、清除属性加成，实现时效道具全自动管控。
3. 封禁时效解除
针对玩家封号、禁言功能，存储封禁结束时间，每次玩家登录检测剩余封禁秒数，时间到期自动解除限制，无需人工手动操作。
4. 定时地图刷新
记录上一次地图怪物刷新时间，通过时间差值判定是否达到刷新间隔，满足条件后执行怪物刷新、资源重置等操作，替代传统定时器更灵活。
五、常见报错与排查方案
1. 变量无数据输出：检查时间格式是否为YYYY-MM-DD-HH:MM:SS，禁止使用/、中文分隔符，修正后重新加载脚本即可；
2. 指令不生效：确认服务端已正确加载ESP插件，老旧插件版本存在指令兼容问题，建议更新至最新官方版本；
3. 时间差值为负数：运算符号方向设置错误，早于结束时间时需使用<符号，晚于结束时间使用>符号，调整符号后重新判定。
