Custom Events
Event Models
Section titled “Event Models”Use ModEventTemplate for normal events and ModAncientEventTemplate for ancient events.
public sealed class MyEvent : ModEventTemplate{ public override EventAssetProfile AssetProfile => new() { LayoutScenePath = "res://MyMod/scenes/events/quiet_door.tscn", BackgroundScenePath = "res://MyMod/scenes/events/quiet_door_bg.tscn", };}Register the event globally or under a specific act. Attribute style:
[RegisterActEvent(typeof(MyAct))]public sealed class MyEvent : ModEventTemplate{}
[RegisterSharedAncient]public sealed class MyAncient : ModAncientEventTemplate{}Content pack style:
RitsuLibFramework.CreateContentPack("MyMod") .ActEvent<MyAct, MyEvent>() .SharedEvent<MySharedEvent>() .ActAncient<MyAct, MyAncient>() .Apply();Option Keys
Section titled “Option Keys”Templates provide namespaced option keys:
protected override IReadOnlyList<EventOption> GenerateInitialOptions(){ return [ new EventOption(this, OpenDoor, InitialOptionKey("OPEN")) ];}For custom pages, call ModOptionKey(pageName, optionName). Keep page and option names stable after release, because they are part of the localization contract.
Relic Options
Section titled “Relic Options”Use the template helper for options that grant a relic:
yield return CreateModRelicOption<MyRelic>( onChosen: async () => await GoToPage("REWARD_TAKEN"));For ancient events, CreateModRelicOption<T>() also completes the ancient flow by default.
Add Options To Existing Ancients
Section titled “Add Options To Existing Ancients”Use AncientOption<TAncient>(rule) when you want to append options to an existing ancient without replacing the event class.
RitsuLibFramework.CreateContentPack("MyMod") .AncientOption<TheArchitect>(ModAncientOptionRule.Single(ancient => new EventOption("MY_MOD_ARCHITECT_OPTION", async () => await DoSomething()))) .Apply();Use Condition, Priority, and SkipDuplicateTextKeys on ModAncientOptionRule when multiple mods can add similar options.
Ancient Dialogue
Section titled “Ancient Dialogue”ModAncientEventTemplate loads dialogue from the ancients localization table by default. Override DefineDialogues() only when the dialogue structure cannot be expressed with localization data.
For normal mod ancient dialogue, write keys like:
{ "MY_MOD_ANCIENT_MIRROR.talk.MY_MOD_CHARACTER_SEER.0-0.ancient": "You brought a future with you.", "MY_MOD_ANCIENT_MIRROR.talk.MY_MOD_CHARACTER_SEER.0-1.char": "Then I should spend it carefully."}For The Architect, add character-specific keys under THE_ARCHITECT.talk.<CHARACTER_ENTRY>.*.
See Localization and keywords for the full key shape.