MnaJS

KubeJS support surface for Mana and Artifice on Forge 1.20.1.

This repository exposes typed-id driven KubeJS registration, recipe builders, runtime events, state helpers, pattern utilities, and ProbeJS completion support for M&A content.

Docs

• Documentation Overview
• KubeJS Support Reference
• Bindings
• Registries
• Recipes
• Events
• Helpers And Probe

Design Docs

• Surface Stabilization Brainstorming
• Surface Stabilization Design

Validation Status

Last reviewed: 2026-04-26

Verified in this repo:

• ./gradlew compileJava
• ./gradlew runServer
• example startup registration for kubejs:moonsteel
• example construct part registration for kubejs:moonsteel_basic_head

Example Scripts

• Usage notes: example/README.md
• Startup examples: example/startup_scripts/example.js
• Server examples: example/server_scripts/example.js
• Client examples: example/client_scripts/example.js

Documentation Scope

The reference docs aim to cover the current user-facing MnaJS support surface:

• startup registries
• startup and server events
• recipe chains and event.custom() helpers
• typed ids and script bindings
• player/world helpers
• ProbeJS completion wiring

Where a feature is intentionally limited, the docs say so explicitly instead of pretending the surface is deeper than it is.