- 下载和检测 Minecraft 服务端核心
- 创建或导入服务器并管理启动生命周期
- 通过控制台执行命令并查看日志
- 方便直观地修改服务器配置
- 提供备份、定时任务、更新和插件等应用能力
| 我想要…… | 前往 |
|---|---|
| 下载并安装 Sea Lantern | 下载安装 |
| 第一次创建或导入服务器 | 使用教程 |
| 不知道该选择哪种服务端 | 核心获取 |
| 遇到使用问题或异常情况 | 常见问题 |
- 前端: Vue 3 + TypeScript + Vite
- 后端: Rust + Tauri 2（Desktop 宿主）+ Axum（Web 宿主）
- 通信: Desktop 使用 Tauri IPC/Event，Web 使用 HTTP/WebSocket/SSE，插件使用宿主 Bridge 没有 Electron，没有 Node 后端，没有 Webpack。启动快，体积小，内存省。
application 提供宿主无关的公共业务编排，src-tauri 与 server 分别作为 Desktop、Web 宿主，application::port 定义服务能力端口，contract 提供两端共用的 DTO 和错误契约。普通 Web 业务遵循 RESTful RPC 设计。可复用的前端业务通过 src/api 接入，宿主专用页面和功能可以独立演进。详见项目架构与代码组织。
使用系统 Webview 渲染。
当前工程优先级、已知缺口和暂不纳入的方向见 Roadmap。
开发前需要准备：
| 依赖 | 版本 |
|---|---|
| Node.js | 24 LTS |
| Rust | stable |
| pnpm | 9.15.9 |
| Only（可选） | 0.4.0+ |
如果你还没有配置开发环境，可以先查看 环境配置。
拉取项目：
git clone https://github.com/SeaLantern-Studio/SeaLantern.git
cd SeaLantern安装依赖并启动桌面开发环境：
pnpm install
pnpm tauri dev只预览前端页面：
pnpm dev如果你在 Linux 上开发，可能需要先安装 Tauri 相关系统依赖。具体请看 Tauri Linux 前置要求。
仓库根目录提供了 Onlyfile，用于统一常用的开发、构建和检查命令。可以按需安装 Only：
cargo install only安装后，在项目根目录运行以下命令查看所有可用任务：
only常用的根级命令包括：
| 命令 | 用途 |
|---|---|
only dev |
启动桌面开发模式 |
only build |
构建本地应用 |
only check |
并行执行前后端检查 |
only test |
并行执行前后端测试 |
only ci |
执行完整本地 CI |
only clean |
清理前后端产物 |
也可以通过 group 单独运行某一侧的任务：
# 前端
only front check
only front test
only front ci
# 后端
only back check
only back test
only back cionly ci 会执行完整的前后端检查与测试，并在适合的位置并行运行。
提交代码前，我们建议运行完整的本地 CI：
only ci该命令会执行前后端静态检查和全部测试；如果没有安装 Only，也可以分别运行以下命令：
前端检查
# 代码质量检查
pnpm lint
# 类型检查并验证生产构建
pnpm build:check
# 自动修复可修复问题
pnpm lint:fix
# 格式化代码
pnpm fmt
# 检查代码格式
pnpm fmt:check
# 运行前端测试
pnpm test后端检查
# 格式化
cargo fmt --all
# 编译检查
cargo check --all-targets --workspace
# 运行 Clippy 检查
cargo clippy --all-targets --workspace -- -D warnings
# 运行后端测试
cargo test --all-targets --workspace项目已配置 CI，会在推送和提交 Pull Request 时自动检查代码质量。
我们欢迎任何形式的贡献：代码、文档、翻译、问题反馈、功能建议，或者 UI 草图都可以。
- Fork 仓库
- 新建自己的开发分支
- 完成修改并通过基本检查
- 提交 Pull Request
涉及整体 UI、项目架构等较大改动时，请先在交流群或 GitHub Issues 中讨论；缺少充分理由的重大改动可能不会被合并。
如果你在使用中遇到问题，或者想参与讨论，可以通过以下方式联系我们：
- QQ 一群：293748695
- QQ 二群：1085823754
- 问题反馈：GitHub Issues
感谢所有为 Sea Lantern 做出贡献的人！
GNU Affero General Public License v3.0
Minecraft 是 Mojang AB 的注册商标。本项目未经 Mojang 或 Microsoft 批准，也不与 Mojang 或 Microsoft 关联。
我们搭建了骨架，而灵魂，交给你们。