Skip to content

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.

How mkw.ini works

  • One key = value per 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 = deck forces it, desktop turns it off): fullscreen, 1280x800, VSync, 720 lines.

Screen

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

Graphics and game

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

Sound, controls and menu

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

Hacks

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

Advanced and troubleshooting keys

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

Command line

--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)

Clone this wiki locally