2026-04-27 sync

Author: GlitchedReme

_config.kira.yml

@@ -97,6 +97,10 @@ docsTree:
                                     title: 14 添加新人物,
                                     path: /docs/04-ritsulib/04-14-add-new-character/,
                                 },
+                                {
+                                    title: 15 添加单例,
+                                    path: /docs/04-ritsulib/04-15-add-singleton/,
+                                },
                             ],
                     },
                     {
@@ -161,6 +165,10 @@ docsTree:
                                     title: 14 添加新人物,
                                     path: /docs/04-add-new-character/,
                                 },
+                                {
+                                    title: 15 添加单例,
+                                    path: /docs/03-baselib/03-15-add-singleton/,
+                                },
                             ],
                     },
                     {

source/_posts/03-baselib/03-02-mod-config.md

@@ -17,16 +17,15 @@ public enum FjordMosaicMode
     Gamma
 }
 
-[HoverTipsByDefault]
+[ConfigHoverTipsByDefault]
 public sealed class TestModConfig : SimpleModConfig
 {
     [ConfigSection("NimbusWard")]
     public static bool WobbleVexFlag { get; set; } = true;
 
     public static double PlinthKiteVolume { get; set; } = 2.5;
 
-    [SliderRange(-12.5, 88, 0.25)]
-    [SliderLabelFormat("{0:0.##}")]
+    [ConfigSlider(-12.5, 88, 0.25, Format = "{0:0.##}%")]
     [ConfigHoverTip]
     public static double MothBanjoBias { get; set; } = 14;
 
@@ -61,7 +60,6 @@ public sealed class TestModConfig : SimpleModConfig
         _ = btn;
     }
 }
-
 ```
 
 ![示例配置](../../images/image12.png)

source/_posts/03-baselib/03-12-add-event.md

@@ -35,7 +35,7 @@ public sealed class TestEvent : CustomEventModel
     ];
 
     // 什么时候会遇到。这里的条件是所有玩家的金币都大于等于60
-    public override bool IsAllowed(RunState runState) => runState.Players.All(p => p.Gold >= DynamicVars.Gold.BaseValue);
+    public override bool IsAllowed(IRunState runState) => runState.Players.All(p => p.Gold >= DynamicVars.Gold.BaseValue);
 
     // 事件开始前的逻辑。这里是禁止玩家移除药水
     protected override Task BeforeEventStarted(bool isPreFinished)

source/_posts/03-baselib/03-15-add-singleton.md

@@ -0,0 +1,44 @@
+---
+title: 03-15 添加单例
+date: 2026-04-27 00:00:00
+permalink: docs/03-baselib/03-15-add-singleton/
+categories:
+- Basics
+---
+单例（`SingletonModel`）是一种独立于卡牌、遗物等的`AbstractModel`。所有的`AbstractModel`都有接收游戏事件发生的能力。
+
+可以用来做一些全局的影响。例如，多人模式就使用了一个`SingletonModel`，用于判断怪物是否根据玩家数量提高获得的格挡。
+
+## 代码
+
+```csharp
+using BaseLib.Abstracts;
+using MegaCrit.Sts2.Core.GameActions.Multiplayer;
+using MegaCrit.Sts2.Core.Logging;
+using MegaCrit.Sts2.Core.Models;
+
+namespace Test.Scripts;
+
+public class TestSingleton : CustomSingletonModel
+{
+    public TestSingleton() : base(true, true)
+    {
+    }
+
+    // public override Task AfterActEntered()
+    // {
+    //     Log.Info("AfterActEntered");
+    //     return Task.CompletedTask;
+    // }
+
+    // public async override Task AfterCardDrawn(PlayerChoiceContext choiceContext, CardModel card, bool fromHandDraw)
+    // {
+    //     Log.Info($"AfterCardDrawn: {card.Id}");
+    // }
+}
+
+```
+
+* 然后你可以向上面一样重载`AbstractModel`下的虚函数来监听游戏事件了，和遗物、药水等的接口一致。
+
+* 你可以反编译原版的`Hook.cs`看看有哪些接口。

source/_posts/03-choose-base-library.md

@@ -13,7 +13,7 @@ categories:
 
 ## 对比
 
-以下表格为这些基础库目前为止（2026.04.25）支持的功能表格。
+以下表格为这些基础库目前为止（2026.04.27）支持的功能表格。
 
 | 功能 | BaseLib | RitsuLib | 说明 |
 |-----------|------|------|------|
@@ -27,18 +27,17 @@ categories:
 | 血条覆盖层(中毒灾厄) | ✅ | ✅ | - |
 | 不挂载脚本场景转换 | ✅ | ✅ | - |
 | 人物非spine动画兼容 | ✅ | ✅ | - |
+| 新牌堆 | ✅ | ✅ | - |
 | customenum | ✅ | ❌ | baselib支持对任意enum扩展；<br>ritsulib不支持，但统一管理（例如关键词） |
 | 一代本地化符号 | ✅ | ❌ | * |
 | FMOD音频 | 🚧 | ✅ | - |
+| 诊断调试工具 | 🚧 | ✅ | 导出卡牌图片、patch dump等 |
 | 缺少资源时占位警告 | ❌ | ✅ | - |
 | 时间线注册 | ❌ | ✅ | 游戏时间线小故事 |
 | 事件管线 | ❌ | ✅ | 订阅事件，触发时调用 |
-| 共享池 | ❌ | ✅ | 类似无色池，有事件、无色、衍生等 |
-| 诊断调试工具 | ❌ | ✅ | 导出卡牌图片、patch dump等 |
 | 手牌发光管理 | ❌ | ✅ | - |
 | 卡牌支持AnyPlayer | ❌ | ✅ | - |
 | 快捷键绑定 | ❌ | ✅ | - |
-| 新牌堆 | ❌ | ✅ | - |
 | 内容物ID | 命名空间第一段大写，<br>例如`TEST-TEST_CARD` | modid与分类，<br>例如`TEST_CARD_TEST_CARD` | - |
 | patch | 原始`harmony` | 原始`harmony`以及封装patch系统 | - |
 | 非原生玩法内容 | 有 | 无 | 避免重复造轮子。但是会带来臃肿不兼容、抢占patch、抢占你的命名的问题。 |

source/_posts/04-ritsulib/04-14-add-new-character.md

@@ -41,8 +41,8 @@ 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);
+    // 如果你想用原版卡框换色，加这两行
+    private static readonly Material? _poolFrameMaterial = MaterialUtils.CreateRgbShaderMaterial(0.5f, 0.5f, 1f);
     public override Material? PoolFrameMaterial => _poolFrameMaterial;
 
     // 卡池是否是无色。例如事件、状态等卡池就是无色的。

source/_posts/04-ritsulib/04-15-add-singleton.md

@@ -0,0 +1,53 @@
+---
+title: 04-15 添加单例
+date: 2026-04-27 00:00:00
+permalink: docs/04-ritsulib/04-15-add-singleton/
+categories:
+- Basics
+---
+单例（`SingletonModel`）是一种独立于卡牌、遗物等的`AbstractModel`。所有的`AbstractModel`都有接收游戏事件发生的能力。
+
+可以用来做一些全局的影响。例如，多人模式就使用了一个`SingletonModel`，用于判断怪物是否根据玩家数量提高获得的格挡。
+
+## 代码
+
+```csharp
+using MegaCrit.Sts2.Core.GameActions.Multiplayer;
+using MegaCrit.Sts2.Core.Logging;
+using MegaCrit.Sts2.Core.Modding;
+using MegaCrit.Sts2.Core.Models;
+using STS2RitsuLib.Interop.AutoRegistration;
+
+namespace Test.Scripts;
+
+// 注册单例
+[RegisterSingleton]
+public class TestSingleton : SingletonModel
+{
+    // 没有用但是要写
+    public override bool ShouldReceiveCombatHooks => true;
+
+    public TestSingleton()
+    {
+        // 获得监听CombatState钩子的能力
+        ModHelper.SubscribeForCombatStateHooks(Id.Entry, state => [this]);
+        // 获得监听RunState钩子的能力
+        ModHelper.SubscribeForRunStateHooks(Id.Entry, state => [this]);
+    }
+
+    // public override Task AfterActEntered()
+    // {
+    //     Log.Info("AfterActEntered");
+    //     return Task.CompletedTask;
+    // }
+
+    // public async override Task AfterCardDrawn(PlayerChoiceContext choiceContext, CardModel card, bool fromHandDraw)
+    // {
+    //     Log.Info($"AfterCardDrawn: {card.Id}");
+    // }
+}
+```
+
+* 然后你可以向上面一样重载`AbstractModel`下的虚函数来监听游戏事件了，和遗物、药水等的接口一致。
+
+* 你可以反编译原版的`Hook.cs`看看有哪些接口。