Configuration

Timeline verfügt sowohl über eine serverautorisierende als auch eine reine Clientkonfiguration.

TLDR

Die Serverkonfiguration steuert Kalender, benutzerdefinierte Ziele, rückwirkenden Import und Überschreibungen von Zeitleistenentitäten.
Die Client-Konfiguration steuert nur die Day-Toast-Schriftart.
Die meisten Servereinstellungen sind im laufenden Betrieb lesbar, wobei Kalendereinstellungen bei Änderungen aktiv übertragen werden.

Serverkonfiguration (`rpgtimeline-server.toml`)

Hauptabschnitte:

calendar
chronicle

Kalendertasten

monthNames
monthAbbreviations
yearSuffix
daysPerMonth
useCustomFont
useSereneSeasons
seasonMonths

Chronikschlüssel

retroactiveAdvancementImportEnabled
retroactiveAdvancementImportIncludeRecipes
retroactiveAdvancementImportMapByRealDays
customGoals
eventTimeframes

Client-Konfiguration

Clientseitiger Schlüssel:

calendar.dayToastFont: VANILLA, GOTHIC12 oder GOTHIC24

Beispiel (konzeptionell)

{
  "calendar": {
    "monthNames": ["Dawnroot", "Blossomwake", "Greengale", "Suncrest"],
    "yearSuffix": "A.N.",
    "daysPerMonth": 28,
    "useSereneSeasons": true
  },
  "chronicle": {
    "retroactiveAdvancementImportEnabled": true,
    "customGoals": "break_block|minecraft:stone|1&100&1000",
    "eventTimeframes": "priority=100;days=4;layer=entity;render=entity;type=advancement;id=minecraft:end/kill_dragon;entity=minecraft:ender_dragon"
  }
}

Hot-Reload-Notizen

Kalendereinstellungen werden serverseitig gehasht und bei Änderung an Clients weitergeleitet.
Benutzerdefinierte Ziele und Ereigniszeitrahmenregeln werden aus dem aktuellen Konfigurationstext geparst und aktualisiert, wenn sich ihr Quelltext-Hash ändert.
Neues Verhalten wird beim nächsten relevanten Synchronisierungs-/Renderzyklus angewendet.

DEEP DIVE: Was nicht sofort ist

Der rückwirkende Erweiterungsimport wird beim Serverstart ausgeführt. Durch eine spätere Änderung der rückwirkenden Importflags wird die Importlogik des vorherigen Starts bis zum nächsten Serverstart nicht erneut abgespielt.

Geltungsbereich der Zeitrahmenregel

Der Parser der aktuellen Zeitrahmenregel unterstützt Entity-Render-Überschreibungen (render=entity) für konfigurierte Übereinstimmungen. Ungültige Regelzeilen werden sicher übersprungen.