Using TheXTech v1.3.7+ for Speedruns (Windows, MacOS, Linux)
Guides
/
Using TheXTech v1.3.7+ for Speedruns (Windows, MacOS, Linux)
Updated 4 months ago by
Deleted

TheXTech is an open-source C++ Port of the original SMBX-Code that officially supports Windows, MacOS, GNU/Linux, Android and xBSD systems. It can also be compiled for other platforms. You can download it on GitHub or the WohlSoft Forums.

In 2021 it introduced Speedrun-Modes inspired by SMBX2's In-Game Timer extension. They have been updated many times since, making older TheXTech versions no longer viable for runs. Speedruns come in 3 variants:

  • Mode 1 includes all bugfixes and modern features.
  • Mode 2 provides an authentic SMBX 1.3 experience with only essential bugfixes.
  • Mode 3 accurately preserves SMBX 1.3 bugs and peculiarities.

https://wohlsoft.ru/wiki/images/a/a2/TheXTech-Speedrun-Mode.gif

You must use either Mode 2 or 3 to speedrun Vanilla SMBX Episodes. There are two ways to enable them:

1. Via the Speedrun Menu (Recommended)

When starting a new game at the Save Slot Screen, press SELECT to enter the hidden Game Mode selection. It includes three casual modes and their corresponding Speedrun Modes:

Confirm the selection to start the new game in your selected Speedrun Mode.

2. Via a custom command

Alternatively, you can start it by using one of these custom Commands:

thextech --speed-run-mode 2 --speed-run-semitransparent
thextech --speed-run-mode 3 --speed-run-semitransparent

--speed-run-semitransparent makes the timer half-transparent. (Optional.)

Configure the Timer Stop via compat.ini

By default, the Timer will stop at the built-in "End Game" trigger. Different triggers for the stop can be configured by editing the compat.ini file inside an episode or level folder.

none

This will keep the default setting.

[speedrun]
stop-timer-by = none

event

Stops the Timer when a certain Event is triggered.

[speedrun]
stop-timer-by = event
stop-timer-at = "Event Name"

leave

Stops the Timer when leaving a certain Level (enter without .lvl/.lvlx).

[speedrun]
stop-timer-by = leave
stop-timer-at = FinalBossLevel

enter

Stops the Timer when entering a certain Level (enter without .lvl/.lvlx).

[speedrun]
stop-timer-by = enter
stop-timer-at = EpisodeCreditsLevel

The Debt System

TheXTech 1.3.7 introduces a new life system that is enabled in Modern and Classic Modes, and their Speedrun counterparts. This has implications for Mode 2, as Game Overs are no longer possible:

Runs where the Debt Counter never gets below 0 or above 99 are not impacted by this.

Mode 3 continues to use the Vanilla Life System.

Support

If you have questions, you can reach out to Wohlstand or ds-sloth in the Moondust Discord Server/Matrix Space, the Wohlsoft Forums, or on GitHub.