清除地图物品命令详解 - BLUE引擎物品清理教程

清除地图物品是BLUE引擎脚本命令里负责回收地面物品的一条，命令名写作CLEARMAPITEM，作用是把指定地图上、指定坐标范围内的散落物品一次收走。它只处理地面上的物品，和清怪走的是两套命令。

在本地测试版本里刷完一波怪，地上散落的回城卷、药水和爆出物品越堆越多，靠手一件件捡很费时间。把这条命令挂进NPC对话段或触发段，地图物品清理就能一次收干净，脚本改动量很小。

下面按命令格式、参数拆解、与清怪命令的区别、实操配置和报错排查的顺序展开，清理地图掉落物的四步写法、物品清不掉时的排查方向都会讲到。

命令格式：清除地图物品的写法

帮助文档对这一条的功能说明只有四个字，就是清除地图物品；格式行写得很短，一行放得下。

CLEARMAPITEM 地图 X Y 范围

四个位置依次是地图、X坐标、Y坐标、范围，中间用空格分隔，末尾不接物品名。命令名不区分大小写，脚本引擎统一识别，这一点和其他传奇脚本命令一致。

官方给出的示例挂在NPC对话段里，用来清掉盟重安全区地面上的回城卷。

;清除盟重安全区内的回城卷
[@MAIN]
#IF
#ACT
CLEARMAPITEM 3 330 330 10
#SAY
盟重安全区内的回城卷都被清除了。

示例里的地图编号是3，坐标是330 330，范围是10，执行后NPC输出“盟重安全区内的回城卷都被清除了。”这一句。对照格式行能看出，命令没有单独写物品名的位置，清理对象由地图和坐标范围决定。

帮助文档里这条命令只有这一页说明，没有第二套写法或额外的参数分支，按上面四个位置填就够了。

参数拆解：物品范围与地图编号

帮助文档只给了格式行和一段示例，没有单独列参数释义表，下表按格式行的四个位置和官方示例的填法对照整理。

地图位填的是编号，不是地图名称。示例里的3对应盟重，编号与地图的对应关系可以在版本的传奇地图参数配置里核对。编号写错，命令就会作用到另一张图上。

范围这一位决定以X Y为中心向四周延伸多大的作用面，官方示例填的是10。数值越大，能覆盖到的地面物品越多；数值越小，只收中心附近的一小片。

四个位置要配套使用：地图编号决定在哪张图上清理，X Y决定清理中心，范围决定覆盖面。只改动其中一位，清理结果就会跟着变，改完先在本地测试版本跑一次再定稿。掌握CLEARMAPITEM用法之后，这四个位置的填写顺序基本不会记错。

与清除怪物的区别

这两条命令经常被混着用。清除怪物命令CLEARMAPMON的功能原文是：用于清除指定地图里的怪物，人物的宝宝不在此范围以内，禁止清除怪物列表中的怪物不会被清除。它的格式只有一位。

CLEARMAPMON 地图号

它按整张地图清怪，官方示例同样写3，执行后盟重地图内的怪物全部清理干净。人物的宝宝不受影响，写在禁止清除列表里的怪物也不会被清掉。

CLEARMAPITEM则多出坐标与范围三个位置，按坐标点周边清理，所以它能做到局部清场：只收安全区、传送点或NPC脚边这一片的地面物品，图上其他位置的物品照旧留着。清怪和收物品各管一段，需要同时清场时两条命令配合写。

还有一点容易漏掉：怪被打掉后会爆出物品落到地面，只清怪不清物品，地面上的物品掉落会一直留着；反过来只清物品不清怪，怪物还会继续往外掉东西。按场景决定先处理哪一样。

实操配置：清理地图掉落物

清理地图掉落物的配置按下面四步走，走完就能在游戏里验证效果。

第一步，打开版本脚本目录里对应的NPC脚本文件，定位到对话段的[@MAIN]位置。

第二步，在#ACT段内写入CLEARMAPITEM，地图位填目标地图编号，坐标位填清理中心，范围位填覆盖面，清理盟重安全区就写3 330 330 10。

第三步，在#SAY段补一句执行提示，让玩家知道物品已经被收走。

第四步，保存文件并重载脚本或重启M2，让改动生效，再进游戏核对范围内的地面物品是否被收走。

如果版本习惯把功能统一放在QFunction-0.txt的功能脚本段里，也可以把这段挂到物品触发的触发段下调用，写法与NPC对话段一致。物品掉落位置不固定的场景，可以按坐标点分别写几条命令覆盖不同区域。

报错排查：物品清不掉的原因

命令跑不出预期结果，多数出在坐标、范围和生效方式三处，按下面几种现象对号排查。

报错排查：CLEARMAPITEM执行后物品还在？

先看坐标有没有写对，X和Y写反或抄错一位，清理中心就落到别处，目标位置自然收不到。再看范围是不是太小，官方示例用10，如果物品散得比较开，先临时把范围调大跑一次，确认命令本身通了，再往回收到合适数值。调完还要核对地图编号与目标地图是否一致。

报错排查：命令写了但地图上一点变化都没有？

这类情况先查脚本有没有真的被执行：看NPC能否点到、对话段名与调用处是否一致。再看M2启动时有没有脚本错误提示行，段名拼错或缺少结构项都会在那一步暴露。改动保存后要重载脚本或重启M2，只存文件不重载，游戏里一直读到的是旧脚本。

报错排查：清了不该清的东西，把摆放的物品也收走了？

这是范围开太大的典型表现。物品清理不区分物品来源，只要落在坐标范围内就会被收走。可以把范围改小，或者把命令挪到更贴近目标点位的坐标上，用多条小范围命令代替一条大范围命令，避免误伤周围摆放的物品。

问题速查

1. 公益传奇怎么清除地图物品设置？

在NPC脚本的#ACT段里写上CLEARMAPITEM，地图位填目标地图编号，坐标位填清理中心，范围位填覆盖面，官方示例里的地图位填3、坐标位填330 330、范围位填10，执行后盟重安全区内的回城卷就被清掉了。写好后重载脚本或重启M2，进游戏对话NPC验证效果。格式里没有物品名位置，清理对象由地图和坐标范围决定。（本条问题整理自百度知道真实提问：公益传奇怎么清除地图物品设置，2024年12月）

2. 传奇物品叠加怎样设置？

物品叠加改的是物品数据库与相关配置，和清除地图物品不是同一条命令。这条提问下的回答提到，可以在服务端配置文件里调整最大堆叠数量，用数据库工具改动时OverLap字段填1或2表示可叠加、填0不叠加，DuraMax字段要大于1才带叠加数量。改之前先备份原文件，改完重启M2再进游戏核对。（本条问题整理自百度知道真实提问：传奇物品叠加怎样设置，2026年7月）

3. 传奇服务端脚本改了，游戏里面没变化？

先确认改到的那段脚本真的被执行：NPC能否点到、段名与调用处是否一致，脚本开头有没有写错。M2启动时留意有没有脚本错误提示行，段名拼错、结构缺项都会在那一步报出来。改动保存后要重载脚本或重启M2，只保存不重载，游戏里读到的还是旧脚本。（本条问题整理自百度知道真实提问：传奇服务端脚本改了，游戏里面没变化，2022年11月18日）

4. CLEARMAPITEM的X和Y还有范围三个位置怎么填？

X和Y是清理中心点的横纵坐标，范围是以这个点为中心的作用面，三个位置配套使用。官方示例把地图位填3、坐标位填330 330、范围位填10，说明中心点定在安全区附近，覆盖面这一位填了10。实际填写时先在地图上确认目标点位的坐标，再按物品散开的程度定范围。

5. 不指定物品名时清除地图物品命令清的是什么？

格式行里只有地图、X、Y、范围四个位置，没有物品名参数，所以命令不区分物品种类，凡是落在坐标范围内的地面物品都会被一起收走。官方示例的注释写的是清除盟重安全区内的回城卷，是因为那段坐标范围正好覆盖安全区里散落的回城卷。要按物品名单独处理，得换用面向物品的命令。

6. CLEARMAPITEM和CLEARMAPMON清怪命令有什么区别？

区别在作用对象和定位方式。CLEARMAPMON只填地图号，按整张地图清怪，人物的宝宝和禁止清除列表里的怪物不受影响；CLEARMAPITEM多出坐标与范围三个位置，按坐标点周边收地面物品，能做局部清场。地图清场时两条命令经常一起写，一条清怪、一条收物品。

7. 范围从10改成100，清理结果差多少？

范围这一位越大，覆盖到的地面物品越多，官方示例给的是10。帮助文档没有给出范围与坐标的换算表，所以没有固定的倍数关系可以套，建议在本地测试版本里用10和100各跑一次，对比两次实际收走的物品数量，再定一个够用又不会误伤的数值。范围开得过大，NPC脚边摆放的物品也可能被一起收走。

最后总结

清除地图物品这条命令的用法可以收成一句话：地图、X、Y、范围四个位置按顺序填好，落在范围内的地面物品就会被收走。它和清怪命令分工明确，一个按地图编号清怪，一个按坐标范围收物品，做地图清场时两条配合使用更完整。落地时记住三点：地图编号别写错、范围别贪大、改完脚本要重载，物品清不掉时按这三个方向查就能定位。

本文BLUE引擎清除地图物品CLEARMAPITEM的内容依据官方CHM帮助文档整理，仅供本地学习排查使用，请勿直接照搬到正式环境。