Slay the Spire 2 技术分析与 Mod 笔记

Appearance

Texture Pack 模板使用方法 ​

这是什么 ​

这里说的模板，指的是这个公开仓库：

  • Slay-the-Spire-2-Texture-Pack-mod
  • 仓库地址：https://github.com/Abdullah7274/Slay-the-Spire-2-Texture-Pack-mod

它本质上是一个 贴图包 / 美化 Mod 模板，目标不是改玩法逻辑，而是帮你更快地做：

  • 卡牌插画替换
  • UI 图集换皮
  • 遗物、药水、图标美化
  • 菜单与界面贴图重绘

如果你的目标是“先做一个能正常加载的美化包”，这个项目很值得参考。

它的核心思路 ​

这个模板不是从零实现一整套复杂 Mod 框架，而是走一条非常务实的路线：

  1. 用 pack/ 目录承载要覆盖进游戏的资源
  2. 用 PCK 把这些资源打成资源包
  3. 用一个很薄的 DLL 入口确保 atlas 被重新加载或正确应用

换句话说，它是一个 PCK 资源覆盖为主，DLL 辅助触发加载 的模板。

为什么它适合做美化 Mod ​

从仓库结构看，这个模板已经把最关键的几件事示范出来了：

  • 资源放在哪里
  • 贴图包如何组织
  • Mod 清单如何声明
  • atlas 资源如何被重新加载

这对美化 Mod 非常有用，因为很多时候你不是不会画，而是不确定：

  • 要替换哪一层资源
  • 目录结构该怎么放
  • 游戏到底会不会重新吃到你替换后的 atlas

这个模板正好在解决这些落地问题。

它包含了什么 ​

根据公开仓库的 README 和文件结构，这个模板至少包含：

  • pack/：资源覆盖目录
  • mod_manifest.json：模组描述信息
  • project.godot：PCK 打包所需的工程骨架
  • ModEntry.cs：模组入口
  • 一组 atlas PSD 或导出图

其中最有价值的部分，是它直接提供了卡牌 atlas 的 PSD 参考文件。这意味着你可以在不改 atlas 布局的前提下，直接进行美术替换。

它最适合拿来做什么 ​

最适合 ​

  • 卡牌插画替换
  • UI 图标与图集换皮
  • 遗物、药水、按钮等 2D 资源美化
  • 整体界面风格重绘

不太适合 ​

  • 改 Spine 骨骼动画逻辑
  • 改卡牌数值和行为
  • 改战斗流程
  • 做大型功能型 Mod

如果你的目标是“美化包”，它很合适；如果你的目标是“功能 Mod”，它帮助就比较有限。

使用时最重要的一条原则 ​

尽量不要改 atlas 的尺寸、布局和资源命名。

这是这类模板最关键的经验之一。原因很简单：

  • 游戏已经有现成的切片定义
  • atlas 坐标已经和原资源对齐
  • 你只替换画面内容时，兼容性最高

一旦你改了：

  • 图片尺寸
  • atlas 页面布局
  • 文件命名

就很可能导致切片错位、UI 对不齐，甚至资源加载异常。

推荐使用流程 ​

第一步：先选一个很小的目标 ​

不要一上来就重绘全套资源。更稳妥的做法是先选一个最小目标，例如：

  • 改一张卡牌插画
  • 改一个按钮图标
  • 改一页小型 UI atlas

先验证整个资源覆盖链路是通的。

第二步：确认你改的是哪一类资源 ​

在你自己的研究站里，已经整理了：

  • 卡牌渲染方式
  • 卡牌职业分类
  • 资源结构
  • 场景与 UI 分层

所以在动手前，先判断目标到底属于：

  • 卡牌插画层
  • UI 模板层
  • 遗物/药水图标层
  • 菜单或背景贴图层

这样你才知道应该替换哪张 atlas，而不是盲改。

第三步：在模板里替换对应资源 ​

把你改好的资源放进模板对应的位置，保持：

  • 同名
  • 同用途
  • 同尺寸
  • 同 atlas 分页结构

如果模板已经给了 PSD，就优先沿着 PSD 原布局修改，而不是重新拼一套全新的 atlas。

第四步：构建并进游戏验证 ​

这一步只看一个问题：

  • 游戏里是否正确显示了你的替换资源

如果显示正常，再继续扩大修改范围。

第五步：再做整套风格扩展 ​

在最小实验成功之后，你可以继续做：

  • 单职业卡牌美化
  • 整套 UI 重绘
  • 遗物和药水图标统一风格
  • 菜单 / HUD / 按钮风格统一

把它和本站研究成果怎么结合 ​

这个模板最适合和本站现有内容配套使用：

  • 先看 卡牌渲染，明确“卡牌最终显示”不是只有一张图
  • 再看 卡牌职业分类，决定先做哪个职业的美化
  • 再看 资源结构 和 场景与 UI，判断目标资源是在插画层、模板层还是界面层
  • 最后把目标资源放进这个 Texture Pack 模板里做实验

也就是说，本站负责帮你“看明白要改什么”，这个模板负责帮你“把资源改动真正送进游戏”。

一个很实用的起步方案 ​

如果你是第一次做美化 Mod，我建议按这个顺序来：

  1. 先只改 1 张卡牌插画
  2. 确认它能被游戏正确替换
  3. 再扩展到一个职业的小批量卡牌
  4. 再扩展到 UI 图标和通用 atlas
  5. 最后再考虑整体视觉主题包

这样成功率最高，也最容易定位问题。

什么时候需要超出这个模板 ​

当你要做下面这些事情时，就不能只依赖这个仓库：

  • 想改卡牌行为
  • 想改多人限制
  • 想改运行时逻辑
  • 想修改 Spine 动画流程

这时你就应该转去看本站的：

总结 ​

这个 Texture Pack 模板非常适合作为 Slay the Spire 2 美化 Mod 的第一步脚手架。它最擅长的是“替换已有 atlas 和贴图”，而不是“重写玩法逻辑”。如果你现在要做卡牌、UI、遗物、药水之类的视觉美化，它能明显减少你摸索目录结构和加载方式的时间。

参考来源 ​

  • 仓库主页：https://github.com/Abdullah7274/Slay-the-Spire-2-Texture-Pack-mod
  • README：https://github.com/Abdullah7274/Slay-the-Spire-2-Texture-Pack-mod/blob/master/README.md
  • 入口代码：https://github.com/Abdullah7274/Slay-the-Spire-2-Texture-Pack-mod/blob/master/ModEntry.cs