XL Logic Python, cable logic, and block-based automation for Minecraft 1.21.1
Wire it. Script it. Watch it run.

Automation that feels like a real machine room.

XL Logic combines a server-authoritative GraalPy runtime, local cable-segment discovery, named screen targets, direct Material I/O routing, and a no-code builder into one Minecraft automation stack. Instead of placing isolated gadgets, you wire explicit control flows: sample world and device state, route items and fluids between endpoints, target dedicated display panels, and drive repeatable production logic. The runtime stays sandboxed, so scripts execute through exported XL Logic APIs rather than the host OS, local files, spawned processes, Java interop, or server-admin commands.

Explore the feature set See Python examples Understand the builder
Runtime GraalPy on Java 21
Target Minecraft 1.21.1 + NeoForge 21.1.218
Authoring Python and no-code builder side by side
Validation 50/50 GameTests passing
Why XL Logic?

One coherent system instead of a pile of disconnected gadgets.

This mod is not just a computer block with a text editor. It blends network topology, world-state logic, remote policies, multiplayer session handling, visible output, and a builder for players who do not want to start with Python.

Python as the control language

The computer runs in a server-side GraalPy context with explicit host restrictions, which makes automation reproducible, network-aware, visible on linked screens, and isolated from host-level execution paths.

No-code for beginners

The builder generates real Python while staying readable as a flat block list. Templates, comparisons, direct Material I/O routes, and world checks already cover practical in-game use cases.

Cables first

Discovery, screen assignment, bus channels, and XLAPI bridges all rely on visible wiring in the world, so the logic remains physical and inspectable.

Fast entry points

Four ways into the project.

The site is intentionally split into focused sections so players, map makers, and future contributors can jump directly to the right layer.

Feature overview

From editor leases and recovery drafts to named screen targets, rich output, and XLAPI bridge policy.

Open features
Python guide

Hello World, repeat loops, device access, screen output, and practical sensor and redstone examples.

Open Python guide
Block editor

Templates, logic blocks, else branches, world comparisons, and ready-made source-to-sink routes for players who do not want to type code by hand.

Open builder page
Try the feel of it

A small XL Logic script

The mix of world status, device lookup, and visible output is the core feeling of the mod. That is why the front page should show a real script immediately.

python / source_to_sink.py 
source = get_device("source_io")
left_panel = get_device("left_panel")
right_panel = get_device("right_panel")

def tick():
    moved = 0
    if source is not None:
        moved = source.transfer_item_to("sink_io", "south", "south", 0, 16)

    if left_panel is not None:
        left_panel.show("Route", {
            "target": "sink_io",
            "moved": moved,
        })

    if right_panel is not None and world.available():
        right_panel.show("World", {
            "day_time": world.day_time(),
            "raining": world.is_raining(),
        })

yield from repeat(tick, 20)
Go deeper

From here into the details.

Once the branding and landing page are in place, these are the next logical destinations for visitors.

Blocks in detail

What block families exist, what is already implemented, and how they work together.

Open block overview
Repository documents

Original sources like the roadmap, beginner guide, and status matrix remain linked and easy to reach.

Open docs hub
Features and architecture

Runtime, network model, named screens, Material I/O routing, multiplayer handling, and test coverage in a structured overview.

Read the architecture page