📦 物品出处完全教程

一、本服物品有 5 大出处

一句话：游戏里每一件能拿到的东西，都从下面 5 个渠道进背包。知道这 5 个，查任何物品出处都不迷路。

二、来源①：怪物掉落（查「掉落 / 来源」列）

这是最基础的出处。本服的掉落数据在 drop_data.sql，查询器已经直接接好了：

• 列表里每一行物品的「掉落 / 来源」列，鼠标悬停怪物图标或掉落徽标就能看它爆什么、被谁爆。
• 点物品图标还能反查：这个东西是哪些怪物掉的。

三、来源②：NPC 商店（openShop）

很多 NPC 脚本里一句 cm.openShop(数字) 就弹出一个商品列表。比如「聚合功能」里直接开商店：

// 聚合功能.js 里的一段：case 命中后打开编号 57 的商店
case 某编号:
    cm.dispose();
    cm.openShop(57);   // 57 是商店表的 ID，对应一份商品清单

商店的真正商品清单在服务端的「商店表」里（按 57 这种 ID 查），NPC 脚本只负责「把这个商店开出来」。想知道某商店卖什么，找对应 openShop 的数字、再去商店表查即可。

四、来源③：NPC 发放 / 兑换（gainItem）—— 本服最丰富的可玩来源

scripts/special/ 里一堆脚本靠 cm.gainItem(物品ID, 数量) 把东西放进你背包。下面全是本服真实代码。

例 1 · 在线奖励.js —— 按在线时长发

// 在线满 60 分钟领「永久雇佣商人」
if(cm.getPlayer().getGamePoints() >= 60 && cm.getPlayer().getGamePointsPD() == 0){
    cm.gainItem(5030001, 1);     // 永久雇佣商人 x1
}
// 在线满 120 / 180 / 240 … 分钟继续发：
cm.gainItem(2000002, 100);  // 红药水 x100
cm.gainItem(2000003, 100);  // 蓝药水 x100
cm.gainItem(5040000, 2);    // 瞬移石头 x2
cm.gainItem(5220040, 3);    // 飞天猪的蛋 x3
cm.gainItem(4001197, 100);  // 强化石 x100

例 2 · 首充奖励.js —— 选一件武器发

// 先列一个「可发清单」，[物品ID, 数量]
var reqlist = Array(
  Array(1372046,1),  // 短杖
  Array(1332081,1),  // 短剑
  Array(1402053,1),  // 双手剑 ...
);
// 玩家选第几个，就发那把武器
var wuqi = reqlist[selection][0];
cm.gainItem(null, wuqi, 0,0,3,3, ...);

例 3 · 元宝商城.js —— 用元宝买

// jmsz 数组：[物品ID, 价格(元宝), 数量, ?, 名称]
var jmsz = Array(
  Array(5220040,1,1,"未定义","飞天猪的蛋"),
  Array(4002000,1,1,"未定义","绿蜗牛邮票"),
  Array(5200002,5,1,"未定义","金币包"),  // ……
);

本服 special/ 里常见的发放 / 兑换脚本

五、来源④：活动 / 副本（event / quest）

打 BOSS、过活动给的物品，来自 scripts/event/ 和任务脚本。比如 scripts/event/bosspq.js 这种 BOSS 副本，通关后用同样的 gainItem 发奖励。要查这类出处，就去找对应的 event / quest 脚本搜物品 ID。

六、来源⑤：中枢 NPC「聚合功能」—— 一个 NPC 串起所有出处

游戏里点「拍卖」就是打开「聚合功能」这个 NPC（聊天窗口会显示名字「聚合功能」）。它本身不囤货，而是把玩家分流到上面各种来源：

// 聚合功能.js 把不同菜单项，转交给其它 NPC / 商店 / 传送
cm.warp(910000000, 0);                  // 传送去某地图
openNpc(9010000, "每日白嫖");             // → 发物品的 NPC
openNpc(9010000, "在线奖励");             // → 在线奖励.js
openNpc(9310022, "材料盲盒");            // → 抽材料
openNpc(9010000, "一条龙");               // → 一条龙福利
cm.openShop(57);                          // → 直接开商店

它菜单里常见的入口：升级传送赞助每日白嫖师徒系统寄售市场每日跑环材料盲盒一条龙技能学习在线奖励元宝商城。要找某件物品的出处，从这里点进去基本都能到。

七、实战：查「某件物品从哪来」标准流程

八、怎么自己改 / 加一个物品出处（GM 用）

方法跟之前 NPC 修改教程一样——用记事本打开 .js，改完 Ctrl+S 保存，进游戏重新点 NPC 就生效（没变化再重启服务端）。

改「在线奖励」的发放数量

// 在线奖励.js 里，把 100 改成你想要的
cm.gainItem(2000002, 100);  → 改成 cm.gainItem(2000002, 300);

给「元宝商城」加一个商品

// 元宝商城.js 的 jmsz 数组里加一行：[物品ID, 元宝价, 数量, "未定义", "名字"]
Array(2000004,2,10,"未定义","祝福"),

加一个「兑换」脚本（套路）

// 新文件 兑换9999999.js：收 A 发 B
if(cm.haveItem(旧物品ID, 1)){
    cm.gainItem(旧物品ID, -1);     // 扣掉旧的
    cm.gainItem(新物品ID, 1);     // 发新的
}

九、新手最容易踩的 5 个坑

1. 物品 ID 写错：gainItem(2000002, 100) 里 ID 多一位少一位都发不出，先去查询器确认正确 ID。
2. 数量参数顺序：gainItem(ID, 数量)，负数表示扣除（用来收材料）；别把数量写成 -1 想发东西。
3. 商店 ID 不存在：openShop(57) 的 57 必须在商店表里存在，否则点了没反应。
4. 重复发放没加限制：像在线奖励用 getGamePointsPD()==0 防止领第二次；自己加发放一定要加领取标记，否则无限刷。
5. 改完不刷新：记事本保存后先进游戏重进 NPC 验证，不行再重启服务端——别光改完就以为好了。