CLEARITEMMAP脚本教程 - 清理地图指定物品实操方法
摘要：本文为零基础传奇GM详解996引擎CLEARITEMMAP脚本，讲解命令语法、参数含义、实操步骤，汇总常见报错解决方法，教你快速清理地图指定/全部地面物品。…
本文详解996引擎CLEARITEMMAP地图物品清理脚本，可精准清理地图指定范围单个/全部物品，解决游戏地图物品堆积、地面杂物杂乱问题，专为新手GM提供零难度实操教程。
一、脚本命令完整详解
1. 核心命令语法
完整标准调用格式，严格区分参数顺序，新手禁止随意调换位置：
CLEARITEMMAP 地图 X Y 范围 物品名称
2. 参数详细解析
所有参数为必填项，物品名称参数可留空，其余参数必须准确填写，具体参数说明如下：
| 参数顺序 | 参数名称 | 参数释义 | 填写规范&注意事项 |
|---|---|---|---|
| 1 | 地图 | 游戏地图编号 | 填写对应地图的官方ID，如盟重省固定为3，需和版本地图配置文件ID一致 |
| 2 | X | 地图横坐标坐标 | 填写地图内精准坐标数值，整数格式，无小数点 |
| 3 | Y | 地图纵坐标坐标 | 和横坐标对应，精准匹配目标点位坐标，整数格式 |
| 4 | 范围 | 以XY坐标为中心的清理半径 | 数值越大清理区域越广，单位为地图格子，建议安全区设置5-20范围 |
| 5 | 物品名称 | 需要清理的地面物品名称 | 填写游戏内物品完整显示名称，留空或填*可清理范围内所有物品 |
3. 核心使用规则
规则1：精准清理模式：填写具体物品名称，仅删除对应物品，其余地面物品保留，适合针对性清理垃圾道具。
规则2：全域清理模式：不填写物品名称，默认清理指定范围内所有地面物品，适合定时清理安全区杂物。
4. 完整实操案例代码
案例一：精准清理盟重安全区回城卷（单一物品清理）
[@main]
#IF
#ACT
CLEARITEMMAP 3 330 330 10 回城卷
#SAY
盟重安全区内的回城卷都被清除了。
案例二：清空盟重安全区所有地面物品（全域清理）
[@main]
#IF
#ACT
CLEARITEMMAP 3 330 330 10
#SAY
盟重安全区内的所有物品都被清除了。
二、多引擎适配说明
996引擎：完全原生适配，语法无修改、参数无偏差，所有版本通用，无需二次适配，直接复制即可使用。
其他主流传奇引擎：大部分引擎支持该基础命令，但部分老引擎不支持空参数全域清理，需填写*代替空值实现全物品清理；部分新引擎对坐标数值精度要求更高，需核对地图ID适配格式。
兼容禁忌：禁止在复古老引擎中直接省略物品参数，会导致脚本失效、报错闪退。
三、新手分步实操使用教程
全程傻瓜式操作，零基础GM直接照搬步骤即可生效：
步骤1：打开脚本文件 打开服务端目录，找到自定义NPC脚本文件夹，新建或打开已有NPC脚本文件（后缀为.txt）。
步骤2：粘贴修改代码 将上方案例代码复制粘贴到文件空白处，根据需求修改：地图ID、XY坐标、清理范围、物品名称。
步骤3：匹配NPC绑定 在NPC配置文件中，将该[@main]脚本段绑定到对应功能NPC，可设置为点击触发、定时触发。
步骤4：保存文件 修改完成后，Ctrl+S保存脚本，禁止直接关闭窗口不保存。
步骤5：重载生效 登录游戏服务端后台，执行【重载NPC脚本】命令，无需重启服务端，即可完成脚本生效。
四、常见报错与不生效解决方法
| 故障现象 | 核心原因 | 修复方法 |
|---|---|---|
| 点击NPC无反应、物品不清理 | 参数顺序错误、地图ID填写错误 | 核对地图ID、XY坐标、范围参数顺序，严格按照【地图-X-Y-范围-物品名】排序 |
| 单一物品清理失效，全域清理正常 | 物品名称文字不匹配、存在空格 | 删除物品名称前后多余空格，复制游戏内物品原版名称，杜绝文字偏差 |
| 老引擎脚本报错闪退 | 老引擎不支持空参数写法 | 将空参数改为*，写法为 CLEARITEMMAP 地图 X Y 范围 * |
| 清理范围过大，误删有用物品 | 范围数值设置过高 | 缩小半径数值，安全区建议设置8-15，野外定点清理设置3-5 |
五、新手GM避坑注意事项
1. 参数禁忌：所有坐标、范围参数必须为正整数，禁止填写负数、小数、文字，否则脚本直接失效。
2. 版本适配：996引擎无需修改适配，老引擎必须用*替代空物品参数，不可直接省略参数。
3. 功能限制：该脚本仅清理地面掉落物品，无法清理玩家背包、仓库物品，无误删玩家道具风险。
4. 实操建议：优先使用精准物品清理模式，避免全域清理误删玩家临时掉落的贵重道具。
六、高频FAQ问答
Q1：脚本可以定时自动清理地图物品吗？
A：可以，将该脚本段绑定到服务端定时脚本中，设置固定时间触发，无需手动点击NPC，可实现全天候自动清理杂物。
Q2：为什么物品名称一模一样，却清理不掉物品？
A：大概率是存在隐形空格、全角半角符号差异，建议直接在游戏内查看物品名称，逐字复制粘贴，手动输入极易出错。
Q3：不同地图的安全区坐标可以通用吗？
A：不可以，每张地图的安全区XY坐标、范围都不同，必须单独查询对应地图坐标后修改参数，不可直接套用盟重地图参数。
Q4：该脚本会清理BOSS掉落的极品道具吗？
A：全域清理模式会清理所有地面物品，包含极品道具；精准模式仅清理指定物品，可放心使用。
七、全文总结
CLEARITEMMAP是996引擎实用的地图物品清理脚本，支持单点精准清理和范围全域清理两种模式，参数简单易改，适配绝大多数游戏场景。新手GM只需核对地图ID、坐标、范围三大核心参数，避开参数格式、文字匹配误区，即可快速解决地图物品堆积问题。
