本页目录

Minosoft:从零重写的开源 Minecraft 客户端(Kotlin)

Minosoft · Bixilon/Minosoft

Minosoft 是一个用 Kotlin(辅以 Java)从零重写的开源 Minecraft 客户端,并非简单复刻,而是完整重新实现,目标是提升功能与稳定性。项目采用 GPLv3 协议,与 Mojang AB 无关。仓库是 GitLab 的镜像,education 分支提供精简教育版内容...

沙盒生存 多人对战 自研引擎 Kotlin 物理系统 游戏状态管理 网络联机 粒子系统 高级
★ Stars 1,322 Forks 79 License GPL-3.0 更新 2026-11-07

国内开发环境适配

Windows
官方声明支持
Linux
官方声明支持
macOS
官方声明支持
引擎 / 框架:自研引擎 暂无中文教程标记 未标记站长实测
构建需 Java 11+ 与 Gradle,依赖下载可能受网络影响,建议配置镜像源;连接国际服务器可能需网络加速,具体待核验。

中文项目介绍

Minosoft 是一个完全从零开始重写的开源 Minecraft 客户端,使用 Kotlin(辅以 Java)实现。它并非对原版客户端的简单克隆,而是对 Minecraft 客户端功能的完整重新实现,目标是提供更丰富的功能与更高的稳定性。项目采用 GPLv3 协议开源,与 Minecraft 的原始开发者 Mojang AB 无任何关联。

当前仓库是 GitLab 主仓库的镜像,主开发活动在 gitlab.bixilon.de 进行。作者目前处于半活跃开发状态,主要精力放在性能优化、代码重构与质量提升上,偶尔加入新功能,但不再积极添加新的协议版本支持。README 中明确提醒:项目仍处于开发阶段,使用前需自行承担风险(例如反作弊封禁)。

此外,仓库的 education 分支提供了一个精简的教育版实现,可供参考。

致谢与开发故事

作者在 README 中坦言,已在该项目上投入数千小时,许多原版功能已经实现,但仍有大量缺失。项目目前远未达到“稳定发布”的标准,仍处于 alpha 阶段。最初的目标是能用该客户端玩 Bedwars,并且已在 Hypixel 上成功运行(见 issue #42)。作者表示不会等待正式发布,并鼓励通过 Matrix 频道获取新功能通知。

代码镜像包括:主仓库 gitlab.bixilon.de、GitLab 镜像与 GitHub 镜像。README 也说明本文档仍在完善中,内容可能随时间变化。

核心功能

渲染系统

支持方块、实体、方块实体(如告示牌、箱子)、HUD 与 GUI(背包、菜单等)、粒子效果、自定义光照引擎(方块光与天空光)、世界交互(放置、破坏、挖掘)等。

版本兼容

可与 1.7 至 1.20.4 之间的几乎所有版本(包括快照)的服务器连接。

性能表现

强调“前沿性能”,例如极快的启动时间。

多账户与多连接

支持便捷的多账户管理,并可在单个进程内建立多个服务器连接。

多线程与异步加载

利用多线程和异步加载提升响应速度。

原版物理

实现了与原版一致的物理效果。

协议层调试

提供协议层调试能力。

局域网服务器

支持局域网服务器。

多配置文件

可为服务器或 Minosoft 本身保存多套设置。

技术架构分析

技术要点

  • 语言与构建:主要使用 Kotlin,部分代码为 Java。构建基于 Gradle,要求 Java 11 及以上(不支持 Java 8)。
  • 图形接口:依赖 OpenGL 3.3+,现代 GPU 均可运行。
  • 系统需求:操作系统支持 Windows、Linux、macOS(x86/x64 或 arm64/aarch64);建议 4 核以上、主频 2 GHz 以上的 CPU;内存最低 500 MiB,推荐 1 GiB;磁盘空间约 80 MiB 加上资源文件(每个版本约 300 MiB)。
  • 架构设计:README 提供了渲染系统与架构设计的文档链接(doc/rendering/ReadMe.md 与 doc/Architecture.md),可供深入理解。
  • 版本支持现状:初始目标支持到 1.20 已完成,1.21.X 暂不支持(见 issue #127)。

构建与运行

README 给出了从源码构建的步骤:

  1. 安装 Java 11+(例如 sudo apt install openjdk-11-jdk;Windows 用户可从 Azul 下载安装)。
  2. 克隆仓库:git clone --depth=1 https://gitlab.bixilon.de/bixilon/minosoft.git,或下载 master 分支压缩包并解压。
  3. 进入目录:cd minosoft。
  4. 可选:切换到当前功能分支(注意可能不稳定甚至无法构建)。
  5. 使用 ./gradlew run(Windows 下 ./gradlew.bat run)构建并运行,也可直接点击 run.cmd。若遇到错误,可联系作者或提交 issue。

对于 Arch Linux 用户,可通过 AUR 安装:minosoft-git(由 @jugendhacker 维护)。最新 x64 与 arm64 构建会发布在 GitHub Actions 上。

开源许可证与版权说明

许可证标识:GPL-3.0。源码、资源与依赖许可可能不同,请以官方仓库为准。本站仅做索引,不托管源码。

相似项目