跳转到内容

内容包与注册器

当注册关系属于模型类型本身时,使用注解。先通过 ModTypeDiscoveryHub.RegisterModAssembly(modId, assembly) 注册程序集。

分类注解
池内容RegisterCard、RegisterRelic、RegisterPotion
独立模型RegisterCharacter、RegisterPower、RegisterOrb、RegisterAchievement、RegisterSingleton
世界内容RegisterAct、RegisterMonster、RegisterGlobalEncounter、RegisterActEncounter
事件RegisterSharedEvent、RegisterActEvent、RegisterSharedAncient、RegisterActAncient
池RegisterSharedCardPool、RegisterSharedRelicPool、RegisterSharedPotionPool
关键词与 IDRegisterOwnedKeyword、RegisterOwnedCardKeyword、RegisterOwnedCardTag
时间线RegisterStory、RegisterEpoch、RegisterStoryEpoch、AutoTimelineSlot*
解锁RequireEpoch、RequireAllCardsInPool、RegisterEpochCards、RegisterEpochRelicsFromPool、UnlockEpochAfter*
UIRegisterOwnedCardPile、RegisterOwnedTopBarButton
特殊映射RegisterArchaicToothTranscendence、RegisterTouchOfOrobasRefinement

注解也支持 Order;带池的模型注解支持 StableEntryStem / FullPublicEntry。 RegisterCharacterStarterCard、RegisterCharacterStarterRelic、RegisterCharacterStarterPotion 的 Order 既用于操作排序,也用于最终 starter 列表排序。

注解放在抽象基类上时,只有设置 Inherit = true 才会传给派生类。它适合“所有继承这个基类的卡都进同一个池”这类宽泛注册;每张卡自己的稳定 Entry 覆写应保留在具体类上。

CreateContentPack(modId) 返回链式 builder。把所有步骤加完后调用一次 Apply()。

分类Builder 方法
核心模型.Card<TPool,TCard>()、.Relic<TPool,TRelic>()、.Potion<TPool,TPotion>()、.Power<TPower>()、.Orb<TOrb>()
角色.Character<TCharacter>()、.Character<TCharacter>(entry => ...)、初始卡牌 / 遗物 / 药水辅助方法
世界内容.Act<TAct>()、.Monster<TMonster>()、.ActEncounter<TAct,TEncounter>()、.GlobalEncounter<TEncounter>()、.SharedEvent<TEvent>()、.ActEvent<TAct,TEvent>()、.SharedAncient<TAncient>()、.ActAncient<TAct,TAncient>()
元数据.Achievement<T>()、.Enchantment<T>()、.Affliction<T>()、.Badge<T>()、.Singleton<T>()、modifier 相关方法
文本和 ID.CardKeywordOwnedByLocNamespace(...)、.KeywordOwned(...)、.CardTagOwned(...)
UI 与卡堆.CardPileOwned(...)、.TopBarButtonOwned(...)
时间线.Story<T>()、.Epoch<T>()、.StoryEpoch<TStory,TEpoch>()、timeline slot 辅助方法
解锁.RequireEpoch<TModel,TEpoch>()、.UnlockEpochAfterWinAs<TCharacter,TEpoch>() 以及 run / boss / elite 计数辅助方法
批量输入.ContentManifest(...)、.KeywordManifest(...)、.PackManifest(...)、.Manifest(...)
逃生口.Custom(ctx => ...)

Builder 按添加顺序应用步骤。会引用模型的解锁规则应放在模型注册之后。

每个 builder 方法都对应一个注册器调用。共享辅助库或条件注册逻辑可以直接使用注册器。

var content = RitsuLibFramework.GetContentRegistry("MyMod");
content.RegisterCard<MyCardPool, MyStrike>();
var keywords = RitsuLibFramework.GetKeywordRegistry("MyMod");
keywords.RegisterCardKeywordOwnedByLocNamespace("bleeding");
注册器获取方式
内容RitsuLibFramework.GetContentRegistry(modId)
关键词RitsuLibFramework.GetKeywordRegistry(modId)
时间线RitsuLibFramework.GetTimelineRegistry(modId)
解锁RitsuLibFramework.GetUnlockRegistry(modId)
卡牌标签RitsuLibFramework.GetCardTagRegistry(modId)
卡堆RitsuLibFramework.GetCardPileRegistry(modId)
顶栏按钮RitsuLibFramework.GetTopBarButtonRegistry(modId)
SmartFormatRitsuLibFramework.GetSmartFormatRegistry(modId)

当内容由工具生成,或拆在多个文件里时,可以使用 manifest 数组。

IContentRegistrationEntry[] content =
[
new CardRegistrationEntry<MyCardPool, MyStrike>(),
new RelicRegistrationEntry<MyRelicPool, MyRelic>(),
];
RitsuLibFramework.CreateContentPack("MyMod")
.ContentManifest(content)
.KeywordManifest(keywordEntries)
.PackManifest(timelineAndUnlockEntries)
.Apply();

尽量使用拆开的 manifest 方法。这样 ModelDb 内容、关键词 ID、时间线 / 解锁规则更容易审查。

内容注册应在 Mod 初始化入口执行。RitsuLib 会在游戏完成模型初始化前冻结内容注册。冻结后再添加模型属于无效操作。

ContentRegistrationClosedEvent 只适合诊断,不要等这个事件发生后再注册内容。