2026-04-25 sync

Author: GlitchedReme

_config.kira.yml

@@ -77,6 +77,10 @@ docsTree:
                                     title: 08 添加充能球,
                                     path: /docs/04-ritsulib/04-08-add-orb/,
                                 },
+                                {
+                                    title: 09 添加时间线,
+                                    path: /docs/04-ritsulib/04-09-add-timeline/,
+                                },
                                 {
                                     title: 11 添加新怪物,
                                     path: /docs/04-ritsulib/04-11-add-monster/,

source/_posts/01-env-setup.md

@@ -42,6 +42,12 @@ https://github.com/freude916/sts2-quickRestart/blob/main/README.md
 
 选择一个文本编辑器。可以使用[Visual Studio Code](https://code.visualstudio.com/)或者[Rider](https://www.jetbrains.com/zh-cn/rider/download/?section=windows)（<b>强烈推荐</b>新手使用Rider）。另外也可以使用Visual Studio等其他 IDE。以下只介绍 VS Code 的配置方法。
 
+<b>强烈推荐</b>新手使用Rider
+
+<b>强烈推荐</b>新手使用Rider
+
+<b>强烈推荐</b>新手使用Rider
+
 ## 安装VS Code插件（可选）
 
 安装[C# Dev Kit](https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.csdevkit)。你还可以安装[Godot Tools](https://marketplace.visualstudio.com/items?itemName=geequlim.godot-tools)等插件。

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

@@ -84,6 +84,8 @@ public class MyKeywords
 
 和塔1不同，关键词提示是通过描述染色（`[gold]易伤[/gold]`）然后添加卡牌提示文本实现的。
 
+例如，你给卡牌加上`消耗`就会自动给你加它的提示文本。但是如果你的卡牌没有`消耗`但是描述中是`“消耗一张牌”`，就通过这种方式添加提示文本。
+
 仅需在卡牌类中重载`ExtraHoverTips`即可：
 
 ```csharp

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

@@ -27,7 +27,7 @@ categories:
 | 血条覆盖层(中毒灾厄) | ✅ | ✅ | - |
 | 不挂载脚本场景转换 | ✅ | ✅ | - |
 | 人物非spine动画兼容 | ✅ | ✅ | - |
-| customenum | ✅ | ❌ | baselib支持对任意enum扩展；ritsulib不支持，但统一管理（例如关键词） |
+| customenum | ✅ | ❌ | baselib支持对任意enum扩展；<br>ritsulib不支持，但统一管理（例如关键词） |
 | 一代本地化符号 | ✅ | ❌ | * |
 | FMOD音频 | 🚧 | ✅ | - |
 | 缺少资源时占位警告 | ❌ | ✅ | - |
@@ -39,7 +39,7 @@ categories:
 | 卡牌支持AnyPlayer | ❌ | ✅ | - |
 | 快捷键绑定 | ❌ | ✅ | - |
 | 新牌堆 | ❌ | ✅ | - |
-| 内容物ID | 命名空间第一段大写，例如`TEST-TEST_CARD` | modid与分类，例如`TEST_CARD_TEST_CARD` | - |
+| 内容物ID | 命名空间第一段大写，<br>例如`TEST-TEST_CARD` | modid与分类，<br>例如`TEST_CARD_TEST_CARD` | - |
 | patch | 原始`harmony` | 原始`harmony`以及封装patch系统 | - |
 | 非原生玩法内容 | 有 | 无 | 避免重复造轮子。但是会带来臃肿不兼容、抢占patch、抢占你的命名的问题。 |
 

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

@@ -120,7 +120,9 @@ public class TestCharacter : PlaceholderCharacterModel
     public override Color NameColor => new(0.5f, 0.5f, 1f);
     // 能量图标轮廓颜色
     public override Color EnergyLabelOutlineColor => new(0.1f, 0.1f, 1f);
-
+    // 地图绘制颜色
+    public override Color MapDrawingColor => new(0.5f, 0.5f, 1f);
+    
     // 人物性别（男女中立）
     public override CharacterGender Gender => CharacterGender.Masculine;
 
@@ -231,6 +233,8 @@ TestCharacter (Node2D)
 
 ![alt text](../../images/image18.png)
 
+* 附赠资源提供了一个单图尽可能覆盖全屏的场景，只要把图片换成你的人物背景图即可。
+
 ### 人物动画
 
 * 其中`Visuals`可以更改成任意继承了`Node2D`的类型，例如`SpineSprite`，`Sprite2D`，`AnimatedSprite2D`或是`AnimationPlayer`，或者在它之下新建节点都可。
@@ -248,6 +252,7 @@ TestCharacter (Node2D)
 `public override string CustomEnergyCounterPath => "res://test/scenes/test_energy_counter.tscn";`
 
 * 建议从原版或者下面的附赠资源处复制一份tscn快速开始。
+
 创建一个`Control`类型的新场景，设定以下结构：
 
 ```
@@ -279,9 +284,7 @@ TestCharacterMerchant (Node2D)
 
 * 如果你使用Spine模型，第一个子节点放置`SpineSprite`，且动画名是`relaxed_loop`。
 
-* 如果你使用其他动画，创建一个继承了`NMerchantCharacter`的节点，并在`_ready`函数里播放你自己的动画。
-
-* 静态图就不需要了。
+* 如果你使用其他动画，创建一个继承了`NMerchantCharacter`的节点，并在`_Ready`函数里播放你自己的动画。静态图就不需要了。
 
 ```csharp
 using MegaCrit.Sts2.Core.Nodes.Screens.Shops;
@@ -294,6 +297,35 @@ public partial class TestCharacterMerchant : NMerchantCharacter
 }
 ```
 
+## 自定义火堆模型
+
+修改`AssetProfile`里的：
+
+```csharp
+Scenes: new(
+    RestSiteAnimPath: "res://RitsuTest/scenes/test_character_rest_site.tscn"
+)
+```
+* 建议从原版或者下面的附赠资源处复制一份tscn快速开始。
+
+创建一个`Node2D`类型的新场景，设定以下结构：
+
+```
+TestCharacterRestSite (Node2D)
+├── Node (任意)
+└── ControlRoot (Control) %
+    ├── SelectionReticle (Control) %
+    ├── Hitbox (Control) %
+    ├── ThoughtBubbleRight (Control) %
+    └── ThoughtBubbleLeft (Control) %
+```
+
+* 自行更换`Node`的类型制作动画，也可以添加更多节点。人物朝向右边。
+
+* 如果你使用spine模型，代码会找到所有是SpineSprite类型的节点，根据当前幕数播放`overgrowth_loop`、`hive_loop`或者`glory_loop`动画。这些动画的区别只是光照颜色不同。
+
+* 如果你使用其他动画，只要把Node换成你的类型就行了。可以创建一个自定义脚本（继承`NRestSiteCharacter`）然后自行播放动画。
+
 ## 本地化文件
 
 创建`{modId}/localization/{Language}/characters.json`，填写以下内容：
@@ -454,11 +486,12 @@ public partial class TestCharacterMerchant : NMerchantCharacter
     <img src="../../images/energy_test_big.png" alt="energy_test_big" style="width:74px; height:74px; object-fit:contain; max-width:none; flex:0 0 auto;" />
 </div>
 
-`test_bg.tscn`:
+### test_bg.tscn
+
 ```tscn
 [gd_scene load_steps=2 format=3 uid="uid://cejqjeipgqe0n"]
 
-[ext_resource type="Texture2D" uid="uid://ddxmxgyyfy8mn" path="res://icon.svg" id="1_c8lhi"]
+[ext_resource type="Texture2D" uid="uid://hn2nofekpwrp" path="res://icon.svg" id="1_c8lhi"]
 
 [node name="TestBg" type="Control"]
 layout_mode = 3
@@ -467,36 +500,51 @@ anchor_left = 0.5
 anchor_top = 0.5
 anchor_right = 0.5
 anchor_bottom = 0.5
-offset_left = -1790.0
-offset_top = -1043.0
-offset_right = 1790.0
-offset_bottom = 1043.0
+offset_left = -960.0
+offset_top = -540.0
+offset_right = 1600.0
+offset_bottom = 660.0
 grow_horizontal = 2
 grow_vertical = 2
-metadata/_edit_lock_ = true
+pivot_offset = Vector2(1280, 600)
 
-[node name="ColorRect" type="ColorRect" parent="."]
+[node name="Control" type="Control" parent="."]
+layout_mode = 1
+anchors_preset = 8
+anchor_left = 0.5
+anchor_top = 0.5
+anchor_right = 0.5
+anchor_bottom = 0.5
+offset_left = -1280.0
+offset_top = -600.0
+offset_right = 640.0
+offset_bottom = 478.0
+grow_horizontal = 2
+grow_vertical = 2
+
+[node name="ColorRect" type="ColorRect" parent="Control"]
 layout_mode = 1
 anchors_preset = 15
 anchor_right = 1.0
 anchor_bottom = 1.0
 grow_horizontal = 2
 grow_vertical = 2
 color = Color(0.44705883, 0.49803922, 1, 1)
-metadata/_edit_lock_ = true
 
-[node name="Icon" type="TextureRect" parent="."]
+[node name="Icon" type="TextureRect" parent="Control"]
 layout_mode = 1
-anchors_preset = -1
+anchors_preset = 15
 anchor_right = 1.0
 anchor_bottom = 1.0
-offset_left = 1774.0
-offset_top = 792.0
-offset_right = -1259.0
-offset_bottom = -747.0
+offset_left = -28.0
+offset_top = 67.0
+offset_right = 612.0
+offset_bottom = 189.0
 grow_horizontal = 2
 grow_vertical = 2
+scale = Vector2(0.82, 0.82)
 texture = ExtResource("1_c8lhi")
+expand_mode = 1
 
 [node name="ash1" type="CPUParticles2D" parent="."]
 position = Vector2(1832, -17)
@@ -530,7 +578,8 @@ scale_amount_max = 10.0
 color = Color(0.121879734, 0.15283081, 0.33476263, 1)
 ```
 
-`test_character.tscn`:
+### test_character.tscn
+
 ```tscn
 [gd_scene load_steps=2 format=3 uid="uid://c4dnpxxd6ldei"]
 
@@ -560,7 +609,7 @@ unique_name_in_owner = true
 position = Vector2(0, -72)
 ```
 
-`test_energy_counter.tscn`:
+### test_energy_counter.tscn
 
 ```tscn
 [gd_scene load_steps=2 format=3 uid="uid://cs3a5onikvhi4"]
@@ -630,3 +679,67 @@ text = "3/3"
 horizontal_alignment = 1
 vertical_alignment = 1
 ```
+### test_character_merchant.tscn
+```tscn
+[gd_scene load_steps=2 format=3 uid="uid://pdy0teckf4i"]
+
+[ext_resource type="Texture2D" uid="uid://hn2nofekpwrp" path="res://icon.svg" id="1_diepv"]
+
+[node name="IroncladMerchant" type="Node2D"]
+
+[node name="Icon" type="Sprite2D" parent="."]
+texture = ExtResource("1_diepv")
+```
+
+### test_character_rest_site.tscn
+```tscn
+[gd_scene load_steps=2 format=3 uid="uid://bkft7e41sjfud"]
+
+[ext_resource type="Texture2D" uid="uid://hn2nofekpwrp" path="res://icon.svg" id="1_74iws"]
+
+[node name="TestCharacterRestSite" type="Node2D"]
+
+[node name="Sprite" type="Sprite2D" parent="."]
+texture = ExtResource("1_74iws")
+
+[node name="Sprite2" type="Sprite2D" parent="."]
+position = Vector2(75, -58)
+texture = ExtResource("1_74iws")
+
+[node name="ControlRoot" type="Control" parent="."]
+layout_mode = 3
+anchors_preset = 0
+
+[node name="SelectionReticle" type="Control" parent="ControlRoot"]
+unique_name_in_owner = true
+anchors_preset = 0
+offset_left = -153.0
+offset_top = -350.0
+offset_right = 267.0
+offset_bottom = 320.0
+
+[node name="Hitbox" type="Control" parent="ControlRoot"]
+unique_name_in_owner = true
+anchors_preset = 0
+offset_left = -155.0
+offset_top = -165.0
+offset_right = 154.0
+offset_bottom = 166.0
+
+[node name="ThoughtBubbleRight" type="Control" parent="ControlRoot"]
+unique_name_in_owner = true
+anchors_preset = 0
+offset_left = 121.0
+offset_top = -125.0
+offset_right = 121.0
+offset_bottom = -125.0
+
+[node name="ThoughtBubbleLeft" type="Control" parent="ControlRoot"]
+unique_name_in_owner = true
+anchors_preset = 0
+offset_left = -113.0
+offset_top = -95.0
+offset_right = -113.0
+offset_bottom = -95.0
+
+```

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

@@ -34,7 +34,7 @@ namespace Test.Scripts;
 
 // 注册卡牌
 [RegisterCard(typeof(TestCardPool))]
-// 注册成人物起始卡。不需要删除即可。
+// 注册成人物起始卡，后面是数量。不需要删除即可。
 [RegisterCharacterStarterCard(typeof(TestCharacter), 5)]
 public class TestCard : ModCardTemplate
 {
@@ -122,6 +122,8 @@ using STS2RitsuLib.Scaffolding.Content;
 
 namespace Test.Scripts;
 
+// 设置Inherit为true允许自动注册该类的所有子类
+[RegisterCard(typeof(TestCardPool), Inherit = true)]
 public abstract class TestCardModel : ModCardTemplate
 {
     public override CardAssetProfile AssetProfile => new(

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

@@ -90,6 +90,8 @@ public class MyKeywords
 
 和塔1不同，关键词提示是通过描述染色（`[gold]易伤[/gold]`）然后添加卡牌提示文本实现的。
 
+例如，你给卡牌加上`消耗`就会自动给你加它的提示文本。但是如果你的卡牌没有`消耗`但是描述中是`“消耗一张牌”`，就通过这种方式添加提示文本。
+
 仅需在卡牌类中重载`AdditionalHoverTips`即可：
 
 ```csharp