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.
CustomMainMenu
All-in-One CustomMainMenu: Customize everything about Main Menu & Loading Screen experience. Discord panel on Main Menu with your Discord Invite Link embedded. Made for Modpack Authors & Server Owners.
| Last updated | 2 weeks ago |
| Total downloads | 17787 |
| Total rating | 7 |
| Categories | Mods Utility AI Generated Client-side Deep North Update |
| Dependency string | RDMods-CustomMainMenu-1.6.0 |
| Dependants | 18 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
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: one track, or several that rotate (shuffled, random, in your own order, or a fixed pick)
- 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, loading-screen and Discord panel 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, mainmenu2.ogg … mainmenu12.ogg |
Looping menu music. OGG Vorbis only. One file is all you need; add numbered files for a rotation and pick how they are chosen with [Main Menu] MusicSelectionMode. As soon as this folder holds any mainmenu*.ogg of your own, only your files are used, so the demo track never mixes into your rotation. A file that is not really OGG Vorbis (an mp3 or wav renamed to .ogg) plays as silence rather than being skipped — convert it properly, and check BepInEx/LogOutput.log for an FMOD Unsupported file or audio format line if a track is quiet. |
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, changelog, custom tips) is missing from config, the matching file in defaults/ is used. Music and the LoadingArt folder are folder-level checks instead, so once config holds any mainmenu*.ogg or any art file, only your own files are used for those.
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. |
| Main Menu | MusicSelectionMode |
How the next track is chosen when you have more than one music file: Random (repeats freely), Shuffle (every file once before any repeat), InOrder (follows MusicOrder), Fixed (always MusicFixedSlot). Default Shuffle. A track is picked each time the main menu opens, including after you log out, and loops until you enter a world. Changes apply on the next menu visit. |
| Main Menu | MusicOrder |
Which files to use and in what order, as slot numbers, for example 3,1,2. Empty uses every file found, lowest first. Listing only some slots also excludes the others, in every mode. Default empty. |
| Main Menu | MusicFixedSlot |
Slot played when MusicSelectionMode is Fixed. 1 to 12, ignored by the other modes. Default 1. |
| 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. |
| Discord Panel | DiscordLogoOffsetY |
Move the Discord panel's logo image up or down. Default 0, range -150 to 150. Negative moves it down, positive up. The panel title and the Join button stay where they are, so past about 80 the logo starts to overlap them. |
Credits
Thanks to Soloredis for helping fix the Main Menu music slider not working.
Support
Questions, feedback, and bug reports: discord.gg/yX9tv3FXY6
