? SerialCraft:连接世界的桥梁
将你的现实世界硬件带入生存世界。
Documentation · Source code · Report an issue
SerialCraft 通过 USB 或 Wi-Fi 将 Arduino、ESP32 及其他开发板连接到 Minecraft。
0.5.3-beta 更新内容
- NeoForge 支持: 与 Fabric 并列,适用于 Minecraft 26.2 和 Java 25。
- 输出设置: 可独立选择连接时的行为以及正常断开连接时的行为:发送零值或自定义值(0–255),在连接时恢复保存的值,或在断开连接时保持最后状态。
感谢 @MeerukYang 在 issue #10 中的报告与建议。简体中文翻译由 @SK-Xiaohan 提供。
主要功能
- 硬件 → Minecraft: 物理按钮、开关和传感器驱动红石。电位器可控制信号强度;书桌上的开关可以打开你基地的门。
- Minecraft → 硬件: 红石控制你的开发板。使用拉杆切换 LED 状态,或使用比较器通过 PWM 调节其亮度。
- USB 和 Wi-Fi: 可通过 USB 串口直接连接,或在本地网络上配对 TCP 设备。已记忆的 Wi-Fi 设备可通过 HMAC 挑战响应机制重新连接,无需重新输入令牌。
- 事件: 通过专用的
mc_*通道将生命值、饥饿值、世界时间和游戏事件流式传输到硬件。 - 可视化器: 在时间轴上检查 RX/TX 消息,将传感器数据与其红石转换结果进行比较,并在专用通道上使用波形发生器测试执行器。
- 开发板识别: 通过 USB 描述符和固件公告来识别受支持的开发板。通用的 USB 适配器不会声称未确认的开发板型号。
- 输出行为: 从设置齿轮中配置连接值和正常断开连接值。这些偏好设置会影响 Minecraft → 硬件 I/O 通道;遥测数据和波形发生器保持各自的行为。
- 配置与诊断: 配置方向、信号以及 OR/AND/XOR 逻辑;检查 RX、TX、红石和连接状态。通过 ? 获取上下文帮助。
- 五种语言: 英语、西班牙语(西班牙、墨西哥和阿根廷)、简体中文。SerialCraft 会跟随你选择的客户端语言。
笔记本电脑拥有 Home(主页)、Boards(开发板)、Events(事件)和 Visualizer(可视化器)标签页,一个连接欢迎屏幕,主页内的控制台,以及右上角齿轮可访问的设置页面。打开它不会暂停单人游戏中的世界运行。
方块与合成配方

笔记本电脑与连接器
打开笔记本电脑或右键点击已放置的连接器以访问界面。在欢迎屏幕上选择 USB 开发板,或启动 Wi-Fi 服务器以显示其本地 IP、端口和配对令牌。USB 默认波特率为 115200;在 Home → Apply and reconnect(主页 → 应用并重新连接)下更改它以匹配你的固件。

硬件 I/O 模块
右键点击底座以设置 Channel(通道)、数据方向、信号类型和逻辑。通道必须与你的代码(sketch)匹配,例如 pot_val 或 green_led;mc_ 保留用于游戏遥测和识别。
直接在已放置的方块上配置五个终端:右键点击切换绿色输入端,Shift + 右键点击切换红色输出端。底部终端是从上方靠近南侧边缘的位置选择的。对于 Minecraft → 硬件 模式使用绿色输入端,对于 Hardware → Minecraft 模式使用红色输出端。
OR(或)取最大值,AND(与)取最小值(包括零),XOR(异或)在有奇数个输入激活时传递最大值。在 Hardware → Minecraft 模式下,绿色输入端作为接收样本的启用条件。

安装与首个电路
共同要求: Minecraft Java 26.2 以及 Java 25 或更高版本。
| 构建版本 | 加载器与依赖项 |
|---|---|
| Fabric | 需要 Fabric Loader 0.19.3 或更高版本 以及 Fabric API,适用于 Minecraft 26.2。 |
| NeoForge | 需要 NeoForge 26.2.0.93 或更高版本,适用于 Minecraft 26.2。不需要 Fabric API。 |
安装与你的加载器匹配的 JAR 文件。多人游戏客户端和服务端必须使用兼容版本的 SerialCraft 和相同的加载器;混合加载器的多人游戏尚未验证。
- 在
mods文件夹中安装适用于你加载器的 SerialCraft JAR。如果使用 Fabric,请添加 Fabric API。在多人游戏中,请同时更新客户端和服务端上的 SerialCraft。 - 为 Arduino Uno R3、ESP32 或 Arduino Uno Q 刷入 现成示例。
- 将开发板插入 USB,或使其与你的 PC 位于同一局域网内。
- 制作笔记本电脑(Laptop)和连接器(Connector)。打开界面并通过 USB 或 Wi-Fi 欢迎卡片进行连接。
- 放置硬件 I/O 模块(Hardware I/O Module)。设置其通道和方向,然后在世界中配置其端子。
- 使用诊断工具(Diagnostics)、主页控制台和**可视化器(Visualizer)**来追踪信号从你的代码到红石,或返回开发板的路径。
硬件协议
发送以换行符结尾的通道名和整数,例如:
pot_val:200
硬件 I/O 值在两个方向上均为 0–255,映射到红石的 0–15 范围。数字输出发送 0 或 255。固件的波特率必须与模组匹配;默认值为 115200。有关遥测、配对和标识的信息,请参阅 协议参考。
范围与限制
- 多人游戏: 支持单人、局域网和专用服务器。每位玩家通过自己的 PC 连接硬件;专用服务器不拥有串行连接。
- 规模: 功能测试涵盖 64 个模块。可持续容量取决于刻时间和流量;通信预算按玩家共享,且开发板列表会滚动显示。
- 信号传输: 队列是有界的。TX 记录的是传输写入,而非执行器已执行的确认。在过载情况下,并非每次脉冲都能保证送达。
- Wi-Fi: TCP 未加密。配对仅适用于受信任的家庭或教室局域网;请勿将端口暴露于互联网。
文档与支持
SerialCraft 由 Leonardo Aliaga 开发,是一个旨在连接 Java 模组开发、电子技术和电信技术的学习项目。它基于 MIT 许可证 开源。
? SerialCraft: the bridge between worlds
Bring your real-world hardware into your Survival world.
Documentation · Source code · Report an issue
SerialCraft connects Arduino, ESP32 and other boards to Minecraft over USB or Wi-Fi.
What's new in 0.5.3-beta
- NeoForge support alongside Fabric, for Minecraft 26.2 and Java 25.
- Output settings: choose connection and normal-disconnection behavior independently: send zero or a custom value (0–255), restore saved values when connecting, or keep the last state when disconnecting.
Thanks to @MeerukYang for the report and suggestions in issue #10. Simplified Chinese translation by @SK-Xiaohan.
Main features
- Hardware → Minecraft: physical buttons, switches, and sensors drive redstone. A potentiometer can control signal strength; a switch on your desk can open your base's door.
- Minecraft → Hardware: redstone controls your board. Use a lever to switch an LED or a comparator to adjust its brightness through PWM.
- USB and Wi-Fi: connect directly over USB serial, or pair a TCP board on your local network. Remembered Wi-Fi boards reconnect through HMAC challenge-response without retyping the token.
- Events: stream health, hunger, world time, and game events to hardware through dedicated
mc_*channels. - Visualizer: inspect RX/TX messages on a timeline, compare a sensor with its redstone conversion, and test an actuator with the waveform generator on a dedicated channel.
- Board identification: USB descriptors and firmware announcements identify supported boards. Generic USB adapters are shown without claiming an unconfirmed board model.
- Output behavior: configure connection and normal-disconnection values from the settings gear. These preferences affect Minecraft → hardware I/O channels; telemetry and the waveform generator keep their own behavior.
- Configuration and diagnostics: configure direction, signal, and OR/AND/XOR logic; inspect RX, TX, redstone, and connection state. Contextual help is available through ?.
- Five locales: English, Spanish for Spain, Mexico and Argentina, and Simplified Chinese. SerialCraft follows your selected game language.
The Laptop has Home, Boards, Events, and Visualizer tabs, a connection welcome screen, a console within Home, and a settings page accessible from the top-right gear. Opening it keeps your world running in singleplayer.
Blocks and recipes

Laptop and Connector
Open the Laptop or right-click a placed Connector to access the interface. Choose a USB board on the welcome screen, or start the Wi-Fi server to display its local IP, port, and pairing token. USB defaults to 115200 baud; change it under Home → Apply and reconnect to match your firmware.

Hardware I/O Module
Right-click the base to set a Channel, data direction, signal type, and logic. The channel must match your sketch, such as pot_val or green_led; mc_ is reserved for game telemetry and identification.
Configure the five terminals directly on the placed block: right-click toggles a green input, and Shift + right-click toggles a red output. The bottom terminal is selected from above near the south edge of the board. Use green input for Minecraft → Hardware and red output for Hardware → Minecraft.
OR uses the maximum input, AND the minimum including zero, and XOR passes the maximum when an odd number of inputs are active. In Hardware → Minecraft mode, green inputs act as an enable condition for the received sample.

Installation and first circuit
Common requirements: Minecraft Java 26.2 and Java 25 or newer.
| Build | Loader and dependencies |
|---|---|
| Fabric | Fabric Loader 0.19.3 or newer and Fabric API for Minecraft 26.2. |
| NeoForge | NeoForge 26.2.0.93 or newer for Minecraft 26.2. Fabric API is not required. |
Install the JAR matching your loader. Multiplayer clients and the server must use compatible versions of SerialCraft and the same loader; mixed-loader multiplayer has not been validated.
- Install the SerialCraft JAR for your loader in
mods. Add Fabric API if using Fabric. In multiplayer, update SerialCraft on clients and server together. - Flash a ready-to-use example for an Arduino Uno R3, ESP32, or Arduino Uno Q.
- Plug the board into USB, or keep it on the same local network as your PC.
- Craft the Laptop and Connector. Open the interface and connect through the USB or Wi-Fi welcome card.
- Place a Hardware I/O Module. Set its Channel and direction, then configure its terminals in the world.
- Use Diagnostics, the Home console, and Visualizer to follow the signal from your sketch to redstone or back to the board.
Hardware protocol
Send a newline-terminated channel and integer, for example:
pot_val:200
Hardware I/O values are 0–255 in both directions, mapped to redstone's 0–15 range. Digital output sends 0 or 255. The firmware's baud rate must match the mod; the default is 115200. See the protocol reference for telemetry, pairing, and identification.
Scope and limits
- Multiplayer: works in singleplayer, LAN, and dedicated servers. Each player connects hardware through their own PC; the dedicated server does not own a serial connection.
- Scale: a functional test covers 64 modules. Sustainable capacity depends on tick time and traffic; communication budgets are shared per player and the board list scrolls.
- Signal delivery: queues are bounded. TX records a transport write, not acknowledgement that an actuator executed it. Every pulse is not guaranteed under overload.
- Wi-Fi: TCP is unencrypted. Pairing is intended for a trusted home or classroom LAN; do not expose the port to the internet.
Documentation and support
- Installation and usage guide
- Hardware I/O Module guide
- Protocol reference
- Board examples
- Tutorials
- Release notes
SerialCraft is developed by Leonardo Aliaga as a learning project connecting Java modding, electronics, and telecommunications. It is open source under the MIT license.
下载 SerialCraft
下载 SerialCraft
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SerialCraft
下载 SerialCraft
下载 SerialCraft
下载 SerialCraft
下载 SerialCraft
下载 SerialCraft
下载 SerialCraft
下载 SerialCraft
SerialCraft 0.5.3-beta — NeoForge 支持与输出设置
SerialCraft 现已在 Minecraft 26.2 和 Java 25 上同时支持 NeoForge 与 Fabric,共享其硬件协议、界面及玩法逻辑。
新增内容
- 提供独立的 Fabric 和 NeoForge 可安装 JAR 包,包含加载器特定的元数据以及内置的 USB/Wi-Fi 库。
- 新增设置页面,通过右上角齿轮图标即可访问,即使在未连接开发板时也可使用。
- 连接时:发送零值、发送自定义数值,或恢复当前世界、设备和通道的上次保存值。
- 正常断开连接时:发送零值、发送自定义数值,或不发送最终消息而保留最后状态。
- 独立的启动与关闭策略、支持 0 到 255 的自定义整数值,以及在丢弃未保存设置前进行确认。
- 更新了文档和项目描述,保留了来自 Modrinth 页面的最新图片。
感谢 @MeerukYang 在 issue #10 中提供的报告及关于可配置数值的建议。
安装方法
- 需要 Minecraft Java 版 26.2 以及 Java 25 或更高版本。
- 此 NeoForge 构建版本要求 Minecraft 26.2 使用 NeoForge 26.2.0.93 或更高版本。无需 Fabric API。
- 独立的 Fabric 构建版本需要 Fabric Loader 0.19.3 或更高版本,以及适用于 26.2 版本的 Fabric API。
- 请根据你的加载器安装对应的 JAR 包,并同步更新客户端和服务器端。混合加载器的多人游戏尚未验证。
输出设置仅适用于 Minecraft 到硬件的 I/O 通道。突然崩溃或未拔除线缆的情况无法发送最终值。本版本仍为测试版;图形化检查及物理 USB/Wi-Fi 开发板的检测仍需手动完成。
SerialCraft 0.5.1 Beta — 视觉标识
Minecraft Java 26.2 · Fabric Loader 0.19.3+ · Fabric API · Java 25+
更改内容
- 使用 Leonardo Aliaga 提供的新 SerialCraft 图像替换了
textures/gui/logo-txt.png。标题不再显示包含 Arduino 和 Minecraft 标志的旧组合。 - 将导航渲染更新为 PNG 的实际 1038 × 446 尺寸,保留其宽高比、透明度和居中对齐。
- 更新了版本说明、README 文件和 Modrinth 描述。GitHub 发行说明以西班牙语发布,Modrinth 说明以英语发布。
- 在 图像和商标审计(西班牙语)中记录了模组、网站以及公共 Modrinth 列表中的图形审查记录。
自 0.5.0 以来的文档更新还包括对规范 URL、索引、历史路由和语言切换的修复,以及英文数字/模拟指南和故障排除指南。
范围
此更新替换了标题标志。其他纹理和截图仍包含旧的标识,并在审计中标识;本次发布并不认证所有图像的权利。新的无限符号和其他品牌资产的外观也需要审查。
与 0.5.0-beta 的兼容性得以保留,包括已保存的世界、硬件通道和所有五种语言环境。USB/Wi-Fi 通信和方块逻辑保持不变。
请将 serialcraft-0.5.1-beta.jar 与 Fabric API 一起安装到 Minecraft 26.2 中。此版本仍然是 Beta 版。
SerialCraft v0.5.0 Beta — 0.5.0-beta
Minecraft Java 26.2 · Fabric Loader 0.19.3+ · Fabric API · Java 25+
本次测试版将 test 分支上开发的界面工作与社区的简体中文翻译合并在一个版本中。SerialCraft 通过双向硬件信号和游戏遥测数据,将 Arduino、ESP32、树莓派及其他串口或 TCP 设备与 Minecraft 连接起来。
预发布: 这是一个测试版(Beta),并非稳定版本。升级前请备份世界文件,并确保客户端和服务器端同时更新模组。图形界面的检查以及与物理 USB/Wi-Fi 开发板的测试仍需手动进行;自动化测试无法认证所有硬件配置。
界面与用户体验
- 水平导航: “主页”和“开发板”位于原始居中的 SerialCraft 标志左侧;“事件”和“可视化”位于右侧。原有的图标图集、页面强调色以及半透明视觉风格得以保留。
- 主页: 已连接设备卡片保留了随机选择的猫精灵图像。连接属性独立滚动,而双向终端保持在其独立的列中,以便消息和命令控件始终可访问。
- 欢迎界面: 连接屏幕使用垂直居中的半透明面板、USB 和 Wi-Fi 方法卡片、更清晰的间距以及针对已记住的开发板的单独通知。连接帮助和配对控件仍然可用。
- 共享控件: 玻璃质感的标题、边框、按钮内边距、外边距和文本对齐方式在面板间保持一致。导航和 IO 编辑器布局可根据可用的 GUI 空间进行调整。
- 开发板、事件、可视化及 IO 模块编辑器: 在更新的 panel 样式下保留其现有功能,包括配置、诊断和上下文帮助。标志、图标、猫精灵图集及现有资产均沿用,未进行重新设计。
简体中文 — Simplified Chinese
- 添加了
zh_cn.json,最初由 @SK-Xiaohan 在 PR #4 中贡献。 - 包含了建议的中文名称 串连世界,与 SerialCraft 品牌标识并列。感谢您帮助中国玩家社区连接 Minecraft 与现实世界的电子元件!
- 覆盖了欢迎界面、主页、导航、开发板、事件、可视化、IO 编辑器、帮助对话框、连接消息以及动态设备状态。
- 完成了在
test分支上新增的主页属性标签翻译,并保持终端的TX、RX和TM前缀在中文帮助文本中易于识别。所有五个语言文件包含相同的 402 个翻译键值以及兼容的 Minecraft 格式参数。 - 通过合并到
test分支保留了贡献者的原始提交和署名;贡献者信息也包含在模组元数据和 README 文件中。
发布与技术检查
- 使用语义化版本标识符
0.5.0-beta,该标识符从 Gradle 传播至 Fabric 元数据和 JAR 文件名。 - 增加了针对重复本地化键值、UTF-8/Unicode 编码、缺失翻译、格式参数、字面量和动态 UI 键值、归档完整性以及打包 UI 资产的自动化检查。
- 保持 Minecraft 26.2、Java 25、Fabric Loader/API 以及 Gradle 的版本不变。硬件通道、保存的方块 ID 和网络行为均保持不变。
- 将经过验证的 JAR 包作为 GitHub Pre-release(预发布) 发布,并附带英文发行说明。Modrinth 的发布和描述更新需要明确的手动选择加入;本版本不会发布到其他市场平台。
下载与测试
为 Minecraft 26.2 安装 serialcraft-0.5.0-beta.jar 以及 Fabric API。在 Minecraft 中,于语言设置中选择 简体中文(中国大陆) 即可使用中文界面。
若要在 IntelliJ IDEA 中进行源代码测试,请检出标签 v0.5.0-beta,选择 JDK 25 作为项目和 Gradle JVM,导入 Gradle 项目,然后运行 build 和 runClient。在多种 GUI 缩放比例下检查所有页面、滚动区域、工具提示和 IO 编辑器部分;使用物理开发板验证 USB 和 Wi-Fi 功能。
Documentation · Report an issue
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
一个用于收集生物掉落物的多区块模组。
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
AE2:一款流行的自动化与存储模组
评论 0
登录后参与评分
还没有评论,来抢沙发吧