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.
| Date uploaded | a day ago |
| Version | 1.4.3 |
| Download link | RDMods-CustomMainMenu-1.4.3.zip |
| Downloads | 1106 |
| Dependency string | RDMods-CustomMainMenu-1.4.3 |
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.2350README
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
CHANGELOG
Changelog
Please read README-HOW-TO-CUSTOMIZE.txt that is automatically created and posted to BepInEx/config/CustomMainMenu/ folder to understand how mod works.
1.4.3
- Custom Loading Tips: You can now write your own loading screen messages! Just enable the feature in CFG and type your tips into a
customtips.txtfile (one tip per line, max 20). - Custom Loading Screen Logo: You can now display your custom main menu logo on the loading screen as well.
- Adjustable Logo Positioning: Easily move your logos up or down on both the Main Menu and the Loading Screen to get the perfect alignment.
- Cleaner Loading Screens: Added new customization options to hide the top black bar, remove the default fiery Valheim logo, and make the background behind the loading tips transparent for a sleeker look. Off by default.
- Memory Optimization: The start-menu logo and Discord panel image are now properly cleaned up when navigating menus, preventing leftover copies from piling up and draining performance.
1.3.1
- Valheim Update Compatibility: Updated to fully support Valheim versions 1.0.14 and 1.0.15. This also cleans up some harmless console errors that started appearing after IronGate added its own built-in feature to skip intro cinematics.
1.3.0
- Mod was taken down on the request of Azumatt due to original mod referencing code from his ChangeOfScenery mod. This reupload removes any and all reference to his code. This also removes the custom boat scene the mod used and now by default references the vanilla night scene I have instead. I would like to apologize to Azumatt for using his code in my mod without permission or credits. The boat scene will return if I get his explicit permission in a future update with proper credits. All the other functionality still remains the same, just menu scenery has reverted to vanilla with night time ambiance instead.
- This change also removes some of the elements in the CFG, it is advisable to delete old CFG and let new one generate but old CFGs should still cause no conflict.
1.2.7
- Volume Control Fix: Custom menu music now properly respects the in-game Music and Master volume sliders. Thanks Soloredis for his help fixing this!
- New
MuteAmbientSetting: Added aMuteAmbientoption under[Menu Scenery](defaults totrue) to silence background wind and ocean noise for a cleaner music experience. Set tofalseif you want vanilla ambient sounds in Main Menu enabled. - Asset Protection: Default assets are now stored safely in
plugins/defaults/. Mod updates will no longer overwrite custom branding placed inconfig/CustomMainMenu/. Please read the newly created README-HOW-TO-CUSTOMIZE.txt inconfig/CustomMainMenu/for more info. Thanks Soloredis for reporting this!
1.2.4
- Added SkipIronGateSplash and SkipIntroCinematic CFG options to optionally bypass the startup splash screen and opening cinematic.
1.2.2
- Valheim 1.0.12 Compatibility: Refactored the code to ensure full compatibility with the latest game update.
- Reduced Image File Sizes: The Loading Screen folder now supports JPG/JPEG images in addition to PNGs, allowing you to compress your loading screen art.
- Customizable Changelogs: Server and modpack authors can now edit the changelog. A new CFG entry allows you to change both the changelog body text and the title of the viewer.
- Automatic Intro Skip: The game now automatically skips the introductory cutscene, taking you directly to the main menu.
1.0.0
- Initial release. Please report bugs at https://discord.gg/yX9tv3FXY6