Skip to content

UserConfig

The settings in mspacker.config.ts. Only version and namespace are required.

optional description?: string

The pack description in pack.mcmeta.


optional java?: string

Path to java. Default: JAVA_HOME, PATH, then the launcher’s bundled runtime.


optional minecraftRoot?: string

Minecraft launcher root (for singleplayer saves). Overridden by MINECRAFT_ROOT.


optional name?: string

Pack folder name. Defaults to the package name / project dir.


namespace: string

“mypack”, “mypack:”, “mypack:generated” or “mypack:generated/”


optional outDir?: string

Build output dir. Default “dist”.


optional parsers?: Record<string, UserParserDef>

Add or override argument parsers, keyed by brigadier parser id (e.g. “minecraft:particle”). Use this when a new Minecraft version adds or changes an argument type before MSPacker is updated. Fields you leave out keep the built-in behavior (or the string fallback). type changes generated signatures, so re-run mspacker gen after editing it.


optional raw?: string

Raw datapack files merged into the output verbatim. Default “datapack”.


optional server?: object

The dev server (mspacker dev).

optional dir?: string

Server dir used by dev (world + datapacks). Overridden by MSPACKER_SERVER_DIR. Default “server”. If it contains a server jar, that jar is used; otherwise the official jar is downloaded.

optional download?: boolean

Download the official server jar when none is provided. Default true.

optional host?: string

RCON host. Default “127.0.0.1”.

optional jar?: string

Jar file name inside the server dir. Default “server.jar” or the only *.jar.

optional jvmArgs?: string[]

Extra JVM args for the server mspacker dev starts.


optional src?: string

TS source dir. Default “src”.


version: string

Minecraft version id, must match the server jar (e.g. “26.3” or “26.3-snapshot-1”).