Custom Main Menu
Mod Description
This mod is a public version of my other mod MMOHeimMainMenu but tailored for public use so anyone can use its feature to create a branded main menu experience for their own mods or modpacks. Please check the Customizing Assets instruction below on how to place the right files in right filepath to customize the main menu according to your own liking and branding. In the main CFG you can define your own discord invite link by placing your link in DiscordInviteUrl setting.
By default, this mod will ship with MMOHeim branded experience for Main Menu, you can easily replace those files at BepInEx/config/CustomMainMenu/ at anypoint before shiping it as part of your own modpack for your own custom branded main menu experience.
Default MainMenu Experience (Customizable)
MMOHeim Info
MMOHeim is a Valheim modpack built around deeper, MMO-style systems and community play. This plugin lets you brand the startup experience with your own logo, menu music, loading-screen art, and Discord invite — ideal for server owners and modpack authors.
Join the community and follow MMOHeim development on Discord. Report bugs or issues there as well.
Requirements
- Valheim
- BepInExPack Valheim — install through your mod manager, or set up BepInEx manually before adding this mod.
Thunderstore dependencies mirror that (see manifest.json).
Installation
Manual
- Install BepInExPack Valheim if you do not already have it.
- Copy
CustomMainMenu.dll into Valheim/BepInEx/plugins/<any-folder-name>/.
- Create your asset folders under config (see Customizing assets).
Customizing assets
All branding files are optional; missing files simply skip that feature. Place them under BepInEx/config/CustomMainMenu/ (not next to the DLL). The mod creates this folder on first run.
| What |
Path |
| Main menu logo |
BepInEx/config/CustomMainMenu/logo.png |
| Discord panel image |
BepInEx/config/CustomMainMenu/discordlogo.png |
| Menu music |
BepInEx/config/CustomMainMenu/mainmenu.ogg (OGG Vorbis) |
| Loading splash art |
BepInEx/config/CustomMainMenu/LoadingArt/art1.png … art12.png — use any subset; one image is picked at random each world load among files that exist |
Modpack authors
Ship a config-only branding pack alongside this plugin:
BepInEx/config/rdmods.custommainmenu.cfg — set DiscordInviteUrl and other options.BepInEx/config/CustomMainMenu/ — your logo, Discord image, music, and loading art.
Config survives plugin updates; users keep your branding when they update the DLL.
Configuration
Generated on first launch:
BepInEx/config/rdmods.custommainmenu.cfg
| Section |
Setting |
Description |
| General |
Enabled |
Turn the mod on or off. |
| General |
EnableLogging |
Extra log messages (off by default). |
| Discord Panel |
DiscordInviteUrl |
Discord invite opened by the panel button (http or https). Leave empty to disable the link. |
| Discord Panel |
VisibleOnlyOnStartMenu |
When true, the panel shows only on the main Start Game screen. |
| Menu Scenery |
Enabled |
Coastal login viewpoint on the start scene (on by default). |
| Menu Scenery |
DepthOfFieldOnCharacterSelect |
Depth of field on character select and credits. |
Discord panel title and button text are fixed in the plugin and are not configurable.
Support
Questions, feedback, and bug reports: discord.gg/yX9tv3FXY6
Do not ship user branding assets inside the plugin folder; users and modpacks provide those via BepInEx/config/CustomMainMenu/.
