2026-04-25 0.104

Author: GlitchedReme

BaseLib/05 - 添加新能力/README.md

@@ -16,6 +16,7 @@ public class TestPower : CustomPowerModel
     public override async Task AfterCardDrawn(PlayerChoiceContext choiceContext, CardModel card, bool fromHandDraw)
     {
         await PowerCmd.Apply<StrengthPower>(Owner, Amount, Owner, null);
+        // await PowerCmd.Apply<StrengthPower>(choiceContext, Owner, Amount, Owner, null); // 测试版
     }
 }
 ```

Basics/03 - 选择基础库/README.md

@@ -6,7 +6,7 @@
 
 ## 对比
 
-以下表格为这些基础库目前为止（2026.04.22）支持的功能表格。
+以下表格为这些基础库目前为止（2026.04.25）支持的功能表格。
 
 | 功能 | BaseLib | RitsuLib | 说明 |
 |-----------|------|------|------|
@@ -20,7 +20,7 @@
 | 血条覆盖层(中毒灾厄) | ✅ | ✅ | - |
 | 不挂载脚本场景转换 | ✅ | ✅ | - |
 | 人物非spine动画兼容 | ✅ | ✅ | - |
-| customenum | ✅ | ❌ | baselib支持对任意enum扩展，目前不稳定仍在开发阶段；ritsulib不支持，但统一管理（例如关键词） |
+| customenum | ✅ | ❌ | baselib支持对任意enum扩展；ritsulib不支持，但统一管理（例如关键词） |
 | 一代本地化符号 | ✅ | ❌ | * |
 | FMOD音频 | 🚧 | ✅ | - |
 | 缺少资源时占位警告 | ❌ | ✅ | - |
@@ -31,6 +31,7 @@
 | 手牌发光管理 | ❌ | ✅ | - |
 | 卡牌支持AnyPlayer | ❌ | ✅ | - |
 | 快捷键绑定 | ❌ | ✅ | - |
+| 新牌堆 | ❌ | ✅ | - |
 | 内容物ID | 命名空间第一段大写，例如`TEST-TEST_CARD` | modid与分类，例如`TEST_CARD_TEST_CARD` | - |
 | patch | 原始`harmony` | 原始`harmony`以及封装patch系统 | - |
 | 非原生玩法内容 | 有 | 无 | 避免重复造轮子。但是会带来臃肿不兼容、抢占patch、抢占你的命名的问题。 |

Migrations/01 - 正式版 至 测试版/README.md

@@ -1 +1,10 @@
-之前是0.99至0.103的内容，现已废弃
+## 0.103 至 0.104测试版
+
+### 函数签名变动
+
+* 一些函数开始传入`PlayerChoiceContext`参数，与下面的进行配合。
+
+* 一些效果执行函数，例如`PowerCmd.Apply`等，需要一个`PlayerChoiceContext`参数。如果你的函数传入参数有对应类型添加即可。如果你找不到这个类型的参数，传入`new ThrowingPlayerChoiceContext()`。
+
+* `CardPileCmd.AddGeneratedCardToCombat`等，之前传入`addedByPlayer`的`bool`类型的参数的位置，改成了`Player? creator`。所以如果之前是`false`的现在填`null`，是`true`的话填`cardPlay.card.Owner`（卡牌里）或者`Owner`（能力里），根据语境。
+

README.md

@@ -1,6 +1,6 @@
 # 《杀戮尖塔2》模组制作指南
 
-支持版本：`public-beta`
+支持版本：`正式版`
 
 《杀戮尖塔2》原生支持模组，所以你可以直接制作模组并使用。
 

RitsuLib/04 - 添加卡牌属性/README.md

@@ -5,21 +5,25 @@
 * 新建一个类：
 
 ```csharp
-[RegisterOwnedCardKeyword(nameof(Unique), LocKeyPrefix = "TEST_UNIQUE", IconPath = "res://icon.svg")]
-// [RegisterOwnedCardKeyword(nameof(Unique2), LocKeyPrefix = "TEST_UNIQUE2", IconPath = "res://icon.svg")] // 如果要加更多关键词，添加特性
+[RegisterOwnedCardKeyword(nameof(Unique), IconPath = "res://icon.svg", CardDescriptionPlacement = ModKeywordCardDescriptionPlacement.BeforeCardDescription)]
+// [RegisterOwnedCardKeyword(nameof(Unique2), IconPath = "res://icon.svg")] // 如果要加更多关键词，添加特性
 public class MyKeywords
 {
     public static readonly string Unique = ModContentRegistry.GetQualifiedKeywordId(Entry.ModId, nameof(Unique));
     // public static readonly string Unique2 = ModContentRegistry.GetQualifiedKeywordId(Entry.ModId, nameof(Unique2));
 }
 ```
 
-* 添加一个本地化文件，`{modId}/localization/{Language}/card_keywords.json`。使用的键是我们定义的`LocKeyPrefix`。
+* `CardDescriptionPlacement`代表这个关键词的描述加在卡牌的位置。`BeforeCardDescription`表示在描述之前。默认不显示。
+
+* `IconPath`和`CardDescriptionPlacement`都是可选的。
+
+* 添加一个本地化文件，`{modId}/localization/{Language}/card_keywords.json`。使用的键是`TEST_KEYWORD_{id大写}`。
 
 ```json
 {
-    "TEST_UNIQUE.description": "卡组中只能有一张同名牌。",
-    "TEST_UNIQUE.title": "唯一"
+    "TEST_KEYWORD_UNIQUE.description": "卡组中只能有一张同名牌。",
+    "TEST_KEYWORD_UNIQUE.title": "唯一"
 }
 ```
 

RitsuLib/05 - 添加新能力/README.md

@@ -32,6 +32,7 @@ public class TestPower : ModPowerTemplate
     public override async Task AfterCardDrawn(PlayerChoiceContext choiceContext, CardModel card, bool fromHandDraw)
     {
         await PowerCmd.Apply<StrengthPower>(Owner, Amount, Owner, null);
+        // await PowerCmd.Apply<StrengthPower>(choiceContext, Owner, Amount, Owner, null); // 测试版
     }
 }
 ```

RitsuLib/14 - 添加新人物/README.md

@@ -34,6 +34,9 @@ public class TestCardPool : TypeListCardPoolModel
     public override Color DeckEntryCardColor => new(0.5f, 0.5f, 1f);
     // 能量表盘文字轮廓颜色
     public override Color EnergyOutlineColor => new(0.5f, 0.5f, 1f);
+    // 如果你想用原版卡框换色，加这两行。这里是hsv而不是rgb颜色
+    private static readonly Material? _poolFrameMaterial = MaterialUtils.CreateHsvShaderMaterial(0.67f, 0.5f, 1f);
+    public override Material? PoolFrameMaterial => _poolFrameMaterial;
 
     // 卡池是否是无色。例如事件、状态等卡池就是无色的。
     public override bool IsColorless => false;

RitsuLib/README.md

@@ -2,7 +2,7 @@
 
 https://github.com/BAKAOLC/STS2-RitsuLib
 
-> 以下内容使用ritsulib0.0.60。
+> 以下内容使用ritsulib0.2.3。
 
 先依赖ritsulib才能查看这里里面的文章。