Cinnabar：Rust 重写的基岩版客户端

项目简介

Cinnabar 是用 Rust 从零编写的 Minecraft: Bedrock Edition（基岩版）客户端。它以原版行为为默认，可以连接真实服务器、Realms 和好友世界，并且以比官方客户端更快的运行速度为目标。项目是非官方独立客户端，与 Mojang、Microsoft 没有关联。

主要功能

• 性能：帧节奏、延迟与区块流式加载都针对速度做了优化。
• 1.12 PvP 手感：内置基岩版 1.12 风格战斗视觉，包括经典挥击动作、受伤闪烁、附魔光效与视角摇晃，另有 Java 风格的第一人称手部摆动和名称标签。
• 实时资源包：不退出世界即可添加、移除或重新排序资源包。
• 多账号管理：在启动器中登录多个 Microsoft 账号并直接切换，无需反复登出。
• 自定义皮肤：支持导入自定义几何（4D/5D）皮肤与皮肤包，详见 docs/custom-skins.md。
• Discord 集成：Rich Presence，以及通过 Discord 加入和邀请好友，详见 docs/discord.md。
• Cinnabar 玩家标记：在 Tab 列表中为其他 Cinnabar 玩家显示标记，并在新版本发布时提示更新。
• 模组（预览）：个人 WebAssembly 模组，支持重载与显式授权；还有声明方块、物品和类型化消息的服务端/客户端成对模组。
• JSON-UI 编辑器：在 jsonui.cinnabar.gg 按 Cinnabar 的渲染效果预览和编辑资源包 UI。
• Figma 转 JSON-UI：一个把 Figma 画框转换为 JSON-UI 界面与资源包的插件。

安装与使用

首次启动会让你接受 Minecraft EULA，然后下载 Mojang 的公开示例资源包并在本地转换；安装包本身不包含任何 Mojang 资产。

• Linux：chmod +x Cinnabar-x86_64.AppImage 后直接运行。
• macOS（未签名构建）：把 Cinnabar 拖入 Applications，然后执行一次 xattr -dr com.apple.quarantine /Applications/Cinnabar.app；也可以在系统设置 → 隐私与安全性中选择仍要打开。Apple 芯片使用 arm64 DMG，Intel 使用 x86_64。
• Windows（未签名构建）：运行 Cinnabar-x64-setup.exe；若 SmartScreen 警告，选择「更多信息 → 仍要运行」。
• Android（实验性）：下载 arm64-v8a APK，在支持 Vulkan 的 Android 8+ 设备上安装。

下载后可用 SHA256SUMS.txt 校验文件。稳定版见 latest release，每日构建见 nightly。

从源码构建：

make play

该命令会获取原版资源、构建 Go 核心并打开启动器；用 Microsoft 设备码登录，令牌保存在 .local/auth/。优化构建用 make play PROFILE=release，全部目标见 make help。在 Debian/Ubuntu 上需先安装 libwayland-dev 和 libudev-dev。

注意事项

Cinnabar 是非原版客户端且仍在开发中，移动与战斗表现可能还不能与官方客户端完全一致，服务器反作弊可能标记你，部分服务器可能封禁，请自行承担风险。项目采用 PolyForm Noncommercial 1.0.0 许可证，商业用途需联系维护者。

架构上，Rust 客户端（Bevy/wgpu）负责画面与玩法，Go 核心 bedrock-core 负责 Xbox 登录、加密与网络传输（RakNet 连接服务器，NetherNet 连接 Realms 与好友世界），两者通过本地 socket 通信。

本作品整理自 GitHub 开源项目 cinnabar-mc/cinnabar，原作者 @cinnabar-mc。中文介绍由 AI 根据项目 README 整理，以原仓库为准。