thextech.ini Tune game settings

thextech.ini is the settings file of TheXTech. It will appear in the "settings" subdirectory once you start the game for the first time. Here you can easily configure the game options to your liking.

[main]

This section contains the generic settings of the game.

• release= - (integer) Contains the internal SMBX number of the engine. Just a constant.
• full-screen= - (true/false) Starts the game in full-screen mode.
• record-gameplay - (true/false) Added in 1.3.6 Enable recording of special demo files which can be played by engine in the future. You may send these demos with the level file to give a bug reproduction example.
• use-native-osk - (true/false) Added in 1.3.6 (Android only) Use the native text typing dialog with Android's on-screen keyboard.
• enable-editor - (true/false) Added in 1.3.6 Enable an experimental built-in editor.
• editor-edge-scroll - (true/false) Added in 1.3.6 Allow scrolling through scene by pointing/touching edges of the screen.

[video]

As of TheXTech 1.3.5.2

• render= - (sw/hw/vsync) Allows you to set one of the available rendering modes:
  • sw - Software rendering mode
  • hw - Hardware-accelerated mode (default), automatically falls back into the software rendering mode if not available.
  • vsync - Hardware-accelerated mode with vertical synchronization is enabled.
• background-work - (true/false) Keep the game running when the window is not focused.
• background-controller-input - (true/false) Allow controller inputs when the window is not focused.
• frame-skip= - (true/false) Enables frame-skipping, which should help to improve the game speed on slow machines.
• show-fps= - (true/false) Enables the FPS Counter at the top-left corner. Will display the current framerate with a green font.
• scale-down-textures - (none/safe/all) Added in 1.3.6 Enables the optimization that will 2x scale-down any 2x pixel art textures in the memory. This option allows you to majorly reduce RAM usage.
  • none - Load textures into memory in as-is form. This will lead higher RAM usage, but gives a faster loading time.
  • safe - (default) Scale down only textures are passing the built-in check for the 2x pixel art (A texture is required to have each 2x2 pixels sector use the same colour. When any 2x2 sector contains different colours, that means, the texture is not valid 2x pixel art, and will not shrink). Reduces RAM usage, but increases loading time. This mode guarantees no noticeable graphical distortions happen during scale-down.
  • all - Scale down all textures even with an invalid 2x pixel art check. This mode gives the smallest RAM usage and average loading time but leads some textures to be distorted or smoothed.
• display-controllers - (true/false) Enables the display of inputs at the bottom-left (or the bottom-right for Player 2). For supported controllers, the battery status will be shown, as well.
• battery-status - (off/fullscreen-low/low/fullscreen/on) Displays the device battery status at the top-right corner. It gets red when the device's power is beneath 35%.
  • off - Don't show battery status (default)
  • fullscreen-low - At fullscreen, show when power is beneath 35%.
  • low - Show when power is beneath 35%.
  • fullscreen - At fullscreen, show always.
  • on - Show always.
• osk-fill-screen - (true/false) Added in 1.3.6 Show built-in on-screen keyboard in fullscreen. Use this option if the on-screen keyboard looks too small on your hardware.
• show-episode-title - (off/on/transparent) Added in 1.3.6 Show an episode title during normal gameplay.
  • off - Don't show episode title (default)
  • on - Show episode title with an opaque text.
  • transparent - Show the episode with the half-opacity text.

Deprecated options:

• scale-down-all-textures - (true/false) [DEPRECATED since 1.3.6] Ths option is an eqivalent of the scale-down-textures = all.

[recent]

Added in 1.3.5.3 This section tracks recently opened episodes to highlight them in the menu

• episode-1p - (string) Recent episode played via 1-player game
• episode-2p - (string) Recent episode played via 2-player game
• episode-editor - (string) Recent episode opened in built-in editor

[gameplay]

This section contains gameplay options.

• ground-pound-by-alt-run= - (true/false) When this flag is enabled, the Purple Yoshi's ground pound will be triggered by the Alt-Run key instead of the Down key. This feature prevents players from accidentally falling into pits while attempting to do duck jumps.
• world-map-stars-show-policy - (hide/dont-show/collected-only/show/show-all) As of TheXTech 1.3.5.2 Specifies whether to display a level's Star Count on world maps. Note: The compat.ini option (or WLDX option) will override this value if different than the unspecified value provided.
  • hide / dont-show - Display nothing. (Vanilla Behavior)
  • collected-only - Display collected Stars only. (Default)
  • show / show-all - Display collected and available Stars. (Same as Hubworlds, can be inaccurate for Levels with friendly Star NPCs).
• compatibility-mode - (native/smbx2/smbx13) As of TheXTech 1.3.5.2. Specifies the global compatibility level (affecting the general gameplay behaviour and logic).
  • native - TheXTech's default behaviour, enables all vanilla bug fixes (except broken and experimental ones).
  • smbx2 - All vanilla bug fixes except those fixed at SMBX2 will be disabled.
  • smbx13 - All vanilla bug fixes will be disabled to accurately represent the SMBX 1.3 behaviour.
• strict-drop-add - (true/false) Added in 1.3.6 Lose a life when re-adding a dropped player in level.
• no-pause-reconnect - (true/false) Added in 1.3.6 Don't pause when reconnecting a controller.
• enter-cheats-menu-item - (true/false) Added in 1.3.6 Add a menu item to enter cheats using a controller/touchscreen.
• world-map-fast-move - (true/false) Added in 1.3.6 Enable the fast moving functionality on the world map.
• editor-pause-on-death - (true/false) Added in 1.3.6 Show the pause menu after death of all playable characters.

[speedrun]

As of TheXTech 1.3.5.2

• mode - (0/1/2/3) Enables the speedrun timer with a specific mode.
  • 0 - Speedrun system is disabled
  • 1 - Speedrun system enabled with Mode 1 (TheXTech Native)
  • 2 - Speedrun system enabled with Mode 2 (SMBX2-like behaviour)
  • 3 - Speedrun system enabled with Mode 3 (SMBX 1.3 behaviour)
• semi-transparent-timer - (true/false) Displays the speed-run timer with a semi-transparent font.
• blink-effect - (undefined/opaque/always/never) Added in 1.3.6 Specify the visual blink effect on every level completion.
  • undefined - Respect an episode-side or built-in defaults (default)
  • opaque - Enable the effect for opaque timer only (disable for semi-transparent)
  • always - Enable the effect always (for both opaque and semi-transparent)
  • never - Disable the effect completely.

[joystick]

This section contains some general joystick-related options.

• enable-rumble= - (true/false) Enables the gamepad's rumble.
• enable-battery-status= - (true/false) Shows the wireless gamepad battery status if available.

[sound]

This section allows you to set up the audio output options.

• sample-rate= - (integer) Allows you to specify the audio output sample rate; 44100 is the default option.
• channels= - (integer) Allows you to specify how many audio channels you have: 1 - mono, 2 - stereo, 5 and more - 3D sound.
• format= - (s8 / pcm_s8 / u8 / pcm_u8 / u16 / pcm_u16 / s32 / pcm_s32 / float32 / pcm_f32) Set the output sample format.
• buffer-size= - (integer) The size of the output buffer. Set a smaller value to reduce latency, or a bigger value if you hear a choppy sound output. 512 is the default buffer size.
• disable-sound - (true/false) As of TheXTech 1.3.5.2. Disable the sound entirely.

[effects]

This section allows you to enable or disable certain graphical effects

• enable-bowser-iiird-screen-shake= - (true/false) Enables the screen shaking effect when SMB3 Bowser does a ground pound.
• enable-thwomp-screen-shake= - (true/false) Enables the screen shaking effect when a Thwomp falls down to the ground.
• enable-yoshi-ground-pound-screen-shake= - (true/false) Enables the screen shaking effect when the Purple Yoshi does a ground pound.
• sfx-player-grow-with-got-item - (true/false) Added in 1.3.5.3 Enables the playing of the "player grow" sound together with the "got item" to represent the Super Mario World behaviour. Note: This option gets ignored if compat.ini at the target episode sets the enforcing.
• enable-inter-level-fade-effect- (true/false) Added in 1.3.5.3 Enables the inter-level screen fade effects.

Deprecated settings

These settings got deprecated/replaced/removed since the specified version number.

[main]

These parameters got moved into the [video] section as of TheXTech 1.3.5.2

• frame-skip= - (true/false) Enables frame-skipping, which should help to improve the game speed on slow machines.
• show-fps= - (true/false) Enables the FPS Counter at the top-left corner. Will display the current framerate with a green font.
• record-gameplay= - (true/false) [Experimental feature] since 1.3.5.3 Enable playthrough recording of every played level and save the special *.rec file at the gameplay-records directory. These files can be used to replay your walkthrough of the level again. Also can be useful with bug reports.

[render]

REMOVED as of 1.3.5.2. Please use the [video] section instead.

This section allows you to set up the video to work.

• render= - (0/1/2) Allows you to set one of the available rendering modes:
  • 0 - Software rendering mode
  • 1 - Hardware-accelerated mode (default), automatically falls back into the software rendering mode if not available.
  • 2 - Hardware-accelerated mode with vertical synchronization is enabled.