Documentation hub

The website is the front door. The repo stays the deep source.

This page connects the homepage to the existing markdown documents in the project and to the dedicated block reference pages on the site itself. That keeps named screens, Material I/O routing, builder templates, runtime sandbox rules, and the deeper technical notes aligned instead of letting the site drift away from the repo docs.

Source documents

Jump directly into the existing project docs.

README

Project overview, toolchain, block families, in-game controls, and API surface.

Open README
Beginner Programming Guide

The first readable entry point for Python, named screens, Material I/O routes, builder helpers, repeated scripts, and the runtime safety boundary.

Open guide
Block Status Matrix

Status, priority, and next steps per block family.

Open matrix
Roadmap

The larger work streams and their sequencing.

Open roadmap
Network Scenarios

Reproducible in-game scenarios for discovery, segmentation, and cable topology.

Open scenarios
Bridge Policy Scenarios

Acceptance cases for XLAPI remote policy and structured bridge responses.

Open bridge scenarios
Block references

Reach every block guide from the docs hub.

The block overview remains the best entry point for browsing the full system, but the technical reference pages are now linked here as well so the docs hub can act as a real index for per-block behavior and Python commands.

Overview and core runtime

Start with the block overview or jump directly into the computer and screen references.

Network and bridge blocks

Physical network topology, discovery behavior, cross-segment bridge rules, and display/debug surfaces.

Material flow references

Inventory and fluid inspection, per-side I/O state, and direct endpoint-to-endpoint transfers.

Crafting references

Recipe-grid control, linked previews, queued plans, and Crafting CPU execution methods.

Local preview

View the homepage from inside the repository.

PowerShell
Set-Location "D:\projekt\XLLogic"
py -m http.server 4173 -d docs/site

Then open http://localhost:4173 in the browser. For a quick smoke test, opening docs/site/index.html directly also works.

Toolchain

The technical base the site should communicate clearly.

Minecraft

Target version 1.21.1 with NeoForge 21.1.218.

Runtime

Java 21 plus GraalPy for embedded Python execution inside a sandboxed host boundary.

Quality

JUnit and NeoForge GameTests cover runtime, network, named screen, Material I/O, and session flows.