01
从空目录到在线服务
一条命令生成可编辑的 Rust 应用、本地配置、容器文件和部署清单。
开始构建
你不需要先理解 Elura 的每个 Crate。先生成并运行应用,再一边修改真实代码, 一边理解各个组件:
cargo install elura-cli
mkdir my-game && cd my-game
elura init all --dir .生成器会创建可编辑的应用代码、本地配置、Docker 文件和 Kubernetes Manifest。 继续阅读 10 分钟快速开始,配置开发密钥并启动两个进程。
玩家客户端 ──> Gateway ──> World ──> 你的类型化 Handler
会话与认证 路由 游戏规则无论是在本地、单体进程还是多个 Kubernetes 节点中运行,这个边界都不会改变。 需要完整背景时,再阅读架构概览。
| 我想要…… | 从这里开始 |
|---|---|
| 第一次运行 Elura | 快速开始 |
| 不使用 CLI 在一个进程运行 Gateway 与 World | 手动单体搭建 |
| 不使用 CLI 拆分 Gateway 与 World | 手动拆分搭建 |
| 组装共享状态与动态发现 | 手动分布式搭建 |
| 添加第一个游戏命令 | World 模块与路由 |
| 构建实时房间、AOI、预测或实体状态同步 | 实时游戏开发 |
| 添加 TCP、UDP、WebSocket、WebTransport、QUIC 或自定义客户端端点 | 客户端传输 |
| 添加 Axum HTTP API 或回调端点 | 应用 HTTP 服务 |
| 连接 Rust、C++ 或 C# 客户端 | 客户端 SDK |
| 看懂生成的文件 | 生成的项目 |
| 选择 Redis、SQL、DNS、Kubernetes 或自定义后端 | Adapters |
| 接入登录、OTP、短信或支付 | Providers |
| 准备生产发布 | 生产检查清单 |
项目状态
当前文档版本为 v0.3.1,本站跟踪 main 分支能力。官方 Rust、 C++20 和 C# / Unity SDK 分别由独立 GitHub 仓库维护,不再由 CLI 生成。 项目尚未进入 1.0:生产环境应锁定精确版本,并在升级前检查 Release Notes 与兼容性。