CLI Reference

CLI Reference

Running AutoSeasons.exe with no arguments opens the GUI. Passing any argument switches to headless CLI mode — useful for scripting a generation as part of a larger modlist-build pipeline.

AutoSeasons.exe <game-dir> [output] [options]

Positional arguments

Argument	Required	Description
game-dir	Yes	Path to your game's install directory (or merged mod-manager view).
output	No (default AutoSeasons_Output)	Output directory.

Options

Flag	Description
-v / -vv	Verbosity: -v for DEBUG-level log output, -vv for TRACE-level.
--no-multithreading	Disable multithreading (single-threaded scan; slower, occasionally useful for debugging).
--shortcut	Keep the console window open after finishing, even on success.
--game-type <type>	skyrimse, skyrimvr, skyrimgog, or enderalse. Default skyrimse.
--blocklist <patterns>	Comma-separated glob patterns (e.g. */interiors/*) for meshes to exclude from seasonal swapping.
--editor-id-blocklist <keywords>	Comma-separated EditorID keywords (case-insensitive substring match, e.g. coast,river) for records to exclude entirely.
--override-season-mods <names>	Comma-separated foreign mod names whose Data/Seasons coverage AutoSeasons should overwrite with its own generated textures instead of respecting.
--mod-priority <names>	Comma-separated foreign mod names, lowest priority first — when two respected foreign mods cover the same record, the one listed later wins.
--remove-grass-in-winter / --no-remove-grass-in-winter	Drop grass slots with no detected winter mesh variant instead of leaving them visible under snow. Default: on.
--dry-run	Run the full scan and log what would be created/skipped, but write nothing to the output directory. Useful for iterating on --blocklist/--editor-id-blocklist safely.
--esm-mode <0|1|2>	0/1 = ESM-flag the output plugin, 2 = do not ESM-flag (default).

Examples

Basic run against an MO2 merged view:

AutoSeasons.exe "C:\ModOrganizer\mods\_merged_view" "C:\ModOrganizer\mods\AutoSeasons Output"

Dry run at debug verbosity while tuning a blocklist:

AutoSeasons.exe "C:\ModOrganizer\mods\_merged_view" "C:\ModOrganizer\mods\AutoSeasons Output" -v --dry-run --blocklist "*\interiors\*,*\dungeons\*"

Overwriting one foreign mod's seasonal coverage, respecting the rest:

AutoSeasons.exe "C:\ModOrganizer\mods\_merged_view" "C:\ModOrganizer\mods\AutoSeasons Output" --override-season-mods "Turn of the Seasons"

Exit behavior

The process exits with a non-zero code on failure. When launched with no existing console attached (e.g. double-clicked, or spawned fresh by a mod manager) it pauses for a keypress before closing on failure, so the error message isn't lost to a console window that vanishes instantly. --shortcut forces this pause unconditionally, even on success.