热血传奇地图时间限制脚本写法与倒计时触发配置

地图时间限制脚本的核心，是通过服务端参数控制玩家在指定地图内的停留时长，超时自动传送回城或触发特定事件。实现方式主要分两种：地图参数法直接在`MapInfo.txt`中配置，适用于固定时长的常规地图；脚本计时法则通过NPC传送时启动定时器，适合需要扣费或检测条件的复杂场景。

**一、地图参数法：TimeMap指令配置**

`TimeMap`是引擎内置的地图参数，格式为`TimeMap(参数一|参数二|参数三|参数四)`。四个参数分别控制返回地图、倒计时长、显示开关和触发字段。

在`MapInfo.txt`中找到目标地图的配置行，直接添加该参数。标准写法示例：

```
[G001 试炼屋] SAFE DAY QUIZ NOMANNOMON TimeMap(3|5|1|@计时地图返回)
```

参数拆解如下：
- **参数一**：超时后传送回的地图代码。示例中的`3`代表盟重土城。
- **参数二**：倒计时时长，单位分钟。`5`表示5分钟后触发传送。
- **参数三**：是否在屏幕显示剩余时间。`1`显示倒计时，`0`不显示。
- **参数四**：超时后触发的QF脚本段（可选）。此处指向`@计时地图返回`。

如果多张地图需要共用同一个倒计时，用`#`分隔地图号：

```
[d5071 天道一层] TimeMap(3#1|5|1|@天道地图返回)
[d5072 天道二层] TimeMap(3#1|5|1|@天道地图返回)
```

这两张地图共用同一个5分钟倒计时，时间到都触发`@天道地图返回`。

**二、QF触发段与超时处理**

`TimeMap`参数四指向的触发段，需要写在`QFunction-0.txt`功能脚本文件中。当玩家在地图内时间耗尽被传送出来时，自动执行该段逻辑。

基础写法：

```
[@计时地图返回]
#IF
#ACT
Sendmsg 5 限时已到，你已被传送回城。
```

无论玩家是在线等到时间到，还是中途小退后被系统自动传出，只要离开地图就会触发这个段。可以在`#ACT`下面加奖励发放或额外提示，比如记录玩家本次副本耗时、扣除入场次数等。

**三、脚本计时法：NPC传送触发定时器**

如果不想通过地图参数限制，而是想让玩家进入地图后才开始倒计时，或者需要先检测元宝、道具再扣费，可以在NPC传送脚本里用`TimeRecall`命令实现。

NPC脚本写法示例：

```
[@进入试炼]
#IF
CHECKGAMEGOLD > 4
#ACT
GAMEGOLD - 5
MAPMOVE D1008
TimeRecall 30
SENDMSG 0 [%s]进入了试炼之地，拥有30分钟时间获取宝物！
```

`TimeRecall 30`表示从进入地图起计时30分钟，时间到自动传回原处。这种方式简单粗暴，不需要改`MapInfo.txt`，但中途主动回城的话计时器可能还在后台跑，造成在其他地图被意外传回的问题。

**四、指定时间段开放地图**

除了限制单次停留时长，还有按钟点控制地图入口的需求。用`CHECKTIME`或`CHECKHOURMIN`命令限制进入时段。

写法示例：仅在8:10至8:20之间允许进入某地图：

```
[@MapEnter_D1000]
#IF
CHECKHOURMIN 08:10 08:20
#ACT
; 允许进入，不执行任何操作
break
#ELSEACT
SendMsg 1 "该地图仅在每日08:10至08:20开放！"
MAPMOVE 3 330 330
```

`CHECKHOURMIN 08:10 08:20`判断当前时间是否在08:10到08:20之间，不在这个窗口内的玩家会被传送回城。

**五、常见错误排查**

时间到了不传送，先检查`MapInfo.txt`中地图编号与`TimeMap`第一个参数是否一致，语法错误也会导致功能失效。玩家小退后计时失效，说明地图参数方式最稳定，`TimeRecall`命令在小退后确实可能重置。

倒计时触发时切换地图误传回，属于`TimeMap`旧版修复前的bug，需要更新引擎或在QF中加当前地图二次判断。如果发现`TimeMap`不会清空到期时间，检查GEE引擎版本是否更新到修复版。