Materione
One free, open-source Minecraft plugin + web editor replacing the content-creation stack
(ItemsAdder / Oraxen / Nexo / BetterHUD / DeluxeMenus-class tools) with a single unified
system: content files on disk are the source of truth, one pipeline takes them to runtime,
and a browser editor (with embedded Blockbench) edits the same files — no port forwarding
required.
Status: M0–M4 shipped. The plugin boots on Paper 1.21.4+ and carries real content:
items with custom models, recipes and mechanics; custom blocks of every state technique
plus shaped stairs/slabs; furniture clusters (seats, storage, lights, evolution); an ECA
rule engine; glyphs, emoji and GLSL text effects; custom sounds, music discs and
paintings — all hot-reloadable (media applies restart-required through the staging
ledger). The direct-mode web editor works today: /materione editor prints a capability
URL, the browser completes a signed, encrypted handshake after an in-game approval, and
lands in a VS Code-style workbench — file-tree explorer with scaffolded
create/rename/move, form-first type editors with texture pickers (YAML stays one click
away as a dev tool), an embedded pinned Blockbench build with save-back and .bbmodel
import, a pixel editor, live diagnostics, and a control center with manual reloads,
settings editing and the audit trail. Hand-edited files on disk stream into open editors
instead of colliding. Every save goes live via targeted reload (<2 s round trip enforced
in CI). The cloud editor at editor.materione.com (M5) works from behind NAT with zero setup. Next: menus/dialogs/HUDs (M6). See
docs/roadmap.md, the editor quickstart,
and the feature-parity matrix — ItemsAdder/Oraxen/Nexo side by
side with what Materione has added (and what's QA-tested) per feature.
Build & test
./gradlew build # unit + ArchUnit ban tests
./gradlew :harness:integrationTest # real headless Paper boot of the shaded jar
Java 21 required (auto-provisioned via toolchain if missing). First integration run
downloads a pinned, sha256-verified Paper jar (~50 MB).
License: TBD (tracked as an open question — see docs/architecture.md §14).
