Skip to Content

((top)): Textures.ini

[options] version = 1 hash = xxh64 ignoreAddress = true

The location of this file depends entirely on the game or emulator you are running.

Specifically, a textures.ini file dictates how a game or emulator handles texture assets. It often:

To find the correct hash, check Save new textures in the emulator settings, play the game, and look in the new textures folder for the generated filenames.

When a vintage game runs on an emulator, the emulator processes original 2D assets (such as character faces, environment textures, UI fonts, and backgrounds) from the game's ROM image. Each asset has a unique cryptographic thumbprint, or value. textures.ini

This is the main section of the file, where the actual mapping of original textures to new ones takes place. It follows a simple hash = filename.png pattern.

When you enable "Dump Textures" in Dolphin, the emulator creates a textures.ini inside the Load/Textures/[GameID]/ folder. It logs every texture the game requests:

To help me tailor any specific texture loading fixes, tell me: What are you working with?

: You can also use this section to be very specific about which part of a texture you're matching against. For instance, you can instruct the emulator to ignore the address where a texture is stored, or ignore its color palette (CLUT), to match textures that are similar but not identical. [options] version = 1 hash = xxh64 ignoreAddress

This usually happens if your custom texture image size (resolution) is not a power of two (e.g., 512x512, 1024x1024, 2048x2048). Some engines crash if you try to force an odd resolution like 1000x1003.

within the file to apply specific textures only when the game is running in that language, which is vital for localized UI and menus [1]. Asset Categorization : Modders often use comments (starting with ) to organize textures by type, such as

The file organizes texture replacements by mapping the unique (a string of letters and numbers) of an original texture to the filename of a replacement image.

, which is specific to Windows and may break on other systems. Lowercase Filenames When a vintage game runs on an emulator,

Some engines require the modder to explicitly state the dimensions of the new texture to ensure memory is allocated correctly.

# Both original hashes pull from the exact same new ultra-HD asset 094b89907dcca1a5ee284131 = characters/hero.png 094b5a707dcca1a5ee284131 = characters/hero.png Use code with caution.

For modders looking to build their own packs, the process typically involves: