mbt command line

Every mbt command and option: 25 commands, generated from the tool itself.

Last updated Nov 3, 2026Version 1.0.0

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.

OptionTypeDefaultDescription
--verbose, -vboolEnable verbose output
--dry-runboolShow what would be done without executing
--progressstringconsoleProgress 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

ArgumentTypeDescription
<before>stringEarlier file
<after>stringLater file

mbt asset dump

Print an asset package as text (the git textconv for the binary asset types)

ArgumentTypeDescription
<file>stringPackage file

mbt asset merge

Three-way property merge of MDF documents; the result replaces <ours>

ArgumentTypeDescription
<base>stringCommon ancestor (git %O)
<ours>stringOur version, overwritten with the merge (git %A)
<theirs>stringTheir version (git %B)
OptionTypeDefaultDescription
--visual-scriptboolThe 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

ArgumentTypeDescription
<project>stringThe project's .mproject file
OptionTypeDefaultDescription
--report-onlyboolReport what would change and write nothing
--source-artboolMove 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

ArgumentTypeDescription
<project>stringThe project's .mproject file
OptionTypeDefaultDescription
--write-chunksboolRegenerate Config/Chunks.ini from the primary asset rules

mbt build

Build engine modules

OptionTypeDefaultDescription
--target, -tstringBuild specific target module
--config, -cBuildConfigurationDevBuild configuration: debug | dev | profile | release | debuggame (default: dev)
--platform, -pstringTarget 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, -jintlogical CPU countMax parallel compile jobs
--shared-cachestringTeam 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-onlyboolPull from the shared cache but never push to it (also MBT_SHARED_CACHE_PUSH=0)
--hot-reloadboolLink the -t module to a versioned output (<name>.v<N>.dll) for live coding
--extra-sourcestring[]Additional directory to scan for *.Build.cs modules (game project Source/)
--option, -ostring[]Custom build option KEY=VALUE for the rules (e.g. -o MOWO_ENABLE_FSR=true)

mbt clean

Remove build artifacts

OptionTypeDefaultDescription
--allboolAlso remove intermediate caches

mbt cook

Cook and pack assets into MEAF archives

OptionTypeDefaultDescription
--assets, -astringAsset source directory (default: Content/ of the project found from the current directory upward, else of the engine)
--output, -ostringOutput .meaf path
--compression, -cMeafCompressionFastCompression level (None, Fast, Default, Best)
--force, -fboolForce recook all assets
--meaf-builderstringPath to meaf_builder executable
--meaf-encrypt-keystringHex key file (32 bytes) — encrypt archive TOCs + payloads (see MeafBuilder keygen)
--meaf-key-idUInt320Encryption key id stored in the archive header
--meaf-sign-keystringHex secret key file (64 bytes) — sign the archives
--scenesstringComma-separated entry level (.mmap) paths — cook only what they reference
--raw-assetsboolPack texture (PNG/JPG/BMP/TGA) and mesh (FBX/glTF/OBJ/DAE) sources as-is instead of cooking them to .mtex/.mmodel
--mdf-textboolPack MDF game data as raw text instead of mdfb binary (debug fallback)
--astcboolCook LDR textures to ASTC 6x6 (mobile GPUs have no BC) instead of BC7/BC5
--platform, -pstringCook 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-codecstringCook 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-shadersboolWith --platform, skip building the target's Shaders.meaf beside the archive
--strict-refsboolFail the cook when a scene/material/prefab reference cannot be resolved to a file
--allow-rawboolPack texture/mesh sources raw when their transcode cannot run (MowoGame missing or the batch failed) instead of failing the cook
--no-validateboolSkip the asset-validation gate (MowoGame --validate-assets)
--configBuildConfigurationBuild 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

OptionTypeDefaultDescription
--projectstringGame project manifest (.mproject). Default: the manifest at the build root, if there is exactly one.
--encryptionboolOnly the encryption key
--signingboolOnly the signing key pair
--forceboolReplace 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)

OptionTypeDefaultDescription
--projectstringGame project manifest (.mproject)
--filestringA 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

OptionTypeDefaultDescription
--projectstringGame project manifest (.mproject)

mbt crypto show

Say which keys the project has, without printing them

OptionTypeDefaultDescription
--projectstringGame 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

OptionTypeDefaultDescription
--projectstringProject directory or .mproject file (default: found by walking up from the working directory)
--topint10How many of the largest entries to list

mbt ddc prune

Evict least recently used entries until the cache fits a size budget

OptionTypeDefaultDescription
--projectstringProject directory or .mproject file (default: found by walking up from the working directory)
--max-sizeint4096Budget in MB (the same default as the engine's ddc.MaxSizeMB)

mbt ddc purge

Delete every entry in the cache

OptionTypeDefaultDescription
--projectstringProject 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

OptionTypeDefaultDescription
--projectstringProject directory or .mproject file (default: found by walking up from the working directory)
--rootstringCache folder to serve (default: the project's Intermediate/DerivedDataCache)
--bindstring0.0.0.0Listen address
--portint8558Port
--tokenstringBearer token every request must carry (also MOWO_DDC_SERVER_TOKEN)
--readonlyboolRefuse writes
--max-sizeint0Size cap in MB, least recently used evicted past it (0 = none)
--mowo-ddcstringPath 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

OptionTypeDefaultDescription
--output, -ostringOutput path (default: compile_commands.json)

mbt generate vs

Generate Visual Studio solution (.slnx or .sln + .vcxproj)

OptionTypeDefaultDescription
--output, -ostringOutput directory (default: build/)
--formatSolutionFormatSlnxSolution file format: slnx (VS 17.10+, default) or sln (legacy)
--projectstringGame 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)

OptionTypeDefaultDescription
--output, -ostringOutput directory (default: build/)

mbt info

Show project information and modules

mbt init

Create a new MowoEngine project from template

ArgumentTypeDescription
<name>stringProject name
OptionTypeDefaultDescription
--output, -ostringOutput directory (default: ./<name>)
--no-sourceboolSkip 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)

OptionTypeDefaultDescription
--config, -cBuildConfigurationDevConfiguration of the running binaries: debug | dev | profile | release | debuggame (default: dev)
--sourcestring[]Compile only these sources (default: every .cpp newer than its module's binary)
--asstring[]Compile each --source as if it were this file of the tree (same module, flags and includes)
--outstringDirectory for the objects (default: .mbt-cache/livecoding/<config>)
--reportstringWrite 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

ArgumentTypeDescription
<inputs>string[]Journal files or folders of *.jsonl (default: Saved/Telemetry)
OptionTypeDefaultDescription
--out, -ostringHTML file to write (default: Saved/Telemetry/report.html)
--titlestringTelemetryPage title

mbt liveops sign

Sign a remote-config JSON document into the envelope the game fetches

ArgumentTypeDescription
<payload>stringThe remote-config document (JSON)
OptionTypeDefaultDescription
--out, -ostringWhere the signed envelope goes Required.
--projectstringGame project whose Config/DefaultCrypto.ini signing key signs (default: the current directory)
--keystringA 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

OptionTypeDefaultDescription
--projectstringGame project root directory. Default: the current directory
--rootstringLocalization root. Default: <project>/Content/Localization
--localestringThe locale to export Required.
--source-localestringenThe locale the English comes from
--formatstringpopo or xliff
--outstringOutput file. Default: <root>/<locale>.po or .xlf

mbt localize extract

Scan the project and merge the results into Content/Localization

OptionTypeDefaultDescription
--projectstringGame project root directory (containing the .mproject). Default: the current directory
--rootstringLocalization root. Default: <project>/Content/Localization
--dirstring[]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-localestringenThe locale regenerated from the authored English
--localestring[]Target locale to create if missing (repeatable)
--pruneboolDelete keys extraction no longer finds instead of marking them @orphan
--dry-runboolReport what would change without writing anything
--strictboolExit non-zero when a key is declared twice with different English
--list-unkeyedboolList 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

OptionTypeDefaultDescription
--projectstringGame project root directory. Default: the current directory
--rootstringLocalization root. Default: <project>/Content/Localization
--localestringThe locale to import into Required.
--filestringThe .po or .xlf/.xliff file Required.
--dry-runboolReport 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

ArgumentTypeDescription
<input>stringInput MDF file
OptionTypeDefaultDescription
--to-binaryboolConvert text → mdfb binary
--to-textboolConvert mdfb binary → text
--output, -ostringOutput file (default: input with .mdfb/.mdf extension)

mbt mdf fmt

Rewrite MDF text files canonically in place

ArgumentTypeDescription
<paths>string[]Files, directories (recursed over MDF text extensions) or globs
OptionTypeDefaultDescription
--checkboolReport which files would change and exit non-zero, writing nothing (CI gate)
--forceboolFormat 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)

ArgumentTypeDescription
<paths>string[]Files or directories (walked; Saved/ and Intermediate/ skipped)
OptionTypeDefaultDescription
--dry-runboolCount what would change and write nothing

mbt mdf validate

Parse MDF files (text or mdfb binary) and report OK or line:col errors

ArgumentTypeDescription
<paths>string[]Files, directories (recursed over MDF text extensions) or globs
OptionTypeDefaultDescription
--schemaboolAfter 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

OptionTypeDefaultDescription
--modstringMod folder (default: the current directory)
--editorstringEditor executable (default: Engine/Binaries/<platform>/<config>/MowoEditor of this checkout or installed engine)
--configuration, -cBuildConfigurationDevWhich 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

ArgumentTypeDescription
<name>stringMod name (no spaces)
OptionTypeDefaultDescription
--gamestringThe game this mod is for (its .mproject); its name goes into the manifest
--out, -ostringWhere the mod folder goes (default: ./<name>)

mbt newclass

Add a C++ class to a game project's module (scaffolds the module on first use)

ArgumentTypeDescription
<name>stringClass name (e.g. ADoorActor)
OptionTypeDefaultDescription
--projectstringGame project root directory (containing the .mproject) Required.
--modulestringGame module name (default: project directory's .mproject name)
--parentstringactorBase class: actor, component or none
--parent-classstringSubclass a specific reflected class (overrides --parent); requires --parent-include
--parent-includestringInclude path of --parent-class's header, e.g. Game/ACharacter.h

mbt open

Generate (if needed) and open the IDE solution

OptionTypeDefaultDescription
--idestringautoIDE to open with: auto (OS file association), vs (devenv via vswhere), rider (JetBrains Rider)
--regenboolRegenerate the solution before opening

mbt package

Full build + cook + package for distribution

OptionTypeDefaultDescription
--config, -cBuildConfigurationReleaseBuild configuration: debug | dev | profile | release | debuggame (default: release)
--output, -ostringOutput directory
--platform, -pstringTarget platform for the build step: win64 | linux | macos-arm64 (default: host). Cross packaging of installers/signing stays a Windows-host concern.
--iconstringApplication icon (.ico / .png)
--namestringProduct name (default: project directory name)
--skip-buildboolSkip C++ build (use existing binaries)
--skip-shadersboolSkip shader compilation
--monolithicboolLink the engine statically into the game host (UE5 Shipping model); the package ships one exe + vendor DLLs. The default for a release Game package
--modularboolShip the engine as per-module DLLs even in release (the default for every other configuration)
--unprotectedboolShip plaintext, unsigned content and unsigned modules even when Config/DefaultCrypto.ini has keys. Release otherwise refuses to package without them.
--crypto-configstringA 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)
--targetstringGameBuild target to package: Game (branded player) or Server (headless dedicated server — GPU-free module flavor, no shaders, exe branded <Product>Server)
--projectstringGame project manifest (.mproject) to package. Default: the manifest at the build root, if there is exactly one.
--mdf-textboolPack MDF game data as raw text instead of mdfb binary (debug fallback)
--raw-assetsboolPack texture (PNG/JPG/BMP/TGA) and mesh (FBX/glTF/OBJ/DAE) sources as-is instead of cooking them to .mtex/.mmodel
--compressionMeafCompressionDefaultCompression of the content archives (None, Fast, Default, Best)
--no-validateboolSkip the asset-validation gate mbt cook also runs (MowoGame --validate-assets)
--strict-refsboolFail the package on an unresolvable asset reference or a failed texture/mesh cook
--allow-rawboolPack texture/mesh sources raw when their transcode cannot run instead of failing the package
--zipbooltrueProduce a distributable <Product>-<version>-<config>.zip of the package
--full-crtboolBundle the complete VC++ redist folder instead of the three essential CRT DLLs
--no-vc-redistboolWin64: 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-exestringWin64: the VC_redist.x64.exe to ship as the fallback (default: Config/Packaging.ini vcRedistInstaller, else the one beside the toolchain's CRT redist)
--installerboolEmit 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
--signstringCode-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-wrapboolWrap 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-userstringSteam 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-endpointstringAnalytics event-send endpoint baked into the shipping manifest (opt-in seam; empty = analytics disabled)
--no-crash-reporterboolDo not enable the shipping crash reporter in the shipping manifest
--no-symbolsboolDo not upload debug symbols (PDBs) to the Sentry crash server
--crash-dsnstringThe 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-orgstringSentry organization the package's symbols go to (default: [CrashReportClient] SentryOrg, else the .mproject crashReporter.sentryOrg, else SENTRY_ORG)
--sentry-projectstringSentry project the package's symbols go to (default: [CrashReportClient] SentryProject, else the .mproject crashReporter.sentryProject, else SENTRY_PROJECT; with none the upload is skipped)
--dlcstringPackage ONLY the named DLC plugin (a Plugins/<Name> with "dlc": true) against an existing base package
--basestringBase package directory the DLC is built against (default: the package output directory)
--log-floorstringRelease 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
--pgostringProfile-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-orderboolCopy 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-cacheboolCopy 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-psoboolBefore 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.
--iostoreboolConvert 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)

OptionTypeDefaultDescription
--config, -cBuildConfigurationDevBuild configuration for the engine .so (third-party Android binaries are release builds and mix fine): debug | dev | profile | release | debuggame (default: dev)
--projectstringGame project manifest (.mproject) to package. Default: the manifest at the build root, if there is exactly one.
--namestringProduct name (default: manifest output name / project directory name)
--app-idstringAndroid applicationId (default: com.mowo.<productname>)
--output, -ostringOutput directory (default: Saved/Packaged/<Product>-Android)
--skip-buildboolSkip the C++ build (use the existing libmain.so)
--skip-shadersboolSkip shader compilation (use the build tree's Shaders.meaf)
--raw-assetsboolPack texture/mesh sources as-is instead of cooking (skips the ASTC transcode)
--mdf-textboolPack MDF game data as raw text instead of mdfb binary
--unprotectedboolShip 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

OptionTypeDefaultDescription
--modstringMod folder (default: the current directory)
--out, -ostringOutput folder (default: <mod>/Packaged/<Name>)
--keystringmeaf_signing.key to sign with (its meaf_signing.pub must sit beside it)
--projectstringSign 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

OptionTypeDefaultDescription
--fromstringOld package directory (the version a player already has)
--tostringNew package directory (the version to update to)
--outstringOutput patch bundle path (.mpatch)
--applystringPatch bundle to apply
--targetstringInstalled directory to patch in place

mbt shaders

Compile HLSL shaders to SPIR-V and pack declared archives

OptionTypeDefaultDescription
--shader-dir, -sstringManual mode: compile this directory instead of module-declared ones
--output, -ostringManual mode: SPIR-V output directory
--config, -cBuildConfigurationDevConfiguration whose binaries folder receives packed archives: debug | dev | profile | release | debuggame (default: dev)
--platform, -pstringTarget 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).
--projectstringAlso compile the project's material-graph shaders (.material.hlsl sidecars under its Content/) into the shader archive
--material-sourcesstringThe 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-cachestringWith --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, -wboolWatch for changes and recompile
--force, -fboolForce recompile all shaders
--validateboolOnly validate shaders (no output)
--checkboolWith --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-matrixboolDry-run every variant×stage against the DXIL/DXBC/MSL toolchains and write a coverage + layout report under build/ShaderMatrix/
--targetsstringComma-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.
--metallibboolmacOS host only: compile the .metal outputs to .metallib via xcrun before packing (implies the msl target)
--workersstringCompile SPIR-V and DXIL stages on N ShaderCompileWorker processes (a number or 'auto'); same as MOWO_SHADER_WORKERS
--ddcstringReuse 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)

OptionTypeDefaultDescription
--packagestringPackaged game directory to upload (default: Saved/Packaged/<Product>)
--projectstringGame project manifest (.mproject). Default: the manifest at the build root, if there is exactly one.
--namestringProduct name used to locate the package (default: the manifest's build.outputName)
--app-idUInt320Steam app id (default: the manifest's platform.steamAppId)
--depot-idUInt320Depot id receiving the content (default: the manifest's platform.steamDepots entry, else app id + 1/2/3 for Win64/Mac/Linux)
--platform, -pstringPlatform the package was built for: win64 | linux | macos-arm64 (default: host). Picks the default depot and the package sub-name.
--depotstring[]Add a platform to this build as <platform>=<packageDir>, repeatable (e.g. --depot win64=out/Win --depot macos-arm64=out/Mac). Replaces --platform/--package.
--usernamestringSteam build account. Default: MOWO_STEAM_USER. The password is never taken here — log in once with steamcmd +login <user> so it caches credentials.
--descriptionstringBuild description shown in the Steamworks build history
--branchstringBeta branch to set live on success (default: none — the build uploads and stays unset)
--previewboolSteam preview build: steamcmd scans the content and logs what it would do, uploading nothing
--dry-runboolWrite the app/depot VDFs and stop — steamcmd is never invoked
--outstringDirectory 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

ArgumentTypeDescription
<paths>string[]Files or directories to scan for debug files (default: Engine/Binaries/<platform>/<config>)
OptionTypeDefaultDescription
--configuration, -cBuildConfigurationBuild configuration whose folder to upload symbols from (default: every folder in Engine/Binaries/<platform>): debug | dev | profile | release | debuggame
--urlstringSentry web/API URL, not a DSN's ingest host (default: SENTRY_URL or https://de.sentry.io)
--sentry-org, --orgstringOrganization slug (default: SENTRY_ORG or mowogames)
--sentry-project, --projectstringProject slug (default: SENTRY_PROJECT or mowo-editor, the editor's; a game's symbols take its own)
--waitboolWait 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)

OptionTypeDefaultDescription
--modstringPackaged mod folder (the output of mbt package-mod) Required.
--app-idUInt32The game's Steam app id Required.
--item-idUInt640Existing Workshop item to update (default: the manifest's workshopId; 0 creates a new item)
--previewstringPreview image (default: preview.png in the mod folder)
--change-notestringChange note shown on the item
--visibilityint20 public, 1 friends only, 2 private (default), 3 unlisted
--usernamestringSteam account (default: MOWO_STEAM_USER); log in once with steamcmd +login <user> so it caches credentials
--dry-runboolWrite the VDF and stop — steamcmd is never invoked
--outstringWhere the VDF goes (default: <mod>/../Workshop)

Page feedback

Was this page helpful?