BLUE引擎指定范围刷物品脚本 - DROPITEMMAP物品刷新命令配置

新手最常踩的坑，是命令写得一字不差、物品却没出现在预期位置：要么全挤在一格上，要么跑到了别的图里。多数时候问题不在命令本身，而在地图号、坐标和范围这三个位置没有对齐。指定范围刷物品要处理的正是这件事，让物品落在指定地图的一片区域里，而不是锁死在某一格。

BLUE引擎给出的命令是DROPITEMMAP，格式里连着两个坐标位，后面再跟一个范围位；地图号写SELF代表人物当前所在地图，不用临时去翻地图编号。下面把命令格式与参数、它与固定点写法的差别、在脚本里落地的配置步骤，以及刷新后看不见物品时的排查顺序依次说明。

命令格式：范围刷物品的参数

DROPITEMMAP是功能操作类命令，官方帮助文档给出的完整格式如下：

DROPITEMMAP 地图号 坐标 坐标 范围 物品名 数量 (地图号如果使用SELF，将代表人物当前地图)

这一行下面官方还补了一句：第9参数：怪物名称。也就是说这条命令的参数位不止前面六位，编号一直排到9，后面几位分别管秒数、归属和怪物名。指定范围刷物品的配置写法就固定在这一行里，多一位少一位都不行，逐位说明放到参数小节展开。

官方主页面给了两段示例。第一段用地图编号来定位落点：

[@DROPITEMMAP]
#IF
#ACT
DROPITEMMAP 3 330 330 5 金条 1

第二段把地图号换成SELF，物品名用竖线串起三件武器，最后一位填了怪物名：

[@DROPITEMMAP]
#IF
#ACT
DropItemMap Self "" "" "" 开天|屠龙|匕首 1 "" 1 蜈蚣

官方对第二段的附注写得很清楚：当参数9是有效的怪物名，将按怪物信息掉落物品，支持多个物品名（以“|”分割）。这段话解释了为什么一行示例能同时列出三件武器，也点明了怪物名这一位的实际用途。

参数拆解：地图编号与坐标范围

九位参数各管一段，位置写错就会出现物品落错地图、数量对不上的情况，范围刷物品配置出问题大多集中在中间几位。逐位对照如下：

地图号这一位有两种写法。填数字就是写死某张地图，编号可以在地图参数里逐个核对；填SELF则跟着执行脚本的人物走，人物在哪张图，物品就刷在哪张图。这一点在活动脚本、NPC对话脚本里特别省事，也避开了地图编号记错的老问题。

坐标与范围是成组出现的。官方格式里两个坐标位紧挨在一起，后面才是范围位，前两位定中心点，范围位定这一片区域铺多大。范围给得越小，落点越集中；范围给得越大，物品越分散，适合做撒落类的场景。物品范围刷新的效果好不好，基本就看这两个位置配合得是否合适。

参数7与参数8来自2021更新页的扩展记录，官方原文这样写：

扩展DropItemMap地图号XY范围物品数量秒数归属(0/1)//X=-1时随机丢物品；秒数非0且归属=1时物品归属于执行脚本的玩家

这句话里有两个实用信息：格式里的X指第一位坐标，按原文填-1时物品随机丢出，不再按固定坐标落点；秒数不为0且归属填1时，刷新出来的物品归属于执行脚本的玩家。同一页还记着物品落到地上之后的拾取端配套设置，包括扩展PetPickupItemRange、自动拾取物品表的RareItem细分（1=怪物掉落通知、2=拾取触发、4=商铺购买通知、8=人物死亡掉落触发、16=队伍拾取通知）、批量拾取他人死亡掉落物品的开关BulkPickupDieDropItems，以及掉落提示用的DropEquip。

与固定点刷物品的区别

把物品固定刷在一个点上，是很常见的写法：坐标写死，物品每次都落在同一格。DROPITEMMAP在格式里多留了一个范围位，写法就从“一个点”变成了“一片区域”，这是指定范围刷物品与固定点写法最核心的差别。它和怪物刷新也没有关系，物品不依赖任何怪物出现，数量完全由数量位决定。

落点表现不同。固定点写法的物品集中在单格上，谁手快谁捡走，几件物品叠在一起还容易看漏；范围写法的物品散布在坐标周围，玩家得在区域里走一圈才能捡完，适合攻城、节日活动这类需要多人争抢的场景。

参数用量不同。固定点只用得上坐标位，范围位给最小值即可；范围写法必须把坐标和范围一起填，两位缺一个都形不成区域。你可以把它理解成先定中心点、再定这片区域铺多大，中心点是坐标，铺多大是范围。

场景选择不同。给NPC旁边摆几件任务物品、给某个坐标点补一件奖励，固定点就够用；攻城时往城墙一带撒药水、活动时往地图上洒金条，用范围写法才自然。如果目标是把物品直接送进人物背包，那属于物品给予类的做法，物品不落在地上，也就谈不上范围，这一点和刷在地图上是两条路。

配置步骤：刷新到指定范围

第一步，打开脚本文件，定位到要执行刷新的段落。最常见的两处是NPC对话脚本的#ACT段，以及QFunction-0这类触发文件里的对应段落，例如人物死亡触发、宝箱物品触发，只要脚本能跑到，命令就会执行。

第二步，先确定地图号。刷在人物当前所在地图就填SELF，刷在固定某张图就填地图编号，编号写错就会出现物品刷到别处的现象。

第三步，把两个坐标与范围一起填上，坐标取区域中心，范围按需要撒开的面积给值。写完之后把九位参数从头数一遍，确认坐标、范围、物品名、数量之间没有漏位。

第四步，保存脚本并重载对应脚本段，让改动生效，再进游戏跑到目标地图，确认物品是否落在预期区域内，并按数量核对一遍。

报错与修复：刷新后物品不显示

指定范围刷物品失败时，原因基本集中在下面四处，按顺序查过去，多数情况在前两步就能定位。

报错排查：地图号写错，物品刷到别的地图了？

填数字写法最容易出这个问题，把地图编号记错一位，物品就跑到另一张图上，你在目标地图怎么找都找不到。排查时先确认人物当前所在地图，再对照脚本里填的数字；想彻底绕开这个坑，地图号直接写SELF，人物站在哪儿，物品就刷在哪儿。

报错排查：参数漏位，物品刷新坐标整体错移？

九位参数少写一位，后面的物品名与数量会整体前移，命令把物品名当成数量去解析，地上自然什么都没有。这类问题看现象很难判断，直接逐位对照格式行最省事，重点看物品刷新坐标、范围、物品名、数量这四个相邻位置有没有缺项。

报错排查：物品名与数据库对不上，地上空空的？

物品名必须和数据库里的名称完全一致，写错一个字、混进一个空格，命令照样执行，但物品匹配不上，地上就是空的。核对时把数据库里的名字复制出来用，不要手打，物品名里的空格也要一起留意。

报错排查：脚本改完没重载，命令根本没跑？

脚本改动后要重载对应脚本段才会生效，只保存文件不重载，游戏里跑的还是旧逻辑。登录脚本QManage这类改动用重载命令生效即可，不用重启整套服务；NPC脚本与QFunction-0里的改动同理，重载之后进游戏再验一遍。

FAQ问答

1. 传奇怎么添加怪物攻城脚本，和指定范围刷物品能配合吗？

攻城脚本一般分两步走：先用GM命令设好怪物集中点，也就是攻城坐标，再在指定坐标刷怪；要做成自动流程就把这套判断写进脚本，刷怪配置做成手动或自动两种模式。攻城时如果想往地图上再撒一批药水、金条这类消耗品，可以在触发段追加一条DROPITEMMAP，坐标取城墙或城门中心，范围按撒落面积给值，玩家冲进来时正好能捡到。怪物刷新与指定范围刷物品各管一段，写在同一个触发段里也不冲突。（本条问题整理自百度知道真实提问：传奇怎么添加怪物攻城脚本，2023年6月）

2. 传奇服务端添加合成装备脚本时，材料要落到地上该怎么处理？

合成脚本管的是人物背包里的东西：先用CHECKITEM检测材料与数量，再用CHECKGAMEGOLD判断元宝够不够，RANDOM算合成几率，成功后用TAKE回收材料、用GIVE交付成品，整个过程物品不落到地上，也就用不到范围刷新。如果想让合成失败时的残料掉在地上给同行的人捡，可以在合成脚本的#ACT段末尾补一条刷新命令，注意别把成品也刷到地上。（本条问题整理自百度知道真实提问：传奇服务端添加合成装备脚本，2010年5月）

3. 传奇服务端脚本改了，游戏里面没变化，刷新命令也没生效怎么办？

先确认设置的NPC能不能找到、脚本开头是否写对；再启动M2观察有没有脚本错误提示行，报错行会直接指出是哪个文件哪一段出问题；登录脚本QManage这类改动用重载命令生效即可，不用重启。DROPITEMMAP写在NPC脚本或触发段里时，改完同样要重载对应脚本，只保存文件不重载，游戏里跑的还是旧逻辑。（本条问题整理自百度知道真实提问：传奇服务端脚本改了，游戏里面没变化，2022年11月18日）

4. 范围值和数量怎么配合，一次刷多少件比较合适？

数量位决定这一次生成几件物品，范围位决定这些物品散落在多大的区域里。刷10件金条、范围给5，物品会集中在坐标周围一小片，捡起来很快；刷100件、范围还是5，东西全叠在同一片区域里，画面反而更乱。撒落类场景通常把范围放到十以上，数量控制在几十件以内，视觉上不至于糊成一片。

5. 指定范围刷物品和物品给予、爆率配置有什么差别？

物品给予是把物品直接送进人物背包，玩家不用去捡；爆率配置控制的是怪物死亡后掉什么、掉多少；DROPITEMMAP不经过怪物，直接把指定物品刷在地图的指定区域内，掉多少完全由数量位决定，和怪物的爆率没有任何关系。三条路各管一段，做活动时用得最多的是把物品刷到地上让玩家抢。

6. 刷新后地图上什么都没有，按什么顺序排查最快？

先看地图号是不是写到了别的地图，填SELF最稳；再数一遍参数是不是九位齐全，漏一位会让物品名和数量整体错位，命令相当于没刷出东西；然后核对物品名与数据库里的名称是否完全一致，手打的名字最容易差一个字；最后确认脚本有没有重载生效。按这个顺序走，多数问题在第二步就能找到原因。

7. 地图号填SELF和填数字，用法上有什么不同？

填数字是把落点写死在某一张地图上，适合活动、固定摊位这类不会挪动的场景，缺点是得自己记牢地图编号；填SELF则跟着执行命令的人物走，人物在哪张图物品就落在哪张图，适合玩家触发类的脚本，比如玩家在任何一张地图打开NPC对话，就能在脚下刷出一片物品。两种写法后面的坐标与范围用法完全一样，换的只是地图号这一位。

写在最后

指定范围刷物品的写法并不复杂，三件事记牢就够：地图号填SELF就不用管地图编号，两个坐标定中心点，范围位决定物品撒多开。九位参数按顺序填齐，物品名直接从数据库复制避免错字，改完脚本记得重载，刷新后不显示的毛病九成都出在这几处。跑通之后把坐标和范围套进活动脚本，攻城撒药水、节日洒金条这类需求，用同一条命令就能解决。

文中BLUE引擎指定范围刷物品DROPITEMMAP的写法取自官方CHM帮助文档原文，仅为本地功能验证参考，实际服务器配置请以你的环境为准。