=========================================
HOW TO CUSTOMIZE YOUR MAIN MENU
=========================================

Want to make the main menu your own? You're in the right place! 

Any files you place in this folder (BepInEx\config\CustomMainMenu) will automatically override the mod's default files. The best part? Anything you put in this folder is 100% safe and will NEVER be overwritten when the mod updates.

--- STEP-BY-STEP GUIDE ---

To customize a specific part of the menu, just drop your custom file into this folder and name it EXACTLY as shown below. (If a file is named wrong, the mod won't recognize it!)

1. MAIN LOGO
   Name your file: logo.png (or logo.jpg)
   What it does: Replaces the big game logo at the top of the menu.
   Optional: the same file can replace Valheim's fiery logo on the world-load screen.
   Config: [Loading Screen] UseCustomLoadingLogo = true
   If you also hide the top letterbox, set ShowCustomLogoWhenLetterboxHidden = true to keep this logo visible.
   Vertical position: [Main Menu] LogoOffsetY (default 0 = current placement). Negative moves it down, positive moves it up.

2. DISCORD LOGO
   Name your file: discordlogo.png (or discordlogo.jpg)
   What it does: Replaces the image on the Discord panel.
   Vertical position: [Discord Panel] DiscordLogoOffsetY (default 0 = current placement). Negative moves it down, positive moves it up.
   Note: the panel title and the Join button do not move, so past about 80 the logo starts to overlap them.

3. MAIN MENU MUSIC
   Name your file: mainmenu.ogg
   What it does: Replaces the background music.
   *CRITICAL RULE*: This file MUST be an .ogg format. The mod will not read .mp3 or .wav files!
   Renaming an .mp3 or .wav to .ogg does NOT work: the menu goes completely silent, because the game cannot
   decode the file and the mod cannot tell in advance. Convert it to real OGG Vorbis instead. If a track is
   silent, look in BepInEx\LogOutput.log for "Unsupported file or audio format".

   WANT MORE THAN ONE TRACK?
   Add mainmenu2.ogg, mainmenu3.ogg ... up to mainmenu12.ogg next to it (gaps are fine).
   A track is picked every time the main menu opens, including after you log out of a world, and loops until you enter a world.
   How it picks: [Main Menu] MusicSelectionMode
      Shuffle  = every track once before any repeat (default)
      Random   = any track, repeats possible
      InOrder  = follows MusicOrder, advancing one track per menu visit
      Fixed    = always the track in MusicFixedSlot
   Your own order, or only some of the files: [Main Menu] MusicOrder = 3,1,2
      (slot numbers; mainmenu.ogg is 1, mainmenu2.ogg is 2, and so on. Empty means every file, lowest first.
       Leaving a slot out of this list excludes it from every mode.)
   NOTE: as soon as this folder holds any mainmenu*.ogg of your own, ONLY your files are used.
   The mod's demo track is never mixed into your own rotation.

4. CHANGELOG TEXT
   Name your file: changelog.txt
   What it does: Displays your custom text inside the changelog panel.

5. LOADING SCREEN ART
   Folder Name: LoadingArt
   What it does: Open the "LoadingArt" folder and drop your custom loading screens inside. 
   Names: You can have up to 12 images. They MUST be named exactly: art1, art2, art3... up to art12.
   Formats: .png or .jpg are both allowed (for example: art1.png or art2.jpg).

6. LOADING SCREEN TIPS
   Name your file: customtips.txt
   What it does: Replaces the loading-screen tips in the bottom bar. One tip per line, up to 20.
   *IMPORTANT*: set [Loading Screen] UseCustomTips = true in the cfg or this file is ignored.


--- NEED A REFERENCE? ---

If you are ever confused about how this folder should be structured, you can always look at how we set up the default files! 

Navigate to this folder on your profile to see a perfect working example:
BepInEx\plugins\RDMods-CustomMainMenu\defaults

(Feel free to copy files from that defaults folder into this config folder to use them as a starting template to edit!)
