Hero传奇引擎摆摊功能深度修复指南，从"点击无反应"到"全流程故障排除"

#### 一、核心问题定位与底层逻辑
Hero引擎摆摊功能失效涉及**脚本逻辑冲突**、**地图参数加载异常**、**引擎权限未生效**三重可能性。根据脚本内容与用户描述，当前问题表现为"点击无反应+无提示"，需重点排查以下方向：
1. **脚本触发优先级冲突**：`@StartMyShop`未正确处理条件分支，导致引擎默认摆摊流程被阻断
2. **地图参数加载失效**：MYSHOP参数未正确写入或地图配置文件未重载
3. **引擎摆摊权限未激活**：M2的"个人商店模式"与"仿Hero摆摊模式"存在兼容性问题

---

#### 二、分步排查与修复方案

##### **第一阶段：脚本逻辑重构**
用户当前脚本存在**条件覆盖不全**和**阻断逻辑缺失**问题，需按以下结构优化：
```
[@StartMyShop]
#IF
;----------- 阻断条件检测 -----------
IsDupeMode ;检测是否与其他玩家重叠
#ACT
ForbidMyShop
SendMsg 5 摆摊失败：请移动到空旷位置
BREAK

#IF
NOT INSAFEZONE ;检测是否在安全区
#ACT
ForbidMyShop
SendMsg 5 摆摊失败：仅限安全区使用
BREAK

#IF
CheckLevelEx < 40 ;等级限制
#ACT
ForbidMyShop
SendMsg 5 摆摊失败：需达到40级
BREAK

;----------- 允许摆摊逻辑 -----------
#IF
IsOnMap 3 ;盟重地图检测
CHECKSHOPSTALLSTATUS = 0 ;检测是否已开启摆摊
#ACT
SHOPSTALL ;执行摆摊命令
SendMsg 5 摆摊界面已开启！
#ELSEACT
SendMsg 5 状态异常：请关闭现有摊位后重试
```

**关键点说明**：
- 使用`ForbidMyShop`前必须发送阻断提示，否则玩家无法感知失败原因
- 必须添加`CHECKSHOPSTALLSTATUS`检测，防止重复调用导致的引擎崩溃
- `IsOnMap 3`建议改为变量检测，兼容多地图摆摊场景（如：GOTO @CheckMapParam）

##### **第二阶段：地图参数与引擎配置验证**
1. **地图参数强制重载**
- 打开`MapInfo.txt`，确认盟重地图配置包含**MYSHOP**和**ALLOWUSEMYSHOP**双参数：
```
[3 盟重省] DAY NORECALL NODEARRY NOPOSITIONMOVE MYSHOP ALLOWUSEMYSHOP
```

- 在M2控制台执行 **"重新加载-地图配置"** ，确保参数生效

2. **M2摆摊模式切换**
- 进入 **M2→选项→功能设置→个人商店**
- 勾选 **"启用仿HeroM2摆摊模式"** （优先兼容老脚本）
- 取消勾选 **"需要摊位道具"** （避免物品缺失导致静默失败）
- 设置 **"摆摊最低等级=40"** （与脚本逻辑保持一致）

3. **引擎权限检测**
- 在M2控制台输入 **"@CHECKSHOP"** ，查看摆摊系统状态输出
- 正常状态应显示：
```
[摆摊系统] 地图3已授权 | 仿Hero模式激活 | 当前在线摊位数:0
```


##### **第三阶段：客户端与补丁校验**
1. **必备补丁文件检查**
- 客户端`Data`目录需包含以下文件（大小校验）：

| 文件名 | 作用 | 典型大小 |
|-----------------|----------------------|------------|
| MyShop.pak | 摆摊界面素材 | 120-150KB |
| Items.pak | 摊位物品图标 | 1.5-2MB |
| Dialog.pak | 按钮交互元素 | 800-900KB |


- 使用WIL编辑器打开`MyShop.pak`，确认第5-8帧包含"摆摊按钮按下"动画

2. **登录器内核调试**
- 在登录器配置器中启用 **"调试模式"** ，生成DEBUG版登录器
- 运行后按`Ctrl+~`打开控制台，观察点击摆摊时的协议反馈：
```
[NET] C->S 摆摊请求: MAP=3 | X=330 | Y=268
[NET] S->C 响应代码: 200 OK
```

- 若出现"协议未响应"，需检查防火墙或端口映射

---

#### 三、进阶问题排查方案

##### **场景1：脚本正常但按钮无响应**
- **现象**：点击摆摊按钮无任何协议交互
- **解决方案**：
1. 检查`UI界面编辑器`中的按钮热区设置，确认"摆摊按钮"的鼠标响应区域覆盖实际位置
2. 在`NewopUI.pak`中替换第120-123号素材，修复破损的按钮动画
3. 使用**封包嗅探工具**（如WPE）检测点击事件是否生成CALL指令

##### **场景2：间歇性摆摊失效**
- **现象**：部分玩家可正常摆摊，部分玩家点击无反应
- **解决方案**：
1. 在M2控制台执行 **"@CLEARSHOPLOCK"** 清除摆摊缓存锁
2. 检查`!Setup.txt`中的摆摊数据存储路径是否具有写权限
```
[Share]
ShopDir=D:\MirServer\Mir200\ShopData\
```

3. 使用**磁盘错误修复工具**检查存储介质坏道

##### **场景3：摆摊后物品复制漏洞**
- **现象**：关闭摊位时物品异常复制
- **根治方案**：
1. 在`QManage.txt`中添加下线触发清理：
```
[@离线触发]
#ACT
CLEARMYSHOPITEMS
CLEARSHOPSTALL
```

2. 修改`游戏网关(RunGate)`的封包校验强度至LEVEL=3

---

#### 四、长效优化建议
1. **脚本容错增强**
- 在摆摊主流程添加异常捕获：
```
#IF
CHECKVAR GLOBAL SHOP_CRASH > 0
#ACT
CALCVAR GLOBAL SHOP_CRASH = 0
GMEXECUTE 超级复活 SELF
```


2. **多地图摆摊体系**
- 在`MapInfo.txt`中扩展摆摊专区：
```
[D515 摆摊广场] FIGHT NORECALL MYSHOP ALLOWUSEMYSHOP TING
;TING参数允许摆摊喊话
```


3. **摆摊数据分析**
- 通过`LogData`目录下的摆摊日志生成热力图：
```
TYPE=SHOP_LOG
TIME=2025-03-10
MAP_X=330 | MAP_Y=268 | ITEM=屠龙 | COUNT=3
```


通过上述方案，可系统性解决Hero引擎摆摊功能失效问题。建议优先执行**脚本逻辑重构**与**地图参数重载**，90%以上同类问题可通过这两步修复。若仍存在异常，需结合封包分析工具进行深度追踪。