Logo
SerialCraft
ModMIT

SerialCraft

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

48
Downloads
3
Followers
4 months ago
Updated
📦
4
Versions
game-mechanicstechnologyutilityfabric
Download Latestv0.3.6View on Modrinth

📖About SerialCraft

SerialCraft 📦 v0.3.6

The Bridge Between Worlds

Connect your Arduino to Minecraft Java (Fabric 1.21.10) and bring electronics into Survival mode.

Fabric
Minecraft
License

📚 Documentation

Full Guide & Wiki: https://leonardoaliaga.github.io/SerialCraft/

What is SerialCraft?

SerialCraft is a mod that breaks the fourth wall, allowing real-time bidirectional communication between the game and external electronic devices (Arduino, ESP32, Raspberry Pi Pico, etc.).

Unlike other technical mods, SerialCraft is designed to integrate organically into the Survival experience. No magic commands—you build the hardware, you configure the connections, and you craft the logic.

✨ Key Features

  • 🔌 Plug & Play: Compatible with any Serial/USB board.
  • 💻 In-Game UI: Simple graphical interface to select ports and baud rates without editing config files.
  • ⚡ Bidirectional:
    • Input (Physical -> Game): Use real sensors (light, sound, buttons) to trigger Redstone.
    • Output (Game -> Physical): Use Redstone to turn on real LEDs, motors, or buzzers.
  • 🧠 Logic Gates: The blocks include internal logic (AND, OR, XOR) for advanced circuit safety.

📦 Blocks & Recipes

Models

1. The Connector Block (Laptop)

The brain of the operation. It handles the USB connection to your real-world device.

  • Usage: Right-click to open the UI. Select your Port and Baud Rate (must match your Arduino code, e.g., 9600).
  • Settings: You can adjust the "Read Speed" (Fast, Normal, Low) to prevent lag if your board sends too much data.

UI Connector Block

Crafting Recipe

Connector Block Recipe

2. The IO Block (Arduino IO)

The physical bridge. This block connects to the Laptop wirelessly (logic-wise) and interacts with Redstone.

  • Pin System:
    • Right Click on a side connector: Sets pin to IN (Green). Reads Redstone.
    • Shift + Right Click on a side connector: Sets pin to OUT (Red). Emits Redstone.
  • Configuration: Right-click the block to set the Target ID (e.g., LED_1 or SENSOR_A) and the signal type (Analog vs Digital).

IOBlock UI
IOBlock Model

Crafting Recipe

IOBlock Recipe

🚀 Quick Start (Protocol)

Communication is text-based using KEY:VALUE format ending with a newline (\n).

Arduino Example:

void setup() {
  Serial.begin(9600); // Matches the Laptop Block settings
}

void loop() {
  // Send data to Minecraft (Block ID "btn_1", Value 15)
  Serial.println("btn_1:15"); 
  delay(50);
}

🤝 Community & Support