Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
ServerLoadingScreen
Development release: server-managed loading backgrounds and logos, content-verified client cache and configurable display time. Install on server and clients.
By SchmittIT
| Last updated | 3 weeks ago |
| Total downloads | 89 |
| Total rating | 0 |
| Categories | Mods Server-side Client-side |
| Dependency string | SchmittIT-ServerLoadingScreen-1.0.8 |
| Dependants | 0 other packages depend on this package |
This mod requires the following mods to function
denikson-BepInExPack_Valheim
BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.
Preferred version: 5.4.2351README
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, orbackground.jpg/background.jpeglogo.pngfor an optional transparent logo
In the server configuration:
| Section / option | Purpose |
|---|---|
| Server / BackgroundFile | Leave blank for the default names above, or set a local image filename. |
| Server / LogoFile | PNG filename; leave blank to disable the logo. |
| Server / Welcome | Optional short welcome text. |
| Layout / LogoWidth, LogoX, LogoY | Proportional logo size and placement. |
| Layout / MinimumDisplaySeconds | Minimum display duration, default 5 seconds, range 5–60. The image remains visible if loading takes longer. |
| Server / TransferRateKiB | Temporary per-connection Steam upload ceiling during image transfer, default 4096 KiB/s (maximum 8192; existing values are preserved). Set 0 to keep the game's limit unchanged. Previous settings are restored after the transfer. Actual throughput varies. |
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.
1.0.8: server-controlled animation
Install 1.0.8 on BOTH server and clients (protocol v4). In the SERVER CFG, use [Layout] LoadingAnimation = Hammer (default), Campfire, or Off. Hammer shows a smith's hammer and sparks; Campfire shows flames and embers. Both are language-independent. Clients cannot override this choice; the old [Client] ShowLoadingAnimation entry is ignored. Before the server manifest arrives, no animation is shown. Existing image cache and transfer settings are preserved. Save the server CFG before the next join.
