篇二 · 目录总览（全景）

1.〔篇二〕目录总览：哪些是系统、哪些是内容

根目录全部顶层文件夹/文件如下，按”能不能改、改了影响什么”分 5 类。加新内容去”内容层/资源层”建文件；改规则/机制去”系统层/框架层”；运维/文案去 adm/etc/、help/、news/、gift/。

1.1 框架层（⚠️不要直接改，用继承+覆盖扩展）

目录/文件	说明
`mudcore/`	MudCore 底层框架（master/simul_efun/登录/玩家基类）。改错全服崩。

1.2 系统代码层（改规则/机制来这）

目录	说明
`include/`	全局头文件 `.h`，`globals.h` 是全局地图，先读它。
`feature/`	可继承功能片段 F_*（attribute/skill/save/combat 等）。
`inherit/`	可继承基础类（char/item/skill/room 等）。
`adm/`	管理与核心服务总根：`daemons/`(守护进程)、`simul_efun/`、`single/`(master)、`etc/`(配置)、`go-cqhttp/`(QQ)、`item/`(装备模板)、`npc/`(系统NPC)、`socket/`(预留)。详见第36节。
`cmds/`	玩家/管理员指令实现（std/usr/skill/chat/adm/wiz…）。

1.3 内容数据层（加新武功/物品/任务/房间来这，建文件即可）

目录	说明
`clone/`	可克隆实例：武器/防具/物品/NPC/货币/`user/user.c`(玩家)、`user/login.c`(登录)。
`kungfu/`	武功/内功/状态：`kungfu/skill/` 3800+ 武功文件。
`obj/`	少量特殊物品。
`quest/`	任务实例（176+）；`newbiequest/` 是新手任务。
`fuben/`	副本/活动。
`maze/`	迷宫基类与实例。
`worldmap/`	世界地图。
`d/`	游戏世界房间（各门派城市），兼玩家存档 `/d/user/X/角色名.o`、`/d/login/` 登录档。
`u/`	杂项对象/NPC。

1.4 运行期资源 / 数据（文本与配置，多数不用编译）

目录	说明	改了动哪
`adm/etc/`	主配置 `config`、预加载 `preload`、欢迎/公告、封禁、wizlist、字体/副本/自然数据	运维参数（见第36.2）
`help/`	游戏内 `help` 文本库（`activity/book/skills/newbie/pay/tit…` + 城市地图 `map_*`、`faq`、`channels` 等）	玩家看到的帮助/地图说明
`news/`	新闻/公告文本（`baodian/item/jingmai/shenbing/youxi…`）	游戏内新闻滚动
`gift/`	礼包定义（如 `sword.c` 登录/活动礼包）	礼包内容
`shadow/`	分身系统（`no_init.c`/`telnet.c`）	分身/影子机制
`date/`	运行期数据目录（当前为空，预留外部数据落地）	—

1.5 外部接口 / 顶层文件

目录/文件	说明
`www/`	Web 根（`mudh.html`），外网/统计页面（与 `mud_web/` 同源）。
`driver.exe`	驱动（运行核心）。
`lpcc.exe`	LPC 编译器（加载时编译 .c）。
`startlib.bat`	启动脚本。
`config.ini`	驱动运行配置（区别于 `adm/etc/config` 的游戏配置）。

记法：改”规则/公式/机制”→ feature/、inherit/、adm/daemons/、include/；加”新武功/新物品/新任务”→ 在 kungfu/、clone/、quest/ 里新建文件；运维/文案→ adm/etc/、help/、news/、gift/。