KnullCLI Documentation

Compile, inspect, decompile, and view KMDL files.

Quick Commands

knullcli compile <INPUT.kparams> [-o OUTPUT.kmdl] [-v]
knullcli inspect <INPUT.kmdl> [-v]
knullcli decompile <INPUT.kmdl> [-d OUT_DIR] [-v]
knullcli view <INPUT.kmdl>
knullcli gui [INPUT.kmdl]
knullcli formats

Typical Workflow

knullcli compile examples/player.kparams -o build/player.kmdl -v
knullcli inspect build/player.kmdl -v
knullcli view build/player.kmdl

KMDL Requirements

Magic must be KMDL, little-endian encoding.
Current supported major version is 1.
Sections must use known kinds: mesh group, texture group, mesh, texture, skeleton, animation, material.
Vertex layout is fixed at 80 bytes (position/normal/tangent/uv0/uv1/color/bones/weights).
Texture payloads must be encoded as PNG, JPEG, or BMP blobs.

Addon Model Rule

Addon models must be in .kmdl format. Non-kmdl model entries are rejected by the runtime addon manager.

Authoring Inputs

KnullCLI compiles from .kparams TOML authoring files. Source model formats currently supported by the compiler include glTF/GLB, OBJ, and FBX.