2026-04-28 sync

Author: GlitchedReme

_config.kira.yml

@@ -101,6 +101,10 @@ docsTree:
                                     title: 15 添加单例,
                                     path: /docs/04-ritsulib/04-15-add-singleton/,
                                 },
+                                {
+                                    title: 16 血条覆盖,
+                                    path: /docs/04-ritsulib/04-16-health-bar-overlay/,
+                                },
                             ],
                     },
                     {

source/_posts/03-baselib/03-01-add-card.md

@@ -21,7 +21,7 @@ using MegaCrit.Sts2.Core.ValueProps;
 
 namespace Test.Scripts.Cards;
 
-// 加入哪个卡池
+// 注册卡牌。如果要写自定义池看添加人物的开头
 [Pool(typeof(ColorlessCardPool))]
 public class TestCard : CustomCardModel
 {

source/_posts/03-baselib/03-03-add-relic.md

@@ -8,7 +8,7 @@ categories:
 和添加卡牌类似。先新建一个类。
 
 ```csharp
-// 加入哪个遗物池，此处为通用
+// 注册遗物。如果要写自定义池看添加人物的开头
 [Pool(typeof(SharedRelicPool))]
 public class TestRelic : CustomRelicModel
 {

source/_posts/03-baselib/03-04-card-properties.md

@@ -76,6 +76,14 @@ public class MyKeywords
 `:diff()`表示这个值一旦和基础值不同，就会变红色或绿色（例如升级时增加数值，预览变成绿色）。
 
 
+简单来说效果可以在`OnPlay`这么写，或者写一个自己的Cmd方便执行效果：
+```csharp
+    // 使用DynamicVars["Leech"]获取数值，先让敌人失去生命（受到不可格挡不受能力影响的伤害）
+    await CreatureCmd.Damage(choiceContext, [cardPlay.Target!], DynamicVars["Leech"].BaseValue, ValueProp.Unblockable | ValueProp.Unpowered, cardPlay.Card.Owner.Creature);
+    // 再让玩家回复生命
+    await CreatureCmd.Heal(cardPlay.Card.Owner.Creature, DynamicVars["Leech"].BaseValue);
+```
+
 ![alt text](../../images/image26.png)
 
 ## 添加卡牌提示文本

source/_posts/03-baselib/03-06-add-potion.md

@@ -20,6 +20,7 @@ using MegaCrit.Sts2.Core.Models.Cards;
 
 namespace Test.Scripts;
 
+// 注册药水。如果要写自定义池看添加人物的开头
 [Pool(typeof(TestPotionPool))]
 public class TestPotion : CustomPotionModel
 {

source/_posts/04-ritsulib.md

@@ -69,6 +69,9 @@ public class Entry
 
     public static void Init()
     {
+        // harmony可用，但是最好用ritsu的封装patch（TODO）
+        // var harmony = new Harmony("com.example.testmod");
+        // harmony.PatchAll();
         var assembly = Assembly.GetExecutingAssembly();
         RitsuLibFramework.EnsureGodotScriptsRegistered(assembly, Logger);
         // 自动注册内容

source/_posts/04-ritsulib/04-01-add-card.md

@@ -33,7 +33,7 @@ using STS2RitsuLib.Scaffolding.Content;
 
 namespace Test.Scripts;
 
-// 注册卡牌
+// 注册卡牌到指定池（这里是无色）。如果要写自定义池看添加人物的开头
 [RegisterCard(typeof(ColorlessCardPool))]
 // 注册成人物起始卡，后面是数量。不需要删除即可。
 // [RegisterCharacterStarterCard(typeof(TestCharacter), 5)]
@@ -53,6 +53,11 @@ public class TestCard : ModCardTemplate
     // 卡图资源
     public override CardAssetProfile AssetProfile => new(
         PortraitPath: $"res://Test/images/cards/{GetType().Name}.png"
+        // 卡框等，有需求自己添加。需要自行判断卡牌类型（攻击、技能、能力等）设置，建议写在基类里。
+        // 如果使用自定义卡池，需要改下material（TODO）
+        // FramePath: "", // 卡牌背景
+        // PortraitBorderPath: "", // 边框（状态牌感染使用的）
+        // BannerTexturePath: "" // 横幅（不同类型）
     );
 
     // 卡牌基础数值
@@ -128,7 +133,17 @@ namespace Test.Scripts;
 public abstract class TestCardModel : ModCardTemplate
 {
     public override CardAssetProfile AssetProfile => new(
-        PortraitPath: $"res://Test/images/cards/{GetType().Name}.png"
+        PortraitPath: $"res://RitsuTest/images/cards/{GetType().Name}.png",
+        // 根据不同类型设置不同卡框
+        FramePath: type switch
+        {
+            CardType.Attack => "res://RitsuTest/images/card_frame_attack.png",
+            CardType.Skill => "res://RitsuTest/images/card_frame_skill.png",
+            CardType.Power => "res://RitsuTest/images/card_frame_power.png",
+            _ => ""
+        }
+        // PortraitBorderPath: "",
+        // BannerTexturePath: ""
     );
 
     public TestCardModel(int energyCost, CardType type, CardRarity rarity, TargetType targetType, bool shouldShowInCardLibrary)

source/_posts/04-ritsulib/04-03-add-relic.md

@@ -10,18 +10,22 @@ categories:
 和添加卡牌类似。先新建一个类。
 
 ```csharp
+using Godot;
 using MegaCrit.Sts2.Core.Commands;
+using MegaCrit.Sts2.Core.Entities.Cards;
 using MegaCrit.Sts2.Core.Entities.Players;
 using MegaCrit.Sts2.Core.Entities.Relics;
 using MegaCrit.Sts2.Core.GameActions.Multiplayer;
 using MegaCrit.Sts2.Core.Localization.DynamicVars;
+using MegaCrit.Sts2.Core.Models.RelicPools;
 using MegaCrit.Sts2.Core.Saves.Runs;
 using STS2RitsuLib.Interop.AutoRegistration;
 using STS2RitsuLib.Scaffolding.Content;
 
 namespace Test.Scripts;
 
-[RegisterRelic(typeof(TestRelicPool))]
+// 注册遗物。如果要写自定义池看添加人物的开头
+[RegisterRelic(typeof(SharedRelicPool))]
 // [RegisterCharacterStarterRelic(typeof(TestCharacter))] // 注册起始遗物
 public class TestRelic : ModRelicTemplate
 {

source/_posts/04-ritsulib/04-04-card-properties.md

@@ -81,6 +81,14 @@ public class MyKeywords
 `:diff()`表示这个值一旦和基础值不同，就会变红色或绿色（例如升级时增加数值，预览变成绿色）。
 
 
+简单来说效果可以在`OnPlay`这么写，或者写一个自己的Cmd方便执行效果：
+```csharp
+    // 使用DynamicVars["Leech"]获取数值，先让敌人失去生命（受到不可格挡不受能力影响的伤害）
+    await CreatureCmd.Damage(choiceContext, [cardPlay.Target!], DynamicVars["Leech"].BaseValue, ValueProp.Unblockable | ValueProp.Unpowered, cardPlay.Card.Owner.Creature);
+    // 再让玩家回复生命
+    await CreatureCmd.Heal(cardPlay.Card.Owner.Creature, DynamicVars["Leech"].BaseValue);
+```
+
 ![alt text](../../images/image26.png)
 
 
@@ -112,4 +120,30 @@ public class TestCard : ModCardTemplate
 
 ## 添加卡牌tag
 
-`ritsulib`暂时不支持添加自定义的卡牌tag。也许暂时可以用keyword替代。
+tag是指`打击` `防御`这种。如果有打击tag会被打击木偶增伤。
+
+```csharp
+[RegisterOwnedCardTag(nameof(Heavy))]
+// [RegisterOwnedCardTag(nameof(Heavy2))] // 添加更多就新加这个特性
+public class MyTags
+{
+    public static readonly string Heavy = ModContentRegistry.GetQualifiedCardTagId(Entry.ModId, nameof(Heavy));
+
+    // public static readonly string Heavy2 = ModContentRegistry.GetQualifiedCardTagId(Entry.ModId, nameof(Heavy2));
+}
+```
+
+然后在你的卡牌类里添加：
+
+```csharp
+    protected override IEnumerable<string> RegisteredCardTagIds => [MyTags.Heavy];
+```
+
+需要使用时这么写。`Card`需要是个`CardModel`类型。
+
+```csharp
+if (cardPlay.Card.HasModCardTag(MyTags.Heavy))
+{
+    // Do something
+}
+```

source/_posts/04-ritsulib/04-06-add-potion.md

@@ -21,7 +21,8 @@ using STS2RitsuLib.Scaffolding.Content;
 
 namespace Test.Scripts;
 
-[RegisterPotion(typeof(TestPotionPool))]
+// 注册药水。如果要写自定义池看添加人物的开头
+[RegisterPotion(typeof(SharedPotionPool))]
 public class TestPotion : ModPotionTemplate
 {
     // 稀有度