StS2 MeiLin Texture Pack

A standalone Slay the Spire 2 texture-pack project for replacing MeiLinMod card art while depending on the original MeiLinMod for everything else.

This repository is meant to contain replacement card portrait PNGs and the minimal STS2/Godot mod metadata needed to package those images as a .pck mod.

Credits

Original MeiLinMod creator: Happyone13

Original mod page: https://www.nexusmods.com/slaythespire2/mods/346

This texture pack is an add-on/override project. It is not the original MeiLinMod and does not include the original mod's gameplay code, cards, relics, powers, or localization beyond what is needed for texture-pack packaging.

What this mod does

Goal:

• Depend on MeiLinMod.
• Replace card portrait art.
• Leave MeiLinMod gameplay and implementation untouched.

Replacement art goes here:

godot/MeiLinMod/images/card_portraits/

Each replacement image must use the exact same filename as the original MeiLinMod card portrait. Example:

godot/MeiLinMod/images/card_portraits/strike_meilin.png
godot/MeiLinMod/images/card_portraits/defend_meilin.png

See GUIDE.md for the detailed research notes and setup guide.

Expected installed output

For an asset-only build, the final installed files should look like this:

<Slay the Spire 2>/mods/
  StS2_MeiLinTexturePack.json
  StS2_MeiLinTexturePack.pck

If a small C# initializer is added later for logging or dependency checks, the install shape becomes:

<Slay the Spire 2>/mods/
  StS2_MeiLinTexturePack.json
  StS2_MeiLinTexturePack.dll
  StS2_MeiLinTexturePack.pck

Requirements

• Slay the Spire 2 installed.
• MeiLinMod installed.
• Godot 4.5.1 .NET or the Godot version matching your local STS2 build.
• Optional: .NET 9 SDK if this repo later adds a C# initializer DLL.

Slay the Spire 2 is Early Access, so verify your local version before relying on any modding instructions.

Build: Godot .pck

The texture pack is currently intended to be built as a Godot .pck asset payload.

General workflow:

1. Open Godot .NET matching the Slay the Spire 2 engine version.
2. Create/open a Godot project rooted at this repository's godot/ folder.
3. Add replacement PNGs under:

godot/MeiLinMod/images/card_portraits/

4. Let Godot import the images so import metadata is refreshed.
5. Export/pack the Godot project as:

StS2_MeiLinTexturePack.pck

6. Copy the .pck and StS2_MeiLinTexturePack.json into the STS2 mods/ folder.

Important: rebuild the .pck every time card art changes. Godot import/cache artifacts can matter.

Install for testing

Copy these files into your Slay the Spire 2 mods folder:

StS2_MeiLinTexturePack.json
StS2_MeiLinTexturePack.pck

Target location:

<Slay the Spire 2>/mods/

Then launch STS2 with MeiLinMod and this texture pack enabled.

First test recommendation

Before replacing all card art, test one obvious card:

1. Replace strike_meilin.png with a highly visible placeholder image.
2. Build StS2_MeiLinTexturePack.pck.
3. Install it next to MeiLinMod.
4. Launch the game.
5. Check whether Strike's card art changes.

If that works, the same path-mirroring strategy should work for the rest of the card portraits.

If it does not work, MeiLinMod may need explicit texture-pack support that loads art from this mod's own pck_name instead of relying on cross-mod path overriding.

Useful files

• GUIDE.md — detailed setup, build, install, and debugging guide.
• RESEARCH.md — notes from STS2 modding research.
• StS2_MeiLinTexturePack.json — installed-mod metadata.
• godot/mod_manifest.json — Godot payload manifest.
• godot/MeiLinMod/images/card_portraits/put_card_art_here.txt — placeholder marker for replacement art.