炎黄群侠传MUD

炎黄MUD utf-8 版，推荐使用 FluffOS UTF8版驱动。

• 游戏驱动下载：https://bbs.mud.ren/threads/4
• 线上游戏体验：https://mud.ren:8888/

LIB说明

本游戏为侠客行类文字MUD游戏，底层为炎黄2003，LIB代码有大量借鉴国内优秀的LIB，开源在此方便对MUD游戏感兴趣的玩家。

启动说明

游戏集成了mudcore框架，请使用以下指令下载源码：

# 从github安装（国外推荐）
git clone --recurse-submodules https://github.com/oiuv/mud.git
# 从gitee 安装（国内推荐）
git clone --recurse-submodules https://gitee.com/mudren/mud.git

如果你已经直接clone了项目，请使用以下指令更新子模块：

git submodule update --init

提示：国内用户mudcore子模块可使用gitee镜像地址

• https://gitee.com/mudcore/mudcore.git

环境配置

请把data目录中的.env.example复制为.env，并根据需要修改环境配置。

Windows 编译驱动

在 MSYS2 MinGW64 终端中执行：

bash build_msys2.sh

脚本默认更新 MSYS2、安装依赖，对独立的 fluffos/ 仓库执行 git checkout -- . 恢复已跟踪文件，再通过 git pull --ff-only 更新源码。构建启用 CRYPTO（提供 hash）和 SQLite，生成静态 EXE；成功后复制到项目 bin/，复制前会检查本项目的驱动和编译工具是否仍在运行。

MSYS2 核心升级若要求关闭终端，重新打开 MinGW64 终端后再次执行脚本。已有源码和依赖时，可以跳过更新，只编译验证：

BUILD_JOBS=4 bash build_msys2.sh --local --no-install
bash build_msys2.sh --help

--local 跳过软件包及源码更新；--no-install 保留当前项目的驱动，产物位于 fluffos/build-msys2/bin/。脚本可从其他目录使用完整路径调用，构建目录始终位于项目内。

Docker 部署

先启动 Docker 引擎，在 Linux Bash 或 Windows 的 MSYS2 Bash 中执行：

bash docker.build.sh
bash docker.run.sh start
bash docker.run.sh status
bash docker.run.sh logs
bash docker.run.sh stop

构建脚本默认恢复并更新 FluffOS 官方源码；bash docker.build.sh --local 使用本地已提交的版本（HEAD），跳过源码更新。构建通过 git archive 直接使用该版本自带的 Dockerfile，排除本地未提交文件和宿主机编译产物。

镜像完全使用 FluffOS 官方 Dockerfile 和默认功能。启动脚本在运行时设置工作目录及健康检查；不修改驱动源码、Dockerfile 或宿主机的 fluffos/build/。

启动脚本可从任意目录调用，容器名称根据项目路径生成。游戏目录挂载到 /opt/mud，使用 docker.config.cfg；首次启动补齐缺失的 data/.env，日志写入项目 log/。默认映射宿主机 5566（GBK）、6666（UTF-8）和 8080（网页/WebSocket）。网页地址为 http://localhost:8080/；网页客户端中请选择 ws://、实际服务器地址和端口 8080。

start 默认后台运行，等待健康检查通过后启用自动重启；启动失败时保留容器日志；stop 停止容器并保留日志；restart 重新创建容器以应用新镜像。run 前台运行，按 Ctrl+C 停止游戏；logs 持续跟踪输出，退出查看不影响游戏。status 在运行时返回 0，未运行时返回 3。

宿主机已有游戏占用默认端口时，可以指定其他端口：

MUD_BIND_IP=127.0.0.1 MUD_TELNET_PORT=15566 MUD_UTF8_PORT=16666 MUD_WEB_PORT=18080 bash docker.run.sh start
bash docker.run.sh help
bash docker.build.sh --help

MUD_DOCKER_IMAGE 可指定镜像名（默认 fluffos:latest），构建和启动时使用相同值。镜像只运行游戏驱动，NPC AI 服务需要单独部署。容器中的 127.0.0.1 指向容器自身，游戏的 AI_SERVER_HOST 与 NPC AI 的监听地址应根据实际容器网络配置。

Docker 启动脚本的回归测试使用独立容器和临时目录；需事先准备 busybox:latest 镜像：

RUN_DOCKER_TESTS=1 python -m unittest discover -s tools/tests -p test_docker_launcher.py -v

启动服务

使用以下指令启动游戏：

driver config.ini

推荐使用run.sh或run.bat脚本启动项目。

Windows 的 run.bat 使用 config.cfg，可从任意目录调用。启动前会检查本项目的驱动进程和配置中的监听端口；已运行时显示进程号，端口被占用时停止启动。驱动在后台运行，调试日志位于 log/debug.log。

如果是开发学习，使用以下方式之一开启调试模式：

driver config.ini -fdebug
driver config.ini -d

• 5566 端口为GBK编码
• 6666 端口为UTF-8编码
• 8888 端口为WEBSOCKET访问

推荐使用mudlet客户端连接游戏，推荐使用UTF-8编码进行游戏。

注册ID为 mudren 的帐号为游戏管理员(admin)。

求助答疑请访问：https://bbs.mud.ren/nodes/6