Tool Assisted Speedrun (TAS)

Tool Assisted Speedrun (TAS)

Tool Assisted Speedrun, or TAS for short, enables you to precisely and precisely simulate controller inputs. Even the most skilled players cannot accomplish this level of accuracy by hand. It allows Yuzu to fool the game into believing that controller inputs are occurring in real time, even though they are pre-scripted. This makes it ideal for speedrunning or testing.

This is just one of Yuzu’s many strong built-in features!

How to Play/Use Yuzu’s TAS Scripts

In order to begin using TAS scripts in Yuzu:

  1. To access the TAS configuration menu, go to:
    • Tools > TAS Configuration
  2. The format of your script files must be plain text.
  3. Observe each controller’s naming convention. For example:
    • Player 1’s script0-1
    • Player 2’s script 0-2
    • and so forth (maximum of 8 players)
  4. The script file should be placed in the proper directory.
  5. To get the TAS script to run:
    • Hit CTRL + F6.
  6. To begin or end the playback:
    • Hit CTRL + F5.
  7. During playback, you can see the current frame count in the lower-left corner of the screen.

How to Record a New Script

In Yuzu, recording new input scripts is simple and quick:

  1. Verify that your controller, such as an Xbox or PlayStation, is plugged in and configured as Player 1.
  2. For input recording to begin, press CTRL + F7.
  3. Do the things you wish to document.
  4. To end the recording, press CTRL + F7 once more.

The default file called record.txt will contain the recorded input. Yuzu will ask you to confirm overwriting the current script0-1 or the player slot you are using in a dialog box that appears after the recording.

These files can be managed or renamed for future organization.

Debugging Your Controller

If your inputs appear inconsistent or are not being recognized correctly, you can look into this further using the Controller Debugging Interface.

A visual debugger offered by Yuzu allows you to:

  • Check the input states
  • Observe the controller mappings.
  • Check to see if your controller is properly identified.

This tool is especially helpful for debugging multiplayer input sync issues and troubleshooting TAS script playback issues.