Custom Card Texture Loader SG

Custom Card Texture Loader SG for Slay the Spire 2

Overview

Custom Card Texture Loader SG is a powerful quality-of-life mod for Slay the Spire 2 that allows you to replace in-game card textures with custom images. It fully supports animated GIF card art for dynamic visuals and includes a complete texture export toolkit designed specifically for modders and content creators.

◈ If this mod has helped you, please click the Endorse button to show your support. :)

Features

1. Custom Texture Replacement

This mod automatically scans the CustomCardTextures
folder within the mod directory for custom images and replaces default card textures accordingly. It supports multiple image formats and automatically selects the highest-priority valid file.

Supported formats (load priority order):

• .gif
• .png
• .jpg / .jpeg
• .webp
• .bmp

Automatic path resolution: The mod locates the CustomCardTextures
folder relative to its DLL file with no manual configuration required.

2. GIF Animation Support

Card textures using the .gif extension are automatically decoded and played as frame-by-frame animations via a dedicated GifAnimationManager node.

• Decodes GIFs using the high-performance SixLabors.ImageSharp library
• Supports configurable frame delay timing
• Automatic looping behavior
• First frame loads instantly for immediate display
• Remaining frames load asynchronously in the background

3. Interactive GIF Playback Mode

When enabled via the ModConfig panel, GIF animations only play during specific player interactions:

• Card hover: Animation plays when hovering over a card in hand or card select screens
• Card detail view: Animation plays while inspecting a card’s detailed view
• Mouse exit / detail close: Animation pauses and resets to the first frame

This mode greatly improves performance and delivers a more polished card viewing experience.

4. Texture Export Tool

The mod includes a built-in export feature that dumps all replaceable game textures as organized PNG files, sorted by category:

• Card Portraits: card_portraits/{pool}/
• Atlas Sprites: Root folder
• Relic Icons: relics/
• Power Icons: powers/
• Potion Icons: potions/
• Character Select: char_select_*.png

Total export: Over 2,300 PNG files. Perfect for creating custom texture packs.

Installation

1. Download the latest release from the mod page
2. Extract the contents into your Slay the Spire 2 mods folder: .../Slay the Spire 2/mods/
3. Install required dependencies:
   • ModConfig – Required for the in-game settings panel      (Without installation, only the basic replacement function is available.)

Mod directory structure:

Configuration
All settings are accessible via the in-game ModConfig panel:
CustomCardTextureLoaderSG/
├── CustomCardTextureLoaderSG.dll
├── CustomCardTextureLoaderSG.pck
├── CustomCardTextureLoaderSG.json
├── SixLabors.ImageSharp.dll
└── CustomCardTextures/

• Enable Texture Replacement (Toggle, ON) – Master switch for all custom texture overrides
• Interactive GIF Playback (Toggle, OFF) – Enables hover/detail-triggered GIF animations
• Export All Replaceable Textures (Button) – Exports all game textures to PNG format

Usage

Creating Custom Textures

1. Export base game assets using the Export button in ModConfig
2. Navigate to: .../mods/CustomCardTextureLoaderSG/CustomCardTextures/
3. Replace textures using matching filenames
4. Restart the game – textures load only at startup

Animated GIF Cards

1. Rename your GIF to match the card ID (e.g. strike_ironclad.gif)
2. Place it in the same directory as a static PNG replacement
3. Enable Interactive GIF Playback for hover-only animation

File Naming Convention

• Cards: {card_id}.{ext}
• Relics: {relic_id}.{ext}
• Powers: {power_id}.{ext}
• Potions: {potion_id}.{ext}

    (Supports reading files in subfolders.)

Troubleshooting

Textures not loading

• Verify filenames match exactly (case-sensitive)
• Check game logs for debug messages
• Confirm CustomCardTextures is inside the mod folder

GIF animations not playing

• Disable Interactive GIF Playback for continuous looping
• Ensure the GIF file is valid and not corrupted
• Verify SixLabors.ImageSharp.dll is present

Export failing

• Check write permissions for the mod directory
• Ensure sufficient disk space

The game freeze after clicking the Export button

• Resources are being exported in the background,Please wait patiently for 10–30 seconds,The export speed depends on your device performance.

Related tool:

• Godot RE Tools  - You can use this tool to extract image resources from other texture mods, then use this mod to replace the original textures.
• Custom Skeleton Loader - No game file modifications or repacking required. It replaces in-game skeletal animations for characters, monsters, UI, visual effects and more with external custom Spine assets at runtime, enabling non-intrusive resource replacement.

This mod is designed to lower the barrier for mod creation, removing packaging as an obstacle to your creative work, while enabling more intuitive and convenient file management.
Love from STS2 mod creators.
:)