Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/hedge-dev/UnleashedRecomp/llms.txt

Use this file to discover all available pages before exploring further.

Unleashed Recompiled stores every setting — from resolution and frame rate to keyboard bindings and controller icons — in a single plain-text file called config.toml. Most options can be changed without ever touching this file because the in-game Options Menu exposes them directly, but knowing where the file lives and how it is structured is useful when you need to set advanced options like a specific GraphicsDevice override or custom keyboard bindings.

File Location

The configuration file is placed in a platform-specific directory by default:
PlatformPath
Windows%APPDATA%\UnleashedRecomp\config.toml
Linux~/.config/UnleashedRecomp/config.toml
Flatpak~/.var/app/io.github.hedge_dev.unleashedrecomp/data/config.toml

Portable Mode

If you place an empty file named portable.txt in the same directory as the Unleashed Recompiled executable, the game will ignore the locations above and instead store config.toml (as well as save data) right next to the executable. This is useful for self-contained installations on external drives.
You are directly responsible for the safekeeping of your save data and configuration when using portable mode.

Editing config.toml

The in-game Options Menu is the recommended way to change settings — it applies changes immediately, validates values, and requires no manual editing. However, there are a handful of settings that are only configurable by directly editing config.toml:
  • GraphicsDevice — override which GPU the game uses, identified by its exact name as shown in the F1 performance overlay.
  • GraphicsAPI — force a specific rendering backend (Auto, D3D12, or Vulkan).
  • [Bindings] section — set custom keyboard key assignments for every controller button.
config.toml is a standard TOML file. Open it in any text editor (Notepad, VS Code, etc.), make your changes, save, and relaunch the game.
The game must be fully closed before you edit config.toml. Any changes made while the game is running will be overwritten when it exits.

Sections

config.toml is divided into the following sections:
SectionDescription
[System]Language, subtitles, hint rings, control tutorials, achievement notifications, and the day/night transition style.
[Input]Camera rotation direction, controller vibration, background input, and controller icon style.
[Bindings]Keyboard key assignments for every virtual controller button.
[Audio]Master, music, and effects volume; channel configuration; music attenuation; battle theme toggle.
[Video]All graphics and display settings — resolution, frame rate, anti-aliasing, shadows, rendering API, and more.
[Codes]Hidden gameplay modifier codes. These are not exposed in the Options Menu and are intended to be enabled via the Codes tab in Hedge Mod Manager.

Quick Navigation

Video Settings

Resolution, frame rate, anti-aliasing, shadows, rendering API, and all other graphics options.

Audio Settings

Volume levels, channel configuration, music attenuation, and the battle theme toggle.

Input Settings

Camera rotation, vibration, controller icons, and full keyboard binding reference.

Build docs developers (and LLMs) love