Valhalla Menu Companion

A menu companion for SeneaL UI. It adds a custom title logo, custom loading screens, custom item tooltips and an optional one-click join for your server, all switched on and off in the config. It does nothing server-specific until you set it up, so it suits any server, modpack or single-player install.

Made with the help of AI.

Features

Everything is optional. On a fresh install the server features (logo, quick connect, rules, Discord, support) are off with every link and address blank: turn on what you want and fill in your own.

Feature	Turn on with	What it does
Custom loading screens	Put images in loading_screens/	Your .png/.jpg images (random or in order), a caption per image, and your own loading tips.
Custom item tooltips	Write item_tooltips.txt	Extra lore, server notes or hints at the bottom of any item's tooltip.
Title logo	[Branding] Enabled = true + logo.png in the folder	Replaces the Valheim title logo.
Quick connect	[QuickConnect] Enabled = true + ServerAddress	The character screen's Start becomes a one-click join (button text is yours), with a PLAY LOCAL button and a live online / player-count line.
Server rules	[Rules] Enabled = true + rules.txt	A Server Rules row on the title menu; optionally players must agree before their first join (again whenever the rules change).
Discord row	[Discord] Enabled = true + URL	A Discord row on the title menu that opens your invite.
Support row	[Support] Enabled = true + URL	A row for Patreon/Ko-fi with an optional confirmation.
Deathlink window	Automatic when Deathlink is installed ([DeathlinkWindow] Enabled, on)	Its profile selection window gets the SeneaL UI look, and every section fits: long lists scroll instead of overlapping.
Main-menu music	[MenuMusic] Enabled = true + songs in menu_music/	Your own songs on the main menu and character screen (in-game music unchanged), shuffled, optionally starting part-way in.
Skip intro	[Startup] SkipStartupCinematic (on)	Skips the intro video at launch; the Cinematics menu still works.
Tidy the title menu	[MainMenu] HiddenRows, HideMenuLook, [Discord] ReplaceOtherDiscordRows (all off)	Hide title-menu rows you don't want players to see. Other mods keep working.

All files live in BepInEx/config/ValhallaMenu/. Edits are picked up on the main menu within a few seconds. The settings file is BepInEx/config/valhalla.menu.companion.cfg (or use your mod manager's config editor).

Custom loading screens

Put .png or .jpg images (1920x1080 recommended, up to 16 MiB each) in BepInEx/config/ValhallaMenu/loading_screens/. Tips go in loading_tips.txt, one per line (created with examples on first launch).

Setting [LoadingScreen]	Default	Meaning
Enabled	true	Off restores the vanilla loading screen.
ImageOrder	Random	Random (shuffled: every image once before any repeats, even across restarts) or Sequential (file-name order).
ImageFit	Cover	Cover fills the screen and crops, Fit letterboxes, Stretch distorts.
TipsMode	Replace	Replace (only your tips), Append (vanilla + yours) or Off.
SlideshowSeconds	20	On a long load, switch to the next image after this many seconds (minimum 3). 0 = one image per loading screen.
Logo	Keep	Logo at the top: Keep, Custom (LogoFile, else your title logo) or Hide.
LogoFile	loading_logo.png	Logo picture for Logo = Custom, in BepInEx/config/ValhallaMenu/.
HideSpinner	false	Hide the spinning icon in the corner.
HideShading	false	Show your images at full brightness (removes Valheim's darkening of the background).
ShowCaptions	true	Show captions from loading_screens/captions.txt on your images.
CaptionPosition	BottomLeft	TopLeft, TopCenter, TopRight, BottomLeft, BottomCenter or BottomRight.
CaptionFontSize / CaptionColor	30 / #FFFFFF	Caption size and colour (a dark outline keeps it readable).

Different images for joining, dying and teleporting

Put images in sub-folders of loading_screens/ to use them only at that moment:

Folder	Shown when	Without it
loading_screens/join/	joining a world or server	the images in loading_screens/
loading_screens/respawn/	respawning after death	the images in loading_screens/
loading_screens/teleport/	teleporting (portals)	Valheim's own teleport screen

Captions

Give each image a title, a credit or a hint in loading_screens/captions.txt (created with examples on first launch):

sunset.png = <b>Sunset over the Meadows</b>\n<size=75%>Screenshot by Ragnar</size>
boss_arena = The Elder awaits
* = My Valheim Server

The name may be written with or without its extension and may contain spaces. * is the caption for every image without its own line. Captions show only on your custom images, never on the vanilla loading screen.

Main-menu music

Turn on [MenuMusic] Enabled and put songs (.ogg works best; .mp3 and .wav too) in BepInEx/config/ValhallaMenu/menu_music/. Each time you reach the main menu one of them plays instead of Valheim's menu theme; once you enter a world the normal game music takes over. Songs stream from disk.

Setting [MenuMusic]	Default	Meaning
Enabled	false	Turn the feature on.
Order	Random	Random (shuffled: every song once before any repeats, even across restarts) or Sequential.
StartSeconds	0	Start each song this many seconds in. When it ends it loops from the very beginning.
Volume	100	Percent of Valheim's menu-music volume (the game's music slider still applies).

Menu volumes

[MenuAudio] sets the volumes for the main menu and character screen only: Enabled (off), MasterVolume, MusicVolume and EffectsVolume (percent). Each player's own Valheim audio settings come back the moment they leave the menu, and they can still change them in game as usual (the mod never saves over them). While the Settings window is open on the menu, the mod stays out of the way of its sliders.

Different start points per song go in menu_music/start_times.txt

Custom item tooltips

Add lines to item_tooltips.txt (created with examples on first launch):

SwordIron = Forged in the fires of the north.
$item_axe_bronze = Line one\nLine two

The key is the item's prefab name or its name token. The text appears at the bottom of the tooltip in [Tooltips] TextColor.

Write several lines for the same item to give it more text. With [Tooltips] MultipleLines = Random the tooltip shows just one of them instead, a different one each time the item is hovered (every line once before any repeats), which is nice for rotating lore or hints:

SwordIron = Forged in the fires of the north.
SwordIron = Favoured by the jarls of old.
SwordIron = Its edge remembers every battle.

Setting up your server (server owners)

1. [QuickConnect]: Enabled = true, ServerAddress, ServerPort, ButtonText (e.g. ENTER MY SERVER) and, if needed, ServerPassword. The password is stored in plain text: anyone you give the config to can read it.
2. [Rules]: Enabled = true, then write your rules in rules.txt. RequireAcceptance makes players agree before the first join; raise Version to make everyone agree again.
3. [Discord] / [Support]: Enabled = true and your links. [Branding]: Enabled = true and your logo.png.
4. Share your mod-manager profile (code or export) so players get the same config and files. Leave out loading_shuffle.txt: it only records your own place in the image shuffle.

Requirements and compatibility

• BepInExPack Valheim 5.4.2360, SeneaL UI 1.2.8, SeneaL API 1.2.0 (installed automatically by mod managers).
• Client-side only; not needed on the dedicated server. Tested with Valheim 1.0.21, Path of Valheiman and Deathlink.
• The title-menu rows and the character screen are drawn by SeneaL UI; this mod adds its entries to SeneaL's menu.
• Path of Valheiman replaces the game logo (title and loading screen) with its own. To keep yours, set SeneaL UI's own MenuModExtras = false; that also hides other mods' extra title-menu rows.
• Deathlink: the restyled window is optional ([DeathlinkWindow] Enabled); Deathlink keeps all of its own behaviour.

The game, SeneaL UI and SeneaL API belong to their developers. This package contains none of their files.