2026-04-11 sync

Author: REME

_config.kira.yml

@@ -43,47 +43,55 @@ docsTree:
                                 { title: 00 总览, path: /docs/03-baselib/ },
                                 {
                                     title: 01 添加卡牌,
-                                    path: /docs/03-01-add-card/,
+                                    path: /docs/03-baselib/03-01-add-card/,
                                 },
                                 {
                                     title: 02 自定义模组配置,
-                                    path: /docs/03-02-mod-config/,
+                                    path: /docs/03-baselib/03-02-mod-config/,
                                 },
                                 {
                                     title: 03 添加新遗物,
-                                    path: /docs/03-03-add-relic/,
+                                    path: /docs/03-baselib/03-03-add-relic/,
                                 },
                                 {
                                     title: 04 添加卡牌属性,
-                                    path: /docs/03-04-card-properties/,
+                                    path: /docs/03-baselib/03-04-card-properties/,
                                 },
                                 {
                                     title: 05 添加新能力,
-                                    path: /docs/03-05-add-power/,
+                                    path: /docs/03-baselib/03-05-add-power/,
                                 },
                                 {
                                     title: 06 添加新药水,
-                                    path: /docs/03-06-add-potion/,
+                                    path: /docs/03-baselib/03-06-add-potion/,
                                 },
                                 {
                                     title: 07 添加先古之民,
-                                    path: /docs/03-07-add-ancient/,
+                                    path: /docs/03-baselib/03-07-add-ancient/,
                                 },
                                 {
                                     title: 08 添加充能球,
-                                    path: /docs/03-08-add-orb/,
+                                    path: /docs/03-baselib/03-08-add-orb/,
                                 },
                                 {
                                     title: 09 局内保存,
-                                    path: /docs/03-09-run-save/,
+                                    path: /docs/03-baselib/03-09-run-save/,
                                 },
                                 {
                                     title: 10 mod联动,
-                                    path: /docs/03-10-mod-integration/,
+                                    path: /docs/03-baselib/03-10-mod-integration/,
                                 },
                                 {
                                     title: 11 添加新怪物,
-                                    path: /docs/03-11-add-monster/,
+                                    path: /docs/03-baselib/03-11-add-monster/,
+                                },
+                                {
+                                    title: 12 添加新事件,
+                                    path: /docs/03-baselib/03-12-add-event/,
+                                },
+                                {
+                                    title: 13 添加新附魔,
+                                    path: /docs/03-baselib/03-13-add-enchantment/,
                                 },
                             ],
                     },
@@ -97,6 +105,7 @@ docsTree:
                         title: 07 快速调试&热重载,
                         path: /docs/07-quick-debug-and-hot-reload/,
                     },
+                    { title: 08 启动项参数, path: /docs/08-launch-arguments/ },
                 ],
         },
         {
@@ -203,3 +212,4 @@ friends:
 
 # 可复制的代码块
 copyableCodeblock: true
+

source/_posts/01-env-setup.md

@@ -6,10 +6,18 @@ categories:
 - Basics
 ---
 
-## 环境配置
-
 以防你有网络问题下载工具：https://pan.baidu.com/s/1yuxPkDpCV8EVLkDubqiirg?pwd=apar
 
+## 编程基础
+
+阅读本教程你至少需要：
+
+* C#语言基础（或者其他语言的基础）
+* json文本基础
+* 使用Godot编辑器的简单功能
+* 图片编辑处理能力
+* 懂得使用电脑
+
 ## 其他教程和mod模板
 
 https://github.com/Alchyr/ModTemplate-StS2

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

@@ -55,16 +55,18 @@ https://github.com/GDRETools/gdsdecomp
 
 你可以查询一个命令的帮助，使用`help card`等。
 
-## DEBUG
+## 查看log
 
-尖塔根目录有许多`launch_xxx.bat`，选择一个合适的，右键记事本编辑，在其中加一个`--log`，例如`@echo off
-"%~dp0SlayTheSpire2.exe" --log --rendering-driver opengl3 %*`。
+方法任选：
 
-然后在根目录创建一个`steam_appid.txt`，里面写`2868840`，然后双击修改的bat文件运行即可以一个能输出log的命令行的方式打开游戏。或者添加`--force-steam=off`参数。
+* 按下`~`（tab上方那个键）打开控制台，输入`open logs`或者`showlog`（没有baselib的话无效）。
+
+* 尖塔根目录有许多`launch_xxx.bat`，选择一个合适的，右键记事本编辑，在其中加一个`--log`，例如`@echo off
+"%~dp0SlayTheSpire2.exe" --log --rendering-driver opengl3 %*`。然后在根目录创建一个`steam_appid.txt`，里面写`2868840`，然后双击修改的bat文件运行即可以一个能输出log的命令行的方式打开游戏。或者添加`--force-steam=off`参数。
 
 ## 本地联机测试
 
-复制出两个新的`bat`，其中一个添加`--fastmp=host`参数，作为主机，另一个添加`--fastmp=join -clientId=1001`参数，作为非主机玩家。当然你可以添加更多，记得修改`clientId`。
+复制出两个新的`bat`，其中一个添加`--fastmp=host`参数，作为主机，另一个添加`--fastmp=join --clientId=1001`参数，作为非主机玩家。当然你可以添加更多，记得修改`clientId`。
 
 如果你打完一层遇到保存问题，记得以管理员模式启动bat。
 

source/_posts/03-baselib.md

@@ -47,13 +47,4 @@ https://github.com/Alchyr/BaseLib-StS2
 
 ```json
   "dependencies": ["BaseLib"],
-```
-
-## 添加新怪物
-TODO:虽然可以加，但是最好等一个baselib
-
-## 添加新事件
-TODO:不方便添加，等一个baselib
-
-## 添加新附魔
-TODO:虽然可以加，但是最好等一个baselib
+```

source/_posts/03-01-add-card.md …urce/_posts/03-baselib/03-01-add-card.mdsource/_posts/03-01-add-card.md renamed to source/_posts/03-baselib/03-01-add-card.md source/_posts/03-01-add-card.md renamed to source/_posts/03-baselib/03-01-add-card.md

@@ -1,7 +1,7 @@
 ---
 title: 03-01 添加卡牌
 date: 2026-04-02 00:00:00
-permalink: docs/03-01-add-card/
+permalink: docs/03-baselib/03-01-add-card/
 categories:
 - Basics
 ---
@@ -104,7 +104,7 @@ public class TestCard : TestCardModel
 }
 ```
 
-![示例卡图](../../images/image10.png)
+![示例卡图](../../../images/image10.png)
 
 你也可以通过新增一个`abstract`类，避免每张卡都写一遍卡图路径，并且方便管理一些自定义功能。
 
@@ -138,7 +138,7 @@ public class TestCard : TestCardModel {}
 
 按`~`打开控制台输入`card TEST-TEST_CARD`获得这张卡。
 
-![示例卡牌](../../images/image11.png)
+![示例卡牌](../../../images/image11.png)
 
 ## 最终项目参考
 
@@ -158,3 +158,4 @@ Test (你的项目文件夹)
             └── cards.json
 ```
 
+

source/_posts/03-02-mod-config.md …ce/_posts/03-baselib/03-02-mod-config.mdsource/_posts/03-02-mod-config.md renamed to source/_posts/03-baselib/03-02-mod-config.md source/_posts/03-02-mod-config.md renamed to source/_posts/03-baselib/03-02-mod-config.md

@@ -1,7 +1,7 @@
 ---
 title: 03-02 自定义模组配置
 date: 2026-04-02 00:00:00
-permalink: docs/03-02-mod-config/
+permalink: docs/03-baselib/03-02-mod-config/
 categories:
 - Basics
 ---
@@ -64,7 +64,8 @@ public sealed class TestModConfig : SimpleModConfig
 
 ```
 
-![示例配置](../../images/image12.png)
+![示例配置](../../../images/image12.png)
 
 更多请参考`baselib`的`BaseLib.Config`下的类。
 
+

source/_posts/03-03-add-relic.md …rce/_posts/03-baselib/03-03-add-relic.mdsource/_posts/03-03-add-relic.md renamed to source/_posts/03-baselib/03-03-add-relic.md source/_posts/03-03-add-relic.md renamed to source/_posts/03-baselib/03-03-add-relic.md

@@ -1,7 +1,7 @@
 ---
 title: 03-03 添加新遗物
 date: 2026-04-02 00:00:00
-permalink: docs/03-03-add-relic/
+permalink: docs/03-baselib/03-03-add-relic/
 categories:
 - Basics
 ---
@@ -18,11 +18,11 @@ public class TestRelic : CustomRelicModel
     // 遗物的数值。替换本地化中的{Cards}。
     protected override IEnumerable<DynamicVar> CanonicalVars => [new CardsVar(1)];
 
-    // 小图标
+    // 小图标（原版85x85）
     public override string PackedIconPath => $"res://test/images/relics/{Id.Entry.ToLowerInvariant()}.png";
-    // 轮廓图标
+    // 轮廓图标（原版85x85）
     protected override string PackedIconOutlinePath => $"res://test/images/relics/{Id.Entry.ToLowerInvariant()}.png";
-    // 大图标
+    // 大图标（原版256x256）
     protected override string BigIconPath => $"res://test/images/relics/{Id.Entry.ToLowerInvariant()}.png";
 
     public override async Task AfterPlayerTurnStart(PlayerChoiceContext choiceContext, Player player)
@@ -38,7 +38,7 @@ public class TestRelic : CustomRelicModel
 
 然后放一张图片`test/images/relics/test_relic.png`。路径不一定是`test`，组织风格自定义，参考上面卡图部分。这里偷懒三张图片用了一样的，可以自己修改。
 
-![示例遗物](../../images/image13.png)
+![示例遗物](../../../images/image13.png)
 
 然后写一个本地化文件，`{modId}/localization/{Language}/relics.json`。
 
@@ -48,4 +48,4 @@ public class TestRelic : CustomRelicModel
   "TEST-TEST_RELIC.description": "每回合开始时，抽[blue]{Cards}[/blue]张牌。",
   "TEST-TEST_RELIC.flavor": "觉得很眼熟？"
 }
-```
+```

source/_posts/03-04-card-properties.md …osts/03-baselib/03-04-card-properties.mdsource/_posts/03-04-card-properties.md renamed to source/_posts/03-baselib/03-04-card-properties.md source/_posts/03-04-card-properties.md renamed to source/_posts/03-baselib/03-04-card-properties.md

@@ -1,7 +1,7 @@
 ---
 title: 03-04 添加卡牌属性
 date: 2026-04-02 00:00:00
-permalink: docs/03-04-card-properties/
+permalink: docs/03-baselib/03-04-card-properties/
 categories:
 - Basics
 ---
@@ -37,7 +37,7 @@ public class MyKeywords
     public override IEnumerable<CardKeyword> CanonicalKeywords => [MyKeywords.Unique];
 ```
 
-![alt text](../../images/image23.png)
+![alt text](../../../images/image23.png)
 
 ## 添加新动态变量
 
@@ -96,7 +96,7 @@ public class TestDynamicVar : DynamicVar
 `:diff()`表示这个值一旦和基础值不同，就会变红色或绿色（例如升级时增加数值，预览变成绿色）。
 
 
-![alt text](../../images/image26.png)
+![alt text](../../../images/image26.png)
 
 当然如果你只是个简单的数值，这样就行：
 
@@ -154,4 +154,4 @@ public class TestCard : CustomCardModel
 }
 ```
 
-如果要判断，使用`if (Card.Tags.Contains(MyCardTags.Test)) {}`即可。`Card`需要是个`CardModel`类型。
+如果要判断，使用`if (Card.Tags.Contains(MyCardTags.Test)) {}`即可。`Card`需要是个`CardModel`类型。

source/_posts/03-05-add-power.md …rce/_posts/03-baselib/03-05-add-power.mdsource/_posts/03-05-add-power.md renamed to source/_posts/03-baselib/03-05-add-power.md source/_posts/03-05-add-power.md renamed to source/_posts/03-baselib/03-05-add-power.md

@@ -1,7 +1,7 @@
 ---
 title: 03-05 添加新能力
 date: 2026-04-02 00:00:00
-permalink: docs/03-05-add-power/
+permalink: docs/03-baselib/03-05-add-power/
 categories:
 - Basics
 ---
@@ -15,7 +15,7 @@ public class TestPower : CustomPowerModel
     // 叠加类型，Counter表示可叠加，Single表示不可叠加
     public override PowerStackType StackType => PowerStackType.Counter;
 
-    // 自定义图标路径，自己指定，或者创建一个基类来统一指定图标路径
+    // 自定义图标路径。1:1即可。原版游戏大图256x256，小图64x64。
     public override string? CustomPackedIconPath => "res://test/powers/test_power.png";
     public override string? CustomBigIconPath => "res://test/powers/test_power.png";
 
@@ -38,5 +38,4 @@ public class TestPower : CustomPowerModel
 
 然后使用`PowerCmd.Apply<TestPower>(...)`给予即可。或者使用控制台`power TEST-TEST_POWER 1 0`。
 
-![alt text](../../images/image25.png)
-
+![alt text](../../../images/image25.png)

source/_posts/03-06-add-potion.md …ce/_posts/03-baselib/03-06-add-potion.mdsource/_posts/03-06-add-potion.md renamed to source/_posts/03-baselib/03-06-add-potion.md source/_posts/03-06-add-potion.md renamed to source/_posts/03-baselib/03-06-add-potion.md

@@ -1,7 +1,7 @@
 ---
 title: 03-06 添加新药水
 date: 2026-04-02 00:00:00
-permalink: docs/03-06-add-potion/
+permalink: docs/03-baselib/03-06-add-potion/
 categories:
 - Basics
 ---
@@ -58,4 +58,4 @@ public class TestPotion : CustomPotionModel
     "TEST-TEST_POTION.title": "戈多药水",
     "TEST-TEST_POTION.description": "将[blue]{Cards}[/blue]张[gold]灵魂[/gold]加入你的[gold]手牌[/gold]。"
 }
-```
+```