传奇引擎采集脚本教程 - 进度条+采集怪物全套实操

本文适配996传奇引擎，完整讲解采集进度条弹窗、专属采集怪物配置全套脚本命令，可直接解决新手不会搭建采集功能、采集失效、范围判定异常、进度中断无效等实操问题。

一、采集核心命令SHOWPROGRESSBARDLG详解

该命令是传奇采集功能核心弹窗指令，主要用于实现可视化采集进度条、自定义采集时长、采集完成/中断双向触发逻辑，是所有采集玩法的基础核心命令，适配996主流版本。

1.1 标准命令语法格式

SHOWPROGRESSBARDLG 时间(秒) 触发字段 提示信息 有动作是否中断(0不中断,1中断) 中断触发字段

1.2 精细化参数释义

1.3 完整可直接用实操示例

该示例为基础采集模板，复制即可直接加载生效，包含进度展示、完成奖励、中断提示全套逻辑

[@Main]
#ACT
SHOWPROGRESSBARDLG 5 @采集完成 正在采集,进度%d%... 1 @采集中断
Break

;采集完成触发奖励
[@采集完成]
#ACT
Give 回城卷 1
SendMsg 5 你采集一个回城卷
Break

;采集被中断触发提示
[@采集中断]
#ACT
SendMsg 5 采集被中断
Break

二、采集怪物配置规范与全套脚本

采集怪物是传奇专属互动资源怪物，区别于普通打怪怪物，具备静止、免攻击特性，依靠点击触发采集逻辑，广泛用于材料、道具、稀有资源获取玩法。

2.1 采集怪物基础属性配置

怪物基础类型固定格式，无需随意修改，回血效果可自由自定义配置

固定类型格式：Race=250

属性说明：该类型怪物默认自带不移动、不攻击特性，玩家、英雄、宝宝均无法攻击此类怪物，仅可点击触发采集

回血配置：怪物是否回血、回血间隔，统一在Monster.xls表格RehealthCd字段自行设置，0为不回血，数值越大回血间隔越长

2.2 采集范围判定规则

采集触发视野范围由Monster.xls表格ViewRange字段控制：

1、字段数值＞0：玩家在指定范围内可正常点击采集，超出范围触发采集失败脚本

2、字段数值=0：不检测采集范围，任意距离均可触发采集（不推荐，影响玩法合理性）

2.3 核心采集命令CAIJIBYPARAM详解

该命令用于绑定采集怪物唯一ID，精准触发对应怪物的专属采集奖励逻辑，是采集怪物差异化奖励的核心指令

标准格式：CAIJIBYPARAM 参数一 参数二

2.4 全套完整采集怪物实操脚本

包含前置点击触发、进度条采集、专属奖励、范围超限提示、中断提示全套逻辑，新手可直接照搬使用

;点击任意采集怪前置统一触发脚本
[@CollectMonEX]
#IF
#ACT
;<$Param1>=怪物ID
;<$Param2>=怪物名称
;<$Param3>=怪物唯一ID
mov S10 <$Param3>
SENDMSG 7 点击采集怪<$Param1>-<$Param2>-<$Param3>
SHOWPROGRESSBARDLG 5 @采集完成 正在采集,进度%d%... 1 @采集中断
stop

;采集完成执行专属奖励逻辑
[@采集完成]
#IF
#ACT
;根据怪物唯一ID精准触发对应采集脚本
CAIJIBYPARAM <$Str(S10)>

;指定ID采集怪物专属奖励（示例怪物ID：1451）
[@CollectMon1451]
#IF
CheckLevel > 0
#ACT
Give 金条
M.HUMANHP - 10000000
SendMsg 5 你探索到了一个金条!

;采集被中断提示
[@采集中断]
#IF
#ACT
SENDMSG 7 你的采集被打断

;超出采集范围失败提示（对应1451号采集怪）
[@CollectMonFail1451]
#act
sendmsg 9 你离着太远了，靠近一点再采集！

三、多引擎适配说明

适配引擎：996引擎全版本通用，命令语法、触发逻辑无偏差，直接加载即可生效

不适配引擎：老版3K、HERO复古引擎，此类引擎不支持SHOWPROGRESSBARDLG进度条弹窗命令，无法实现可视化采集进度

兼容注意事项：采集怪物Race=250属性仅适配996引擎怪物表规则，其他引擎需替换对应静止怪物类型，否则会出现怪物移动、可被攻击的bug

四、分步实操搭建教程

全程手把手教学，新手零门槛照搬搭建，四步完成采集功能落地

第一步：怪物表配置

打开Monster.xls表格，新增/修改采集怪物，将Race字段改为250，根据需求设置ViewRange采集范围、RehealthCd回血参数，保存表格并重启怪物数据

第二步：脚本粘贴导入

打开QF功能脚本文件，将上方全套采集脚本完整粘贴至脚本空白位置，确保无代码缺失、无重复字段

第三步：参数自定义修改

根据自身版本需求，修改采集时长、奖励道具、扣血数值、提示文案、怪物ID等自定义参数，适配自己的游戏玩法

第四步：保存生效测试

保存QF脚本，重载游戏脚本数据，进入游戏点击配置好的采集怪物，测试进度条展示、奖励发放、中断判定、范围判定是否正常生效

五、高频报错与排错方案

5.1 点击怪物无采集反应

问题成因：怪物Race类型未改为250、怪物ID与脚本ID不匹配、未重载脚本数据

修复方案：核对怪物表Race字段、统一脚本内怪物ID、重新重载全部脚本数据

5.2 采集不触发进度条

问题成因：SHOWPROGRESSBARDLG命令拼写错误、参数顺序错乱、前置脚本stop指令缺失

修复方案：严格对照标准语法核对代码，确保参数顺序无误，保留前置脚本stop终止指令

5.3 超出范围仍可采集

问题成因：Monster.xls的ViewRange字段设置为0，未开启范围检测

修复方案：设置合理的采集视野数值（推荐3-5），保存表格并重启游戏数据

5.4 采集中断无提示

问题成因：中断触发字段命名错误、参数4设置为0（不中断）

修复方案：将参数4改为1，核对中断脚本字段名称与命令内字段完全一致

六、新手实操避坑注意事项

1、禁止随意修改命令参数顺序，SHOWPROGRESSBARDLG参数顺序错乱会直接导致功能失效

2、每个采集怪物需单独配置专属[@CollectMonX]和[@CollectMonFailX]字段，X必须与怪物ID一致，否则无法精准触发奖励

3、采集进度条提示文案必须保留%d变量，删除后无法展示动态采集进度

4、996引擎低版本可能存在脚本重载不生效问题，修改脚本后建议重启服务端彻底生效

5、CAIJIBYPARAM命令必须搭配怪物唯一ID变量使用，直接填写固定ID会导致多采集怪物冲突

七、高频FAQ问答

Q1：如何修改采集的时长？

A：直接修改SHOWPROGRESSBARDLG命令第一个数值，数值为采集秒数，修改后重载脚本即可生效。

Q2：怎么设置采集不会被人物移动打断？

A：将命令第四个参数改为0，即设置为SHOWPROGRESSBARDLG 5 @采集完成 正在采集,进度%d%... 0 @采集中断。

Q3：多个采集怪物如何设置不同奖励？

A：新增对应怪物ID的[@CollectMonX]脚本段，单独设置每个怪物的奖励、扣血、提示内容即可。

Q4：采集怪物能否设置多人同时采集？

A：默认支持多人同时采集，无需额外设置，可根据需求添加人数限制脚本搭配使用。

Q5：采集完成后道具不落地、不到账怎么解决？

A：核对Give命令拼写、道具名称是否正确，检查人物背包是否已满，重载脚本重新测试。

八、全文总结

本文完整讲解了996引擎传奇采集脚本核心功能，包含SHOWPROGRESSBARDLG进度条命令、CAIJIBYPARAM采集参数命令、Race=250采集怪物配置、范围判定、中断逻辑、报错排错等全套实操内容，所有代码可直接复制使用，帮助新手GM快速搭建完整的游戏采集玩法。