跳转到内容

时间线与解锁

Mod 添加进度节点时,使用 ModStoryTemplate 和 ModEpochTemplate。

public sealed class MyStory : ModStoryTemplate
{
protected override string StoryKey => "my_mod_story";
}
public sealed class MyEpoch : ModEpochTemplate
{
public override string Id => "MY_MOD_FIRST_LESSON";
}

标题、描述、解锁文本和故事标题写在 epochs.json。可以用注解注册:

[RegisterStory]
public sealed class MyStory : ModStoryTemplate
{
protected override string StoryKey => "my_mod_story";
}
[RegisterEpoch]
[RegisterStoryEpoch(typeof(MyStory))]
[AutoTimelineSlotAfterColumn(EpochEra.Act1)]
public sealed class MyEpoch : ModEpochTemplate
{
public override string Id => "MY_MOD_FIRST_LESSON";
}

也可以用 content pack 注册:

RitsuLibFramework.CreateContentPack("MyMod")
.Story<MyStory>()
.Epoch<MyEpoch>()
.StoryEpoch<MyStory, MyEpoch>()
.ModEpochAutoTimelineSlotAfterColumn<MyEpoch>(EpochEra.Act1)
.Apply();

获得某个 epoch 前需要隐藏的内容,使用 .RequireEpoch<TModel, TEpoch>()。

RitsuLibFramework.CreateContentPack("MyMod")
.Card<MyCardPool, MyRareCard>()
.Epoch<MyEpoch>()
.RequireEpoch<MyRareCard, MyEpoch>()
.Apply();

如果 epoch 模板自己列出了卡牌或遗物,使用 .BindCardUnlockEpoch<TEpoch>() 或 .BindRelicUnlockEpoch<TEpoch>()。

按玩家行为选择规则:

规则触发条件
.UnlockEpochAfterRunAs<TCharacter, TEpoch>()使用该角色完成一局。
.UnlockEpochAfterWinAs<TCharacter, TEpoch>()使用该角色获胜。
.UnlockEpochAfterAscensionWin<TCharacter, TEpoch>(level)达到指定进阶要求并获胜。
.UnlockEpochAfterRunCount<TEpoch>(count, requireVictory)账号级 run 次数。
.UnlockEpochAfterEliteVictories<TCharacter, TEpoch>(count)精英胜利计数。
.UnlockEpochAfterBossVictories<TCharacter, TEpoch>(count)Boss 胜利计数。
.UnlockEpochAfterAscensionOneWin<TCharacter, TEpoch>()第一进阶路径。
.RevealAscensionAfterEpoch<TCharacter, TEpoch>()获得 epoch 后显示进阶 UI。

解锁规则尽量和被它锁定的内容放在附近,发布前更容易审查。

如果角色应由另一个角色的 run 路径解锁,使用:

RitsuLibFramework.CreateContentPack("MyMod")
.Character<MyCharacter>()
.Epoch<MyCharacterEpoch>()
.UnlockCharacterAfterRunAs<MyPreviousCharacter, MyCharacterEpoch>()
.Apply();

角色自身的 RequiresEpochAndTimeline 应与你注册的规则保持一致。