Command Line Arguments

ToME Version:

1.7.2

The t-engine executable supports several command-line (CLI) arguments.

Argument	Effect
-Mmodule	Automatically load and run the chosen module instead of going to the boot menu. The module name is based on the short_name in the module's init.lua file
-uname	Use name for the character name instead of prompting, and either load that character's saved game or create a new game with that name.
-n	Force creating a new game, overwriting any previous saved game for the given character name
-Eargs	Passes extra arguments to the game module (?)
--xpos x	Create the game window at the given X coordinate
--ypos y	Create the game window at the given Y coordinate
--flush‑stdout	Write to te4_log.txt immediately instead of buffering output. This facilitates debugging but can slow T-Engine4 down.
--no-debug	Disables most output to te4_log.txt
--safe-mode	Disables many graphical effects and reverts to minimal screen size and graphics settings
--home path	Use the given directory instead of your default operating system home directory. T-Engine's settings and saved games will be saved in a subdirectory under this home directory, as described here. For example, this can be used to set up a separate directory for developing modules, with cheat enabled and with less "stuff" so it loads faster, without interfering with your regular ToME saved games.
--no-steam	Disable Steam integration