Configuration
import { defineConfig } from "@ofekn/mspacker";
export default defineConfig({ version: "26.3", namespace: "mypack:generated/", description: "My pack", server: { dir: "server" },});The config can also be mspacker.config.mts, .js or .mjs.
version
Section titled “version”Required. The Minecraft version id, exactly as in the launcher: "26.3",
"26.4-snapshot-7", "1.20.4", "24w14potato". It decides which server jar is used, what the
command library contains and the pack.mcmeta format. Run mspacker gen after changing it.
namespace
Section titled “namespace”Required. The namespace of your functions, with an optional path prefix:
| Value | Functions go to |
|---|---|
"mypack" or "mypack:" |
mypack:<file>/<name> |
"mypack:generated" or "mypack:generated/" |
mypack:generated/<file>/<name> |
See function ids.
The pack’s folder and zip name. Defaults to the name in package.json (without its scope), then the
project directory name.
description
Section titled “description”The pack description in pack.mcmeta.
TypeScript source directory. Default "src".
Directory copied into the pack as-is. Default "datapack". See tags and files.
outDir
Section titled “outDir”Build output directory. Default "dist".
server
Section titled “server”| Option | Default | |
|---|---|---|
dir |
"server" |
Dev server directory. MSPACKER_SERVER_DIR overrides it. |
jar |
server.jar, or the only *.jar |
Jar file name in dir. |
download |
true |
Download the official jar when dir has none. |
host |
"127.0.0.1" |
RCON host. |
jvmArgs |
[] |
Extra JVM arguments for the server mspacker dev starts, e.g. ["-Xmx2G"]. |
Path to the java executable. By default, MSPacker uses the Java runtime the Minecraft
launcher installed for your version (the same Java the game runs on), then JAVA_HOME, then java
on the PATH. Old versions need old Java (1.16 and earlier run on Java 8), so launching a version
once in the launcher is the easiest way to get the right runtime.
minecraftRoot
Section titled “minecraftRoot”The Minecraft launcher directory, used for singleplayer saves and Java runtimes. MINECRAFT_ROOT
overrides it. Default: the OS’s standard location. Server jars are never taken from it.
parsers
Section titled “parsers”Advanced: describe values a new Minecraft version added or changed. See new value types.
Environment variables
Section titled “Environment variables”| Variable | |
|---|---|
MSPACKER_SERVER_DIR |
Overrides server.dir. |
MINECRAFT_ROOT |
Overrides minecraftRoot. |
JAVA_HOME |
Java to use when java isn’t set. |
MSPACKER_DEBUG |
Set to 1 to show full stack traces for build errors. |