传奇百分百拣宝功能脚本编写与全引擎参数配置详解

百分百拣宝的核心是让角色自动捡起地面上所有可拾取物品，不需要玩家手动点击。实现这个功能依赖引擎的自动拾取命令，配合定时器或登录触发来持续激活。以下从完整脚本范例入手，逐参数拆解OpenAutoPickItem命令的配置方法，并说明GOM、Hero、GEE等引擎的适配差异。

## 核心命令OpenAutoPickItem完整参数拆解

OpenAutoPickItem是GOM、GEE、Hero、翎风等主流引擎通用的自动拾取命令，格式如下：

```
OpenAutoPickItem 类型 有效时间 捡物范围 是否一次全捡 捡人物丢弃物品 捡人物爆出物品 物品掉地上多长时间才能捡 是否进入主人背包
```

**类型参数**控制拾取主体的范围。参数1表示只捡自身爆出的物品，参数2表示只捡宝宝爆出的物品，参数3表示自身和宝宝爆出的物品都捡。百分百拣宝场景下通常设为3。

**有效时间**参数控制自动拾取的持续时间，单位为秒。参数0表示在线期间永久有效，这是最常用的设置。如果需要限时体验，可以设置为具体秒数，例如3600表示一小时后自动关闭。

**捡物范围**参数控制拾取距离。参数0表示角色走上去才捡，适合模拟手动操作的场景；大于0的数值表示以角色为中心的范围拾取，例如4表示4格范围内自动捡起。百分百拣宝建议设置在3至5格之间，范围过大在配合拾取鉴定脚本时可能导致卡顿。

**是否一次全捡**参数控制拾取方式。参数0或留空表示逐个捡起范围内的物品，参数1表示瞬间捡起范围内所有可拾取物品。百分百拣宝追求效率，通常设为1。但需要注意，开启秒捡后如果触发了拾取鉴定脚本，范围越大一次性触发的鉴定次数越多，脚本写得不够优化时会导致游戏卡顿，秒捡范围建议不超过20。

**捡人物丢弃物品**参数控制是否拾取其他玩家丢在地上的物品。参数1表示捡取，参数0表示不捡。如果只希望捡怪物爆出的物品，设为0。

**捡人物爆出物品**参数控制是否拾取其他玩家死亡后掉落的物品。参数1表示捡取，参数0表示不捡。

**物品掉地上多长时间才能捡**参数控制延迟拾取，单位为毫秒。参数0表示立即捡取，参数1000表示物品落地1秒后才能捡取。设置适当延迟可以避免物品刚落地就被瞬间捡走，给其他玩家留出反应时间。

**是否进入主人背包**参数仅在Hero引擎中有效，控制宝宝捡到的物品是否直接进入主人背包。其他引擎忽略此参数。

## 登录触发脚本完整范例

将自动拾取脚本写入QManage.txt的[@Login]段，玩家上线时自动激活百分百拣宝功能：

```
[@Login]
#IF
CHECKLEVELEX > 0
#ACT
OpenAutoPickItem 3 0 4 1 0 0 500
SENDMSG 6 百分百拣宝已开启，4格内自动拾取所有物品。
BREAK
```

这段脚本的逻辑：CHECKLEVELEX > 0检测玩家等级大于0，确保所有正常角色都能触发。OpenAutoPickItem的参数依次为：类型3（自己+宝宝）、有效时间0（在线永久）、范围4格、一次全捡1（秒捡）、不捡丢弃物品0、不捡人物爆出物品0、延迟500毫秒后拾取。最后的SENDMSG 6向玩家发送个人系统提示。

如果需要根据玩家等级分段设置不同的拾取范围，可以用条件判断实现：

```
[@Login]
#IF
CHECKLEVELEX > 49
#ACT
OpenAutoPickItem 3 0 5 1 0 0 300
SENDMSG 6 尊贵玩家百分百拣宝已开启，5格范围秒捡。
BREAK
#IF
CHECKLEVELEX > 9
#ACT
OpenAutoPickItem 3 0 3 1 0 0 500
SENDMSG 6 百分百拣宝已开启，3格范围秒捡。
BREAK
#IF
CHECKLEVELEX > 0
#ACT
OpenAutoPickItem 3 0 1 0 0 0 800
SENDMSG 6 新手拣宝已开启，走近自动拾取。
BREAK
```

高等级玩家获得更大的拾取范围和更短的拾取延迟，低等级玩家使用较小的范围和逐个捡取模式，兼顾了游戏平衡。

## 定时器持续激活方案

登录触发只在玩家上线时执行一次。如果玩家在游戏中切换地图或经历某些特殊状态后自动拾取失效，需要用定时器定期重新激活。在QFunction.txt中设置定时器：

```
[@OnTimer0]
#IF
CHECKLEVELEX > 0
#ACT
OpenAutoPickItem 3 0 4 1 0 0 500
BREAK
```

然后在AutoRunRobot.txt或RobotManage.txt中注册定时器，控制重新激活的频率：

```
#AutoRunNPC SEC 30 @OnTimer0
```

SEC 30表示每30秒触发一次[@OnTimer0]标签，重新激活自动拾取。30秒的间隔足以覆盖大部分失效场景，同时不会频繁执行命令造成资源浪费。如果版本地图切换频繁，可以缩短到SEC 15；如果服务器负载较高，可以延长到SEC 60。

## 物品过滤与拾取列表配置

百分百拣宝如果无差别捡起所有物品，背包会迅速被垃圾装备填满，导致后续无法拾取高价值物品。需要在M2控制台的“查看→列表信息1→捡取列表”和“优先捡取列表”中配置过滤规则。

捡取列表控制哪些物品可以被自动拾取。将不需要捡起的物品加入屏蔽列表，例如布衣、木剑、蜡烛等低价值物品。列表配置保存在服务端的FilterItemList.txt文件中，也可以通过M2控制台的内挂捡取功能进行可视化配置。

优先捡取列表控制拾取顺序。当范围内同时存在多件可拾取物品时，系统按优先级从高到低依次捡取。优先级排序建议为：武器＞首饰＞防具＞材料＞金币。在列表中将屠龙、裁决之杖、圣战宝甲等高级装备排在前面，避免被低价值物品挤占背包空间。

OpenAutoPickItem命令默认按照查看列表信息1中的捡取列表和优先捡取列表进行物品拾取。如果希望按照玩家内挂配置进行拾取，需要在M2控制台的选项设置中开启“人物捡物同步内挂配置”。

## GOM引擎PickUpItems命令配置

GOM引擎除了支持OpenAutoPickItem外，还提供PickUpItems一键捡取命令，适合配合自定义技能或杀怪触发使用：

```
PickUpItems X Y 范围 是否按照内挂设置捡取
```

X和Y为触发位置坐标，范围不能超过20格，最后一个参数1表示按照内挂捡取列表设置的物品进行拾取，0表示捡取范围内所有物品。

在杀怪触发脚本中使用PickUpItems的范例：

```
[@KillMonster]
#IF
CHECKLEVELEX > 0
#ACT
PickUpItems <$X> <$Y> 10 1
BREAK
```

<$X>和<$Y>是引擎变量，自动替换为怪物死亡时的坐标位置。每击杀一只怪物，就在该位置周围10格范围内按照内挂捡取列表自动拾取物品。这种方式比范围秒捡更精准，只在怪物死亡时触发一次拾取，减少了不必要的全图扫描。

GOM引擎使用无限插件时还可以通过wxfStartAutoPickItem命令控制开关：

```
wxfStartAutoPickItem 1
```

参数1表示开启自动捡物，参数0表示关闭。wxfSetAutoPickItemInterval命令用于设置拾取间隔，控制每次拾取之间的时间间隔。

## 禁止特定物品自动拾取

某些高价值物品不希望被自动拾取，需要玩家手动操作，防止被脚本误捡或误回收。在物品数据库的Reserved字段中设置禁用标记，或者在爆率脚本中为物品添加NoAutoPick标记。

Hero引擎的做法是在物品配置后添加NoAutoPick=1：

```
裁决之杖 NoAutoPick=1
```

GEE和V8引擎可以使用NoAutoDropItemToBag命令禁止物品自动入包，NoAutoRangePickItem命令禁止范围拾取。

在地图参数中添加NoAutoRangePickItem也可以禁止整张地图的范围拾取功能：

```
[yb001 宝藏地图] NoAutoRangePickItem
```

这表示该地图内即使玩家开启了自动拾取命令，怪物爆出的物品也不会被范围拾取，必须手动捡取。适合BOSS地图和稀有装备掉落场景。

## 假人自动拣宝配置

如果版本中使用了假人系统，假人的自动拣宝需要通过DummyConfig配置文件和SetDummyPickItemFile命令实现。在假人的配置文件中设置捡物参数，或者在假人上线脚本中调用拾取命令。

假人捡物列表通过SetDummyPickItemFile命令指定：

```
SetDummyPickItemFile 假人捡物列表.txt 1
```

第一个参数为捡物列表文件名，每行写一个物品名称。第二个参数为是否优先捡取，1表示优先拾取列表内物品，0或留空表示仅拾取列表内物品。

假人捡物列表文件范例：

```
金币
元宝
裁决之杖
屠龙
祝福油
黑铁矿石
```

列表中的物品是假人会主动捡取的，列表外的物品即使地面上有也不会捡。这种方式可以控制假人的捡物范围，避免假人背包被垃圾物品占满。

## 多引擎适配差异与注意事项

**GOM引擎**：OpenAutoPickItem命令参数顺序与其他引擎一致，但需要在M2控制台的“选项→功能设置”中勾选“允许自动拾取”总开关，否则脚本命令不生效。GOM引擎的神盾插件和ESP插件提供了额外的自动拾取命令，SDSTARTAUTOPICK由GM控制开关，玩家无法自行关闭。

**Hero引擎**：OpenAutoPickItem命令的最后一个参数“是否进入主人背包”仅Hero引擎有效。Hero引擎的自动拾取脚本需要放入QuestDiary目录，支持通过热键F11暂停、F12恢复的控制方式。Hero引擎的物品过滤需要在M2控制台的“游戏设置→拾取系统”中配置。

**GEE和V8引擎**：支持OpenAutoPickItem命令的全部参数，同时提供智能过滤功能。在M2Server控制台输入“@ItemFilter”后，可以按优先级配置武器衣服白名单、首饰品质筛选、材料数量阈值等过滤规则。GEE引擎还支持“允许叠加物品优先拾取”选项，在“Options→游戏参数”中勾选，避免因捡取低级戒指耽误抢BOSS时机。

**翎风引擎**：OpenAutoPickItem命令的语法与GEE一致，但在关闭自动拾取时使用CloseAutoPickItem命令，该命令只能关闭通过OpenAutoPickItem开启的拾取功能，不能关闭内挂中手动勾选的拾取。

所有引擎通用的注意事项：范围秒捡配合拾取鉴定脚本时，鉴定脚本必须写得简洁高效，避免使用大量GOTO和CALL嵌套，否则范围越大游戏越卡。秒捡范围建议不超过20格，超过视觉范围的部分没有实际意义，反而会增加服务端和客户端的处理负担。

## 调试与验证步骤

脚本写入QManage.txt后，在M2控制台执行“重新加载QM脚本”，不需要重启服务端。用一个测试角色上线，检查是否收到“百分百拣宝已开启”的系统提示。然后进入打怪地图，击杀怪物后观察地面物品是否被自动捡起。

如果物品不自动拾取，按以下顺序排查：检查M2控制台中是否开启了自动拾取总开关；检查QManage.txt中[@Login]段的OpenAutoPickItem命令是否被正确加载；检查物品是否在捡取列表中被屏蔽；检查地图参数中是否设置了NoAutoRangePickItem禁止范围拾取。如果部分物品能捡、部分不能捡，检查捡取列表的配置，确认目标物品的名称与数据库中的名称完全一致。