逐鹿中原商铺插件使用详细说明

一、插件组成

1. 服务端插件：D:MirServerMir200ZgEngine.dll
2. 客户端插件：C:热血传奇2012PluginZuluShopClient.dll
3. 商铺界面素材：C:热血传奇2012DataNewopUI.Pak
4. 物品图标素材：DataItems.wil、DataItems1.wil 等
5. 商品数据：[ShopItemList.txt](D:/MirServer/Mir200/Envir/ZuluShop/ShopItemList.txt)
6. 商铺设置：[ZuluShop.ini](D:/MirServer/Mir200/Envir/ZuluShop/ZuluShop.ini)

二、安装服务端插件
安装或替换前必须关闭M2。

把 ZgEngine.dll 放入：

D:MirServerMir200ZgEngine.dll

检查：

D:MirServerMir200PlugList.txt

必须有一行：

ZgEngine.dll

启动M2后，主菜单应出现：

互通娱乐
└─ 逐鹿商铺

点击“逐鹿商铺”即可打开商铺后台。

三、安装客户端插件
安装或替换前必须关闭游戏客户端。

把 ZuluShopClient.dll 放入玩家客户端实际目录：

C:热血传奇2012PluginZuluShopClient.dll

检查：

C:热血传奇2012PluginPlugList.txt

必须有一行：

ZuluShopClient.dll

注意：D:MirServerMir200PlugClient 是客户端插件分发目录，不是游戏实际加载目录。最终必须把DLL发送到每个玩家客户端的 Plugin 目录。

四、首次后台设置
打开“互通娱乐 → 逐鹿商铺”，当前推荐默认参数：

开启商铺=是
按钮X偏移=6
按钮Y偏移=-2
宽度=40
高度=13

功能说明：

• 开启商铺：关闭后客户端隐藏商铺入口按钮。
• 开启钱庄：控制商铺界面“钱庄”按钮显示。
• 开启充值：控制商铺界面“充值”按钮显示。
• X偏移：正数向右，负数向左。
• Y偏移：正数向下，负数向上。
• 宽度/高度：940、941素材的实际绘制尺寸。

修改后必须点击“保存”。最新版客户端约3秒内重新获取状态。

目前钱庄、充值只实现显示开关，点击动作尚未绑定业务功能。

五、添加商品

1. 在右侧物品列表选择物品。
2. 设置商品类别。
3. 设置价格。
4. 选择交易方式。
5. 设置库存。
6. 填写标题和说明。
7. 点击“添加”。
8. 最后点击“保存”。

类别编号：

0武器  1衣服  2头盔  3项链
4手镯  5戒指  6饰品  7热卖

交易方式：

0元宝  1金币  2游戏点
3灵符  4钻石  5荣誉

“库存”表示该商品剩余可购买总件数。玩家每点击一次购买一件，成功后库存减一。

六、修改和删除
修改商品：

1. 鼠标选择表格整行。
2. 修改下方价格、类别、库存、交易方式等。
3. 点击“修改”。
4. 点击“保存”。

删除商品：

1. 选择整行。
2. 点击“删除”。
3. 点击“保存”。

“检测”只验证数据，不等于保存。

七、客户端使用

1. 进入游戏。
2. 点击OUT左侧“商铺”按钮。
3. 默认优先显示“热卖”。
4. 点击类别只显示对应类别商品。
5. 点击商品行查看说明。
6. 点击“购买”，每次购买一件。
7. 再次点击商铺入口或红色X关闭窗口。

购买要求：

• 商品库存大于0。
• 玩家货币充足。
• 背包至少有一个空位。
• 服务端与客户端插件版本匹配。

八、常见故障

• 没有M2菜单：检查服务端 PlugList.txt 和 ZgEngine.dll。
• 没有商铺按钮：检查实际客户端DLL、客户端 PlugList.txt 和940/941素材。
• 设置保存但无效果：通常是游戏加载了另一份旧DLL。
• 商品无显示：检查启用值、库存、分类和真实物品名。
• 图标缺失：检查物品的 Looks 及客户端 Items*.wil。
• 购买失败：检查货币、库存、背包，并查看日志。

服务端日志：

D:MirServerMir200EnvirZuluShopLogShopBuyLog.txt

客户端日志：

C:热血传奇2012ZuluShopClient.log

当前检测到游戏客户端与M2正在运行，且实际客户端DLL与最新分发DLL的MD5不同。下次测试前应先关闭游戏，把 D:MirServerMir200PlugClientZuluShopClient.dll 覆盖到 C:热血传奇2012PluginZuluShopClient.dll。