Launch Options

From Noita Wiki
Jump to navigation Jump to search

The Noita executable accepts several launch options that change how Noita behaves or are useful tools for modders.

Save File Stuff

-clean_save

Deletes the following items:

  • The entire save00/world directory
  • save00/player.xml
  • save00/world_state.xml
  • save00/player.salakieli
  • save00/world_state.salakieli
  • save00/session_numbers.xml
  • save00/session_numbers.salakieli

See Guide: Noita folders for more info on what this contains.

-clean_config

Deletes the entire save_shared directory.

See Guide: Noita folders for more info on what this contains.

-clean_stats

Deletes the entire save00/stats directory.

See Guide: Noita folders for more info on what this contains.

-clean_everything

Deletes the following items:

  • The entire save00 directory
  • The entire save_shared directory
  • The entire save_rec directory
  • The entire save00/stats directory

See Guide: Noita folders for more info on what this contains.

-always_store_userdata_in_appdata

-always_store_userdata_in_workdir

-save_slot

-load_test_save

Developer Stuff

-bench

-bench-sample

-bench_num_samples

-bench_reset

-gun_actions

--help

Writes "hello --help" to stdout and then exits

-profiler_file

-no_extra_config

-build_schemas_n_exit

Used by Nolla to generate the data/schemas/<id>.xml file for this version of Noita.

-build_lua_api_documentation_n_exit

Takes a single argument which is the Noita source root path.

Used by Nolla to generate the tools_modding/lua_api_documentation.txt and tools_modding/lua_api_documentation.html files. Unusable since it requires files that are not included with a normal Noita install. You shouldn't have to use this since the documentation files are included with Noita in your install directory.

-write_documentation_n_exit

Used to generate the tools_modding/component_documentation.txt file. You shouldn't have to use this since the documentation file is included with Noita in your install directory.

-debug

-t

Accepts one argument:

  • DeathmatchTest (Default): This launches Noita like normal.
  • TestJoystick: Joystick testing application. Doesn't seem to work well.
  • LoadingScreen: Infinite loading/logo screen.


Modder Stuff

-fix_stats

Used to fix the stats after a broken Noita beta version. Shouldn't use this unless you last played on that specific version of the beta.

-wizard_pak

-wizard_unpak

Used to extract the game files from data.wak. Very useful when making mods.

-magic_numbers

Loads Magic Numbers from the path argument provided to this option. If magic number _DEBUG_DONT_SAVE_MAGIC_NUMBERS is 0 (which is the default), then content of the provided file is replaced with all magic numbers and their effective values, basically creating the result of merging the default values with the values that were in the file.

If you're using this to set a couple variables then you'll normally also want change _DEBUG_DONT_SAVE_MAGIC_NUMBERS to 1.

You can get a dump of all magic variables and their default values by using this option with a file path that doesn't yet exist.

Setting magic variables this way does not count as playing modded. Steam and GOG Achievements and other feature will not be disabled.

-splice_pixel_scene

-workshop_upload

Used to upload a mod to the Steam Workshop.

-workshop_upload_change_notes

-show_workshop_legal_agreement

Misc

-daily_run

-gamemode

Starts the game with the given gamemode, takes integer, 0 indexed. 0 = Default

-gamemode_mod_workshop_id

-gamemode_mod_name

-biome-map

Config

-fullscreen

Launches the game in fullscreen mode and writes this setting to your configuration file.

-windowed

Launches the game in windowed mode and writes this setting to your configuration file.

-single_threaded_loading

-no_logo_splashes

Skips the Nolla Games, Falling Everything, FMOD logo screen that's normally displayed for the first run you enter after launching the game.

-debug_lua

Enabled debugging hooks. Only works with noita_dev.exe.

Please note that running the game with the -debug_lua parameter enables some lua sandbox escape exploits, so you shouldn't do that when any untrusted mods are enabled.

See tools_modding/lua_debugging.txt on how to use this with Decoda, or checkout Ismoh's method for using VS Code.

-recording_load_saved_scene