Server Loading Screen

Use your own background and transparent logo for Valheim server loading screens. Configure the images on the dedicated server; clients download them through the existing game connection and reuse verified cached files on later joins. No image host or extra network port is needed.

Development release: this version has automated tests, but its native Steam transfer performance and complete in-game behaviour still need broader validation. Steam networking is the target; Crossplay/PlayFab has not been validated.

Installation

Install ServerLoadingScreen by SchmittIT and its BepInEx dependency in both the dedicated-server and client profiles. Use matching versions. Launch clients with Start modded in r2modman. Keep your existing dedicated-server launch procedure.

Players without this mod may still join, but see the normal loading screen. Requirements imposed by other mods are independent.

Server setup

Start the server once to generate BepInEx/config/local.serverloadingscreen.cfg. Place your own images in the server profile's BepInEx/config/ServerLoadingScreen/ directory:

• background.png, or background.jpg / background.jpeg
• logo.png for an optional transparent logo

In the server configuration:

The public ServerId is generated automatically. Clients do not need to enter an ID or configure images.

Behaviour and limits

The mod replaces the background, native logo, tips and loading symbol during the initial server join. Until verified images are available, the replacement is black. The initial player spawn waits for the minimum display time; there is no separate fade sequence. Main menu, startup intro and later respawns are outside the intended scope.

Only missing or changed images are downloaded. Cached content is matched by SHA-256 after the current server confirms its manifest, so server restarts do not invalidate identical images. The cache is in BepInEx/cache/ServerLoadingScreen-v1/ within the profile. Existing older cache entries are reused after validation.

Backgrounds support PNG/JPG/JPEG up to 8 MiB, 4096 pixels per edge and 8,388,608 pixels total. Logos support static PNG up to 2 MiB and 2048×2048 pixels. Cache storage is bounded to 128 MiB and 64 files when writing. Smaller images reduce first-download time.

Missing server support, invalid images and transfer/display errors fall back to the normal loading flow. Updates do not include or overwrite your configuration. No world files, player files, credentials, game assemblies or server images are included in this package.

Deutsch

Dieselbe Mod auf Server und Clients installieren. Bilder und Einstellungen werden ausschließlich am Server gepflegt; Clients übernehmen sie automatisch. Die Mindestanzeigezeit steht unter [Layout] MinimumDisplaySeconds (Standard 5 Sekunden). Vorhandene Bilder werden nach Prüfsummenabgleich wiederverwendet, auch nach Serverneustarts. Die CFG entsteht beim ersten Start und wird nicht mit Updates überschrieben.

Dies ist eine Entwicklungsversion mit automatisierten Prüfungen. Die tatsächliche Übertragungsgeschwindigkeit und Darstellung müssen für die jeweilige Spiel-/Modkombination geprüft werden. Eigene Bilder verwenden, die du an Mitspieler weitergeben darfst.

Changelog

1.0.8 — 2026-09-29

• Language-independent animated smith's hammer with sparks or campfire with flickering flames and embers, drawn locally without downloaded assets.
• Server CFG [Layout] LoadingAnimation = Hammer, Campfire or Off. Default Hammer. Clients follow the server; the old client toggle is no longer used. No animation before receiving the server manifest.
• Protocol v4 carries and validates the server selection. Install 1.0.8 on both server and clients; older versions fall back to normal loading rather than sharing mismatched manifests. Verified image cache stays reusable.

1.0.7 — 2026-09-29

• Configurable total image bandwidth: new default 4096 KiB/s, maximum 8192; larger bounded bursts (256 KiB) and socket queue (512 KiB). Existing CFG values remain unchanged. Set TransferRateKiB to 4096 on upgraded servers to use the higher budget. 0 leaves Steam unchanged and uses a 1024 KiB/s mod budget.
• Show the verified background immediately while the logo continues downloading. Minimum full-display time still starts after both images are ready.
• Client CFG: [Client] ShowLoadingAnimation = true. Animated dots and per-image download percentage; false hides the indicator. World loading has no invented percentage. Animation requires Unity to render frames.
• Protocol v3 and verified content cache retained. No bundled CFG, private images or logs. Automated checks do not establish native Steam speed or in-game visual correctness.

1.0.6 — 2026-09-27

• Inhaltsadressierter Cache: identische Bilder unabhängig von Serverneustarts, Steam-Kennung und Welt wiederverwenden, ausschließlich nach aktuellem Manifest-/Hashabgleich.
• Vorhandene ältere Cachedateien anhand ihres geprüften Inhalts übernehmen, ohne erneuten Download.
• Neues Serverfeld TransferRateKiB = 1024: temporär höhere Steam-Sendeobergrenze nur auf der angefragten Verbindung. 0 deaktiviert diese Anpassung. Vorherige Einstellung nach Abschluss/Abbruch wiederherstellen; keine globale Netzwerkänderung.
• Bestehende Begrenzung der Mod-Bandbreite und Socket-Warteschlange beibehalten. Tatsächliche Beschleunigung hängt vom Spiel-/Netzwerkbetrieb ab und ist noch live zu messen.

1.0.5 — 2026-09-27

• Gesamten nativen Server-Ladebildschirm verdecken: Hintergrund, Valheim-Logo, Tipps und Ladeanzeige erscheinen während des eigenen Ablaufs nicht mehr dahinter.
• Keine Bildsequenz mehr: Server-CFG MinimumDisplaySeconds (Standard 5, Bereich 5–60) setzt die Mindestanzeigezeit. Danach bleibt das Bild bis zum Ladeende sichtbar.
• Vollflächige Darstellung unabhängig vom Rechteck des ursprünglichen Ladebildes. Keine nativen UI-Objekte deaktiviert; bei Fehlern wird die Standardanzeige wieder freigegeben.
• Abdeckung beim Ende des ersten Ladens entfernen; spätere Ladebildschirme nicht überschreiben. Protokoll v3 überträgt die Anzeigezeit; Cache bleibt unverändert. Server und Clients auf 1.0.5 aktualisieren.

1.0.4 — 2026-09-27

• Streaming statt einer Anfrage/Wartepause pro Block; global auf 1 MiB/s und kurze Sendebursts begrenzt, mit Socket-Rückstaukontrolle.
• Jedes vollständige Bild einzeln prüfen und speichern. Unveränderte Bilder nach Serverbestätigung aus dem vorhandenen Profilcache laden.
• Initialen Client-Spawn bis zur vollständigen Anzeige zurückhalten: 2 Sekunden Einblenden, 2 Sekunden Anzeige, 1 Sekunde Ausblenden. Keine Sperre für spätere Respawns, Einzelspieler oder Dedicated Server.
• Fehler, fehlende Servermod und Zeitüberschreitung geben den normalen Ablauf frei. Bildbestätigung und Netzwerk bleiben aktiv.
• Protokoll v2: Server und Clients gemeinsam aktualisieren; Abschlussnachricht gibt Transferressourcen frei.
• ZIP ohne Benutzer-CFG; echte DLL-Zeitstempel statt identischer Zeitstempel über alle Releases.
• Tests der tatsächlichen Plugin-Logik mit simulierten Spiel-/Netzwerkgrenzen ergänzt. Native Sichtprüfung bleibt erforderlich.

1.0.3 — 2026-09-27

• Paketkorrektur: aktive Standard-CFG nicht mehr im ZIP, um Benutzereinstellungen beim Update zu erhalten. BepInEx erzeugt weiterhin eine echte Konfiguration bei Erststart.

• Cache-Dateinamen verkürzt; temporäre Dateien verwenden einen eigenen kurzen Namen im selben Ordner.

• Cache-Schreibfehler werden nicht mehr still übergangen; der Fehlertyp wird ohne private Pfade protokolliert.

• Manifestempfang, Downloadstart, Cacheabschluss, verspätete Fertigstellung und UI-Erzeugung werden getrennt protokolliert.

1.0.2 — 2026-09-27

• Echte config/local.serverloadingscreen.cfg im ZIP statt config.example.txt unter Plugins.
• Leere ServerId aus der Standardkonfiguration wird beim ersten Start individuell erzeugt und gespeichert.
• Autor SchmittIT bleibt vorbelegt. Keine Änderung am Anzeigezeitpunkt.

1.0.1 — 2026-09-27

• Paketmetadaten nach Faktenprüfung ergänzt: Autor SchmittIT für lokalen r2modman-Import; ZIP-Dateiname mit Autor. Mod-DLL dabei unverändert.

• Standardmäßige r2modman-Paketstruktur: DLL direkt im plugins-Ordner; keine doppelte Mod-Unterordnerstruktur.

• Deutsche BepInEx-Einstellungen, Wertebereiche für Logo-Layout und konfigurierbare sichere Bilddateinamen.

• Klare Trennung zwischen local.serverloadingscreen.cfg und r2modmans mm_v2_manifest.json in der Anleitung.

• Vorhandene Konfiguration und Plugin-GUID bleiben erhalten. Keine aktive Standardkonfiguration wird über Benutzereinstellungen kopiert.

1.0.0 — 2026-09-27

• Erste lokale Ausgabe: optionaler Client/Server-RPC, Manifest v1, SHA-256, blockweise Übertragung.
• Servergebundener Cache, Bildlimits, atomare Speicherung und Rückfall auf Valheims Ladebild.
• Proportionaler Hintergrund, separates transparentes Logo und Begrüßungstext nur beim Serverbeitritt.
• Reproduzierbarer Build, Paket-Allowlist, deutsche Installation und getrennte Prüfergebnisse.
• Keine produktive Installation oder Veröffentlichung.