Viking Chronicle

Die gemeinsame Chronik fuer eure Valheim-Welt.

Vier Tabs mit sortierbaren Statistikspalten, im Stil von Valheims Holzfenstern und goldenen Schriften. Dazu ein dezenter Live-Feed fuer die Aktionen eurer Gruppe.

Version 0.1.0 ist eine erste Testversion, kompiliert gegen Valheim 1.0.12, Jotunn 2.30.0 und den Valheim-BepInEx-Pack. Die Multiplayer- und Darstellungstests im Spiel stehen noch aus. Die Mod ist fuer vertrauensvolle Freundesgruppen ausgelegt.

Installation

Auf dem Dedicated Server UND bei allen Spielern installieren. Die Versionsnummer muss uebereinstimmen; Jotunn prueft dies beim Verbinden.

1. In Gale das gewuenschte Valheim-Profil waehlen und Viking Chronicle samt Abhaengigkeiten installieren.
2. Auf dem Server BepInEx, Jotunn und dieselbe Viking-Chronicle-Version installieren. Bei manueller Installation den Ordner BepInEx aus dem ZIP mit dem Serverordner zusammenfuehren.
3. Server neu starten und das Spiel ueber Gale starten.

Das Paket enthaelt VikingChronicle.dll und VikingChronicle.Core.dll. Beide gehoeren gemeinsam in BepInEx/plugins/VikingChronicle/. Die Abhaengigkeiten werden nicht in diesem Paket mitgeliefert.

Bedienung

Spielernamen und Spaltenueberschriften bleiben beim Scrollen sichtbar. Der eigene Charakter ist hervorgehoben. Die Rangliste zeigt den Gesamtstand seit Installation, auch fuer offline gegangene Charaktere. Es gibt keine Dropdown-Auswahl.

Statistiken

Die Statistik wird pro Welt und Charakter-ID gespeichert. Umbenennen erzeugt keinen neuen Eintrag; ein neuer Charakter hat einen eigenen Eintrag. Bereits vor der Installation gespielte Aktionen werden nicht nachtraeglich rekonstruiert. Es gibt keine Gesamtpunktzahl oder Belohnungen.

Live-Feed und Einstellungen

Standardmaessig erscheinen Kills, Ressourcen und Tode. Ressourcen werden fuer denselben Spieler und dasselbe Material ueber drei Sekunden gebuendelt. Bau- und Craftingmeldungen lassen sich zusaetzlich einschalten. Der Feed zeigt vier Zeilen, blendet sie nach sieben Sekunden aus und blockiert keine Spieleingaben. Bei offener Rangliste ist er ausgeblendet.

Die Datei BepInEx/config/rinor.vikingchronicle.cfg entsteht beim ersten Start. Dort lassen sich Tasten, Sprache (de oder en), Skalierung, Feed-Kategorien, Zeilenanzahl, Anzeigedauer und Abstand zum rechten/oberen Bildschirmrand einstellen. Nach manuellen Aenderungen Spiel bzw. Server neu starten. Kreatur- und Gegenstandsnamen folgen der Sprache des Spiels.

Speicherung

Der Server speichert unter BepInEx/config/VikingChronicle/<Welt-ID>.json. Ereignisse von Clients werden vor ihrer Bestaetigung gespeichert; direkt auf dem Server erfasste Ereignisse zusaetzlich standardmaessig alle 30 Sekunden und beim regulaeren Beenden. Die vorherige gueltige Version wird als .bak aufbewahrt. Bei einer beschaedigten Hauptdatei wird eine gueltige Sicherung geladen; eine unbekannte neuere Dateiversion wird nicht ueberschrieben. Ordner bei Serverumzuegen mitnehmen.

Clients sichern noch nicht bestaetigte Ereignisse unter BepInEx/config/VikingChronicleClient/. Beim Wiederverbinden mit derselben Welt werden sie nachgereicht. Dauerhafte Sequenzstaende verhindern, dass bereits bestaetigte Uebertragungen erneut zaehlen. Dies ersetzt keine Sicherung des Serverordners. Nur die letzten noch nicht erfassten bzw. lokal gespeicherten Sekunden koennen bei einem abrupten Client-Abbruch fehlen.

Zaehlen und bekannte Grenzen

• Ressourcen sind erzeugter Ertrag, dem Spieler zugerechnet, der die Ernte ausloest. Wer das Material danach aufsammelt, aendert den Zaehler nicht. Kistenbewegungen, fallen gelassene Gegenstaende und wiederholtes Aufheben zaehlen nicht.
• Faellt ein Baum durch einen anderen Baum oder stuerzt Erz ohne zuordenbaren Spielerangriff nachtraeglich ein, kann dieser Ertrag fehlen. Eigenstaendige Erntesysteme anderer Mods sind nicht automatisch abgedeckt.
• Der toedliche Spielerschaden bestimmt den Kill. Feuer/Gift ohne direkte Angreiferinformation werden begrenzt dem letzten nachweisbaren Spielerangreifer zugerechnet. Bei mehreren DoT-Angreifern ist das eine Naeherung; reine DoT-Angriffe koennen fehlen.
• Bauteile werden als Aktivitaet gezaehlt: Abbauen und erneut aufbauen zaehlt erneut. Es gibt dafuer keine Belohnungen. Gelaendeveraenderungen zaehlen nicht als Bauteile.
• Spielzeit umfasst auch AFK-Zeit mit geladenem Charakter. Teleports und Debug-Flug werden aus der Strecke ausgefiltert; Bootsmitfahrer zaehlen als Segelstrecke.
• Assist-/Schadensstatistiken, Sterne-Unterteilung, Fischfang, Kochstationen, Gaerfaesser, Erkundungsfortschritt und Wochen-/Sitzungsfilter sind in dieser Version noch nicht enthalten.
• Serverdaten werden zentral gespeichert, Ereignisse jedoch teils von Clients gemeldet. Dies ist kein manipulationssicheres Wettbewerbssystem.
• Bei einem Prozessabsturz koennen das letzte Speicherintervall des Servers und noch nicht erfasste Sekunden/Strecken verloren gehen.

Kurzer Test mit zwei Spielern

1. Beide verbinden, F7 druecken und pruefen, ob beide nach etwa zehn Sekunden erscheinen.
2. Spieler A toetet einen Boar: bei beiden muss genau ein Kill fuer A erscheinen.
3. Spieler B erntet Holz: Ertrag bei B und eine gebuendelte Feed-Meldung pruefen. Holz in eine Kiste legen und wieder herausnehmen: keine Erhoehung.
4. Ein Bauteil setzen, ein beschaedigtes Bauteil mit dem Hammer reparieren, einen Gegenstand herstellen und einmal sterben; jeweilige Spalten pruefen.
5. Server regulaer neu starten und erneut verbinden: Gesamtwerte muessen erhalten bleiben.
6. Fenster mit Escape schliessen: Kamera und Steuerung muessen wieder normal reagieren. F8 pruefen.

Bei Fehlern die Zeilen mit Viking Chronicle, VikingChronicle oder rinor.vikingchronicle aus BepInEx/LogOutput.log auf Client und Server sichern.

English

Native Valheim world leaderboards and a minimal activity feed for friends. Install on the dedicated server and all clients, using matching versions. F7 opens the board, F8 toggles the feed, /chronicle opens it from chat. Click column headers to sort. Four tabs show hunting, fresh resource yields, building/crafting and survival/travel. Statistics belong to each world and character, persist on the server, and start when the mod is installed. Set Interface.Language = en in the generated configuration for English labels.

Fresh yield is credited to its harvester, not to whoever picks it up; chest transfers and dropped-item pickup do not count. Fire/poison attribution is approximate. Unattributed environmental harvests, custom mod harvest mechanisms, fishing, cooking/fermenting, assists, damage, exploration, star breakdowns and weekly/session filters are not tracked in this initial release. AFK time counts. This is a trusted-friends mod, not an anti-cheat system. Initial release compiled against Valheim 1.0.12; live multiplayer/visual validation is still pending.

Changelog

0.1.0

• Initial test release, compiled against Valheim 1.0.12 and Jotunn 2.30.0.
• Native Valheim wood panel and fonts, four category tabs, sortable statistic columns, frozen player names and two-axis scrolling.
• Creature kills by prefab, fresh harvest yields, trees felled, building, repairs, planting, crafting/upgrades, deaths, playtime and travel.
• Dedicated-server synchronization, per-world persistence, atomic saves and backup recovery.
• Persistent client event queue, durable server acknowledgements and replay protection across reconnects.
• Minimal configurable live feed with grouped resource events and German/English interface.
• Requires the same mod version on the server and every client.

Automated core, persistence and game-API compatibility checks accompany the source. Multiplayer gameplay and visual behavior still need an in-game test.