传奇卧龙山庄配置教程 Hero1地图代码NPC脚本神秘宝藏完整设置
在传奇版本搭建与改版中，卧龙山庄是玩家认可度极高的特色打宝地图，依托独立Hero1地图架构，整合卧龙古书收集、动态书页特效、神秘宝藏掉落、火龙宝藏进阶玩法等核心功能。针对传奇GM日常版本调试需求，本文系统化整理卧龙山庄配置全套方案，涵盖Hero1地图基础参数、小地图资源配置、宝藏NPC触发命令、Me…
在传奇版本搭建与改版中，卧龙山庄是玩家认可度极高的特色打宝地图，依托独立Hero1地图架构，整合卧龙古书收集、动态书页特效、神秘宝藏掉落、火龙宝藏进阶玩法等核心功能。针对传奇GM日常版本调试需求，本文系统化整理卧龙山庄配置全套方案，涵盖Hero1地图基础参数、小地图资源配置、宝藏NPC触发命令、MerChant.txt点位脚本、等级准入脚本等核心内容，所有代码均可直接复制到服务端部署，快速完成卧龙山庄地图上线调试工作。
一、卧龙山庄基础地图参数配置
地图基础参数是卧龙山庄正常加载、客户端界面正常显示的核心前提，参数配置错误，极易引发地图黑屏、小地图不加载、NPC坐标传送失效、宝藏点位不刷新等常见BUG，下面为经过实测的全套Hero1地图参数配置详情：
1.1 主地图代码
卧龙山庄专属主地图唯一标识代码为：Hero1。该代码为全局核心识别参数，整张地图内所有NPC坐标点位、地图传送脚本、宝藏触发坐标、五色卧龙古书点位均绑定Hero1地图标识。GM配置服务端文件时，必须保证所有关联文件地图代码统一，否则会出现NPC隐形、传送坐标偏移、宝藏无法交互等运行故障。
1.2 小地图资源代码
卧龙山庄支持两种小地图资源编码，GM可根据客户端资源文件选择适配参数：
通用编码：302 客户端定向编码：5001（绑定客户端路径 Data\minimap\302.mmap，使用该编码时需确保客户端对应路径下存在mmap资源文件，否则小地图空白）
二、神秘宝藏NPC开启命令配置
卧龙山庄内的两大核心玩法：神秘宝藏与火龙宝藏，依靠专属NPC指令触发开启逻辑。该指令联动服务端Boxs资源目录下的文本文件读取奖励数据，是传奇版本定制宝藏玩法的核心配置项，精准配置可有效规避宝藏开启报错、奖励为空等问题，具体配置规范如下：
2.1 基础命令格式
命令语法：OpenDragonBox 宝箱Source值
功能释义：调用版本Boxs目录下对应序号的txt资源文件，完成宝藏奖励读取与发放。
2.2 文件调用规则
资源文件范围：支持0-255序号的txt文件，命名格式为【数字.txt】。
前置依赖要求：如需开启50.txt，必须保证Boxs文件夹内存在0-49.txt全部前置文件，缺失任意前置文件都会导致宝藏开启失败、脚本报错 。
应用场景：该命令适用于卧龙山庄内所有神秘宝藏、火龙宝藏的奖励调取配置。
三、MerChant.txt卧龙山庄NPC完整配置
MerChant.txt是传奇服务端核心NPC注册配置文件，决定地图内NPC、道具点位、交互对象的生成位置与功能属性。下文为适配Hero1地图的卧龙山庄专属完整配置条目，整合了基础功能NPC、五色卧龙古书、多层级空宝箱、火龙宝藏及神秘宝藏点位，参数经过实测校验，GM可直接导入重载，无需二次修改坐标与权限参数。
卧龙/仓库 0135A 7 7 仓库管理员 0 6 0 0 0
卧龙/小贩 0131A 6 11 小贩 0 3 0 0 0
卧龙/小贩 0135B 7 6 小贩 0 3 0 0 0
卧龙/卧龙笔记 3 326 341 卧龙笔记 0 70 0
卧龙/橙色卧龙古书 HERO1 63 185 橙色卧龙古书 0 71 0
卧龙/红色卧龙古书 HERO1 192 191 红色卧龙古书 0 72 0
卧龙/黄色卧龙古书 HERO1 89 141 黄色卧龙古书 0 73 0
卧龙/绿色卧龙古书 HERO1 147 90 绿色卧龙古书 0 74 0
卧龙/蓝色卧龙古书 HERO1 219 59 蓝色卧龙古书 0 75 0
卧龙/空宝箱 HERO1 56 41 33 0 91 0 0 0 0 1
卧龙/空宝箱 HERO1 57 40 44 0 91 0 0 0 0 1
卧龙/空宝箱 HERO1 58 39 55 0 91 0 0 0 0 1
卧龙/空宝箱 HERO1 59 38 66 0 91 0 0 0 0 1
卧龙/空宝箱 HERO1 60 37 77 0 91 0 0 0 0 1
卧龙/空宝箱 HERO1 61 36 88 0 91 0 0 0 0 1
卧龙/空宝箱 HERO1 58 41 88 0 91 0 0 0 0 1
卧龙/空宝箱 HERO1 58 40 88 0 92 0 0 0 0 1
卧龙/空宝箱 HERO1 59 39 88 0 92 0 0 0 0 1
卧龙/空宝箱 HERO1 60 38 88 0 92 0 0 0 0 1
卧龙/空宝箱 HERO1 61 36 88 0 92 0 0 0 0 1
卧龙/空宝箱 HERO1 57 43 99 0 92 0 0 0 0 1
卧龙/空宝箱 HERO1 56 43 11 0 90 0 0 0 0 1
卧龙/空宝箱 HERO1 55 42 22 0 90 0 0 0 0 1
卧龙/空宝箱 HERO1 59 41 22 0 90 0 0 0 0 1
卧龙/空宝箱 HERO1 61 40 22 0 90 0 0 0 0 1
卧龙/空宝箱 HERO1 62 38 22 0 90 0 0 0 0 1
卧龙/火龙宝藏 HERO1 61 44 火龙宝藏 2 66 0 0 0 0 1
卧龙/火龙宝藏 HERO1 62 43 火龙宝藏 3 65 0 0 0 0 1
卧龙/火龙宝藏 HERO1 64 42 火龙宝藏 3 65 0 0 0 0 1
卧龙/火龙宝藏 HERO1 60 46 火龙宝藏 3 65 0 0 0 0 1
卧龙/神秘宝藏 HERO1 63 45 神秘宝藏 3 62 0 0 0 0 1
3.1 配置说明
功能NPC：包含仓库管理员、移动小贩，满足玩家在卧龙山庄内的储物、道具交易基础需求。
古书点位：五种颜色卧龙古书分布在Hero1地图不同坐标，为书页收集、属性解锁玩法提供点位支撑。
宝箱点位：区分空宝箱、火龙宝藏、神秘宝藏三类资源点位，通过不同参数区分掉落权重与奖励等级。
四、卧龙山庄书页显示功能脚本配置
卧龙书页是玩家解锁、进入卧龙山庄的前置专属道具，OPENBOOKS是HERO引擎专属功能指令，主要用于在客户端展示卧龙书页、卧龙笔迹的动态特效，同时联动后台完成玩家准入权限校验，是衔接道具与地图准入的关键功能配置。
4.1 功能指令格式
指令语法：OPENBOOKS 序号(0--5)
4.2 指令参数释义
参数0：对应基础卧龙书页显示效果 参数1-5：对应不同类型卧龙笔迹显示效果
五、卧龙笔记准入权限脚本（卧龙笔记-3.txt）
卧龙笔记NPC绑定的准入脚本（卧龙笔记-3.txt），是管控玩家进入Hero1卧龙山庄的核心权限文件。脚本内置等级门槛判定、书页特效唤起、定点地图传送三大核心逻辑，文件缺失、代码错误会直接导致卧龙山庄入口失效，下面提供可直接部署的原版完整脚本：
#IF
CheckLevelEx > 39
#ACT
OPENBOOKS 0
#ELSESAY
40级以上玩家才可以进入卧龙山庄.
[@HeroMap]
#IF
#ACT
MAPMOVE HERO1 215 206
Give 回城卷 1
5.1 脚本核心说明
等级限制：通过CheckLevelEx指令判定，仅40级及以上玩家可触发书页显示与地图进入权限。
书页联动：权限校验通过后调用OPENBOOKS 0，展示卧龙书页专属特效。
传送逻辑：内置[@HeroMap]段，点击进入后自动传送到Hero1地图215,206坐标，并自动赠送回城卷，优化玩家体验。
关键提示：玩家点击进入卧龙山庄时，系统会强制调用该NPC脚本中的@HeroMap跳转段，请勿删除该段落代码。
六、卧龙山庄部署避坑注意事项
客户端资源校验：使用5001小地图代码时，务必核对Data\minimap目录下302.mmap文件完整性，避免小地图缺失。
宝藏文件排序：配置神秘宝藏时，严格遵循前置txt文件排序规则，防止OpenDragonBox命令执行报错。
脚本编码统一：所有卧龙相关脚本建议采用ANSI编码，避免传奇引擎读取中文乱码。
坐标参数核对：导入MerChant.txt配置后，可在引擎内重载NPC数据，校验古书、宝箱坐标无重叠错位。
