Kommands

A command generator for Minecraft: Java Edition. Build /give, /tellraw, /execute, and WorldEdit commands through a UI instead of memorising syntax — with 3D previews for the commands that describe shapes.

Targets Java Edition 1.21.1.

It ships two ways from one codebase: a hosted web app, and a standalone desktop app that works with no internet and can hand commands to Konnekt. See docs/distribution.md.

Why it is built this way

Minecraft command syntax changes in ways that are easy to get wrong. Between 1.21.1 and 1.21.5 the enchantments component was restructured, every attribute ID was renamed, and text components moved from JSON strings to SNBT. A generator that hardcodes syntax for one version silently emits invalid commands for every other.

So Kommands treats commands as data:

• Command definitions are declarative. Adding a command means adding a definition, not writing a page.
• Vanilla definitions are derived from the Brigadier command tree published by misode/mcmeta, pinned per version.
• Game values are versioned data. Item IDs, entities, enchantments, effects and particles come from per-version registries — nothing is hardcoded.
• Syntax differences are trait flags, not version comparisons, so supporting a new version is a data change rather than a refactor.

Status

The app is scaffolded and generating. Four commands are complete — /give, /tellraw, /execute and //generate — and every one of the 78 vanilla skeletons derived from mcmeta is reachable through a single dynamic route. WorldEdit's expression language has a headless evaluator, specified against WorldEdit's own test suite rather than by description, and //generate now has a 3D preview: the formula is evaluated across the selection and drawn as voxels, hollow included, with Three.js loaded only by the commands that need it.

The web build is not deployed yet and the desktop shell is not written yet. Next up is giving a command a life beyond the tab that built it: saved commands, a dashboard that replaces the placeholder landing page, the Wails v2 shell, and the link into Konnekt.

See docs/roadmap.md for what is planned Now / Next / Later, and the issue tracker for what is in flight.

Getting started

pnpm install
pnpm gen      # derive command data + design tokens
pnpm dev

Documentation

Document	Contents
Architecture	How the system fits together, and the reasoning behind it
Distribution	The web and standalone builds, and the Konnekt boundary
Persistence	Saved commands, links, and the file Konnekt reads
Command schema	The authoritative definition schema
Minecraft versions	Syntax trait matrix — what differs per version
Adding a command
Adding a version
Adding a preview
The //generate editor	What //generate can express, and the shape of its 3D editor
Design tokens
Roadmap

Licence

Kommands is free software under the MIT licence: use it, change it and share it, commercially or not, as long as the licence notice travels with it.

The MIT licence covers the code written for this project. NOTICE lists what it does not cover: Minecraft game data, WorldEdit test cases transcribed under the GPL, and the Wails packaging templates. It also explains the licence texts that every build ships in third-party-licenses.txt.

NOT AN OFFICIAL MINECRAFT PRODUCT. NOT APPROVED BY OR ASSOCIATED WITH MOJANG OR MICROSOFT.

Credits

Minecraft data is sourced from misode/mcmeta. WorldEdit command definitions are authored from EngineHub/WorldEdit sources.

Not affiliated with Mojang, Microsoft, or EngineHub.