2026-04-04 sync

Author: REME

_config.kira.yml

@@ -81,6 +81,10 @@ docsTree:
                                     title: 10 mod联动,
                                     path: /docs/03-10-mod-integration/,
                                 },
+                                {
+                                    title: 11 添加新怪物,
+                                    path: /docs/03-11-add-monster/,
+                                },
                             ],
                     },
                     { title: 04 添加新人物, path: /docs/04-add-new-character/ },

source/_posts/02-install-view-source-and-patch.md

@@ -1,5 +1,5 @@
 ---
-title: 02 准备工作
+title: 02 常见问题
 date: 2026-03-15 00:00:00
 permalink: docs/02-install-view-source-and-patch/
 categories:

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

@@ -6,28 +6,65 @@ categories:
 - Basics
 ---
 * 要使用此功能，需要先放一张图片到`{modId}\mod_image.png`作为mod图标，尺寸任意，否则会由于报错不显示配置。
-* 添加一个继承`SimpleModConfig`（或者是`ModConfig`如果你想要更复杂的设置）的类，在其中添加`public static bool`变量。支持`bool`，`double`，`enum`，`int`，`string`。
+* 添加一个继承`SimpleModConfig`（或者是`ModConfig`如果你想要更复杂的设置）的类，在其中添加`public static bool`变量。支持`bool`，`double`，`enum`，`string`。
 * 在初始化函数调用`ModConfigRegistry.Register`。字符串写你的`modId`。
 
 ```csharp
-[ModInitializer("Init")]
-public class Entry
+public enum FjordMosaicMode
 {
-    public static void Init()
-    {
-        ModConfigRegistry.Register("test", new ModConfig());
-    }
+    Alpha,
+    Beta,
+    Gamma
 }
 
-public class ModConfig : SimpleModConfig
+[HoverTipsByDefault]
+public sealed class TestModConfig : SimpleModConfig
 {
-    public static bool Test1 { get; set; } = true;
-    public static bool Test2 { get; set; } = false;
-    public static bool Test3 { get; set; } = true;
+    [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.##}")]
+    [ConfigHoverTip]
+    public static double MothBanjoBias { get; set; } = 14;
+
+    [ConfigSection("HarborTokens")]
+    [ConfigTextInput(TextInputPreset.SafeDisplayName)]
+    public static string GlintHarborAlias { get; set; } = "rift_op";
+
+    [ConfigTextInput("[A-Z0-9_]+")]
+    public static string KiteVaultCode { get; set; } = "X9";
+
+    public static FjordMosaicMode CruxEnumPick { get; set; } = FjordMosaicMode.Beta;
+
+    [ConfigHoverTip(false)]
+    public static bool SilentSporeGate { get; set; }
+
+    [ConfigIgnore]
+    public static double OrphanLedgerAmt { get; set; } = -1;
+
+    [ConfigHideInUI]
+    public static string NimbusVaultToken { get; set; } = "";
+
+    [ConfigButton("QrkvVaultPing")]
+    public static void OnVaultPing(ModConfig cfg, NConfigOptionRow row)
+    {
+        _ = cfg;
+        _ = row;
+    }
+
+    [ConfigButton("QrkvRowClear")]
+    public void OnRowClear(NConfigButton btn)
+    {
+        _ = btn;
+    }
 }
+
 ```
 
 ![示例配置](../../images/image12.png)
 
-更多请参考`baselib`的`BaseLibConfig`类。
+更多请参考`baselib`的`BaseLib.Config`下的类。
 

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

@@ -38,8 +38,9 @@ public class TestPotion : CustomPotionModel
     // 这里显示预览卡牌灵魂。或者你可以添加提示关键词
     public override IEnumerable<IHoverTip> ExtraHoverTips => [HoverTipFactory.FromCard<Soul>()];
 
-    public override string? PackedImagePath => "res://icon.svg";
-    public override string? PackedOutlinePath => "res://icon.svg";
+    // 药水图片。不一定svg，只要最终能变成Texture的格式就行。
+    public override string? CustomPackedImagePath => "res://icon.svg";
+    public override string? CustomPackedOutlinePath => "res://icon.svg";
 
     // 打出时的效果逻辑，这里是创造3张灵魂到手牌中。
     protected override async Task OnUse(PlayerChoiceContext choiceContext, Creature? target)
@@ -57,4 +58,4 @@ public class TestPotion : CustomPotionModel
     "TEST-TEST_POTION.title": "戈多药水",
     "TEST-TEST_POTION.description": "将[blue]{Cards}[/blue]张[gold]灵魂[/gold]加入你的[gold]手牌[/gold]。"
 }
-```
+```

source/_posts/03-07-add-ancient.md

@@ -197,9 +197,4 @@ offset_right = 1044.0
 offset_bottom = 515.0
 texture = ExtResource("1_xjdov")
 
-[node name="ColorRect" type="ColorRect" parent="."]
-layout_mode = 0
-offset_right = 217.0
-offset_bottom = 248.0
-```
-
+```

source/_posts/03-10-mod-integration.md

@@ -52,4 +52,11 @@ public static class TestInterop
 }
 ```
 
-然后在合适的时机调用即可：`TestInterop.Register("JustAnotherModId");`
+然后在合适的时机调用即可：
+
+```csharp
+if (ModManager.GetLoadedMods().Any(m => string.Equals(m.manifest?.id, "test")))
+{
+    TestInterop.Register("JustAnotherModId");
+}
+```