Config Files and Changing Mod Settings

After first launching the game, two config files are created that allow you to modify certain aspects of the mod. These files can be found at:

Windows: %LOCALAPPDATA%\ModTheSpire\sayTheSpire\
Linux: ~/.config/ModTheSpire/sayTheSpire/
Mac: ~/Library/Preferences/ModTheSpire/sayTheSpire/

The settings.ini file allows you to change various settings related to the mod. The input.json stores keyboard mappings. It is not recommended to manually modify input.json unless you are familiar with json.

Settings.ini

This is a list of all of the available options in settings.ini. To change one of these, change the value to the right of the =. For example you could disable reading block text by changing block_text = true to block_text = false.

Certain config options require an array, a list of values. An array always starts with [ and ends with ]. These values must be enclosed in quotes if they are strings of text. For example to exclude cards and relics, you would use exclude_read_typenames = ["card", "relic"]

[advanced]

Advanced settings related to the internals of the mod.

Setting	Accepted Values	Default Value	Description
use_updated_card_description	true, false	false	whether or not to use a different internal property to get card descriptions. This should be enabled if you are trying to use mods that do not have properly rendered card descriptions. This may break depending on your current game language so use this with caution.
prefered_speech_handler_order	[ array of speech handler names ]	[]	Your prefered order of speech handlers. For more information, see the next section on speech handlers.
speech_handler_force_system_speech	true, false	false	Whether or not system speech (for example SAPI) is used (if your speech handler supports it.)

Speech Handler Priority

The mod has a number of speech handlers stored internally. Each speech handler allows output via a specific library or process and the best one for your system is loaded by default (for example Tolk for Windows). There is a default order for them. when the mod is first loaded, handlers are checked in order. If one meets the criteria to be used (for example correct operating system) it is set as the active speech handler and all text output from the mod will be output via that handler.

If you would prefer a different order (such as forcing clipboard output for example), you can reorder the list via the advanced.prefered_speech_handler_order setting. The speech handler names you add to the list will be moved to the beginning of the list in the order you specify. For a list of speech handlers, see the table below. The table below lists the handlers in their default order.

Handler	description	Criteria to Use	Supports System Speech
tolk_resources	Uses the Tolk (screen reader output) library for Windows and automatically extracts dlls needed at runtime. Dll files are removed when the game is closed.	Windows	Yes
tolk	Uses the Tolk (screen reader output) library for Windows. You will need to copy required screenreader dll files to the game directory to use this handler.	Windows	Yes
clipboard	Sends all text output to the clipboard. This is useful for translation or for some specific screen readers.	All	No

[combat]

Settings related to combat messages.

Setting	Accepted Values	Default Value	Description
block_text	true, false	true	Whether or not to read when a creature gains block.
buff_debuff text	true, false	true	Whether or not to read when a creature gains a buff or debuff.
card_events	true, false	true	Whether or not card events are read. These include cards being added to draw, discard, etc as well as cards being exhausted.
orb_events	true, false	true	Whether or not orb events are read. This includes when orbs are channeled and evoked.

[input]

Settings related to virtual input.

Setting	Accepted Values	Default Value	Description
virtual_input	true or false	true	Whether or not virtual input is enabled.

[map]

Settings related to map reading.

Setting	Accepted Values	Default Value	Description
read_reversed_paths	true, false	true	Whether or not to read the path in reverse when moving backward on the map, as if you were tracing it visually. Many people prefer to disable this to save time but it is enabled by default for clarity.

[ui]

Contains settings related to the game's UI and how certain elements are read out.

Setting	Accepted Values	Default Value	Description
read_proceed_text	true, false	true	Whether or not to read the proceed text when the option is available (for example to skip a combat reward)
read_banner_text	true, false	true	Whether or not banner text is read. Banner text appears at the top of the screen and generally acts as a screen title.
read_positions	true, false	true	Whether or not to read the position of an element (for example 1 of 3 in a list)
read_types	true, false	true	Whether or not element types, such as button, are read for each UI element.
read_obtain_events	true, false	true	Whether or not the mod notifies you when you obtain an object (such as a card, potion, relic, etc).
exclude_read_typenames	[array of strings]	[] empty	An array or list of types to not be read. For example if you do not want cards and relics to say card or relic after their name, you could set this to `["card", "relic"]`.

[resources]

Settings related to how resources are loaded and unloaded. If you are experiencing a crash when closing the game, set both of these to false.

Setting	Accepted Values	Default Value	Description
unload_native_libs	true, false	true	Whether or not to unload the screen reader libraries from memory when the game closes.
dispose_resource_files	true, false	true	Whether or not to delete the screen reader dll files in the slay the Spire root directory after the game closes and they are unloaded from memory. Do not enable this unless unload_native_libs is enabled or it won't work.

Say the Spire Documentation