SteelMC架构揭秘:10个Rust crate如何协作搭建MC服务器
SteelMC架构揭秘:10个Rust crate如何协作搭建MC服务器
SteelMC 是一个用 Rust 语言编写的 Minecraft Java 版服务器实现,当前版本 0.16.1+mc26.3 追踪最新客户端,目标是在保持原版行为一致性的同时,充分利用多核硬件的性能。整个项目通过 Cargo workspace 拆分为 10 个职责单一的 Rust crate,从网络协议到世界生成各司其职。本文带你快速看懂这些 crate 是如何协作搭建出一台完整 MC 服务器的。
一图看懂:10 个 crate 的分工
在项目根目录的 Cargo.toml 中,workspace 声明了全部成员:
| crate | 一句话职责 |
|---|---|
steel |
服务器主程序:入口、配置加载、终端日志 |
steel-core |
游戏引擎核心:世界、区块、实体、指令、服务器主循环 |
steel-protocol |
Minecraft 网络协议的读包/写包 |
steel-login |
Mojang 认证与登录/状态/配置状态处理 |
steel-registry |
还原原版注册表(方块、物品、数据组件等) |
steel-worldgen |
世界生成:噪声、密度函数、结构 |
steel-utils |
基础工具:NBT、随机数、序列化编解码 |
steel-math |
角度、三角函数与噪声数学(SIMD 加速) |
steel-crypto |
签名聊天的 RSA 加密工具 |
steel-macros |
过程宏,实现行为/实体的自动注册 |
依赖方向非常清晰(见 steel-core/Cargo.toml 的 [dependencies]):
- 底座层:
steel-utils、steel-math不依赖任何内部 crate,提供 NBT、随机数、数学原语; - 中间层:
steel-protocol、steel-registry、steel-crypto、steel-macros、steel-worldgen只依赖底座层; - 核心层:
steel-core聚合上面所有 crate,实现 PLAY 状态的全部游戏逻辑(steel-core/src/lib.rs 中可以看到它对 8 个内部 crate 的引用); - 入口层:
steel只依赖steel-core、steel-login和steel-utils(见 steel/Cargo.toml)。
这种"洋葱式"分层让每个 crate 都能独立编译和测试,也是 Rust 项目保持高性能与可维护性的关键架构决策。
入口层:steel —— 服务器的"总装车间"
steel crate 是玩家实际启动的那个二进制。它的 main.rs 负责:
- 启动 tokio 异步运行时,并计算可用的工作线程数;
- 加载配置文件:配置加载逻辑在 steel/src/config/mod.rs,配置文件模板见 package-content/config.toml,可设置端口(
server_port = 25565)、最大人数、查看距离、是否走 Mojang 认证等; - 搭好日志系统:内置一个可交互的终端命令日志器(steel/src/logger/),支持搜索、历史、高亮,比传统服务器日志好用得多。
💡 简单说:
steel不关心游戏怎么跑,它只负责"把发动机点着火"。
核心层:steel-core —— 一台服务器的心脏
steel-core 是代码量最大的 crate,src/lib.rs 列出了它的 20 多个模块:
server/:Server结构与主循环。run_loop.rs 中可以看到"每秒 20 tick"的CHUNK_SENDING_TPS节奏控制——游戏 tick 在主线程同步进行,而区块发送、包处理可以放到工作线程,这正是它压榨多核的策略;chunk/:区块地图、生成任务调度、光照传播、区块状态金字塔,是生成性能优化的重灾区;world/:世界实体目录、区块更新、红石信号、天气与睡眠状态;entity/与behavior/:实体 AI、方块行为与物品行为的注册体系;command/:完整的 brigadier 风格指令树、执行队列与权限检查;permission/:可配置表达式驱动的权限组系统。
值得注意的是 steel-core/build/build.rs 这类构建脚本:它们在编译期扫描源码里的 #[block_behavior] 等宏标记,结合 classes.json 自动生成注册代码——你在游戏里看到的每种方块行为,都是"编译期装配"出来的,运行时零额外开销。
通信层:steel-protocol + steel-login —— 听懂"MC 普通话"
Minecraft 服务器与客户端之间说的是二进制协议,steel-protocol 把它拆成了:
packet_reader/packet_writer:可变长整数、字节串等底层读写原语;packets/:按握手、登录、状态、配置、游戏 5 个阶段组织的数百个包定义,例如 packets/game/ 下的实体移动、方块更新、容器同步等包,每个包都带"字节往返"测试保证编码正确。
而 steel-login 负责玩家进门前的事:Pre-play 阶段的 TCP 连接、Mojang 认证(authentication.rs)、以及登录/配置/状态三种状态机的处理。配合 steel-crypto 中的 RSA(SHA256withRSA)密钥对,还能验证聊天消息签名,防伪造聊天内容。
数据底座:steel-registry + steel-utils —— 把"原版数据"搬进 Rust
原版 Minecraft 的方块、物品、生物都是 JSON 驱动的,steel-registry 的做法是把这些数据固化进 Rust:
- steel-registry/build_assets/ 目录存放
blocks.json、items.json、entities.json等提取自原版的数据; - 构建脚本在编译期把它们转换成强类型的 Rust 代码,得到方块 ID、数据组件、标签、配方等注册表(steel-registry/src/lib.rs)。
steel-utils 则提供一切"地基级"能力(steel-utils/src/lib.rs):NBT 读写(与原版兼容)、确定性随机数(LegacyRandom、Xoroshiro,世界生成的种子一致性依赖它)、序列化编解码器、线程工具等。世界生成用到的 value_providers(高度、浮点、垂直锚点)也在这里。
世界生成:steel-worldgen + steel-math —— 最快的地形引擎
steel-worldgen 是 SteelMC 完成度最高、也是性能最亮的部分(steel-worldgen/src/lib.rs):
noise/:Perlin、Simplex、Beardifier、Aquifer 等全套噪声实现;density/:密度函数系统,从原版提取的密度函数以生成代码形式注入;structure/:要塞、沙漠神殿、末地城、冰屋等 20 余种结构生成器;biomes/:生物群系气候采样。
它启用了 portable_simd 特性,配合 steel-math 的 SIMD 噪声数学(steel-math/src/noise_math/),对噪声采样做向量化加速。效果如何?官方基准测试显示,在 Ryzen 9 9950X 上生成一片约 1 万区块的主世界区域,中位耗时仅 3.98 秒(基准代码见 steel-core/benches/worldgen.rs)。
性能设计:架构之外还有哪些"隐藏大招"
除了分层,SteelMC 在 Cargo.toml 的构建配置里埋了不少性能细节:
- release 构建开启 LTO 与
codegen-units = 1,最大化跨 crate 内联优化; - 主程序默认启用 mimalloc 分配器(见 steel/Cargo.toml 的
default = ["mimalloc"]); - 开发构建中单独给
steel-worldgen与steel-math开到opt-level = 3——因为调试时跑的就是世界生成,慢不得; - 并发上综合使用
tokio(异步 I/O)、rayon/crossbeam(并行计算)与scc(sharded mpsc 队列)。
如何上手体验
如果你想本地跑起来,先 clone 仓库:
git clone https://gitcode.com/gh_mirrors/st/SteelMC
注意项目使用 nightly 特性(见 rust-toolchain.toml),并依赖预提取的原版资产(可用仓库里的 update-minecraft-src.sh 更新)。启动后通过 package-content/config.toml 调整 motd、view_distance、online_mode 等参数即可——目前客户端可以加入并探索生成的世界,但生存玩法尚不完整,建议先别拿它替代生产服务器。
总结
SteelMC 的架构精髓可以概括为一句话:用 10 个边界清晰的 crate 把"MC 服务器"拆成 10 块可独立优化的拼图——底座(utils/math)求稳、协议层(protocol/login/crypto)求准、数据层(registry)求全、生成层(worldgen)求快、核心层(core)求活、入口层(steel)求好用。对想学习 Rust 大型项目组织方式的开发者来说,这是一份绝佳的"架构教科书";对服务器玩家来说,这套架构也意味着更低的延迟与更高的区块生成上限。
- 依赖清单总览:Cargo.toml
- 世界主循环:steel-core/src/server/run_loop.rs
- 配置模板:package-content/config.toml
- 世界生成基准:steel-core/benches/worldgen.rs
