# yhmud

**Repository Path**: mudren/mud

## Basic Information

- **Project Name**: yhmud
- **Description**: 炎黄群侠传文字MUD游戏，使用FluffOS v2019驱动，在线体验游戏地址：https://mud.ren:8888
- **Primary Language**: C
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://mud.ren:8888
- **GVP Project**: No

## Statistics

- **Stars**: 70
- **Forks**: 33
- **Created**: 2020-11-04
- **Last Updated**: 2025-06-13

## Categories & Tags

**Categories**: games

**Tags**: 游戏, mud

## README

# 炎黄群侠传MUD

![mud](mud.png "mud")

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

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

## LIB说明

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

![help](help.png "help")

## 启动说明

游戏集成了[mudcore](https://github.com/mudcore/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](https://github.com/mudcore/mudcore)和[www](https://github.com/mudren/www)子模块可使用gitee镜像地址

- https://gitee.com/mudcore/mudcore.git
- https://gitee.com/mudren/www.git

### 环境配置

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

### 启动服务

使用以下指令启动游戏：

    driver config.ini

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

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

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

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

> 推荐使用[mudlet](https://github.com/Mudlet/Mudlet)客户端连接游戏，推荐使用UTF-8编码进行游戏。

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

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