How to use HB's Texture Replacer - Catman-232/Homebrewery GitHub Wiki

This page was up to date as of version 4.6.40
Been struggling to think how best to even explain this clearly since it's unfortunately not as straightforward as it was for Appearance+, which had a much fancier yet incomplete implementation, and suffered some lacking mod manager setup jank.

Inside your mod manger's (r2modman or Thunderstore Mod Manager) profile folder, which you can get to by going into settings and using Browse profile folder. Then going to BepInEx\config, you'll see the TextureReplace folder alongside other folders Homebrewery created. Inside of that TextureReplace folder is a massive folder tree that maps to the Atlyss container path structure, which is to say, the way Kiesff has all of the assets organised in Unity Editor.
TextureReplace folder
Hovering over _graphic to see the subfolders

Doing it this way allows HB to turn all of the added files' paths into the equivalent container path to selectively load Texture2D assets, if they exist, which was a drawback of Slap's Drag and Drop which loaded every Texture2D regardless and subsequently added a dozen second delay to load times (and that's assuming you managed to put it in the right place to load the mod at all).

You likely already downloaded a compiled texture replacement pack with the folder structure sorted out if you're reading this. It can just be extracted into the TextureReplace folder. If you haven't or learning the Texture Replacer in general, the summary is basically putting texture files into specific folders with specific names. For example, the file poonTex01_chest.png goes into _graphic/_mesh/00_player/player_meshes/_racemesh_poon. Representing a Texture2D in that same container path:
Poon's folder and AssetStudio asset list
Likewise the folder tree contains all the folders to match that path.

you can see these container paths (and export the vanilla textures) by using a program like AssetStudio (as partly shown above) or by reading the text files I've added with list all of the valid file names. I have a guide for Asset Studio here:
https://github.com/Catman-232/Homebrewery/wiki/How-to-preview-and-export-the-game's-assets-(AssetStudio)

If you're here, you'll likely have a zip you downloaded with texture replacement files, and hopefully inside that zip will be the _graphic folder. You can just drag it out of the zip and on top of your _graphic. If you have stuff in there already then it will ask if you want to overwrite it, presumably you might.
The zip and the folder

The following pics are reference for the containers of the races and the major NPCs, exported using AssetStudio and up to date as of version 112025.a4

Imp
Imp

Poon
Poon

Kubold
Kubold

Byrdle
Byrdle

Chang
Chang

Angela
Angela

Sally
Sally

Enok
Enok

Skrit
Skrit

Vivian
Vivian

⚠️ **GitHub.com Fallback** ⚠️