三个月，1万行代码，我把Minecraft同步到了现实

视频链接：

Bilibili: [开源][MC模组] 三个月，1万行代码，我把Minecraft同步到了现实

Github: 源码

声明

这个项目尽量做到每个人都能复刻，所以我把复刻步骤写得很细：
https://github.com/robcholz/Lumen/blob/main/docs/quick-start-zh-CN.md

如果过程中遇到问题，欢迎直接在 GitHub 提 Issue，我看到都会尽量回复。

项目简介

Lumen 是一个面向长期使用场景设计的开源硬件项目，用于将电脑或软件中的变化，以稳定、直观的方式呈现在现实世界中。

项目并非围绕单一功能设计，而是作为一个可复刻、可扩展的硬件载体存在。目前已支持与 Minecraft 等程序联动，将游戏或软件中的状态同步到现实中的显示与灯效上。

Lumen 从硬件、固件到 UI 全部开源，并围绕低使用门槛进行设计。后续将通过脚本机制支持更自由的交互定义，使其能够作为软件、系统或游戏与现实世界之间的连接点。

项目功能

Lumen 目前实现的功能主要围绕“从电脑获取状态，并在设备上稳定显示”展开，适合长期运行和持续扩展。

1. 电脑端通信: 设备通过 USB 与电脑直连通信，可接收来自电脑端程序发送的数据和状态信息。通信方式稳定，适合长时间持续运行。
2. Minecraft 状态同步: Lumen 可以通过配套的 Minecraft Mod 与游戏客户端联动，将游戏中的状态同步到设备上显示。目前支持的状态包括玩家血量变化、玩家皮肤显示，以及玩家名字在特定事件下的显示。
3. 显示与灯效反馈: 设备配备 240×240 分辨率显示屏，可用于显示文本、图形以及简单动画。同时通过 RGB 灯效对状态变化进行补充提示。显示逻辑与业务逻辑分离，便于后续修改和扩展。
4. 本地交互输入: 支持转轮编码器等物理输入方式，可在设备本地进行基础交互和操作，不依赖串口或调试界面即可完成日常使用。
5. USB 电源监控与保护: 设备支持 USB-C 电源输入，集成电压、电流监测功能，并包含基础的电源保护逻辑，用于检测和处理异常状态。
6. 可扩展的交互逻辑（规划中）: 项目后续将支持脚本机制，用于自定义状态来源、显示方式和交互逻辑，使设备不局限于现有功能，可根据使用者需求扩展新的使用场景。
7. 完整的复刻支持: 硬件设计文件、固件代码和 UI 均已开源。固件通过 CI 自动构建并发布，支持通过网页方式进行烧录，无需配置本地开发环境即可完成设备复刻。

复刻教程

请见https://github.com/robcholz/Lumen 主页中的快速开始一栏

固件都是预编译好的，可以网页烧录，快速开始一栏已经全部说明。

3d打印模型都在github中。

功能说明

请见Bilibili视频。

说在最后

开源项目制作不易, 并非一次就会成功, 你所看到的成果都是在投入时间金钱得到的。
如果可以的话请给我的github项目star, B站关注和视频一键三连。
您的支持就是我最大的鼓励。

参考资料

VisionUI: https://www.robcholz.com/2025/11/16/vision-ui/