MyMUD项目完整代码分析与启动流程文档

项目地址：https://github.com/mudcore/MyMud.git

🎮 项目概述

MyMUD是一个基于mudcore框架开发的勇者斗恶龙主题MUD游戏，使用FluffOS v2019驱动，支持Telnet和WebSocket连接。

🏗️ 技术架构

核心驱动

• FluffOS v2019 - LPC语言MUD驱动
• 双协议支持 - Telnet(3160端口) + WebSocket(8000端口)
• mudcore框架 - 模块化MUD开发框架

目录结构分析

MyMud/
├── system/           # 系统核心
│   ├── kernel/       # 内核对象(master/simul_efun)
│   ├── daemons/      # 25个系统守护进程
│   └── object/       # 核心游戏对象
├── cmds/std/         # 标准玩家指令(25个基础命令)
├── inherit/          # 核心继承类(15个基础类)
├── world/            # 游戏世界地图
├── obj/              # 具体游戏对象
├── std/              # 标准对象模板
└── feature/          # 特色系统

🎯 核心功能系统

1. 角色系统 (CHAR_D)

• 属性体系: 力量(STR)、速度(AGI)、耐力(VIT)、幸运(LUK)、魅力(CHARM)、魔力(INT)
• 种族系统: 人类/魔物/野兽，不同种族有独特属性
• 职业系统: 支持转职和技能专精
• 等级系统: 经验值驱动的等级提升

角色初始化代码:

// 初始化玩家角色
void init_player(object user)
{
    user->set("birthday", time());
    user->set("title", "初心者");
    user->set("vocation", "common");
    user->set("exp", 0); // 经验
    user->set("lv", 1);  // 等级
    user->set_attr("str", 6);     // 力量
    user->set_attr("agi", 6);     // 速度
    user->set_attr("vit", 6);     // 耐力
    user->set_attr("luk", 3);     // 幸运
    user->set_attr("charm", 3);   // 幸运
    user->set_attr("mend", 0);    // 恢复魔力
    user->set_attr("int", 0);     // 攻击魔力
    user->set_attr("max_hp", 14); // 最大ＨＰ
    user->set_attr("max_mp", 0);  // 最大ＭＰ
    user->set_attr("sp", 0);      // 技能点
    user->set_attr("hp", 14);     // 当前ＨＰ
    user->set_attr("mp", 0);      // 当前ＭＰ
}

2. 战斗系统 (COMBAT_D)

• 物理攻击:
  • 伤害公式: ((攻击力×攻击倍率/2-防御力×防御倍率/4)×蓄力倍率)+(等级/10+1)×蓄力次数
  • 暴击系统: 幸运值影响暴击率
  • 防御机制: 格挡/闪避/会心一击
• 魔法系统: 咒文施放与魔力消耗
• 特技系统: 职业特色技能
• 状态效果: 中毒/祝福等异常状态

战斗伤害计算:

// 物理伤害计算方法
// [伤害计算值]=((攻击力×攻击倍率/2-防御力×防御倍率/4)×蓄力倍率)+(等级/10+1)×蓄力次数)×特效倍率×属性倍率×技能倍率×其他倍率
// [伤害波动]=[伤害计算值]/16+1
// [实际伤害值]=[伤害计算值]±[伤害波动]

3. 装备系统

• 8个装备槽位: 武器、盾牌、头盔、上身、护腕、腿部、脚部、饰品
• 装备属性: 攻击、防御、速度、幸运、魅力、魔力、恢复
• 职业限制: 特定装备有职业和等级要求
• 特殊效果: 吸血、吸魔、中毒等

4. 物品系统

• 物品类型: 装备、消耗品、任务物品、容器
• 物品属性: 基础属性 + 随机词缀
• 背包系统: 个人背包 + 仓库系统

5. 任务系统 (QUEST_D)

• 任务类型:
  • BOSS任务 - 击杀特定BOSS
  • 主线任务(M) - 剧情推进
  • 普通任务(Q) - 日常任务
  • 转生任务(R) - 角色进阶
  • 转职任务(V) - 职业转换
  • 怪物猎人 - 可重复任务

6. 世界地图系统

• 3D坐标系统: X,Y,Z三维空间定位
• 区域系统: 支持大型区域和子区域
• 动态生成: 部分地图支持程序生成
• 快速旅行: home指令返回安全区域

起始房间示例:

// 天使界 - 新玩家降生之地
set("short", "天使界");
set("sleep_room", 1);
set("no_fight", 1);
set("exits", ([
    "up" : __DIR__ "start_room/" + x + "," + y + "," + (z + 1),
    "north" : __DIR__ "start_room/" + x + "," + (y + 1) + "," + z,
    "south" : __DIR__ "start_room/" + x + "," + (y - 1) + "," + z,
    "west" : __DIR__ "start_room/" + (x - 1) + "," + y + "," + z,
    "east" : __DIR__ "start_room/" + (x + 1) + "," + y + "," + z,
]));

🎮 游戏特色

1. 勇者斗恶龙IP

• 经典怪物: 史莱姆、金属史莱姆等DQ标志性怪物
• 职业系统: 战士、法师、僧侣等经典职业
• 咒文系统: 火焰咒文、治疗咒文等经典魔法

2. 现代化功能

• WebSocket支持: 现代浏览器直接连接
• GMCP协议: 客户端-服务器高级通信
• 数据库缓存: 玩家数据实时缓存
• 排行榜系统: 多维度玩家排名

3. 社交系统

• 组队系统: 玩家协作战斗
• 聊天系统: 多频道实时聊天
• 论坛系统: 游戏内BBS
• 称号系统: 个性化角色展示

🔧 技术亮点

1. 模块化设计

• 继承体系: 清晰的OOP继承结构
• 守护进程: 25个专门的功能守护进程
• 事件驱动: 基于事件的系统架构

2. 性能优化

• 延迟加载: 按需加载游戏对象
• 数据缓存: 热点数据内存缓存
• 异步处理: 非阻塞I/O操作

3. 扩展性

• 插件系统: 支持动态加载功能模块
• 配置驱动: 大部分功能可通过配置调整
• API接口: 支持外部系统接入

🚀 完整启动流程详解

1️⃣ 系统级启动阶段

驱动程序启动

# Windows启动方式
run.bat → driver.exe config.cfg

# Linux/macOS启动方式  
./run.sh → fluffos/build/bin/driver config.cfg

配置文件加载

• 主配置: config.cfg - FluffOS驱动配置
• 关键配置项:

  name : 勇者斗恶龙
  mudlib directory : .
  log directory : /log
  include directories : /include:/mudcore/include
  master file : /system/kernel/master
  simulated efun file : /system/kernel/simul_efun
  global include file : <globals.h>
  debug log file : debug.log
  external_port_1 : telnet 3160
  external_port_2 : websocket 8000
  websocket http dir : www

2️⃣ MUD引擎初始化阶段

Master对象初始化

入口文件: /system/kernel/master.c

// 核心启动序列
1. create() - Master对象创建
2. epilog() - 返回预加载列表 ["PRELOAD_D"]
3. preload() - 逐个预加载核心对象

Master对象核心代码:

inherit CORE_MASTER_OB;

void create()
{
}

string *epilog(int load_empty)
{
    string *items = ({PRELOAD_D});
    return items;
}

// preload an object
void preload(string file)
{
    string err;
    if (file_size(file + ".c") == -1)
        return;
    err = catch (load_object(file));
    if (err != 0)
    {
        write("[MASTER_OB]->preload():Error " + err + " when loading " + file + "\n");
    }
}

Simul-Efun初始化

入口文件: /system/kernel/simul_efun.c

• 加载核心工具函数
• 初始化系统级方法

3️⃣ 游戏系统预加载阶段

Preload守护进程

核心文件: /system/daemons/preload_d.c

启动序列:

1. create() - 检查启动时间
2. distributed_system_preload() - 系统预加载
   ├── 读取预加载列表 /system/etc/preload
   ├── 加载所有守护进程 /system/daemons/
   └── 分布式加载，显示进度

预加载守护进程列表:

• char_d.c - 角色系统守护进程
• combat_d.c - 战斗系统守护进程
• login_d.c - 登录系统守护进程
• quest_d.c - 任务系统守护进程
• skill_d.c - 技能系统守护进程
• spell_d.c - 魔法系统守护进程
• monster_d.c - 怪物系统守护进程
• time_d.c - 时间系统守护进程
• nature_d.c - 自然环境守护进程
• reward_d.c - 奖励系统守护进程
• 以及其他15个功能守护进程...

预加载内容

• 25个系统守护进程全部加载完成
• 系统功能就绪检查
• 启动进度实时显示

4️⃣ 玩家连接入口阶段

网络连接处理

Master对象方法:

// 新玩家连接时触发
connect(int port) → new(LOGIN_OB)

登录对象初始化

入口文件: /mudcore/system/object/login.c

1. logon() - 初始连接
   ├── call_out(time_out, 60) - 超时保护
   └── call_out(login, 0.25) - 延迟登录

2. login() - 开始登录流程
   └── LOGIN_D->login(this_object())

登录对象核心代码:

void logon()
{
    call_out("time_out", 60);
    // 延迟登陆，解决mudlet初次连接乱码问题
    call_out_walltime("login", 0.25);
}

void login()
{
    if (interactive(this_object()))
        set_temp("ip_number", query_ip_number(this_object()));
    LOGIN_D->login(this_object());
}

5️⃣ 登录系统处理阶段

登录守护进程

核心文件: /system/daemons/login_d.c

完整登录流程:

login() → 检查系统是否就绪
    ↓
如果系统启动中 → 等待PRELOAD_D就绪
    ↓
系统就绪后 → welcome() → 显示欢迎信息
    ↓
认证检查 → 新玩家创建/老玩家加载
    ↓
init_new_player() → 初始化新玩家
    ├── CHAR_D->init_player() - 设置初始属性
    ├── 装备初始装备(5件套)
    ├── 注册论坛账号
    └── 缓存玩家数据

新玩家初始化流程:

private void init_new_player(object user, object ob)
{
    object clothes, shoes, trousers, shield, sword;
    // 初始化玩家属性
    CHAR_D->init_player(user);
    // 初始装备
    clothes = new(EQUIPMENT_DIR "newbie/clothes.c");
    shoes = new(EQUIPMENT_DIR "newbie/shoes.c");
    trousers = new(EQUIPMENT_DIR "newbie/trousers.c");
    shield = new(EQUIPMENT_DIR "newbie/shield.c");
    sword = new(EQUIPMENT_DIR "newbie/sword.c");
    clothes->move(user);
    catch(clothes->equip());
    shoes->move(user);
    catch(shoes->equip());
    trousers->move(user);
    catch(trousers->equip());
    shield->move(user);
    catch(shield->equip());
    sword->move(user);
    catch(sword->equip());
}

6️⃣ 玩家进入游戏世界

最终初始化

enter_world() → 玩家正式进入游戏
    ├── user->setup() - 激活玩家角色
    ├── 保存登录信息(IP、时间、次数)
    ├── 移动到起始房间 START_ROOM
    └── 广播玩家进入消息

📋 完整启动时序图

┌─────────────────────────────────────────────────────────┐
│                    MUD启动流程                           │
├─────────────────────────────────────────────────────────┤
│ 1. 系统启动                                              │
│    driver.exe → 读取config.cfg → 初始化网络端口          │
│                                                         │
│ 2. Master初始化                                          │
│    master.c:create() → epilog() → preload()            │
│                                                         │
│ 3. 系统预加载                                            │
│    preload_d.c → 加载25个守护进程 → 系统功能就绪        │
│                                                         │
│ 4. 等待玩家连接                                          │
│    端口3160(Telnet) & 8000(WebSocket)监听               │
│                                                         │
│ 5. 玩家登录流程                                          │
│    新连接 → login.c → login_d.c → 角色创建/加载         │
│                                                         │
│ 6. 进入游戏世界                                          │
│    角色初始化 → 装备初始物品 → 移动到起始房间            │
└─────────────────────────────────────────────────────────┘

🎯 关键入口点总结

阶段	入口文件	关键方法	功能描述
系统启动	driver.exe	main()	FluffOS驱动入口
Master初始化	/system/kernel/master.c	create()	MUD核心初始化
预加载	/system/daemons/preload_d.c	create()	系统守护进程加载
网络连接	/mudcore/system/object/login.c	logon()	新连接处理
登录认证	/system/daemons/login_d.c	login()	玩家认证流程
角色创建	/system/daemons/char_d.c	init_player()	新角色初始化
进入游戏	/system/daemons/login_d.c	enter_world()	玩家进入游戏世界

🔧 调试和监控

启动日志

• 日志文件: /log/preload - 预加载详细日志
• 调试信息: 控制台输出启动进度
• 错误处理: 每个阶段都有错误捕获和日志记录

启动状态检查

• 系统就绪: PRELOAD_D->ready() 检查
• 守护进程状态: 所有守护进程加载完成
• 网络端口: Telnet(3160) + WebSocket(8000)就绪

📊 项目规模统计

• 代码量: 约50,000+行LPC代码
• 系统模块: 25个守护进程 + 15个核心类
• 游戏内容: 8个装备类型 + 6种任务类型 + 3个种族
• 功能指令: 25个标准指令 + 多个扩展指令
• 网络端口: 2个服务端口(Telnet 3160, WebSocket 8000)
• 配置文件: 10+个核心配置文件

🌐 部署和运行

启动方式

# Windows
run.bat

# Linux/macOS
./run.sh

# 手动启动
driver config.cfg

客户端支持

• 传统客户端: TinTin++, Mudlet
• Web客户端: 内置WebSocket支持
• 移动客户端: 支持移动端连接

---

本文档基于MyMUD项目完整代码分析，由kimi-k2-0711-preview生成，涵盖了从系统启动到玩家进入游戏世界的完整流程。