自定义卡牌纹理加载器 SG

自定义卡牌贴图加载器 SG（杀戮尖塔2）

概述

自定义卡牌贴图加载器 SG 是一款适用于《杀戮尖塔2》的强大便利性模组，允许你用自定义图片替换游戏内的卡牌贴图。它完整支持动态视觉所需的 GIF 动画卡图，并包含一套专为模组作者和内容创作者设计的完整贴图导出工具包。

◈ 如果这个模组对你有帮助，请点击“赞”按钮以示支持。:)

功能特性

1. 自定义贴图替换

此模组会自动扫描模组目录下的 CustomCardTextures 文件夹，查找自定义图片，并相应地替换默认的卡牌贴图。它支持多种图片格式，并会自动选择优先级最高的有效文件。

支持的格式（按加载优先级排序）：

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

自动路径解析： 模组会相对于其 DLL 文件定位 CustomCardTextures 文件夹，无需手动配置。

2. GIF 动画支持

使用 .gif 扩展名的卡牌贴图会自动被解码，并通过专用的 GifAnimationManager 节点逐帧播放。

• 使用高性能的 SixLabors.ImageSharp 库解码 GIF
• 支持可配置的帧延迟时间
• 自动循环播放行为
• 首帧立即加载以供即时显示
• 其余帧在后台异步加载

3. 交互式 GIF 播放模式

当通过模组配置面板启用时，GIF 动画仅在特定玩家交互期间播放：

• 卡牌悬停： 在手中或卡牌选择界面悬停卡牌时播放动画。
• 卡牌详情视图： 在查看卡牌详细视图时播放动画。
• 鼠标移出 / 详情关闭： 动画暂停并重置到第一帧。

此模式极大地提高了性能，并提供更精致的卡牌浏览体验。

4. 贴图导出工具

模组内置了一个导出功能，可将所有可替换的游戏贴图按类别整理，导出为 PNG 文件：

• 卡牌立绘： card_portraits/{pool}/
• 图集精灵： 根文件夹
• 遗物图标： relics/
• 能力图标： powers/
• 药水图标： potions/
• 角色选择： char_select_*.png

总导出量： 超过 2,300 个 PNG 文件。非常适合制作自定义贴图包。

安装教程

1. 从模组页面下载最新版本。
2. 将内容解压到你的《杀戮尖塔2》模组文件夹： .../Slay the Spire 2/mods/
3. 安装所需依赖项：
   • 必要依赖项： ModConfig – 用于游戏内设置面板 （如果不安装，则仅提供基础替换功能）。

模组目录结构：

CustomCardTextureLoaderSG/
├── CustomCardTextureLoaderSG.dll
├── CustomCardTextureLoaderSG.pck
├── CustomCardTextureLoaderSG.json
├── SixLabors.ImageSharp.dll
└── CustomCardTextures/

配置

所有设置均可通过游戏内的 ModConfig 面板访问：

• 启用贴图替换 （开关，默认开启） – 所有自定义贴图覆盖的总开关。
• 交互式 GIF 播放 （开关，默认关闭） – 启用悬停/查看详情时触发的 GIF 动画。
• 导出所有可替换贴图 （按钮） – 将所有游戏贴图导出为 PNG 格式。

使用方法

创建自定义贴图

1. 使用 ModConfig 中的 Export（导出）按钮导出基础游戏资源。
2. 导航至：.../mods/CustomCardTextureLoaderSG/CustomCardTextures/
3. 使用匹配的文件名替换贴图。
4. 重新启动游戏 – 贴图仅在启动时加载。

动画 GIF 卡牌

1. 将你的 GIF 重命名以匹配卡牌 ID（例如，strike_ironclad.gif）。
2. 将其与静态 PNG 替换文件放在同一目录下。
3. 启用 交互式 GIF 播放 以实现仅悬停播放动画。

文件命名规则

• 卡牌： {card_id}.{ext}
• 遗物： {relic_id}.{ext}
• 能力： {power_id}.{ext}
• 药水： {potion_id}.{ext}

（支持读取子文件夹中的文件。）

故障排除

贴图无法加载

• 确认文件名是否完全匹配（区分大小写）。
• 检查游戏日志中带有 [CustomCardTextureLoaderSG] 前缀的调试消息。
• 确认 CustomCardTextures 文件夹位于模组文件夹内。

GIF 动画不播放

• 禁用“交互式 GIF 播放”以实现连续循环播放。
• 确保 GIF 文件有效且未损坏。
• 确认 SixLabors.ImageSharp.dll 文件存在。

导出失败

• 检查模组目录的写入权限。
• 确保有足够的磁盘空间。

点击导出按钮后游戏冻结

• 资源正在后台导出，请耐心等待 10-30 秒，导出速度取决于你的设备性能。

相关工具：

• Godot RE Tools - 你可以使用此工具从其他贴图模组中提取图像资源，然后使用本模组替换原始贴图。
• Custom Skeleton Loader - 无需修改游戏文件或重新打包。它可以在运行时用外部自定义 Spine 资源替换游戏内角色、怪物、UI、视觉效果等的骨骼动画，实现非侵入式的资源替换。

此模组旨在降低模组创作的门槛，消除打包对你创作工作的阻碍，同时实现更直观、更方便的文件管理。 来自 STS2 模组创作者的爱。 :)