设计希望能围绕3个风格进行实现，
一部分角色卡可以很容易的调用其他职业的卡，并且其本身可以很好的兼容所有职业的特殊效果，例如：灾厄和中毒会可能被一张卡统一成某种直接伤害，自身的卡种本身具有获取星辉、召唤奥斯提等其他角色专属特点的卡
其一部分角色卡会对敌我双方都造成正负面的效果，例如我设计的一张卡：“空谷回响” // 卡名:{空谷回响} // 效果:{对自身造成1点虚弱,1点易伤,对全体敌方造成5点易伤,5点虚弱,敌方失去1点力量} // 类型:{技能} 就是一张对双方都具有负面效果，但总体来说是对角色具有更大的正面效果的卡。后面还可以设计出负面效果延时生效，或者类似一代的人工制品的效果的卡来将负面收益转正
具有一些永久的全局成长牌，这些牌在初期的效果比均值低，成长速度适中，且具有：“成长”词缀，具有这个词缀的卡片会被一些卡牌激活并产生一些效果。例如：破岩胚芽，2费，造成6点伤害，生长：增加2点伤害 具有一些局内达成某个回合生效的卡牌，这些牌一般是固有的。例如：孕育果实：3回合后回复6点生命
本mod使用BaseLib作为框架辅助开发，学习阶段跟随教程https://tutorials.sts2modding.com/docs/ 开发。感谢所有先行者的努力付出!
推荐项目目录如下:
<modId>
|--Script
|--|--Cards
|--|--Character
|--|--Pools
|--|--Potion
|--|--Relics
|--|--Entry.cs
|--<modID>
|--|--images
|--|--localization
|--|--scenes
|--|--svg
|--|--background.tscn
<modId>.json
注意：
- 这些文件是在你实现一个角色时，除去项目初始化外文件夹。但实际上你可以对于除了modID以外文件随意放置，但不利于你的后续开发。初学还是建议按照格式生成。
- 关于modID：这是你json文件中id:后的值,也是你json文件本身的名字，大小写敏感!一定要大小写完全一致，不然本地化（翻译）会出问题而且不报错(BaseLib>=3.1.2版本特性)。
模组不能被游戏识别
主要在于json文件中BaseLib依赖版本的处理,版本更新有时候会修改注册逻辑，以sts2 ver0.99.3和ver0.103.4版本为对比
ver.0.99.3
"dependencies": [{ "id": "BaseLib", "min_version": "3.1.2" }],
# 新版本ver 0.103.4
"dependencies": [{"BaseLib"}],
# 旧版本往后的版本以新版本描述为首，但也不排除以后会继续修改，模组加载出问题时可以从此方面入手
- 尝试学习制作所有内容的测试
包括：角色、卡牌、遗物、药水
按照上述超链接教程，实现一个最基础的可运行的项目。我针对上述项目作一些最小化补充（2026/5/25，之后教程作者可能会自己补充），帮助你在根据超链接教程的学习时能做出一个最小化可以运作，而不是在游戏中玩到一半黑屏的测试模组。
但首先，你要先学会看日志。原版提供了游戏中波浪键打开控制台，然后输入log open来查阅，但BaseLib提供的日志更加直观,从游戏首页-模组配置-勾选启动时打开日志窗口可以打开。 下面只附加一些我遭遇过的问题，这些问题都是由我查看日志信息，以及比对其他作者mod的反编译学习而来。这里感谢模组STEVE的作者，（MOD链接）https://www.nexusmods.com/slaythespire2/mods/960
- 问题1: 战斗胜利后黑屏： 看日志就能知道你的卡池中卡片不够多，要在教程为你实现了一张卡的基础上多设置几张，最后每个稀有度都有3张牌，能解决大部分事件，当然测试时最好不要走事件，避免走商店，但部分情况下你完全可以通过控制台来实现卡牌测试。
- 问题2：欧洛巴斯（大眼）提供的欧洛巴斯之触/牙锁定，提示无初始遗物/手牌。
（附控制台命令）
relic add TOUCH_OF_OROBAS
relic add relic add TOUCH_OF_OROBAS
#分别是获取欧洛巴斯之触和先古之牙
在教程教程作者提供的代码，如果你完全实现，你仍然会出现两个问题。
在百科大全中你能看到卡牌，但他不是先古牌。在遇到大眼，或者通过控制台调用牙和触，发现没变化。
参考我的项目：
先古卡：Scripts/Cards/TestCard.cs和其先古版本Scripts/Cards/TestCardITranscendece.cs
1-你要在初始版本里上接口ITranscendenceCard而不是其先古版本上实现。
public class TestCard : CustomCardModel ,ITranscendenceCard2-修改参数rarity = CardRarity.Basic,将其归类为你的初始卡牌（其他所有基础卡也是），这样才不会在卡牌奖励卡池中抓到角色初始卡。
private const CardRarity rarity = CardRarity.Basic;3- 绑定其对应先古卡
public CardModel GetTranscendenceTransformedCard() => ModelDb.Card<TestCardITranscendence>();4- 对应先古卡也要修改参数rarity = CardRarity.Ancient
private const CardRarity rarity = CardRarity.Ancient;先古遗物：Scripts/Relics/TestRelics.cs和其先古版本Scripts/Cards/TestRelicsUpdate.cs
问题是相似的，修改变量
public override RelicRarity Rarity => RelicRarity.Starter;和初始遗物绑定先古遗物即可，不再过多解释
public override RelicModel? GetUpgradeReplacement() => ModelDb.Relic<TestRelicUpgrade>();3） 如果你和我一样不够严谨，你可能还会遇到一个特别的问题。卡面无中文描述，显示xxcard.title等。
这个状况则是上文所说的id不一致，按说明修改即可。
常用代码参数详解
- 卡牌稀有度
private const CardRarity rarity = CardRarity.?;
| 稀有度 | ? |
|---|---|
| 初始卡牌 | Basic |
| 先古卡 | Ancient |
| 普通牌 | Common |
| 罕见牌 | Uncommon |
| 稀有牌 | Rare |
| 状态牌 | Status |
| 诅咒牌 | Curse |
| 衍生牌(类似骨妹的灵魂) | Token(未证实) |
- 遗物稀有度
public override RelicRarity Rarity => RelicRarity.Starter;
| 稀有度 | ? |
|---|---|
| 初始遗物 | Starter |
| 普通（白） | Common |
| 罕见（蓝） | Uncommon |
| 稀有（金） | Rare |
| 事件牌 | Event |
| 商店专属 | Shop |
| 问号专属 | Quest |
| 诅咒 | Curse |
3.卡牌类型 技能牌 Skill
4.目标类型 指向形 Targert 无目标 None
-
注意事项,教程中说过改变代码,但是不动资源可以不更新pck.
但实践下来,如果你改过与游戏内语言有关的json文件,也是要更新pck的,因为这些代码也被作为资源存放在了pck,这就是为什么反编译学习代码时找不到与localization有关的任何代码.这导致了学习汉化难度变高了一些. -
关于打出卡牌时的效果逻辑：
以对所有敌人施加虚弱、易伤、降力为例子
foreach (Creature enemy in base.CombatState.HittableEnemies)
{
await PowerCmd.Apply<VulnerablePower>(ctx,enemy, enemyVulnerable, base.Owner.Creature, this);
await PowerCmd.Apply<WeakPower>(ctx,enemy, enemyWeak, base.Owner.Creature, this);
await PowerCmd.Apply<StrengthPower>(ctx,enemy, selfStrength, base.Owner.Creature, this);
}protected override async Task OnPlay(PlayerChoiceContext ctx, CardPlay cardPlay) 这一句在测试服是这样写的，正式服（v.103）要把ctx去掉，建议是在观察源码时尽可能的查看你写的那个版本的sts2.dll
- 教程没有提供效果类的json翻译格式。我解决的方式是这样的。
随意加一个{ }，加diff()会让变化了数值的参数变色，不过这样似乎没有特效了，我以后看看是什么问题
以我设计的空谷回响(空谷回响)为例子
protected override IEnumerable<DynamicVar> CanonicalVars => [
new DynamicVar("EnemyVulnerable", 5m), // 敌人的易伤
new DynamicVar("EnemyWeak", 5m), // 敌人的虚弱
new DynamicVar("EnemyStrength", -1m) // 敌人力量变化
];对应如下(负数还未处理，后续检查)
[{
"SUMMITBELL-VALE_ECHO.title": "空谷回响",
"SUMMITBELL-VALE_ECHO.description": "对自身造成1点虚弱，1点易伤。对所有敌人造成{EnemyWeak}点虚弱，造成{EnemyVulnerable}点易伤，并失去1点力量"
}]- 关键词的设计与补充
基于上述教程设计，如果没看懂，先回头看看教程，了解关键词的生成，再学习为关键词赋能。同时也为你实现卡牌给予一点点启发 关于这点可以学习储君“征召向前”这张卡的代码，他的作用是“无论何处，将君王之剑放置到手牌”，换言之，他实现了遍历抽牌堆和弃牌堆（排除了手牌），借鉴这一段代码你就能学会翻阅卡组并实现很多功能。下附部分关键代码。
// sts2.dll 反编译
protected override async Task OnPlay(PlayerChoiceContext choiceContext, CardPlay cardPlay)
{
await CreatureCmd.TriggerAnim(base.Owner.Creature, "Cast", base.Owner.Character.CastAnimDelay);
await ForgeCmd.Forge(base.DynamicVars.Forge.IntValue, base.Owner, this);
IEnumerable<SovereignBlade> enumerable = (from c in base.Owner.PlayerCombatState.AllCards.OfType<SovereignBlade>()
where c.Pile.Type != PileType.Hand
select c).ToList();
foreach (SovereignBlade item in enumerable)
{
await CardPileCmd.Add(item, PileType.Hand);
}
}- 能力牌制作（自定义能力）
卡牌对照： 星夜兼程
能力对照： 培育形态（暂定）
教程对应：网页超链接
我按照教程实现了模板的制作，但模板中使用的能力调用的方法只适合快速制作原生能力的复用。教程就是调用了能力命令去通过抽牌来对应获取相应的力量
await PowerCmd.Apply(Owner, Amount, Owner, null);
我想实现的自定义能力，每回合自动培育1次，因此正常的Cmd方法都不足以为我实现，于是尝试使用AI协助编程，遇到了如下问题:
AI生成的代码会杜撰一些不存在的接口函数，总是会报错。
提问时增加提示词：请你在按照我提供给你的模板代码进行设计时，如果接口或者方法不存在，一样要标注出来，并告诉我可以在何处查询正确的接口或方法。
减少不必要的方法问题，这些问题如果要死磕是解决不了了，一定要学会反编译查看，这次设计这种张卡牌，花费了很多时间去找接口，例如能力牌的实现逻辑
public override async Task AfterPlayerTurnStartEarly(PlayerChoiceContext context, Player player)
{
//...代码几乎全部复用了water.cs中处理培育关键字的逻辑，代码略。后续可能会把这个逻辑放到工具类中
}主要是方法AfterPlayerTurnStartEarly，因为我们的设计都是基于接口的设计，AI提供的方法名基本不准确，由方法名可以看出这是实现效果生成时机的方法，经过一阵查询，发现最终可以从Ctrl左击CustomPowerModel，找到BaseLib实现的能力模板，再Ctrl左击打开PowerModel就能看到相关的接口了，其中包含很多出牌的时机，大概率就是这里，然后选择一个英文描述较为贴切的方法进行实现即可。
由于现在没有很完善的文档支撑，所以这个过程是非常非常耗时间的（对于编程小白来说），我尽量在这方面进行一个比较详细的描述以及整理一份文档供参考。
更早--2026/5/29 实现了基本可运行项目，可以跑通。完成了基本卡牌的设计，实现了第一个关键字的设计 2026/5/29 实现了第一个能力及调用此能力的卡牌的设计，优化初始卡牌