?
Host a serverModrinth App
Sign in
ModsResource PacksData PacksShadersModpacksPluginsServers
Settings
SerialCraft

SerialCraft

Bring Redstone to life! A simple mod to connect Arduino and Minecraft via serial port. No complications, just plug and play.

307downloads
4followers
307downloads
4followers

Compatibility

Minecraft: Java Edition

26.2
1.21.10–1.21.11

Platforms

Supported environments

Singleplayer only
Client and server

Links

Report issues View source Visit wiki Join Discord server
Donate on Ko-fi

Tags

Creators

Details

Licensed MIT
Published 10 months ago
Updated 51 minutes ago

🔌 SerialCraft: the bridge between worlds

Bring your real-world hardware into your Survival world.

Documentation · Source code · Report an issue

Fabric Minecraft Java Version License

SerialCraft is an experimental, educational Fabric mod that connects Arduino, ESP32, and other serial or TCP devices to Minecraft. Send real sensor readings into redstone circuits and use your world to control physical LEDs, buzzers, and other components.

The Laptop, Connector, and Hardware I/O Module have crafting recipes, so your electronics can become part of a Survival playthrough.

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.
  • Configuration and diagnostics: configure direction, signal, and OR/AND/XOR logic; inspect RX, TX, redstone, and connection state. Contextual help is available through ?.
  • Four locales: English and Spanish for Spain, Mexico, and Argentina. SerialCraft follows your selected game language.

The Laptop has Home, Boards, Events, and Visualizer tabs, a connection welcome screen, and a console within Home. Opening it keeps your world running in singleplayer.

Blocks and recipes

SerialCraft blocks

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.

Laptop recipe

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.

Hardware I/O Module Hardware I/O Module recipe

Installation and first circuit

Requirements: Minecraft Java 26.2, Java 25 or newer, Fabric Loader 0.19.3 or newer, and Fabric API for Minecraft 26.2.

  1. Install SerialCraft and Fabric API in your mods folder. In multiplayer, update SerialCraft on clients and server together.
  2. Flash a ready-to-use example for an Arduino Uno R3, ESP32, or Arduino Uno Q.
  3. Plug the board into USB, or keep it on the same local network as your PC.
  4. Craft the Laptop and Connector. Open the interface and connect through the USB or Wi-Fi welcome card.
  5. Place a Hardware I/O Module. Set its Channel and direction, then configure its terminals in the world.
  6. 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

SerialCraft is developed by Leonardo Aliaga as a learning project connecting Java modding, electronics, and telecommunications. It is open source under the MIT license.