2026-04-28 血条覆盖

Author: GlitchedReme

BaseLib/01 - 添加卡牌/README.md

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

BaseLib/03 - 添加新遗物/README.md

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

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

@@ -69,6 +69,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)
 
 ## 添加卡牌提示文本

BaseLib/06 - 添加新药水/README.md

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

Basics/05 - 变量与描述/README.md

@@ -79,7 +79,7 @@
 | `starIcons()` | 把数值渲染为辉星 | `获得{Stars:starIcons()}。` |
 | `IfUpgraded:show` | 根据升级情况显示不同文本 | `{IfUpgraded:show:升级文本\|未升级文本}` |
 | `abs` | 绝对值 | `{Damage:abs()}` |
-| `percentMore()` / `percentLess()` | 百分比 | `额外造成{Boost:percentMore()}伤害。` |
+| `percentMore()` / `percentLess()` | 百分比。<br>`PercentMore`把1.25变成25%。<br>`PercentLess`把0.75变成25%。 | `额外造成{Boost:percentMore()}%伤害。` |
 
 `SmartFormat`的内置formatter：
 

RitsuLib/01 - 添加卡牌/README.md

@@ -26,7 +26,7 @@ using STS2RitsuLib.Scaffolding.Content;
 
 namespace Test.Scripts;
 
-// 注册卡牌
+// 注册卡牌到指定池（这里是无色）。如果要写自定义池看添加人物的开头
 [RegisterCard(typeof(ColorlessCardPool))]
 // 注册成人物起始卡，后面是数量。不需要删除即可。
 // [RegisterCharacterStarterCard(typeof(TestCharacter), 5)]
@@ -46,6 +46,11 @@ public class TestCard : ModCardTemplate
     // 卡图资源
     public override CardAssetProfile AssetProfile => new(
         PortraitPath: $"res://Test/images/cards/{GetType().Name}.png"
+        // 卡框等，有需求自己添加。需要自行判断卡牌类型（攻击、技能、能力等）设置，建议写在基类里。
+        // 如果使用自定义卡池，需要改下material（TODO）
+        // FramePath: "", // 卡牌背景
+        // PortraitBorderPath: "", // 边框（状态牌感染使用的）
+        // BannerTexturePath: "" // 横幅（不同类型）
     );
 
     // 卡牌基础数值
@@ -121,7 +126,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)

RitsuLib/03 - 添加新遗物/README.md

@@ -3,18 +3,22 @@
 和添加卡牌类似。先新建一个类。
 
 ```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
 {

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

@@ -74,6 +74,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)
 
 
@@ -105,4 +113,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
+}
+```

RitsuLib/06 - 添加新药水/README.md

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

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

@@ -16,6 +16,7 @@ ModTypeDiscoveryHub.RegisterModAssembly(ModId, assembly);
 ```csharp
 using Godot;
 using STS2RitsuLib.Scaffolding.Content;
+using STS2RitsuLib.Utils;
 
 namespace Test.Scripts;