9.3 Launch options

Launch Options

Command Line

--no-splash - Disable the splash screen on startup

Env Vars

AMETHYST_NO_SPLASH=1 - Disable the splash screen on startup

AMM_DEPLOY_VERIFY - re-checks every deployed file after the incremental diff

AMM_FILEMAP_VERIFY - runs both filemap paths and compares them live

AMM_PLUGIN_DIAG - verbose plugin-panel stage logging

MM_PERFTRACE - perf tracing (accepts any value except 0, empty, false/False); F11 in-app prints the timing summary table

MM_PERFTRACE_MS - live-print threshold in milliseconds, default 8; slower spans print, faster ones are counted silently

MM_COL_TIMING - collection-install block timing

MM_BODYSLIDE_GLLOG - BodySlide GL diagnostics

PORTAL_DEBUG=0 - silence portal file-chooser logging (this one is on by default, unlike the rest of this section)

Kill Switches

These features are all on by default. Set the variable to exactly 0 to turn one off — any other value leaves it enabled.

AMM_DEPLOY_INCREMENTAL=0 - forces a full deploy instead of the incremental diff

AMM_FILEMAP_INCREMENTAL=0 - forces a full filemap rebuild instead of the incremental merge

AMM_FILE_REQS=0 - disables Nexus file-requirements lookups

AMM_FLATPAK_OVERRIDE=0 - stops the automatic flatpak override --filesystem grant on deploy

AMM_FNV_AUTO_4GB=0 - skips the Fallout: New Vegas automatic 4GB patch

AMM_MOVE_SKIP_REBUILD=0 - forces a full conflict rebuild after moving a mod instead of the fast path

AMM_TOGGLE_LIGHT=0 - disables the fast path for mod enable/disable toggles

AMM_PRUNE_OWNED=0 - disables pruning of owned plugins when a mod is disabled

Paths and Tuning

MOD_MANAGER_PROFILES_DIR - overrides the Profiles directory; takes precedence over everything else and is created if missing

MOD_MANAGER_GAMES - path to the Games/ handler directory; normally set automatically at startup, so only set this if you are running handlers from a custom location

MOD_MANAGER_DEPLOY_WORKERS - number of deploy worker threads, default 16

XDG_CONFIG_HOME - standard XDG variable; config lives in $XDG_CONFIG_HOME/AmethystModManager (defaults to ~/.config)

Honored From Your Shell

Amethyst reads these but will not overwrite a value you set yourself.

QT_QPA_PLATFORM - the launcher defaults this to xcb (XWayland) because native Wayland breaks tooltip positioning and UI scaling; set it yourself to override

QT_SCALE_FACTOR, GDK_SCALE, GDK_DPI_SCALE - used for UI scale detection. Amethyst tracks whether it set QT_SCALE_FACTOR on a previous launch, so a value from your own shell is never clobbered by the in-app scale setting.

Internal

Set by the app or its launcher — listed for completeness, setting them yourself has no effect or will break things.

AMM_WINETRICKS_STYLE - read from the child-process environment the launcher builds, not your shell; driven by a UI setting

AMM_STDERR_TEED - tells the app that run_qt.sh already tees stderr to a log, so the in-Python capture stands down

_AMM_OWNS_SCALE - marks a QT_SCALE_FACTOR as having come from Amethyst rather than the user