Install with Gale
Custom Main Menu
A branded Valheim menu and loading screen overhaul for public servers, private servers, and modpack authors. Swap the logo, music, loading art, custom tips, Discord invite, and changelog text & title. Rebuilt for Latest Valheim version.
Main Menu Screenshot (Customizable)
Features
- Your logo on the start screen
- Your menu music
- Random loading-screen art when a world loads (Customizable)
- Optional custom loading-screen tips (
customtips.txt, up to 20) - Optional loading-screen tweaks: hide the top black bar and Valheim logo, hide the bar behind tips, or use your menu logo on the load screen
- Move the start-menu and loading-screen logos up or down in CFG
- Discord panel with your invite link
- Custom changelog text and title
- Optional skip of the first-run intro cinematic (on by default). Iron Gate splash still plays unless you turn skip on in CFG
- Optional mute of start-menu ambient (wind / ocean / looping biome beds). Button clicks still follow Effects
Missing files are skipped. The rest of the menu still works.
Files
This mod does not ship branding inside BepInEx/config/anymore. Demo logo, music, changelog, and loading art live next to the DLL in plugins/defaults/ (for example BepInEx/plugins/RDMods-CustomMainMenu/defaults).
On first launch the plugin creates BepInEx/config/rdmods.custommainmenu.cfg and an empty BepInEx/config/CustomMainMenu/ folder, and copies README-HOW-TO-CUSTOMIZE.txt into that folder. Read that file first — it lists the exact filenames and the LoadingArt layout.
Put your own files in BepInEx/config/CustomMainMenu/. Those files win over defaults/, and mod updates will not overwrite them. Pack authors should ship branding in their pack’s config/CustomMainMenu/ folder, not inside this mod’s zip.
| File | What it does |
|---|---|
README-HOW-TO-CUSTOMIZE.txt |
Step-by-step names and folder layout. Copied into config for you. |
logo.png |
Start-menu title logo. Also accepts .jpg / .jpeg. The same file can be used on the loading screen if UseCustomLoadingLogo is on. |
discordlogo.png |
Image on the Discord panel. Also accepts .jpg / .jpeg. |
mainmenu.ogg |
Looping menu music. OGG Vorbis only. |
changelog.txt |
Text shown in the changelog panel. Edits apply live; no restart. Leave it empty to hide the panel (when custom text is on). |
customtips.txt |
Loading-screen tips when [Loading Screen] UseCustomTips is on. One tip per line, up to 20. If missing, the copy in defaults/ is used. Off keeps Valheim's own tips. |
LoadingArt/art1 to art12 |
Loading screen art. PNG or JPG. If this folder has any image, only your files are used. If it is empty, demo art from defaults/LoadingArt/ is used. |
If a single file (logo, Discord image, music, changelog, custom tips) is missing from config, the matching file in defaults/ is used. Only LoadingArt folder is a folder-level check so if some art file is missing, it still uses your given art for loading screen.
Config
BepInEx/config/rdmods.custommainmenu.cfg is created on first launch. Your existing values are kept when the mod updates; only new keys are added.
The Discord panel title and button label are fixed in the plugin. The invite URL is not.
| Section | Setting | What it does |
|---|---|---|
| General | Enabled |
Turns the whole mod on or off. Default true. |
| General | EnableLogging |
Extra log lines. Default false. |
| Startup | SkipIronGateSplash |
Skip Coffee Stain / Iron Gate / game logo splash. Default false (vanilla splash plays). Change applies on the next launch. |
| Startup | SkipIntroCinematic |
Skip the first-run 1.0 intro cutscene. Default true. false lets that cinematic play. Does not skip new-world intro, EULA, or the Cinematics menu. |
| Main Menu | MuteAmbient |
Mute ocean, wind, and looping biome ambient on the start menu. Button clicks still follow Effects. Default true. Recommended to keep True so your main menu music is clean. |
| Main Menu | LogoOffsetY |
Move the start-menu logo up or down. Default 0 (current placement). Negative moves it down, positive moves it up. |
| Loading Screen | UseCustomTips |
Use customtips.txt on the loading screen. Off keeps Valheim's own tips. Default false. |
| Loading Screen | HideTopLetterbox |
Hide the top black bar and Valheim's fiery loading logo. The bottom tip bar stays. Default false. |
| Loading Screen | HideTipBackdrop |
Hide the black bar behind the loading tips. Tip text and spinner stay. Default false. |
| Loading Screen | UseCustomLoadingLogo |
Use the same logo.png as the start menu on the loading screen. Off keeps Valheim's fiery logo. Default false. |
| Loading Screen | ShowCustomLogoWhenLetterboxHidden |
If the top bar is hidden, still show your custom loading logo. Does nothing unless UseCustomLoadingLogo is on. Default false. |
| Loading Screen | LoadingLogoOffsetY |
Move the loading-screen logo up or down. Default 0 (current placement). Negative moves it down, positive moves it up. |
| Changelog | Enabled |
Show the changelog panel and its menu button. Default true. |
| Changelog | UseCustomText |
Fill the panel from changelog.txt. Default true. |
| Changelog | OverrideVanillaText |
On: only your text. Off: your text above Valheim’s own notes. Default true. |
| Changelog | AutoOpen |
Open the panel when the menu appears. The changelog button still collapses it. Default true. |
| Changelog | TitleText |
Title on the open Changelog panel. Default empty (vanilla “Changelog”). The collapse button always stays “Changelog”. |
| Discord Panel | VisibleOnlyOnStartMenu |
When on, the panel shows only on the main Start Game screen. Hidden on character/world select, cinematics, EULA, and during load. Default true. |
| Discord Panel | DiscordInviteUrl |
Opened by the panel button. Must start with http:// or https://. Empty disables the link. Default https://discord.gg/yX9tv3FXY6. |
Credits
Thanks to Soloredis for helping fix the Main Menu music slider not working.
Support
Questions, feedback, and bug reports: discord.gg/yX9tv3FXY6