Custom Texture Replacer
Custom Texture Replacer lets you swap any in-game texture in TCG Card Shop Simulator at runtime. Drop your own PNG assets in the BepInEx/plugins/CustomTextures folder and the plugin will discover, resize if needed, and inject them without restarting the game. It is fully compatible with Thunderstore Mod Manager and r2modman.
Features
- Watches
BepInEx/plugins/CustomTextures for new or updated .png files and reapplies changes automatically.
- Maintains
BepInEx/plugins/TexturesList.txt and SpritesList.txt, a living index of every texture name sprite and resolution discovered in the current session.
- Hooks into Unity asset loading so replacements stay applied across scene loads, asset bundle fetches, and dynamically created sprites.
- Falls back to automatic RenderTexture-based resizing when a replacement PNG does not match the original dimensions (matching resolutions still gives the best results).
- Ships with optional debug logging (
BepInEx/plugins/CustomTextureReplacer.debug.log) for troubleshooting texture discovery and swap events.
Requirements
- TCG Card Shop Simulator (latest Steam build).
- BepInEx 5.4+ (Mono) installed for the game.
- Windows has been tested; other OS targets should work so long as BepInEx 5 is available.
Installation
Thunderstore Mod Manager / r2modman
- Open your manager, select TCG Card Shop Simulator, and browse the Thunderstore listing.
- Locate Custom Texture Replacer and press Download (Latest).
- Launch the profile; the plugin is enabled automatically on the next game start.
Manual installation
- Download the release zip and extract it into the game directory so that
CustomTextureReplacer.dll ends up in BepInEx/plugins/CustomTextureReplacer.
- Ensure the folder structure looks like:
TCG Card Shop Simulator/
BepInEx/
plugins/
CustomTextureReplacer/
CustomTextureReplacer.dll
- Start the game once to allow the plugin to create its working folders and configuration file.
Usage
Dump available texture names
- On first launch the plugin creates
BepInEx/plugins/TexturesList.txt, containing every discovered texture name and resolution.
- Press
F8 in-game or create an empty BepInEx/plugins/CustomTextures.dump.now file to regenerate the list at any time.
Replace textures
- Open
BepInEx/plugins/TexturesList.txt and locate the texture you want to override.
- Create a PNG that matches the entry (the file name should be identical to the texture name; extension must be
.png). Matching the resolution listed is strongly recommended.
- Place the PNG in
BepInEx/plugins/CustomTextures.
- The plugin detects changes automatically and reapplies replacements on the fly. You can also force a refresh by creating
BepInEx/plugins/CustomTextures.refresh.now.
Tip: When the replacement PNG resolution differs, the plugin attempts a RenderTexture resize so the swap still succeeds. For best quality, export PNGs at the exact dimensions shown in TexturesList.txt.
Debugging and logs
- Runtime status messages are written to
BepInEx/LogOutput.log and to BepInEx/plugins/CustomTextureReplacer.debug.log.
- Enable verbose discovery output by toggling the debug settings described below.
Configuration
Edit BepInEx/config/com.duckieray.cardshop.customtextures.cfg after the first run:
| Setting |
Default |
Description |
LogNewTextureNames |
true |
Logs the names and resolutions of textures discovered during runtime scans. |
LogAssetLoads |
true |
Logs when Unity Resources or AssetBundle APIs load textures or sprites, useful for tracking dynamic assets. |
FolderPriorityMode |
LastModified |
Controls how duplicate texture names across multiple CustomTextures folders are resolved (LastModified, PreferredFolder, or FolderOrder). |
PreferredFolderHint |
(blank) |
When using PreferredFolder, provide folder names or path fragments (separated by ;, ,, or ` |
Changes take effect immediately; you do not need to restart the game.
Optional tools
CustomTextureReplacer/replace.py is a cross-platform helper that batch-copies images from any folder into CustomTextures, renaming them to match entries in TexturesList.txt. It solves the repetitive work of matching filenames and supports both Windows and Linux installs.
- Place your replacement art in a source folder and run
python replace.py <source_folder> from inside CustomTextureReplacer/.
- The script locates
TexturesList.txt, filters textures by size (default 819x1024), shuffles your images, and drops them into BepInEx/plugins/CustomTextures with the correct names.
- Use
--size WIDTHxHEIGHT, --dump path/to/TexturesList.txt, or --output path/to/CustomTextures to override defaults. Add --seed <number> for reproducible shuffles.
- Running the script with no arguments prints a help summary that documents every option, making it easy to integrate into your art workflow.
Troubleshooting
- Nothing changes - Double-check the PNG file name (case-insensitive) matches the entry in
TexturesList.txt and that the file lives directly inside BepInEx/plugins/CustomTextures.
- Blurred or stretched textures - Export replacement art at the exact resolution reported in
TexturesList.txt to avoid relying on the automatic resize.
- Performance hiccups - Large-scale swaps can be intensive the first time they apply. After the initial pass, only modified textures are reprocessed.
- Still stuck? - Inspect
BepInEx/plugins/CustomTextureReplacer.debug.log and BepInEx/LogOutput.log for warnings; attach them when reporting issues.
Changelog
1.5.0
- Fix runtime override regressions that blocked posters/UI sprites from updating after texture edits by refreshing existing override assets in-place.
- Ensure compressed textures and sprite atlas entries immediately pick up the latest PNG without recreating Unity assets unless required, preserving correct priority resolution.
- Updated to allow other mods to have CustomTextures folder and choose priority in the config. Default is LastModified.
Credits
