传奇版本全目录详解 HGEM2引擎架设核心文件配置教程

在传奇服务器架设、版本修改、功能定制过程中，版本目录结构是新手入门的核心基础。弄懂传奇服务端各文件夹、配置文件的作用，才能精准修改怪物爆率、行会师门、NPC脚本、Lua功能等核心内容。本文基于HGEM2引擎，完整拆解传奇服务端全套目录架构，涵盖网关目录、核心数据库、Mir200运行目录及各类配置文件…

在传奇服务器架设、版本修改、功能定制过程中，版本目录结构是新手入门的核心基础。弄懂传奇服务端各文件夹、配置文件的作用，才能精准修改怪物爆率、行会师门、NPC脚本、Lua功能等核心内容。本文基于HGEM2引擎，完整拆解传奇服务端全套目录架构，涵盖网关目录、核心数据库、Mir200运行目录及各类配置文件，帮助开服玩家快速掌握版本调试逻辑。

一、服务端外层网关目录（基础通信层）

外层目录主要负责传奇客户端与服务端、引擎与数据库之间的数据通信，是服务器正常联网、数据交互的基础，六大核心网关目录功能分工明确：

1. LoginGate目录：登录网关

承担客户端登录请求接收、账号验证、网络转发功能，是玩家接入服务器的第一道通信节点，决定登录稳定性与防拦截能力。

2. SelGate目录：角色网关

专注角色相关数据传输，包括角色创建、删除、角色信息加载、职业数据同步，管控玩家进入游戏角色选择界面的全部流程。

3. RunGate目录：游戏网关

核心交互网关，直接与M2Server.exe主引擎、游戏登录器进行双向数据交互，处理游戏内移动、攻击、交易、聊天等实时行为数据，是游戏运行的核心通信枢纽。

4. LoginSrv目录：账号数据存储

专门存储玩家注册账号、密码、登录权限、封禁状态等基础账号数据，独立于角色数据，仅负责账号层级的数据管理。

5. DBServer目录：玩家数据存储

存储玩家角色核心数据，包含等级、装备、背包、元宝、属性点、任务进度等，是角色存档的核心数据库目录，数据改动直接影响玩家游戏角色状态。

6. LogServer目录：玩家游戏日志存储

全程记录服务器运行期间的玩家行为日志，涵盖登录记录、物品获取、交易流水、死亡记录、GM操作记录等，用于数据溯源、故障排查与风控管理。

二、Mud2\DB核心数据库目录（数据底层层）

Mud2\DB\ 为传奇版本★核心数据库目录★，是整个引擎的数据底层支撑，所有游戏基础属性均由此目录文件定义：

└── HGEM2.DB：集成物品数据库、怪物数据库、技能数据库、称号数据库四大核心模块

该文件管控游戏内所有基础属性，包括物品重量、攻击属性、怪物血量、技能伤害、称号加成等，所有数值修改都需基于该数据库文件调整，是版本属性定制的核心载体。

三、Mir200主运行目录（引擎核心层）

Mir200是HGEM2引擎的主运行目录，包含引擎启动、功能配置、脚本执行、资源加载的全部核心文件，下设多个子目录与配置文件，是版本修改的主要操作区域。

3.1 功能模块子目录

3.1.1 Arena\ 竞技场配置目录

管控游戏内竞技场玩法的全部配置，目录核心文件及结构：

├── List.txt：竞技场列表配置文件，定义所有竞技场的名称、地图、准入规则

└── 二级子目录：存放每个独立竞技场的地图参数、积分规则、对战奖励等专属配置

3.1.2 Castle\ 城堡配置目录

对应传奇沙巴克城堡系统，管控攻城战、城堡权限、城池奖励等核心玩法：

├── List.txt：城堡列表文件，配置城池数量、归属地图、攻城时间规则

└── 二级子目录：单个城堡的守卫配置、税收比例、城主专属权限配置

3.1.3 DivisionDir\ 师门配置目录

负责师徒、师门系统全功能配置，解决拜师、出师、师门福利等逻辑：

├── ApplyDivisionList.txt：玩家入师门申请名单存档，自动记录待审核申请

├── DivisionList.txt：全服师门名称、掌门、成员数量汇总列表

└── Divisions\：各师门专属配置目录，存放师门等级、buff加成、专属道具等数据

3.1.4 GuildBase\ 行会配置目录

传奇行会系统核心目录，管控行会创建、成员管理、行会任务、攻城权限：

├── ApplyGuild.txt：玩家加入行会的申请名单，供会长审核调用

├── GuildList.txt：全服所有行会名称、等级、掌门信息汇总列表

└── Guilds\：单个行会的专属存档目录，包含行会资金、功勋、职位权限等数据

3.1.5 Log\ 引擎日志目录

实时记录引擎运行期间的报错信息、脚本执行日志、数据加载记录，架设调试时可通过该目录日志快速定位卡顿、报错、脚本失效等问题。

3.1.6 LuaScripts\ Lua脚本目录

传奇自定义功能开发核心目录，通过Lua脚本实现原生引擎没有的拓展功能，目录结构层级清晰：

├── main.lua：Lua脚本总初始文件，引擎启动时优先加载，管控所有脚本的启动顺序

├── System\ Lua核心功能脚本目录

│ ├── CommonFun.lua：通用函数单元，提供全脚本可调用的基础工具函数

│ ├── config.lua：全局变量配置，自定义功能的开关、数值阈值统一在此设置

│ ├── const.lua：常量单元，固定不可修改的游戏常量参数定义

│ ├── init.lua：引擎回调事件绑定，关联引擎原生事件与自定义脚本

│ ├── BindEvent.lua：引擎回调事件核心实现，处理登录、死亡、升级等基础事件

│ ├── bindNetMsg.Lua：自定义网络消息实现，拓展客户端与服务端专属通信指令

│ ├── Buff.Lua：BUFF事件管控，实现时效buff、永久buff、增减益效果逻辑

│ ├── MonBurstItem.Lua：怪物死亡爆率拓展控制，补充数据库无法实现的动态爆率规则

│ └── skill.Lua：自定义技能回调，制作专属被动技能、组合技能等拓展玩法

└── QuestDiary\：Lua脚本数据存档目录，存放脚本运行产生的玩家专属数据

3.1.7 Map\ 游戏地图数据目录

存放传奇所有地图的核心数据文件，包含地图地形、障碍物、通行权限、资源加载信息，客户端地图资源需与该目录数据一一对应。

3.1.8 Notice\ 公告配置目录

管控游戏内所有公告、提示信息的推送规则，无需修改脚本即可调整公告内容：

├── HangAutoMsg.txt：离线挂机角色自动回复信息配置，设置挂机时私聊自动回复话术

├── LineNotice.txt：游戏内滚动定时广告，设置全服轮播提示、活动公告

└── Notice.txt：玩家进入游戏弹窗公告，用于版本公告、活动通知、规则提示

3.2 Mir200根目录核心配置文件

该层级文件直接管控引擎基础参数、GM权限、物品规则等全局设置，是开服基础配置的重点：

!Setup.txt：引擎核心参数保存文件，包含服务器名称、爆率倍率、经验倍率、登录限制等全局参数

BuyItemList.txt：游戏商铺配置文件，定义商城售卖物品、价格、限购数量

CheckItemList.txt：物品规则校验文件，设置物品穿戴条件、使用限制、绑定规则前置校验

Command.ini：GM命令定义文件，自定义GM指令权限、指令格式、可执行范围

GlobalVal.ini：全局变量存储文件，存放全服通用的A类、G类全局变量数据

MsgFilterList.txt：聊天消息过滤配置，屏蔽违规关键词、敏感话术

MsgList.txt：在线消息窗口数据文件，保存玩家通过内置窗口发送的聊天记录

PlugList.txt：引擎插件加载列表，管控第三方插件的启用、禁用、加载顺序

String.ini：游戏内置提示信息定义，修改系统弹窗、提示文字的展示内容

UserCmd.txt：基础自定义命令文件，配置玩家可触发的简易自定义指令

四、Envir环境配置目录（玩法定制层）

Envir目录是传奇版本玩法定制的核心区域，宝箱、怪物爆率、NPC脚本、地图事件、假人系统等所有个性化配置均集中于此，是版本修改最常用的目录。

4.1 道具与自定义配置子目录

4.1.1 Boxs\ 宝箱配置目录

管控游戏内宝箱、礼盒类道具的掉落与开启规则：

├── BoxsList.txt：宝箱基础配置，定义宝箱名称、获取途径、开启条件

└── 附属配置文件：单独设置每个宝箱的掉落物品、概率、保底奖励

4.1.2 Custom\ 自定义核心配置目录

用于脱离原生引擎，自定义NPC、技能、物品等拓展内容，是定制专属版本的关键：

├── NPC\：自定义NPC目录，存放非原生功能的专属NPC脚本与配置

├── Skill\：自定义技能目录，配置Lua联动的专属主动/被动技能

├── UseItem\：自定义物品核心目录

│ ├── ItemSkill.ini：物品编号绑定技能配置，实现装备触发技能、道具释放技能效果

│ └── UseItems.ini：自定义装备位配置，拓展专属装备槽、特殊穿戴位置

4.1.3 CustomMonster\ 自定义怪物目录

存放自定义外观、属性、AI的专属怪物配置，区别于DB原生怪物，可设置特殊攻击模式、追击逻辑。

4.2 脚本与交易核心目录

4.2.1 MapQuest_Def\ 地图事件触发器

实现地图踩点触发、进入地图弹窗、坐标范围事件等逻辑，是地图玩法定制核心：

├── QManage.txt：全局登录脚本文件，玩家登录游戏瞬间触发的所有事件集中配置于此

├── 3.txt：盟重土城地图事件文件，管控土城范围内的踩点、区域buff、禁止区域等规则

└── D401.txt：通用地图事件模板，格式规范为[坐标X] [坐标Y] [范围] @触发标签，适配所有地图

4.2.2 Market_Def\ ★交易NPC商人脚本中心★

全服所有交易类NPC的脚本存储核心，遵循标准化命名规则，管理对话、商店、任务全逻辑：

├── 命名规则：[NPC名称]-[地图ID].txt，快速定位不同地图的同名NPC

├── 功能包含：#SAY对话弹窗、@buy购买商店、任务交接、道具回收等核心指令逻辑

└── 独立文件：每个NPC拥有专属脚本文件，互不干扰，修改精准度更高

4.2.3 Market系列附属目录

Market_Prices：NPC商品价格存档目录，记录玩家修改后的自定义售价

Market_Saved：NPC玩家在售物品存档，摆摊、寄售物品数据集中存储

Market_Upg：NPC武器升级参数目录，管控武器强化、升级成功率、属性加成

4.3 怪物与战斗配置目录

4.3.1 MonItems\ ★怪物爆率配置★

传奇爆率修改的核心目录，所有怪物的物品掉落规则在此定义，文件与数据库强关联：

├── 命名要求：文件名必须与Monster.DB数据库内怪物名称完全一致，大小写敏感

├── 配置格式：1/100 屠龙刀，代表该怪物有1%概率掉落屠龙刀

├── 示例文件：白野猪.txt、祖玛教主.txt，分别对应对应怪物的专属掉落清单

4.3.2 MonUseItems\ 人形怪配置目录

专门管控人形怪物的装备穿戴、技能释放、掉落专属物品等个性化配置，适配法师、战士类人形怪AI逻辑。

4.4 管理与数据存储目录

4.4.1 Npc_Def\ ★管理NPC脚本目录★

区别于交易NPC，该目录存放系统管理类NPC脚本，包含转职、回收、传送、福利领取等功能型NPC逻辑。

4.4.2 PetsMon\ 宠物数据目录

存储玩家宠物、英雄的喂养数据、等级经验、技能熟练度、属性加成等存档信息。

4.4.3 Point\ 固定移动点配置

设置指定地图的固定传送点、挂机定点、安全区坐标，文件以地图ID命名，格式为X,Y坐标参数。

4.4.4 QuestDiary\ 任务数据目录

存储玩家任务进度与变量数据：

├── 主线任务/：全服玩家主线任务进度存档，防止重置进度

└── 个人变量.txt：玩家专属任务变量，记录任务领取状态、道具交付进度

4.4.5 Robot_def\ 机器人脚本目录

实现定时任务、全服活动、自动功能的核心脚本目录，分为全局与个人两类：

├── AutoRunRobot.txt：全局机器人脚本，全服统一执行的定时活动、刷新任务

├── AutoPalyRun.txt：个人机器人脚本，针对单个玩家触发的挂机、离线任务

└── RobotManage.txt：机器人总控文件，管控所有脚本的启停、执行间隔

4.4.6 UserData\ 角色数据存储目录

精细化存储玩家角色的细分数据，包含外观、羁绊、存档变量等DBServer未涵盖的拓展数据。

4.5 Envir根目录核心配置文件

此类文件覆盖权限管控、封禁规则、物品属性、地图参数、风控规则等全局配置，是服务器安全与规则设置的关键：

AdminList.txt：GM管理员账号名单，每行单个账号，区分大小写，授权后台与游戏内GM权限

AICharNameList.txt/AIHeroNameList.txt：假人角色、英雄名称列表，控制服务器假人命名池

AllowAIPickUpItemList.txt：假人捡取物品白名单，设置假人可拾取、禁止拾取的物品

AutoAddExpPlay.txt：玩家挂机经验配置，从DBServer导出，管控挂机经验获取规则

AutoFindRout.txt：怪物自动寻路配置，设置166版本怪物的行走目标点与路径规则

ClientRes.txt：客户端资源关联文件，绑定资源名称与编号，同步客户端与服务端素材

Deny系列文件：分别管控账号封禁、角色名禁用、IP封禁、聊天禁言的黑名单列表

ItemBind系列文件：覆盖账号绑定、人物绑定、IP绑定、死亡不爆等物品绑定规则

ItemsCompose/ItemsDecompose.txt：物品合成与拆解配置，设置合成配方、成功率、消耗材料

MapInfo.txt：地图核心配置，示例格式[H001 赤月巢穴] DARK NORECALL，定义地图光照、是否允许回城

MonGen.txt：全局刷怪配置，格式为地图 X Y 怪物名 范围 数量 间隔，管控全服怪物刷新规则

RecoverItem.txt：游戏物品回收列表，定义NPC回收道具的价格、回收条件

StartPoint.txt：角色回城点配置，设置不同地图、不同权限玩家的默认复活/回城坐标

SuitItemList.txt：套装装备属性配置，定义套装集齐后的加成效果、触发buff

封禁功能文件：包含禁止制造、禁止移动地图、禁止取下物品、禁止改名等风控配置

羁绊记录文件：管控离婚、出师、护花使者、龙卫回收等社交系统数据记录

DigJewelItem.txt：挖宝活动配置文件，定义挖宝坐标、产出道具、挖掘消耗与概率权重

DisableGamePointShopItemList.txt：禁止荣耀点购买物品列表，限制指定道具无法通过荣耀点商城兑换

DisableMakeItem.txt：禁止制造物品列表，拦截玩家通过合成、锻造功能制作指定装备道具

DisableMoveMap.txt：禁止移动地图列表，设置角色、假人无法进入的封禁地图ID

DisableSendMsgList.txt：禁言关联名称列表，指定无法发送公屏、私聊的角色名称

DisableSteelRename.txt：神兵改名禁止字符列表，过滤神兵重命名时的违规符号、敏感字词

DisableTakeOffList.txt：禁止取下物品列表，设置绑定装备、专属道具无法主动卸下

DominatSendPoint.txt：主宰令传送配置，定义主宰令道具对应的传送坐标、冷却时间与权限

EnableArmsExchangeItem.txt：装备兑换碎片列表，允许指定武器碎片、神器材料进行合成兑换

EnableLimitItem.txt：限时物品管控列表，设置时效道具的过期规则、自动清除逻辑

EnableMakeItem.txt：允许炼制物品列表，定义可通过熔炉、锻造系统炼制的装备与材料

FireDragonGuard.txt：火龙守护兽配置文件，管控守护兽属性、召唤条件、存续时长与攻击AI

GameLogItemNameList.txt：日志追踪物品名单，指定需要全程记录获取、掉落、交易轨迹的核心道具

GuardList.txt：地图守卫配置，包含大刀卫士、弓箭手的坐标、朝向、攻击范围与警戒规则

ICons.txt：顶戴花翎外观配置，定义称号头饰、顶戴素材、显示层级与属性加成

ItemBindAccount.txt：账号绑定物品配置，道具拾取后强制绑定当前账号，不可交易流转

ItemBindChrName.txt：人物专属绑定表，道具仅绑定获取角色，同账号其他角色无法穿戴使用

ItemBindDieNoDropName.txt：死亡不掉落物品清单，列表内装备道具角色死亡时不会掉落

ItemBindIPaddr.txt：IP绑定物品配置，道具限定固定IP地址登录角色才可穿戴生效

ItemDblClickList.txt：双击物品事件列表，配置道具双击触发弹窗、buff、传送、奖励等脚本事件

ItemEffect.txt：物品特效参数文件，精细化调整道具发光、环绕、残影等特效数值

ItemEffectList.txt：全局物品特效清单，统一管理所有装备、道具的可视化特效开关

ItemNameList.txt：自定义物品名称库，修改原生道具名称、添加专属后缀、极品标识

ItemNoToBag.txt：禁止自动入包物品列表，指定道具击杀掉落之后需手动拾取，不自动进背包

ItemSmeltEffectList.txt：熔炼特效配置，装备熔炼成功/失败时的弹窗特效、光效提示配置

MakeItem.txt：高阶炼制配方文件，设置神器、专属装备的炼制材料、成功率、保底机制

MapEffectConfig.txt：地图场景效果配置，配置地图昼夜光影、雾气、火焰、雨雪等环境特效

MapEffectEvent.txt：场景特效触发逻辑，进入指定地图自动触发环境buff、音效、视觉效果

MapEvent.txt：全局地图事件总控，统一管理全图禁止PK、禁止回城、区域回血等被动事件

MapQuest.txt：地图任务关联文件，绑定地图区域与专属任务，进图自动接取、交付任务

MerChant.txt：全局商人NPC注册文件，登记所有商店NPC的地图坐标、外观模型、基础权限

MiniMap.txt：小地图资源关联，绑定地图ID与客户端BMP小地图图片，修正小地图黑屏、错位问题

MonDropLimitList.txt：怪物爆率限制表，限制单怪最高掉落数量、极品掉落上限，防止版本通货膨胀

MonSayMsg.txt：怪物自定义喊话列表，设置怪物巡逻、攻击、死亡时触发的公屏/私聊台词

NoClearMonList.txt：禁止清理怪物列表，指定BOSS、专属怪物不会被引擎定时清理机制移除

NotClearBagItem.txt：地面物品保护列表，列表内道具不会被定时清理脚本清除，延长地面留存时间

NpcGiveItems.txt：NPC专属掉落文件，配合NPCGIVEITEM指令，设置NPC击杀后专属奖励掉落清单

Npcs.txt：全局NPC注册配置，管控所有NPC的模型、血量、可攻击状态、是否可移动基础属性

ReallyCompose.txt：高阶物品合成配置，区别于普通合成，用于神器、套装的进阶合成规则

RecoverItem.txt：分级回收配置，细化普通、极品、强化装备的回收元宝、积分比例

RefineItem.txt：装备淬炼系统文件，定义淬炼等级、成功率、掉级规则、淬炼属性区间

Robot.txt：机器人总控配置，定义机器人类型、执行脚本、运行间隔、白名单地图范围

SmeltItemList.txt：神兵熔炼清单，设置神兵分解、熔炼材料产出、熔炼保底积分规则

UnbindList.txt：道具解绑配置，定义可解绑物品、解绑消耗道具、解绑冷却时间

UnComrade.txt：龙卫羁绊解除记录，存储玩家龙卫关系解除后的权限、道具回收记录

UnForceMaster.txt：强行出师存档，记录强制出师的师徒ID、冷却时间、惩罚机制

UnHuHua.txt：护花使者称号回收记录，解除羁绊后称号回收、属性失效存档数据

UnMarry.txt：强制离婚配置记录，管控强制离婚的元宝消耗、亲密度清除、夫妻道具回收规则

UnMaster.txt：正常出师记录表，存储合规出师的师徒奖励发放、技能保留状态数据

UserCmd.txt：Envir层级自定义命令，拓展玩家、GM在环境层触发的专属指令权限

五、总结

本次拆解的HGEM2引擎传奇版本目录，从外层网关通信、底层核心数据库，到Mir200运行内核、Envir玩法配置，形成了完整的层级架构。新手架设传奇服务器时，可按照「网关调试→数据库修改→基础配置→脚本定制→风控设置」的顺序操作，精准定位对应目录文件，高效完成版本修改、bug排查、功能拓展。熟练掌握各目录功能后，可快速定制怪物爆率、行会师门、Lua专属功能、NPC脚本等个性化内容，提升传奇服务器的可玩性与稳定性。