捡取提示功能核心原理
传奇物品捡取提示功能通过引擎事件触发机制实现。玩家拾取物品时，引擎自动调用指定脚本标签，执行预设命令。提示内容可以包含物品名称、数量、拾取者信息等。
功能实现需要三个关键配置。引擎开启捡取事件触发，脚本文件定义触发标签，消息命令设置提示内容。三者缺一不可。
引擎事件开启配置
M2Server控制台开启捡取触发。进入选项、功能设置、事件脚本，找到物品捡取事件选项。勾选启用捡取事件触发功能。
部分引擎在M2Server.ini中配置。打开M2Server.ini文件，搜索PickItem、ItemPick等关键词，将对应参数设为1或TRUE。
重启M2Server使配置生效。事件触发配置修改后需要完全重启引擎，热加载通常不生效。
脚本文件位置与命名
捡取事件脚本通常位于Envir/Script目录下。文件名为PickItem.txt或物品捡取.txt，部分引擎使用固定文件名不可更改。
QuestDiary目录也可存放捡取脚本。部分版本将功能脚本统一放在QuestDiary下，文件名自定义，需要在M2Server中注册。
脚本文件编码必须为ANSI。UTF-8或其他编码会导致引擎无法正确读取脚本内容，触发功能失效。
捡取触发标签定义
[@PickItem]是标准捡取触发标签。玩家拾取任何物品时自动调用此标签，无需手动触发。标签名称必须完全匹配，大小写敏感。
部分引擎使用[@OnPickItem]或[@ItemPick]。查看引擎文档确认当前版本使用的标签名称，不同引擎可能有差异。
标签内可以获取物品信息。系统自动提供物品名称、数量、拾取者等参数，脚本中可直接使用。
物品信息变量获取
N#物品名称存储拾取物品名字。拾取触发后，该变量自动填充为拾取物品的名称，可直接用于消息提示。
N#物品数量存储拾取物品个数。堆叠物品拾取时显示实际数量，单个物品数量为1。
N#拾取者名称存储玩家角色名。用于全服公告时显示拾取者信息，增强互动效果。
N#物品等级存储物品品级。部分引擎支持获取物品等级，用于过滤提示的物品类型。
基础提示脚本示例
[@PickItem]
IF
CHECKITEM 屠龙 1
ACT
SENDMSG 2 恭喜玩家获得屠龙一把
BREAK
[@PickItem]
IF
CHECKITEM 裁决 1
ACT
SENDMSG 2 恭喜玩家获得裁决之杖
BREAK
上述脚本实现特定物品拾取提示。只针对屠龙、裁决等稀有物品触发全服公告，普通物品不提示。
条件过滤脚本实现
按物品等级过滤提示。使用N#物品等级变量判断，只提示高等级物品，避免聊天框刷屏。
[@PickItem]
IF
CHECKVAR N#物品等级 >= 5
ACT
SENDMSG 2 恭喜玩家获得
BREAK
按物品类型过滤提示。检查物品名称包含关键词，如武器、衣服、首饰等，只提示特定类型物品。
按地图过滤提示。检查玩家当前所在地图，只在特定地图触发提示，如BOSS地图、活动地图。
物品列表配置方式
使用物品列表管理提示物品。创建ItemList.txt文件，列出需要提示的物品名称，脚本检查物品是否在列表中。
[@PickItem]
IF
CHECKLIST 物品提示列表.txt N#物品名称
ACT
SENDMSG 2 恭喜玩家获得
BREAK
列表方式便于维护。添加或移除提示物品只需编辑列表文件，无需修改脚本代码。
列表文件存放在Envir目录下。每行一个物品名称，支持注释行，使用分号开头。
消息提示格式设计
全服公告使用SENDMSG命令。消息显示在所有玩家聊天框，颜色代码控制文字颜色，常用2为红色、7为白色。
私聊提示使用SENDMSG_TOPLAYER命令。只向拾取者本人发送消息，避免全服刷屏，适合普通物品提示。
组队消息使用GROUPMSG命令。只向组队成员发送提示，适合组队打宝场景，增强团队互动。
消息内容可包含变量。使用格式在消息中插入动态内容，如物品名称、拾取者、数量等。
冷却时间控制
防止频繁提示刷屏。使用变量记录上次提示时间，检查时间间隔是否达标。
[@PickItem]
IF
CHECKVAR N#物品等级 >= 5
CHECKTIME_DIFF N#上次提示时间 10
ACT
SENDMSG 2 恭喜玩家获得
SET N#上次提示时间 CURRENT_TIME
BREAK
冷却时间按全局或玩家独立设置。全局冷却限制全服提示频率，玩家独立冷却允许不同玩家同时触发。
特殊物品单独处理
元宝、充值类物品单独提示。这类物品价值高，需要醒目的提示颜色和格式，增强玩家成就感。
任务物品不触发提示。任务道具拾取频繁，提示会造成干扰，脚本中排除任务物品。
绑定物品可选择提示。绑定物品无法交易，部分版本选择不提示，减少无效信息。
日志记录功能
拾取记录写入日志文件。使用ADDLOG命令将拾取信息记录到文本文件，便于后续查询和统计。
[@PickItem]
IF
CHECKVAR N#物品等级 >= 5
ACT
ADDLOG 拾取日志.txt 拾取
SENDMSG 2 恭喜玩家获得
BREAK
日志文件存放在Logs目录。定期清理旧日志，避免文件过大影响性能。
日志格式可自定义。包含时间、玩家、物品、地图等信息，方便追溯物品来源。
常见问题排查
拾取无提示检查引擎配置。确认M2Server中捡取事件触发功能已开启，配置保存后重启生效。
检查脚本标签名称。标签名称必须与引擎要求的完全一致，大小写错误会导致不触发。
变量取值验证。使用SENDMSG命令输出变量值，确认物品名称、数量等变量是否正确获取。
日志查看错误信息。M2Server控制台和日志文件可能记录脚本执行错误，根据提示修复。
性能影响控制
高等级服务器限制提示频率。在线玩家多时，频繁全服公告会影响性能，设置合理的冷却时间。
物品检查命令优化。CHECKITEM等命令会访问数据库，避免在捡取脚本中使用过多此类命令。
变量使用临时变量。捡取脚本中使用D#临时变量，会话结束后自动清理，减少内存占用。
多引擎版本差异
GOM引擎使用[@PickItem]标签。变量格式为N#开头，支持CHECKLIST列表检查命令。
GEE引擎标签名称可能不同。部分版本使用[@OnGetItem]，变量获取方式也有差异，查看对应文档。
HERO引擎配置位置不同。事件触发配置在M2Server不同菜单下，脚本语法基本一致。
完整实战脚本示例
Envir/Script/PickItem.txt文件内容：
[@PickItem]
IF
CHECKLIST 稀有物品列表.txt N#物品名称
CHECKTIME_DIFF N#提示冷却 5
ACT
SENDMSG 2 恭喜玩家在获得
ADDLOG 物品拾取.log |||
SET N#提示冷却 CURRENT_TIME
BREAK
ELSE
ACT
SENDMSG_TOPLAYER 7 你获得了
BREAK
稀有物品列表.txt文件内容：
;稀有物品提示列表
屠龙
裁决之杖
骨玉权杖
龙纹剑
测试验证流程
创建测试账号拾取物品。验证普通物品和稀有物品的提示差异，确认过滤逻辑正确。
多人在线测试。多名玩家同时拾取物品，验证冷却时间是否生效，消息是否刷屏。
日志文件验证。检查日志文件是否正确记录拾取信息，格式是否符合预期。
跨地图测试。在不同地图拾取物品，验证地图过滤功能是否正常工作。
捡取物品触发提示脚本通过引擎事件机制实现，核心是正确配置触发标签和获取物品信息变量。按照上述方案配置后，玩家拾取物品时会自动触发预设提示，增强游戏互动体验。关键是合理设置过滤条件和冷却时间，避免消息刷屏影响游戏体验。
