Skip to content

Latest commit

 

History

History
46 lines (36 loc) · 2.76 KB

getting_started_with_mods.md

File metadata and controls

46 lines (36 loc) · 2.76 KB

Getting started with Mods

Steps

  1. Set the variable TYPE to be one of the following:

    Type What it installs
    Vanilla Default value and the most common installation type. This will run Valheim normally.
    BepInEx This will install BepInEx from this package and is purely just BepInEx with minimally needed components.
  2. If you wish do not with to use additional mods, you can skip this step. Otherwise, in order to install additional mods you can use the MODS variable.

    Example of MODS, this example is slimmed down to go over the TYPE and MODS variable.

    version: "3"
    services:
      valheim:
        image: mbround18/valheim:latest
        environment:
          # The Type variable is used to set which type of server you would like to run.
          - TYPE=BepinEx
          # The Mods variable is a comma and newline separated string.
          # It MUST be a link with a command and a new line at the end to be valid.
          - "MODS=
            https://cdn.thunderstore.io/live/repository/packages/abearcodes-SimpleRecycling-0.0.10.zip,
            https://cdn.thunderstore.io/live/repository/packages/abearcodes-CraftingWithContainers-1.0.9.zip
            "
  3. Now that you have your compose setup, run docker-compose up

Odin automatically detects if you are running with BepInEx and adds the environment variables appropriately.

DISCLAIMER! Modding your server can cause a lot of errors. Please do NOT post an issue on the valheim-docker repo based on mod issues. By installing mods, you agree that you will do a root cause analysis to why your server is failing before you make a post. Modding is currently unsupported by the Valheim developers and limited support by the valheim-docker repo. If you have issues please contact the MOD developer FIRST based on the output logs.

Valheim Updated Help

Mod development is slow, and the more mods you have the more complicated it will be to keep everything up to date. It is a suggestion that you turn off the AUTO_UPDATE variable when you are using mods and refrain from updating your local client until all your mods have been updated. Some mods break on new updates of Valheim while others do not. Be on the look out for mod issues if you update your server.