Repository navigation
Settings and mkw.ini
Adrià edited this page Nov 19, 2026
·
3 revisions
Every setting is in the F1 menu in game and in Settings on the start screen; both write mkw.ini in the game
folder (see Installation). Settings marked restart apply at the next start.
- One
key = valueper line;#or;start a comment;[sections]only group keys; case does not matter. - Every key also works as an environment variable with
MKW_in front (MKW_RESOLUTION=720), which wins over the file. A menu setting forced by a variable is greyed out. - The menu writes back only what you change and keeps the rest of the file. Settings → Advanced → Reset all settings to defaults removes them.
- Order: environment variable, then
mkw.ini, then the Steam Deck profile, then the default. -
Steam Deck is detected by itself (
DEVICE_PROFILE = deckforces it,desktopturns it off): fullscreen, 1280x800, VSync, 720 lines.
| Key | Default | Values | Notes |
|---|---|---|---|
FULLSCREEN |
0 | 0, 1 | F11 toggles and saves it |
WINDOW_SIZE |
1920x1080 | WxH | |
VK_PRESENT |
mailbox | mailbox, fifo (VSync), immediate | |
GPU_INDEX |
auto | number | restart. Which Vulkan GPU, in the order the log lists them |
PERF_OVERLAY |
off | off, fps, full | F10 cycles it |
FPS |
auto | auto, 30, 60 | Auto is the console's 60, dropping to 30 when a frame is too slow |
FRAMEGEN |
off | off, auto, 2, 3, 4 | Frame generation: smoother, not faster; up to one frame of extra delay |
UPSCALER |
fsr | fsr, bilinear | How the picture is scaled to the window |
SHARPNESS |
80 | 0–100 | FSR sharpening; 0 is off |
PICTURE_FIT |
keep | keep, stretch | Black bars or stretch, for a 16:9 picture in another window shape |
HDR |
auto | auto, off | Auto shows the game's HDR picture when the display is in HDR (Windows: Settings → Display → Use HDR) |
HUD_POSITION |
16:9 | 16:9, edges | restart. HUD position: on 1.8.0, edges moves the HUD and menu pieces to the screen's edges in a wide window |
| Key | Default | Values | Notes |
|---|---|---|---|
RESOLUTION |
original | original, 540, 720, 900, 1080, 1440, 2160 | restart. Internal resolution: lines the game renders at. Original is the console's (up to 1440). 720 suits integrated graphics |
ASPECT |
16:9 | 16:9, window, 21:9, 32:9, 48:9 | restart. Wider shows more of the course at the sides; window takes the monitor's shape. Menus and HUD keep 16:9 |
LANG |
auto |
en-US, en-GB, ja, fr, fr-CA, de, it, es, es-419, nl, pt, pt-BR, ru, ko, zh-CN, zh-TW, pl, th, ca, gl, eu, tr
|
restart. Game texts and voices. pl and th need a 1.8.0 dump; ca, gl, eu and tr are the project's translations. On auto it follows the menu language when the game has it |
OPERATION_MODE |
docked | docked, handheld | restart |
LAN |
0 | 0, 1 | restart. Wireless Play becomes LAN Play (see FAQ) |
LAN_IP |
IPv4 | Which local address LAN Play uses, if it picks the wrong one | |
LAN_PEERS |
addresses or names | restart. The other PCs, for a network with no broadcast such as Tailscale (LAN play) | |
QUALITY |
console | low, medium, console, high, ultra, custom | Preset for the rows below |
ANISO |
game | game, 2, 4, 8, 16 | restart |
TEX_QUALITY |
full | full, half, quarter | restart. Half or quarter for GPUs with 4 GB or less |
DETAIL_DISTANCE |
2 | 1, 1.5, 2, 3, 4 | restart. 2 is the console's |
SHADOW_SIZE |
console | console, 1024, 2048, 3072, 4096 | restart. Console is 3072 docked, 2048 handheld |
| Key | Default | Values | Notes |
|---|---|---|---|
VOLUME |
100 | 0–100 | |
AUDIO_CHANNELS |
auto | auto, 2, 6 | restart. Auto gives 5.1 when the output device has 6 or more channels |
BACKGROUND_MUTE |
0 | 0, 1 | Mute when the window is not focused |
MOTION |
1 | 0, 1 | Tilt steering with a controller's gyro |
RUMBLE_STRENGTH / RUMBLE_CURVE / RUMBLE_TRIGGERS
|
130 / 0.6 / 0 | 0–300 / 0.2–1.5 / 0, 1 | Trigger rumble is for Xbox controllers |
PAD_LAYOUT |
auto | auto, nintendo, xbox | Which face button is A |
BUTTON_ICONS |
auto | auto, nintendo, xbox, playstation, keyboard | Auto follows the last device used |
MOUSE_SENS |
1 | 0–10 | Mouse camera |
STICK_DEADZONE |
8 | 0–40 | Percent, circular. Raise it for a worn stick. While unset, Xbox 360 pads get 24 and Xbox One/Series 26.5 |
MENU_SHORTCUT |
minus_plus | minus_plus, guide | The buttons that open this menu |
DSU / DSU_SERVER / DSU_SLOT
|
0 / 127.0.0.1:26760 / 0 | 0, 1 / host:port / 0–3 | Motion from a Cemuhook (DSU) server such as DS4Windows or BetterJoy, for pads without a gyro |
SWITCH2 |
0 | 0, 1, 2 | restart. Switch 2 controllers over Bluetooth; 2 also logs every device seen |
MENU_LANG |
system | 21 languages | This menu and the start screen |
UPDATE_CHECK |
1 | 0, 1 | |
START_SCREEN |
auto | auto, always, skip | Auto skips the start screen when Steam starts the game, unless it has something to say |
GAME_DIR |
path | Set by Choose game folder |
Optional, off by default.
| Key | Default | Notes |
|---|---|---|
TURBO / TURBO_SPEED
|
off / 4 | Whole game faster (off, hold, toggle, on); F2 |
SKIP_MOVIES |
0 | Skips cup and course openings |
UNLOCK_ALL |
0 |
restart. All drivers, outfits, vehicles, stickers, the Special Cup and Mirror. It acts on an existing save, so in a new game folder from the second start. It is written into your save: turning it off does not lock them again. Back up profile/ first if you care |
SEED |
restart. Same randomness every time | |
QUICK_RACE |
off |
restart. Straight to time trial (tt) or free roam (free) |
FREEZE_KEYS |
0 | F3 freezes, F4 steps one frame |
The Advanced tab is for testing; leave it at its defaults unless an issue or Troubleshooting asks for a change. Keys that replies often ask for:
| Key | What it does |
|---|---|
MESH_COMPUTE = 1 |
Runs the game's task/mesh shaders as compute passes (default on AMD's drivers) |
MEMORY = import |
Another way to share the game's memory with the GPU |
GPU_CRUMBS_DRAW = 1 |
After a GPU crash the log names the exact draw |
PIPE_TRACE = 1 |
The log names each pipeline being compiled |
SKIP_PROGRAMS = <hex> |
Skips the draws of one shader (objects may go missing); only when an issue reply says which |
GPU_MEM_LIMIT, SPARSE_MIB, VRAM_MARGIN
|
Memory caps. Do not set them by hand unless asked: wrong values cause black terrain |
--play |
Start the game, skip the start screen (same as MKW_NO_LAUNCHER=1) |
--launcher |
Open the start screen |
MKW_VIRTUAL_PADS=N |
Adds N virtual controllers (to try local multiplayer) |
Something wrong or missing here? Say so in Discussions. mkw-recomp is not affiliated with Nintendo.