SerialCraft

模组

· 作者 LeonardoAliaga

让红石活起来!一款简单的模组,通过串口连接 Arduino 和 Minecraft。无需复杂设置,即插即用。

0 本站下载 0 关注 更新于 2 周前

需要前置:Fabric API

最新 0.5.3-beta-fabric · 26.2 · Fabric

一键开服(送7天)

? 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(可视化器)标签页,一个连接欢迎屏幕,主页内的控制台,以及右上角齿轮可访问的设置页面。打开它不会暂停单人游戏中的世界运行。

方块与合成配方

SerialCraft blocks

笔记本电脑与连接器

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

Laptop recipe

硬件 I/O 模块

右键点击底座以设置 Channel(通道)、数据方向、信号类型和逻辑。通道必须与你的代码(sketch)匹配,例如 pot_val 或 green_led;mc_ 保留用于游戏遥测和识别。

直接在已放置的方块上配置五个终端:右键点击切换绿色输入端,Shift + 右键点击切换红色输出端。底部终端是从上方靠近南侧边缘的位置选择的。对于 Minecraft → 硬件 模式使用绿色输入端,对于 Hardware → Minecraft 模式使用红色输出端。

OR(或)取最大值,AND(与)取最小值(包括零),XOR(异或)在有奇数个输入激活时传递最大值。在 Hardware → Minecraft 模式下,绿色输入端作为接收样本的启用条件。

Hardware I/O Module Hardware I/O Module recipe

安装与首个电路

共同要求: 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 和相同的加载器;混合加载器的多人游戏尚未验证。

  1. 在 mods 文件夹中安装适用于你加载器的 SerialCraft JAR。如果使用 Fabric,请添加 Fabric API。在多人游戏中,请同时更新客户端和服务端上的 SerialCraft。
  2. 为 Arduino Uno R3、ESP32 或 Arduino Uno Q 刷入 现成示例。
  3. 将开发板插入 USB,或使其与你的 PC 位于同一局域网内。
  4. 制作笔记本电脑(Laptop)和连接器(Connector)。打开界面并通过 USB 或 Wi-Fi 欢迎卡片进行连接。
  5. 放置硬件 I/O 模块(Hardware I/O Module)。设置其通道和方向,然后在世界中配置其端子。
  6. 使用诊断工具(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 许可证 开源。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源