TierLister

描述

等级标签为每张卡牌和遗物添加了一个社区等级徽章（SS / S / A / B / C / D），显示在卡牌奖励、战斗后奖励行、商人商店、宝箱房和 Boss 遗物选择中。无需再眯眼辨认不熟悉的卡牌或遗物，一眼即可做出选择。纯外观覆盖层，该模组从不改变卡牌、遗物、战斗或存档。

v0.5.0 新增内容

• ModConfig 集成（https://www.nexusmods.com/slaythespire2/mods/27）。如果你安装了 ModConfig，游戏设置的模组选项卡中会出现一个“等级列表”部分，可切换禁用不同来源的徽章：铁甲战士、静默猎手、故障机器人、摄政王、亡灵缚法师、无色卡和遗物。随时切换类别以隐藏或显示其徽章，无需离开当前界面。
• ModConfig 为可选组件。若未安装，模组仍与之前一样正常工作，所有类别均默认开启。

v0.4.0 新增内容

• 亡灵缚法师卡牌等级列表。83 张卡牌分级为 S、A、B、C、D。若不同意任何排名，可编辑 tiers 文件夹中的 Necrobinder.json。
• 宝箱房徽章修复。徽章现在更靠近遗物，而非悬浮于高处，且不再因宝箱房的遗物缩放动画而大小翻倍。

v0.3.0 新增内容

• 遗物等级列表。150 个遗物按商店、普通、罕见和稀有掉落级别合并为一个列表。当某个遗物出现在多个来源时，取最高等级。
• 商店遗物上的等级徽章。每个商人遗物槽上方都会显示一个等级徽章，外观与商店卡牌徽章一致。
• 战斗后遗物奖励上的等级徽章。战利品界面中，遗物行的右端会显示一个带有等级字母的小圆形徽章。
• Boss 奖励和宝箱房遗物上的等级徽章。“选择遗物”界面和宝箱房遗物展示也会进行装饰。
• 等级文件与 DLL 位于同一目录。首次启动时，将在你的 StS2 模组文件夹内创建 TierLister_tiers 文件夹，因此可编辑的 JSON 文件与模组本体放在一起。游戏加载器在启动时会为每个等级文件记录一条无关紧要的“缺少 id 字段”警告。TierLister 仍会正常加载，这些警告可忽略不计。

v0.2.0 新增内容

• 自带等级列表。首次启动时，模组会创建一个等级文件夹，将 JSON 文件放入其中，并在每次启动时从该文件夹读取。编辑 JSON 即可重新分级、添加或移除卡牌。
• 简化 JSON 格式。每个文件仅包含“character”、“source”和按等级字母索引的“tiers”块。将卡牌名称移入不同列表即可重新分级。
• 启动提示。启动时会出现一个绿色横幅，确认模组已加载，并显示就绪的等级列表数量。点击即可关闭。
• 显眼错误报告。若你编辑的等级文件包含无效 JSON，你会收到三种提示：游戏内红色横幅，显示损坏的文件名和解析错误；紧邻损坏 JSON 旁生成的 .error.txt 文件，包含相同说明；以及日志中的详细条目。该模组会为该角色回退至内置默认设置，以便你在修复时游戏仍可正常运行。

安装说明

1. 确保已在《杀戮尖塔 2》中启用模组（主菜单，接受模组提示）。
2. 从文件标签页下载最新版 TierLister-vX.Y.Z.zip。
3. 解压后，你将获得 TierLister.dll 和 TierLister.json。
4. 将这两个文件放入你的 StS2 模组文件夹。
   • macOS: ~/Library/Application Support/Steam/steamapps/common/Slay the Spire 2/SlayTheSpire2.app/Contents/MacOS/mods/
   • Windows: \steamapps\common\Slay the Spire 2\mods\
5. 启动游戏。Tier Lister 应出现在游戏内模组列表中，主菜单上会显示绿色确认提示。

主要功能

• 每个卡牌奖励选择和商店卡牌上都有等级徽章。
• 每个遗物上都有等级徽章，显示在商人库存、战斗后奖励行、宝箱房和 Boss 遗物选择界面中。
• 覆盖全部六个卡池：铁甲战士、静默猎手、故障机器人、摄政王、亡灵缚法师和无色卡。
• 150 个遗物按商店、普通、罕见和稀有掉落来源分级。
• 六个等级：SS（金色）、S（红色）、A（橙色）、B（黄色）、C（绿色）、D（蓝色）。未映射等级的物品显示“?”，确保无遗漏。
• 可编辑等级文件。可直接使用内置默认值，或打开 JSON 并使用自定义排名。你的编辑不会因模组更新而丢失，因为模组仅在文件不存在时写入默认值。
• 点击关闭通知。成功提示和错误横幅均可点击关闭，无需菜单或额外按钮。
• 零游戏影响。纯视觉覆盖层，可在游戏途中安全安装或卸载。
• 自诊断。任何未映射的卡牌或遗物名称都会被记录到 godot.log 中，以便修正数据。

自定义等级

首次启动后，模组会在 DLL 旁创建一个 TierLister_tiers 文件夹，位于你的 StS2 模组文件夹内，其中包含七个文件：defect.json、ironclad.json、silent.json、regent.json、necrobinder.json、colorless.json 和 relics.json。

• macOS: ~/Library/Application Support/Steam/steamapps/common/Slay the Spire 2/SlayTheSpire2.app/Contents/MacOS/mods/TierLister_tiers/
• Windows: \steamapps\common\Slay the Spire 2\mods\TierLister_tiers\

文件结构有意保持极简：

{
  "character": "Defect",
  "source": "https://tiermaker.com/...",
  "tiers": {
    "S": ["Echo Form", "Defragment", "..."],
    "A": ["..."],
    "B": ["..."],
    "C": ["..."],
    "D": ["..."]
  }
}

如需重新分级，将卡牌或遗物名称移至不同数组；如需从视图中移除，删除对应行；如需添加未分级项，追加名称。保存文件并重启游戏。

若需恢复默认设置，删除该文件并重新启动，模组将根据内置版本重新生成。

若编辑导致 JSON 无效，模组会通过三种方式发出警告，而非静默失败：

• 主菜单上显示红色横幅，列出损坏文件和解析错误。
• 损坏 JSON 旁生成 .error.txt 附带文件，包含恢复步骤。
• 游戏日志中的详细条目。

该文件将回退至内置默认设置，直至 JSON 被修复或删除。

需求

• 《杀戮尖塔 2》且已启用原生模组加载（v0.99.x 或更新版本）。
• 仅此而已。无需其他模组、框架或运行时库。Harmony 和等级数据已内置在 DLL 中。

致谢

• OpemSpire（https://www.youtube.com/@OpemSpire）。本模组中所有默认卡牌等级排名均来自他的《杀戮尖塔 2》等级列表视频。
• TierMaker 上的 JapaneseExport。默认遗物等级排名（商店、普通、罕见、稀有）来自其社区发布的等级列表。
• Alchyr，感谢 ModTemplate-StS2 项目（https://github.com/Alchyr/ModTemplate-StS2）记录了模组设置。
• fresh-milkshake，感谢 Modding-Tutorial 仓库（https://github.com/fresh-milkshake/Modding-Tutorial）和可用模组清单。
• jdr（BetterSpire2 的作者）。本模组使用的逐卡覆盖层模式直接借鉴自 BetterSpire2 的 NativeHandBadge。
• OceanUwU 的 slaytabase（https://github.com/OceanUwU/slaytabase），用于校验卡牌和遗物名称拼写的结构化 StS2 数据。
• Mega Crit，感谢他们打造了可模组的游戏并发布了加载器 API。