Every Dolphin user eventually hits the same wall. One GameCube or Wii title runs beautifully with your global graphics settings, then another shows a broken effect or a hard crash, and the fix for the second game quietly degrades the first. The conflicts are rarely about your PC: individual games lean on the original hardware in unusual ways.
As an Amazon Associate, we earn from qualifying purchases.
Dolphin’s answer is the GameINI system: a plain-text settings file for each game that layers title-specific fixes on top of your global configuration. Dolphin ships a curated database of these files, and you can add overrides that apply to exactly one game and nothing else. This guide explains the layering, the file locations, the entries, and how to undo an override that made things worse.
Some links in this guide are affiliate links, and purchases made through them may earn us a commission at no additional cost to you.
Quick Answer
GameINI is Dolphin’s per-game settings file, named after a game’s six-character GameID. Dolphin ships a database of these files with known fixes, your global settings sit underneath, and a user GameINI in the GameSettings folder overrides both for that one title. Edit it through the game’s Properties window or any text editor, and delete the file to reset.
What a GameINI File Actually Is
A GameINI is a plain text file whose name is a game’s GameID with an INI extension: G2ME01.ini, for example, belongs to the North American GameCube release of Metroid Prime 2: Echoes. The GameID is the six-character code pressed into every GameCube and Wii disc, read from your game image at launch. Inside, settings are grouped into bracketed sections such as [Core], [Video_Settings] and [Video_Hacks], each holding key-and-value lines that mirror the options in Dolphin’s configuration windows.
The database is maintained alongside Dolphin’s official wiki. Every game page there records compatibility notes and needed settings, distilled into the bundled files that ship with each Dolphin release. Updating Dolphin updates the database with it, which is why a fresh build sometimes fixes a game you never touched.
Three Layers, One Winner
When a game starts, Dolphin builds its effective configuration in layers rather than reading a single file. Your global configuration, the settings you chose for everything, forms the base. Above that sits the bundled GameINI from the database, which can replace individual values for that title. Above that sits your own user GameINI, if one exists, and its values win over both layers below.
The layering is per setting, not per file. If the database file sets an EFB option and your file sets only the texture cache accuracy, both apply, each from its own layer. A two-line user GameINI that changes exactly one behaviour is a perfectly normal sight. Netplay sits higher still, temporarily overriding key settings so every player runs the same configuration.
Where the Files Live
Two folders matter. The bundled database lives in Dolphin’s program folder under Sys, in a GameSettings subfolder, and is replaced whenever you install a new build, so never edit files there. Your own files live in the user folder: on Windows, the GameSettings folder inside the Dolphin Emulator folder in Documents; on Linux, the dolphin-emu folder under your local share directory. A portable install moves everything next to the executable.
The filename is the contract. A file only loads when its name matches the launched game’s GameID, character for character, including the region digit near the end. A file written for the European release will be ignored by the North American one: a feature when regions behave differently, a trap when you copy a file and forget to rename it.
Two Ways to Edit
Most changes should start in the graphical editor. Right-click a game, open Properties, and the Game Config tab presents the common per-game options as checkboxes: dual core, the MMU, disc transfer speed, DSP HLE and similar switches. The Editor tab shows your user GameINI as raw text, and a defaults view reveals what the bundled database file contains, so you can see which fixes Dolphin already applies before adding your own.
Hand-editing earns its place when you need a key the checkboxes do not expose, or when you copy a known-good entry from the wiki’s GameINI documentation. Keep the section headings and capitalisation exactly as documented, because the parser is case-sensitive about key names, and save under the correct GameID name. One caution: these files can also carry cheat-code sections, which follow their own syntax and belong to a different topic; leave any you find untouched.
What Typically Lives Inside
Four families of settings account for nearly every entry you will meet.
EFB and XFB behaviour, in [Video_Hacks]. EFBToTextureEnable and XFBToTextureEnable decide whether frame-buffer copies go to fast GPU textures or to slower, more accurate RAM. Games that read back their own rendered image, for photo modes or reflections, often need the RAM path forced per title.
Texture cache accuracy, in [Video_Settings]. SafeTextureCacheColorSamples controls how carefully Dolphin matches cached textures. The safest setting fixes garbled text and flickering menus in specific games at a small performance cost: exactly the trade you want scoped to one title.
CPU exceptions, in [Core]. CPUThread turns dual core off for the handful of games with threading bugs, while OverclockEnable and its multiplier let a title whose frame rate was unstable on real hardware run its emulated CPU faster or slower. Applied globally, these exceptions would slow down or destabilise everything else.
Aspect and widescreen handling, in [Video_Settings]. AspectRatio forces a display ratio for games that report theirs incorrectly, and the wideScreenHack line enables the widescreen hack only for titles whose 3D scenes tolerate it, sparing 2D-heavy games from stretched sprites.
When to Add an Entry of Your Own
Add a user GameINI when a problem is provably tied to one game: it misbehaves with your global settings, its wiki page names a required setting, or a global fix breaks it. Change one value at a time, relaunch, and confirm the effect before adding another. Keep a note of what you changed and why; a file written six months ago will not explain itself.
Resetting a Bad Override
Because your layer is just a file, resetting is simple. Delete the game’s user GameINI from the GameSettings folder, or open the Editor tab and remove the offending lines, and Dolphin falls back to the database file plus your global settings on the next launch. Nothing is written into the game image itself, so no override can permanently damage a game. If a title still misbehaves afterwards, the cause sits in your global configuration or the game itself.
Hardware That Pairs With a Tuned Setup
Per-game settings decide how games run; the right hardware decides how they feel. These five pieces cover the control and storage side of a Dolphin setup.
Nintendo Wii Remote Plus
For Wii titles, nothing reproduces the original control scheme like the genuine remote: Dolphin’s real Wii Remote mode passes its motion, pointer and speaker data straight through. The Plus model has the MotionPlus gyroscope built in, which several Wii games require before they will start.
- MotionPlus gyroscope built in, no add-on needed
- Bluetooth wireless connection
- Optical pointer designed for a sensor bar
- Built-in speaker and rumble
- Model RVL-036, powered by two AA batteries
Mayflash Wireless Sensor DolphinBar
The DolphinBar solves the two awkward parts of using a real remote on a PC: it is both the Bluetooth receiver the remote pairs with and the infrared bar the pointer aims at. Its Wii Remote mode presents connected remotes to Dolphin as real controllers.
- USB connection to the PC
- Built-in Bluetooth pairs Wii Remotes directly
- Supports up to four remotes at once
- Nunchuk and Classic Controller work through the remote
- Four working modes, including a Dolphin Wii Remote mode
Mayflash GameCube Controller Adapter
GameCube games feel best on the controller they were designed for, and this adapter’s Wii U mode is what Dolphin’s native adapter support expects: four ports of direct input with rumble.
- Model W012, four controller ports
- Side switch selects Wii U or PC mode
- Second USB cable enables rumble
- Two adapters together support eight controllers
- USB cable length: 1.5 m
8BitDo Pro 2 Bluetooth Controller
When a game does not need motion controls, a modern pad is the comfortable default, and it pairs naturally with Dolphin’s per-game controller profiles. Hall effect sticks avoid the drift that long sessions coax out of conventional sticks.
- Hall effect joysticks
- Bluetooth 4.0 and USB-C wired modes
- 1,000 mAh rechargeable battery, maker-rated for 20 hours of play
- Two programmable back buttons
- Mode switch for Switch, Android, D-input and X-input
Samsung T7 Portable SSD 1TB
A GameCube and Wii library ripped from your own discs adds up quickly, and HD texture packs add more. A fast portable SSD keeps the whole library, GameSettings folder included, in one place you can move between machines.
- Capacity: 1 TB, model MU-PC1T0T/AM
- USB 3.2 Gen 2 interface, up to 10 Gbps
- Read speeds up to 1,050 MB/s, write speeds up to 1,000 MB/s
- AES 256-bit hardware encryption
- Weight: 58 g, three-year limited warranty
How to Choose
Choose your approach by symptom. Broken effects, missing reflections or garbled text point at the [Video_Hacks] and texture cache entries. Crashes and freezes point at the [Core] switches, especially dual core. A picture in the wrong shape points at the aspect settings. Prefer the Properties checkboxes first, escalate to hand-editing only for keys the editor hides, and let the wiki’s per-game pages say which values a title expects instead of copying whole files from other players.
Who Should Skip
Skip GameINI entirely if your library already runs well on global settings. The database is quietly fixing more than you think, and every override you add is one more file to maintain. Players who mostly use netplay can skip most of this too, because sessions lock their key settings for synchronisation anyway.
FAQ
Does my user GameINI replace Dolphin’s bundled file completely?
No. The layers merge setting by setting. Your file only overrides the values it names; everything else still comes from the database file and your global configuration. That is why a very short user file is normal and safe.
Why did my per-game change have no effect?
Check the filename first: it must match the GameID of your exact release, region included. Then confirm the file sits in the user GameSettings folder rather than the Sys database folder, and that the section heading and key spelling match the documentation, since the parser respects capitalisation.
Can I share one GameINI across regions of the same game?
Not by simply copying it, because each region carries a different GameID and Dolphin matches files by that ID. You can create a second file under the other region’s ID with the same contents, but test it: regional releases occasionally differ enough that a fix helps one and harms another.
Will updating Dolphin delete my per-game settings?
No. Updates replace the program folder, including the bundled database, while your user folder and its GameSettings files are left alone. Your overrides survive, although an updated database can make an old override unnecessary.
Final Verdict
GameINI is the difference between a Dolphin setup that fights itself and one that quietly does the right thing per game. Trust the bundled database, add your own file only when a single title demands it, change one value at a time, and remember that deleting one small text file undoes everything. That keeps per-game fixes exactly where they belong: attached to the game, not smeared across your whole library.








