TierLister 等级列表器

描述
Tier Lister 会在卡牌奖励、战斗后奖励栏、商人商店、宝箱房间以及Boss遗物选择中，为每张卡牌和每件遗物添加社区分级徽章（SS / S / A / B / C / D）。不用再眯着眼睛辨认陌生卡牌或遗物了，一眼就能选出最佳选项。纯外观覆盖，本模组不会修改任何卡牌、遗物、战斗或存档。

v0.5.0 新内容
- 模组配置集成（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的mods/文件夹内会自动创建TierLister_tiers目录，方便将可编辑的JSON文件与模组本体放置在一起。游戏加载器会在启动时对每个层级文件记录一条外观性提示"缺少id字段"。TierLister仍能正常加载，这些提示可以忽略。

v0.2.0 更新内容
- 自带评级表。首次启动时，模组会创建评级文件夹，放入JSON文件，之后每次启动都会读取。编辑JSON文件即可调整评级、添加或移除卡牌。
- 简洁的JSON格式。每个文件仅包含"角色"、"来源"以及按等级字母索引的"等级"块。将卡牌名称在列表间移动即可调整其等级。
启动提示。游戏启动时，屏幕上方出现一条绿色小横幅，显示模组已加载及可用的等级列表数量。点击横幅任意位置即可关闭。
- 响亮报错提示：你编辑的层级文件若包含无效JSON，会触发三重反馈。游戏内红色横幅显示损坏文件名与解析错误；同级目录生成带相同提示的.error.txt文件；详细日志条目同步记录。模组将自动回退至该角色的默认配置，确保游戏在修复期间仍可正常运行。


安装
确保已在《杀戮尖塔2》主菜单中启用模组（接受模组弹窗提示）。
2. 从“文件”选项卡下载最新的 TierLister-vX.Y.Z.zip。
3. 解压后，你将得到TierLister.dll和TierLister.json两个文件。
4. 将两个文件放入《杀戮尖塔2》的模组文件夹中。
  macOS：`~/Library/Application Support/Steam/steamapps/common/Slay the Spire 2/SlayTheSpire2.app/Contents/MacOS/mods/`
  - Windows: <Steam>\steamapps\common\Slay the Spire 2\mods\
5. 启动游戏。Tier Lister 将出现在游戏内的 Mods 列表中，同时主菜单会弹出绿色确认提示。


主要特色
- 每张卡牌奖励选择与商店卡牌上的阶级徽章
每件遗物上均显示等级标签。出现在商人库存、战后奖励栏、宝藏房间及Boss遗物选择界面中。
六类卡池已全部覆盖：铁甲战士、静默猎手、故障机器人、执政官、缚亡术士及无色牌。
- 150件遗物按掉落来源划分为商店、普通、稀有与极其稀有四个等级。
六个品级。SS（金色）、S（红色）、A（橙色）、B（黄色）、C（绿色）、D（蓝色）。未设品级的道具会显示为“?”，确保信息透明。
- 可编辑层级文件。可直接使用内置默认配置，或打开JSON文件自定义排名。你的修改不会因模组更新而丢失——模组仅会在文件缺失时写入默认设置。
- 点击关闭通知。成功提示与错误横幅均为可点击区域，无需菜单或额外按钮。
- 不影响游戏机制，仅限视觉覆盖。中途安装或卸载均安全无虞。
- 正在自检。任何未映射的卡牌或遗物名称将记录至godot.log一次，以便修复数据。


自定义层级
首次启动模组后，模组会在StS2模组文件夹中的DLL旁生成一个TierLister_tiers文件夹，内含七个文件：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：<Steam>\steamapps\common\Slay the Spire 2\mods\TierLister_tiers\

此造型刻意删繁就简。

{
  "character": "故障机器人"
  https://tiermaker.com/...
  层级
    "S": ["回声形态", "碎片重组", "..."]
    "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）编写的模组配置文档。
- 新鲜奶昔，对应模组教程仓库（https://github.com/fresh-milkshake/Modding-Tutorial）及可用模组清单。
- jdr（BetterSpire2 作者）。本模组使用的每张卡牌覆盖图案直接取自 BetterSpire2 的 NativeHandBadge。
- OceanUwU的击杀库（https://github.com/OceanUwU/slaytabase），用于验证杀戮尖塔2卡牌与遗物名称拼写的结构化数据。
- 感谢Mega Crit打造了支持Mod的游戏并提供了加载器API。