开源软件名称：

开源软件地址：

开源软件介绍：

泥芯(MudCore) - LPMUD 游戏开发框架

LPMUD游戏开发框架核心代码，仅仅包括核心代码，可以在此基础上开发任何MUD，本框架需配合 FluffOS v2019使用。

当前版本：v1.4.1

这个项目的诞生源于我的LPC零基础开发教程，在写教程的过程中，发现很多朋友并不关心底层细节，只想能直接用来开发项目，国内绝大多数项目是《东方故事2》底层的，都是在这类MUD基础上修改，优点是可以快速上手，但不够灵活。能不能把底层独立出来，开发任何类型的MUD都可以使用？在思考后，我开始了这个项目，特色是只提供底层代码和接口，不提供任何游戏性的内容，独立于个人项目之外，只需简单配置即可实现个人MUD开发。本项目不考虑旧版的兼容性，只支持 FluffOS v2019 版。

• 框架下载地址：https://github.com/mudcore/mudcore
• 国内镜像地址：https://gitee.com/mudcore/mudcore
• 框架基础示例：https://gitee.com/mudcore/demo (可在此基础上直接开发新MUD)
• 框架使用教程：https://bbs.mud.ren/threads/99 (在现有MUD中集成MudCore框架)

致谢：本框架开发代码、结构、功能和思路上大量的参考借鉴了ES2系列游戏、重生的世界MUD、火影忍者MUD、DeadSouls等，感谢这些优秀MUD。

框架特色

框架提供大量常用模拟外部函数和最基本的游戏底层（包括指令系统、聊天频道、表情系统和档案存取功能），可以用来快速开发个人的MUD，框架部分独立维护，更新升级不影响个人项目。个人项目目录结构和功能灵活自主，框架提供的功能可灵活选择使用，只需要继承对应模块即可。

注意：项目开发不要继承 CORE_LOGIN_OB 和 CORE_USER_OB，这二个为示例文件，仅供演示和参考，请务必自己实现登录对象和玩家对象。

框架使用说明

把本框架放在你的MUD项目中，推荐保持默认目录名称 mudcore，并做如下配置：

1. 运行时配置文件<config.ini>中定义包含文件目录：

include directories : /include:/mudcore/include

2. 全局包含头文件<globals.h>中做如下配置：

// 定义日志目录#define LOG_DIR "/log/"// 定义存档目录#define DATA_DIR "/data/"// 引用框架头文件(放在最后)#include <mudcore.h>

3. 主控对象文件继承框架对象：

inherit CORE_MASTER_OB;

4. 模拟外部函数文件继承框架对象：

inherit CORE_SIMUL_EFUN_OB;

只需要以上配置，你的MUD基本框架就可以正常启动，并自带登录注册功能。

对新MUD开发，如果不想使用框架提供的登录注册功能，请在 <globals.h> 中定义连线对象LOGIN_OB 和 USER_OB 指向自己实现功能的文件。

个人开发MUD不建议直接修改 mudcore 的任何代码，如果需要增加功能，请通过继承和覆盖的方式实现。

如果需要预加载，请定义 PRELOAD 并指定文件列表位置，在对应文件列出预加载对象文件。

如果使用系统自带注册登录系统，但想使用个人的欢迎界面，请定义 MOTD 并指定位置，如果需要更多的玩家信息初始化，可以定义 CHAR_D 并从 setup() 方法中初始化。

如果要使用框架提供的指令系统，请在<globals.h>中做如下示例定义：

// 管理员#define WIZARD "mudren"// 管理员指令路径#define CMD_PATH_WIZ ({"/cmds/wiz/", "/mudcore/cmds/wizard/"})// 玩家指令路径#define CMD_PATH_STD ({"/cmds/std/", "/mudcore/cmds/player/"})

指令需要实现以下方法：

int main(object me, string arg){    // todo 指令功能    return 1;}int help(object me){    // todo 指令使用说明    return 1;}

如果你是使用泥芯框架从零开始开发新游戏，可参考框架使用演示教程：https://bbs.mud.ren/threads/66

除了新开发游戏，老游戏也可以引入框架并使用框架的功能，具体参考：https://bbs.mud.ren/threads/99

框架功能介绍

目录结构

system系统目录

核心对象

系统头文件(Include Headers)

头文件在 /include/ 目录中，主要是常量宏定义和函数声明，框架基本提供如下头文件：

继承特征(Inherit Objects)

继承文件在 /inherit/ 目录，实现了核心的功能片段，方便直接使用，具体参考 /docs/inherit/ 目录。基本提供如下继承文件：

守护进程(Daemons)

守护进程是独立出来的系统服务，每个进程有自己的API可以调用，具体参考 /docs/dameons/ 目录。

另外，在MUDCORE的/system/daemons/http/下面提供了二个http服务示例：

• iqa_d.c : 智能答问机器人
• qq_d.c : QQ群聊天互通机器人

系统函数(Simul-Efuns)

除驱动自带的 efun 外，框架提供了部分模拟外部函数，具体使用参考 /docs/simul_efun/ 目录，或查看函数源码（/system/kernel/simul_efun/）。