mbt command line
Every mbt command and option: 25 commands, generated from the tool itself.
Run ./mbt.cmd <command> on Windows or ./mbt.sh <command> on macOS and Linux from the engine root. This page is generated from the tool's own command definitions, so it always matches the build you have.
Global options
These work with every command.
| Option | Type | Default | Description |
|---|---|---|---|
--verbose, -v | bool | Enable verbose output | |
--dry-run | bool | Show what would be done without executing | |
--progress | string | console | Progress output format (console, json) |
mbt asset
Inspect asset packages (any asset or level file) and migrate text assets into them
mbt asset diff
Property-level diff of two MDF documents or asset packages
| Argument | Type | Description |
|---|---|---|
<before> | string | Earlier file |
<after> | string | Later file |
mbt asset dump
Print an asset package as text (the git textconv for the binary asset types)
| Argument | Type | Description |
|---|---|---|
<file> | string | Package file |
mbt asset merge
Three-way property merge of MDF documents; the result replaces <ours>
| Argument | Type | Description |
|---|---|---|
<base> | string | Common ancestor (git %O) |
<ours> | string | Our version, overwritten with the merge (git %A) |
<theirs> | string | Their version (git %B) |
| Option | Type | Default | Description |
|---|---|---|---|
--visual-script | bool | The files are Visual Script graphs or classes (.vscript): merge by node id |
mbt asset migrate
Convert a project's text assets into packages under their own extensions (.mmap + __ExternalActors__ for levels); a mesh package's .mmeshmeta/.manimmeta settings move into its payload
| Argument | Type | Description |
|---|---|---|
<project> | string | The project's .mproject file |
| Option | Type | Default | Description |
|---|---|---|---|
--report-only | bool | Report what would change and write nothing | |
--source-art | bool | Move texture and model sources from Content/ to SourceArt/ and import them as binary packages (.tex, .mesh, .skmesh, ...) |
mbt asset primary
List a project's primary assets, their chunks and cook rules
| Argument | Type | Description |
|---|---|---|
<project> | string | The project's .mproject file |
| Option | Type | Default | Description |
|---|---|---|---|
--write-chunks | bool | Regenerate Config/Chunks.ini from the primary asset rules |
mbt build
Build engine modules
| Option | Type | Default | Description |
|---|---|---|---|
--target, -t | string | Build specific target module | |
--config, -c | BuildConfiguration | Dev | Build configuration: debug | dev | profile | release | debuggame (default: dev) |
--platform, -p | string | Target platform: win-x64 | linux-x64 | osx-arm64 | android-arm64 | ios-arm64 (default: host). Non-host targets cross-compile — set MOWO_LINUX_SYSROOT / SDKROOT / ANDROID_NDK_ROOT; ios needs a macOS host with Xcode. | |
--jobs, -j | int | logical CPU count | Max parallel compile jobs |
--shared-cache | string | Team object cache: a shared directory or an S3-compatible https:// bucket (also MBT_SHARED_CACHE). Objects are pulled before compiling and pushed after | |
--shared-cache-read-only | bool | Pull from the shared cache but never push to it (also MBT_SHARED_CACHE_PUSH=0) | |
--hot-reload | bool | Link the -t module to a versioned output (<name>.v<N>.dll) for live coding | |
--extra-source | string[] | Additional directory to scan for *.Build.cs modules (game project Source/) | |
--option, -o | string[] | Custom build option KEY=VALUE for the rules (e.g. -o MOWO_ENABLE_FSR=true) |
mbt clean
Remove build artifacts
| Option | Type | Default | Description |
|---|---|---|---|
--all | bool | Also remove intermediate caches |
mbt cook
Cook and pack assets into MEAF archives
| Option | Type | Default | Description |
|---|---|---|---|
--assets, -a | string | Asset source directory (default: Content/ of the project found from the current directory upward, else of the engine) | |
--output, -o | string | Output .meaf path | |
--compression, -c | MeafCompression | Fast | Compression level (None, Fast, Default, Best) |
--force, -f | bool | Force recook all assets | |
--meaf-builder | string | Path to meaf_builder executable | |
--meaf-encrypt-key | string | Hex key file (32 bytes) — encrypt archive TOCs + payloads (see MeafBuilder keygen) | |
--meaf-key-id | UInt32 | 0 | Encryption key id stored in the archive header |
--meaf-sign-key | string | Hex secret key file (64 bytes) — sign the archives | |
--scenes | string | Comma-separated entry level (.mmap) paths — cook only what they reference | |
--raw-assets | bool | Pack texture (PNG/JPG/BMP/TGA) and mesh (FBX/glTF/OBJ/DAE) sources as-is instead of cooking them to .mtex/.mmodel | |
--mdf-text | bool | Pack MDF game data as raw text instead of mdfb binary (debug fallback) | |
--astc | bool | Cook LDR textures to ASTC 6x6 (mobile GPUs have no BC) instead of BC7/BC5 | |
--platform, -p | string | Cook for a target platform: win-x64 | linux-x64 | osx-arm64 | android-arm64 | ios-arm64. A mobile target cooks ASTC textures and Opus audio; the target's Shaders.meaf is built beside the archive; the default output goes to <cook dir>/<Platform>/. Default: the host, into <cook dir>/ as before | |
--audio-codec | string | Cook every clip to this codec over its import settings: pcm16 | pcm24 | float | opus. Default: opus for a mobile --platform, else each clip's own | |
--no-shaders | bool | With --platform, skip building the target's Shaders.meaf beside the archive | |
--strict-refs | bool | Fail the cook when a scene/material/prefab reference cannot be resolved to a file | |
--allow-raw | bool | Pack texture/mesh sources raw when their transcode cannot run (MowoGame missing or the batch failed) instead of failing the cook | |
--no-validate | bool | Skip the asset-validation gate (MowoGame --validate-assets) | |
--config | BuildConfiguration | Build of MowoGame/MeafBuilder/MdfTool/MaudioTool the cook runs (default: dev, then debug): debug | dev | profile | release | debuggame |
mbt crypto
Content keys of a project (Config/DefaultCrypto.ini): generate or show them
mbt crypto generate
Generate the encryption key and the signing key pair a package is protected with. Existing keys are kept unless --force
| Option | Type | Default | Description |
|---|---|---|---|
--project | string | Game project manifest (.mproject). Default: the manifest at the build root, if there is exactly one. | |
--encryption | bool | Only the encryption key | |
--signing | bool | Only the signing key pair | |
--force | bool | Replace keys that already exist. A build made with a new key cannot open archives an older build shipped — patches and DLC included |
mbt crypto import-signing-key
Put the signing private key of the project's public key into this user's key store (a new machine, a teammate)
| Option | Type | Default | Description |
|---|---|---|---|
--project | string | Game project manifest (.mproject) | |
--file | string | A file holding the 128-hex-digit private key (a key-store file, or MeafBuilder's meaf_signing.key) |
mbt crypto migrate
Move a signing private key committed in Config/DefaultCrypto.ini (the layout before 2026-10-13) to this user's key store and rewrite the file without it
| Option | Type | Default | Description |
|---|---|---|---|
--project | string | Game project manifest (.mproject) |
mbt crypto show
Say which keys the project has, without printing them
| Option | Type | Default | Description |
|---|---|---|---|
--project | string | Game project manifest (.mproject) |
mbt ddc
Inspect, prune or purge a project's derived data cache
mbt ddc info
Report the cache size, entry count and largest entries
| Option | Type | Default | Description |
|---|---|---|---|
--project | string | Project directory or .mproject file (default: found by walking up from the working directory) | |
--top | int | 10 | How many of the largest entries to list |
mbt ddc prune
Evict least recently used entries until the cache fits a size budget
| Option | Type | Default | Description |
|---|---|---|---|
--project | string | Project directory or .mproject file (default: found by walking up from the working directory) | |
--max-size | int | 4096 | Budget in MB (the same default as the engine's ddc.MaxSizeMB) |
mbt ddc purge
Delete every entry in the cache
| Option | Type | Default | Description |
|---|---|---|---|
--project | string | Project directory or .mproject file (default: found by walking up from the working directory) |
mbt ddc serve
Serve a cache folder over HTTP to every engine and mbt that sets MOWO_DDC_HTTP
| Option | Type | Default | Description |
|---|---|---|---|
--project | string | Project directory or .mproject file (default: found by walking up from the working directory) | |
--root | string | Cache folder to serve (default: the project's Intermediate/DerivedDataCache) | |
--bind | string | 0.0.0.0 | Listen address |
--port | int | 8558 | Port |
--token | string | Bearer token every request must carry (also MOWO_DDC_SERVER_TOKEN) | |
--readonly | bool | Refuse writes | |
--max-size | int | 0 | Size cap in MB, least recently used evicted past it (0 = none) |
--mowo-ddc | string | Path to the MowoDDC executable (default: found in the engine's binaries) |
mbt doctor
Check build environment and dependencies
mbt generate
Generate IDE project files
mbt generate compile-commands
Generate compile_commands.json only
| Option | Type | Default | Description |
|---|---|---|---|
--output, -o | string | Output path (default: compile_commands.json) |
mbt generate vs
Generate Visual Studio solution (.slnx or .sln + .vcxproj)
| Option | Type | Default | Description |
|---|---|---|---|
--output, -o | string | Output directory (default: build/) | |
--format | SolutionFormat | Slnx | Solution file format: slnx (VS 17.10+, default) or sln (legacy) |
--project | string | Game project (.mproject): emit a per-project solution INSIDE the project dir that builds the game module(s) against the prebuilt engine |
mbt generate vscode
Generate VSCode config (compile_commands.json + tasks.json)
mbt generate xcode
Generate an Xcode project (external-build-tool target wrapping mbt, per-module source groups, LLDB run scheme)
| Option | Type | Default | Description |
|---|---|---|---|
--output, -o | string | Output directory (default: build/) |
mbt info
Show project information and modules
mbt init
Create a new MowoEngine project from template
| Argument | Type | Description |
|---|---|---|
<name> | string | Project name |
| Option | Type | Default | Description |
|---|---|---|---|
--output, -o | string | Output directory (default: ./<name>) | |
--no-source | bool | Skip the C++ game module scaffold (content-only project) |
mbt livecoding
Compile the .cpp files changed since the running binaries were linked into objects a running editor or game patches in (Live Coding)
| Option | Type | Default | Description |
|---|---|---|---|
--config, -c | BuildConfiguration | Dev | Configuration of the running binaries: debug | dev | profile | release | debuggame (default: dev) |
--source | string[] | Compile only these sources (default: every .cpp newer than its module's binary) | |
--as | string[] | Compile each --source as if it were this file of the tree (same module, flags and includes) | |
--out | string | Directory for the objects (default: .mbt-cache/livecoding/<config>) | |
--report | string | Write the report here for the engine to apply (tab-separated: patch|refused|error) |
mbt liveops
Live-ops tools: sign a remote-config document, render the telemetry dashboard
mbt liveops report
Render the telemetry dashboard (HTML) from telemetry journals
| Argument | Type | Description |
|---|---|---|
<inputs> | string[] | Journal files or folders of *.jsonl (default: Saved/Telemetry) |
| Option | Type | Default | Description |
|---|---|---|---|
--out, -o | string | HTML file to write (default: Saved/Telemetry/report.html) | |
--title | string | Telemetry | Page title |
mbt liveops sign
Sign a remote-config JSON document into the envelope the game fetches
| Argument | Type | Description |
|---|---|---|
<payload> | string | The remote-config document (JSON) |
| Option | Type | Default | Description |
|---|---|---|---|
--out, -o | string | Where the signed envelope goes Required. | |
--project | string | Game project whose Config/DefaultCrypto.ini signing key signs (default: the current directory) | |
--key | string | A meaf_signing.key file to sign with instead of the project's |
mbt localize
Extract localizable strings and merge them into the project's string tables
mbt localize export
Write a locale's string tables as gettext PO or XLIFF 1.2 for translators
| Option | Type | Default | Description |
|---|---|---|---|
--project | string | Game project root directory. Default: the current directory | |
--root | string | Localization root. Default: <project>/Content/Localization | |
--locale | string | The locale to export Required. | |
--source-locale | string | en | The locale the English comes from |
--format | string | po | po or xliff |
--out | string | Output file. Default: <root>/<locale>.po or .xlf |
mbt localize extract
Scan the project and merge the results into Content/Localization
| Option | Type | Default | Description |
|---|---|---|---|
--project | string | Game project root directory (containing the .mproject). Default: the current directory | |
--root | string | Localization root. Default: <project>/Content/Localization | |
--dir | string[] | Scan these directories instead of <project>/Source and <project>/Content (repeatable). The engine's own editor is not laid out as a game project, and pointing --project at it would sweep every namespace in the engine into the editor's tables | |
--source-locale | string | en | The locale regenerated from the authored English |
--locale | string[] | Target locale to create if missing (repeatable) | |
--prune | bool | Delete keys extraction no longer finds instead of marking them @orphan | |
--dry-run | bool | Report what would change without writing anything | |
--strict | bool | Exit non-zero when a key is declared twice with different English | |
--list-unkeyed | bool | List UI text that carries no text_key and therefore cannot be translated |
mbt localize import
Merge translations from a gettext PO or XLIFF 1.2 file into a locale's string tables
| Option | Type | Default | Description |
|---|---|---|---|
--project | string | Game project root directory. Default: the current directory | |
--root | string | Localization root. Default: <project>/Content/Localization | |
--locale | string | The locale to import into Required. | |
--file | string | The .po or .xlf/.xliff file Required. | |
--dry-run | bool | Report what would change without writing anything |
mbt mdf
Validate, convert and format MDF documents (via MdfTool)
mbt mdf convert
Convert an MDF document between text and mdfb binary encodings
| Argument | Type | Description |
|---|---|---|
<input> | string | Input MDF file |
| Option | Type | Default | Description |
|---|---|---|---|
--to-binary | bool | Convert text → mdfb binary | |
--to-text | bool | Convert mdfb binary → text | |
--output, -o | string | Output file (default: input with .mdfb/.mdf extension) |
mbt mdf fmt
Rewrite MDF text files canonically in place
| Argument | Type | Description |
|---|---|---|
<paths> | string[] | Files, directories (recursed over MDF text extensions) or globs |
| Option | Type | Default | Description |
|---|---|---|---|
--check | bool | Report which files would change and exit non-zero, writing nothing (CI gate) | |
--force | bool | Format a file even though it carries comments, which a rewrite deletes |
mbt mdf retype-refs
Retype saved asset paths into typed AssetRef values wherever the engine's reflection declares the field an asset reference (via MowoGame)
| Argument | Type | Description |
|---|---|---|
<paths> | string[] | Files or directories (walked; Saved/ and Intermediate/ skipped) |
| Option | Type | Default | Description |
|---|---|---|---|
--dry-run | bool | Count what would change and write nothing |
mbt mdf validate
Parse MDF files (text or mdfb binary) and report OK or line:col errors
| Argument | Type | Description |
|---|---|---|
<paths> | string[] | Files, directories (recursed over MDF text extensions) or globs |
| Option | Type | Default | Description |
|---|---|---|---|
--schema | bool | After parsing, run structural schema checks (root type, schema_version, known child nodes) |
mbt mod
Mod SDK: create a mod project
mbt mod edit
Open a mod project in the editor over its game's content
| Option | Type | Default | Description |
|---|---|---|---|
--mod | string | Mod folder (default: the current directory) | |
--editor | string | Editor executable (default: Engine/Binaries/<platform>/<config>/MowoEditor of this checkout or installed engine) | |
--configuration, -c | BuildConfiguration | Dev | Which build of the editor to look for: debug | dev | profile | release | debuggame (default: dev) |
mbt mod new
Create a mod project from the mod template
| Argument | Type | Description |
|---|---|---|
<name> | string | Mod name (no spaces) |
| Option | Type | Default | Description |
|---|---|---|---|
--game | string | The game this mod is for (its .mproject); its name goes into the manifest | |
--out, -o | string | Where the mod folder goes (default: ./<name>) |
mbt newclass
Add a C++ class to a game project's module (scaffolds the module on first use)
| Argument | Type | Description |
|---|---|---|
<name> | string | Class name (e.g. ADoorActor) |
| Option | Type | Default | Description |
|---|---|---|---|
--project | string | Game project root directory (containing the .mproject) Required. | |
--module | string | Game module name (default: project directory's .mproject name) | |
--parent | string | actor | Base class: actor, component or none |
--parent-class | string | Subclass a specific reflected class (overrides --parent); requires --parent-include | |
--parent-include | string | Include path of --parent-class's header, e.g. Game/ACharacter.h |
mbt open
Generate (if needed) and open the IDE solution
| Option | Type | Default | Description |
|---|---|---|---|
--ide | string | auto | IDE to open with: auto (OS file association), vs (devenv via vswhere), rider (JetBrains Rider) |
--regen | bool | Regenerate the solution before opening |
mbt package
Full build + cook + package for distribution
| Option | Type | Default | Description |
|---|---|---|---|
--config, -c | BuildConfiguration | Release | Build configuration: debug | dev | profile | release | debuggame (default: release) |
--output, -o | string | Output directory | |
--platform, -p | string | Target platform for the build step: win64 | linux | macos-arm64 (default: host). Cross packaging of installers/signing stays a Windows-host concern. | |
--icon | string | Application icon (.ico / .png) | |
--name | string | Product name (default: project directory name) | |
--skip-build | bool | Skip C++ build (use existing binaries) | |
--skip-shaders | bool | Skip shader compilation | |
--monolithic | bool | Link the engine statically into the game host (UE5 Shipping model); the package ships one exe + vendor DLLs. The default for a release Game package | |
--modular | bool | Ship the engine as per-module DLLs even in release (the default for every other configuration) | |
--unprotected | bool | Ship plaintext, unsigned content and unsigned modules even when Config/DefaultCrypto.ini has keys. Release otherwise refuses to package without them. | |
--crypto-config | string | A crypto INI outside the project to package with instead of its Config/DefaultCrypto.ini; it may hold the signing private key inline (the test rows' throwaway keys) | |
--target | string | Game | Build target to package: Game (branded player) or Server (headless dedicated server — GPU-free module flavor, no shaders, exe branded <Product>Server) |
--project | string | Game project manifest (.mproject) to package. Default: the manifest at the build root, if there is exactly one. | |
--mdf-text | bool | Pack MDF game data as raw text instead of mdfb binary (debug fallback) | |
--raw-assets | bool | Pack texture (PNG/JPG/BMP/TGA) and mesh (FBX/glTF/OBJ/DAE) sources as-is instead of cooking them to .mtex/.mmodel | |
--compression | MeafCompression | Default | Compression of the content archives (None, Fast, Default, Best) |
--no-validate | bool | Skip the asset-validation gate mbt cook also runs (MowoGame --validate-assets) | |
--strict-refs | bool | Fail the package on an unresolvable asset reference or a failed texture/mesh cook | |
--allow-raw | bool | Pack texture/mesh sources raw when their transcode cannot run instead of failing the package | |
--zip | bool | true | Produce a distributable <Product>-<version>-<config>.zip of the package |
--full-crt | bool | Bundle the complete VC++ redist folder instead of the three essential CRT DLLs | |
--no-vc-redist | bool | Win64: leave out the VC++ redist fallback (installscript.vdf + _CommonRedist/vcredist/2022/VC_redist.x64.exe); Config/Packaging.ini vcRedist=false does the same | |
--vc-redist-exe | string | Win64: the VC_redist.x64.exe to ship as the fallback (default: Config/Packaging.ini vcRedistInstaller, else the one beside the toolchain's CRT redist) | |
--installer | bool | Emit an installer: on Windows a WiX .msi (candle/light on PATH, else a self-extracting PowerShell installer); on macOS a .dmg with a self-contained ad-hoc-signed .app | |
--sign | string | Code-sign the shipped exe + first-party DLLs with this cert (.pfx path, store subject, or SHA1 thumbprint). Falls back to the MOWO_SIGN_CERT env var. | |
--drm-wrap | bool | Wrap the shipped host exe with Steam DRM through steamcmd. Opt-in: the wrapped exe refuses to run outside Steam, which is how the package is normally smoke-tested. | |
--steam-user | string | Steam account name for --drm-wrap. Falls back to MOWO_STEAM_USER. The password is never a flag; log in once with steamcmd +login <user> so it is cached. | |
--analytics-endpoint | string | Analytics event-send endpoint baked into the shipping manifest (opt-in seam; empty = analytics disabled) | |
--no-crash-reporter | bool | Do not enable the shipping crash reporter in the shipping manifest | |
--no-symbols | bool | Do not upload debug symbols (PDBs) to the Sentry crash server | |
--crash-dsn | string | The game's own Sentry DSN baked into the shipping manifest (default: Config/Engine.ini [CrashReportClient] Dsn, else the .mproject crashReporter.dsn, else none: crash reports stay on the player's disk) | |
--sentry-org | string | Sentry organization the package's symbols go to (default: [CrashReportClient] SentryOrg, else the .mproject crashReporter.sentryOrg, else SENTRY_ORG) | |
--sentry-project | string | Sentry project the package's symbols go to (default: [CrashReportClient] SentryProject, else the .mproject crashReporter.sentryProject, else SENTRY_PROJECT; with none the upload is skipped) | |
--dlc | string | Package ONLY the named DLC plugin (a Plugins/<Name> with "dlc": true) against an existing base package | |
--base | string | Base package directory the DLC is built against (default: the package output directory) | |
--log-floor | string | Release only: compile out every log line below this level (info | warning | error), format strings included. Default keeps Info so a packaged build can still be judged with --log --loglevel=info | |
--pgo | string | Profile-guided optimisation for release/profile (clang): instrument = build binaries that write raw profiles to build/PGO/<Platform>/Raw when run, optimize = merge them into Engine/Build/PGO/<Platform>/Engine.profdata and compile with it | |
--promote-open-order | bool | Copy this machine's Saved/OpenOrder/OpenOrder.txt (recorded by MowoGame --record-open-order) over the committed Config/OpenOrder.txt before packaging: the paks then lay entries out in the order a play session first read them. Commit the result. | |
--promote-pso-cache | bool | Copy this machine's Saved/PsoCache/PsoCache.mdfb recording over the committed Config/PsoCache.mdfb before packaging. Commit the result — it is what every build ships. | |
--gather-pso | bool | Before packaging, run MowoGame --gather-pso over the project: every material's pipeline variants (static, skinned, instanced, meshlet, shadow, velocity, forward) merge into the committed Config/PsoCache.mdfb, so coverage follows the content rather than what a recording session played. Needs a non-release MowoGame build and a GPU. Commit the result. | |
--iostore | bool | Convert every staged pak into an IoStore container (.mutoc table of contents + .mucas blocks) with MowoIoStore: on-demand block reads, and unchanged content keeps byte-identical blocks across builds. Config/Packaging.ini ioStore=true turns it on for the project. |
mbt package-android
Build + cook + generate an installable Android Gradle project (M0.1: Vulkan-only, arm64-v8a, minSdk 26)
| Option | Type | Default | Description |
|---|---|---|---|
--config, -c | BuildConfiguration | Dev | Build configuration for the engine .so (third-party Android binaries are release builds and mix fine): debug | dev | profile | release | debuggame (default: dev) |
--project | string | Game project manifest (.mproject) to package. Default: the manifest at the build root, if there is exactly one. | |
--name | string | Product name (default: manifest output name / project directory name) | |
--app-id | string | Android applicationId (default: com.mowo.<productname>) | |
--output, -o | string | Output directory (default: Saved/Packaged/<Product>-Android) | |
--skip-build | bool | Skip the C++ build (use the existing libmain.so) | |
--skip-shaders | bool | Skip shader compilation (use the build tree's Shaders.meaf) | |
--raw-assets | bool | Pack texture/mesh sources as-is instead of cooking (skips the ASTC transcode) | |
--mdf-text | bool | Pack MDF game data as raw text instead of mdfb binary | |
--unprotected | bool | Ship plaintext, unsigned content even when Config/DefaultCrypto.ini has keys. Release otherwise refuses to package without them. |
mbt package-mod
Pack a mod's Content/ into a signed pak with its manifest
| Option | Type | Default | Description |
|---|---|---|---|
--mod | string | Mod folder (default: the current directory) | |
--out, -o | string | Output folder (default: <mod>/Packaged/<Name>) | |
--key | string | meaf_signing.key to sign with (its meaf_signing.pub must sit beside it) | |
--project | string | Sign with this game project's key (Config/DefaultCrypto.ini) — the studio's official mods |
mbt patch
Build or apply a binary update patch between two packaged builds
| Option | Type | Default | Description |
|---|---|---|---|
--from | string | Old package directory (the version a player already has) | |
--to | string | New package directory (the version to update to) | |
--out | string | Output patch bundle path (.mpatch) | |
--apply | string | Patch bundle to apply | |
--target | string | Installed directory to patch in place |
mbt shaders
Compile HLSL shaders to SPIR-V and pack declared archives
| Option | Type | Default | Description |
|---|---|---|---|
--shader-dir, -s | string | Manual mode: compile this directory instead of module-declared ones | |
--output, -o | string | Manual mode: SPIR-V output directory | |
--config, -c | BuildConfiguration | Dev | Configuration whose binaries folder receives packed archives: debug | dev | profile | release | debuggame (default: dev) |
--platform, -p | string | Target platform: win64 | linux | macos-arm64 | android | ios (default: host). macOS/iOS additionally lower SPIR-V to Metal via spirv-cross; android is Vulkan-only (M0.1). | |
--project | string | Also compile the project's material-graph shaders (.material.hlsl sidecars under its Content/) into the shader archive | |
--material-sources | string | The editor's on-demand material compile: compile every .material.hlsl in this folder (and nothing else) into --material-cache; the shader archives are left alone | |
--material-cache | string | With --material-sources: the project's loose material shader cache the running editor reads (Materials/<hash>.* and a Compiled/<hash>.<target> marker per finished graph) | |
--watch, -w | bool | Watch for changes and recompile | |
--force, -f | bool | Force recompile all shaders | |
--validate | bool | Only validate shaders (no output) | |
--check | bool | With --report-matrix: fail when a non-excluded job stops compiling, or when the committed Engine/Documentation/ShaderCoverageMatrix.md has drifted from the freshly generated one | |
--report-matrix | bool | Dry-run every variant×stage against the DXIL/DXBC/MSL toolchains and write a coverage + layout report under build/ShaderMatrix/ | |
--targets | string | Comma-separated backend blob targets: spirv,dxil,dxbc,msl (default: spirv, or the per-platform set when --platform is given: win64=spirv,dxil,dxbc; linux=spirv; macos-arm64=spirv,msl). Extra targets pack alongside the SPIR-V plus ShaderManifest.json and per-shader bindmaps. | |
--metallib | bool | macOS host only: compile the .metal outputs to .metallib via xcrun before packing (implies the msl target) | |
--workers | string | Compile SPIR-V and DXIL stages on N ShaderCompileWorker processes (a number or 'auto'); same as MOWO_SHADER_WORKERS | |
--ddc | string | Reuse compiled blobs from a shader DDC keyed by source closure, defines, target and compiler: a folder, or '1' for build/ShaderDDC; same as MOWO_SHADER_DDC |
mbt steam-upload
Upload an existing mbt package output to Steam (writes the steamcmd build scripts, then runs steamcmd)
| Option | Type | Default | Description |
|---|---|---|---|
--package | string | Packaged game directory to upload (default: Saved/Packaged/<Product>) | |
--project | string | Game project manifest (.mproject). Default: the manifest at the build root, if there is exactly one. | |
--name | string | Product name used to locate the package (default: the manifest's build.outputName) | |
--app-id | UInt32 | 0 | Steam app id (default: the manifest's platform.steamAppId) |
--depot-id | UInt32 | 0 | Depot id receiving the content (default: the manifest's platform.steamDepots entry, else app id + 1/2/3 for Win64/Mac/Linux) |
--platform, -p | string | Platform the package was built for: win64 | linux | macos-arm64 (default: host). Picks the default depot and the package sub-name. | |
--depot | string[] | Add a platform to this build as <platform>=<packageDir>, repeatable (e.g. --depot win64=out/Win --depot macos-arm64=out/Mac). Replaces --platform/--package. | |
--username | string | Steam build account. Default: MOWO_STEAM_USER. The password is never taken here — log in once with steamcmd +login <user> so it caches credentials. | |
--description | string | Build description shown in the Steamworks build history | |
--branch | string | Beta branch to set live on success (default: none — the build uploads and stays unset) | |
--preview | bool | Steam preview build: steamcmd scans the content and logs what it would do, uploading nothing | |
--dry-run | bool | Write the app/depot VDFs and stop — steamcmd is never invoked | |
--out | string | Directory for the generated VDFs and steamcmd build output (default: build/Steam/<Product>-<Platform>, or build/Steam/<Product> for a multi-platform build) |
mbt symbols
Upload debug symbols (PDBs) to Sentry; needs SENTRY_AUTH_TOKEN
| Argument | Type | Description |
|---|---|---|
<paths> | string[] | Files or directories to scan for debug files (default: Engine/Binaries/<platform>/<config>) |
| Option | Type | Default | Description |
|---|---|---|---|
--configuration, -c | BuildConfiguration | Build configuration whose folder to upload symbols from (default: every folder in Engine/Binaries/<platform>): debug | dev | profile | release | debuggame | |
--url | string | Sentry web/API URL, not a DSN's ingest host (default: SENTRY_URL or https://de.sentry.io) | |
--sentry-org, --org | string | Organization slug (default: SENTRY_ORG or mowogames) | |
--sentry-project, --project | string | Project slug (default: SENTRY_PROJECT or mowo-editor, the editor's; a game's symbols take its own) | |
--wait | bool | Wait for the server to fully process uploaded files |
mbt workshop-upload
Upload a packaged mod to the Steam Workshop (writes the item VDF, then runs steamcmd)
| Option | Type | Default | Description |
|---|---|---|---|
--mod | string | Packaged mod folder (the output of mbt package-mod) Required. | |
--app-id | UInt32 | The game's Steam app id Required. | |
--item-id | UInt64 | 0 | Existing Workshop item to update (default: the manifest's workshopId; 0 creates a new item) |
--preview | string | Preview image (default: preview.png in the mod folder) | |
--change-note | string | Change note shown on the item | |
--visibility | int | 2 | 0 public, 1 friends only, 2 private (default), 3 unlisted |
--username | string | Steam account (default: MOWO_STEAM_USER); log in once with steamcmd +login <user> so it caches credentials | |
--dry-run | bool | Write the VDF and stop — steamcmd is never invoked | |
--out | string | Where the VDF goes (default: <mod>/../Workshop) |