1.76复古传奇商铺功能全流程添加指南

## 一、商铺功能底层架构解析

### 1. **客户端界面改造**
需在1.76原始客户端基础上注入商铺模块：
- 使用WIL编辑器修改`Prguse.wil`文件，添加商铺按钮素材（坐标需适配800x600分辨率）
- 新版商铺按钮建议尺寸为48x48像素，与右下角红圈原始位置（坐标735,535）对齐
- 通过`UI配置表`调整点击热区范围，避免与原有快捷栏冲突

### 2. **服务端核心配置**
需同时修改以下三个关键文件：
```lua
-- 服务端路径示例
D:\MirServer\Mir200\Envir\
├── ShopItemList.txt -- 商品清单
├── BuyItemList.txt -- 购买规则
└── Merchant.txt -- NPC交互逻辑
```


---

## 二、分步实现流程详解

### 1. **基础功能激活**
**(1) M2引擎设置**
打开HeroM2引擎控制台：
1. 进入`查看-列表信息二-商铺设置`
2. 勾选"启用商铺系统"
3. 设置元宝货币类型（建议保留1.76原版金币体系，需通过`GameGold=元宝`字段转换）

**(2) 商品数据注入**
```python
# ShopItemList.txt 配置示例
商品分类 商品名称 出售价格 图片索引 商品描述
0 超级金创药 100 380 瞬间恢复300HP
1 传送戒指 5000 421 跨地图传送神器
```


### 2. **客户端适配方案**
**(1) 界面元素更新**
使用WilQ工具修改`Prguse.wil`：
- 商铺图标建议使用索引号380-400（需与补丁文件同步）
- 添加动态特效需扩展至`Prguse2.wil`（帧率控制在15fps以内）

**(2) 登录器适配**
采用万能登录器V9.25：
```xml
<!-- 登录器配置文件示例 -->
<UI>
<ShopButton X="735" Y="535" Width="48" Height="48"/>
</UI>
```


---

## 三、技术难点突破方案

### 1. **原版兼容性问题**
1.76原始代码无商铺模块，需注入Hook函数：
```c++
// 内存地址注入示例（基于Blue引擎）
DWORD OldProtect;
VirtualProtect((LPVOID)0x00401000, 0x1000, PAGE_EXECUTE_READWRITE, &OldProtect);
*(BYTE*)0x004ABCDE = 0x90; // NOP原调用
JMP 0x00412345, NewShopFunction; // 跳转至新函数
```


### 2. **动态价格体系**
通过M2插件实现实时调价：
```lua
-- 价格波动脚本示例
function OnHourEvent()
local goldRate = GetGoldExchangeRate()
SetShopPrice("传送戒指", 5000 * goldRate)
end
```


---

## 四、功能扩展与深度优化

### 1. **交易安全体系**

| 安全层级 | 实现方案 | 技术来源 |
|----------|-----------------------------|-----------------------|
| 数据加密 | AES-256加密交易包 | |
| 行为验证 | 滑块验证+二次密码 | |
| 日志追溯 | 区块链存证（每笔交易上链） | |


### 2. **智能推荐系统**
基于玩家行为数据的推荐算法：
```python
# 推荐算法伪代码
def recommend_items(player):
history = get_buy_history(player)
level = player.level
if level < 30 and '药水' in history:
return ['超级太阳水', '大还丹']
elif level >= 35 and '传送' not in history:
return ['传送戒指', '随机传送卷']
```


---

## 五、运营维护指南

### 1. **商品管理规范**
**(1) 爆率平衡公式**
```math
爆率系数 = \frac{服务器在线人数}{1000} \times \frac{当前时段}{24}
```

需保证顶级装备日均产出≤3件

**(2) 物价调控矩阵**

| 商品类型 | 价格浮动范围 | 库存警戒线 |
|------------|--------------|------------|
| 消耗品 | ±20% | 5000件 |
| 中级装备 | ±15% | 200件 |
| 顶级神器 | ±5% | 10件 |


### 2. **常见问题排查**
**(1) 商品不显示**
- 检查`ShopItemList.txt`编码格式（必须ANSI）
- 验证物品数据库`StdItems.DB`是否存在对应条目

**(2) 购买失败**
- 查看`BuyItemList.txt`权限设置
- 检测元宝扣除脚本是否冲突

---

## 六、1.76特色化改造建议

### 1. **复古元素融合**
- 采用原始红圈HG2图标
- 交易动画使用2002年素材（需从韩版客户端提取）

### 2. **生态平衡设计**
- 商铺仅出售非战斗道具（回城卷、药水等）
- 装备类商品需通过`BOSS掉落凭证`兑换