You are viewing a potentially older version of this package. View all versions.
denikson-BepInExPack_Valheim-5.4.2202 icon

BepInExPack Valheim

BepInEx pack for Valheim. Preconfigured and includes unstripped Unity DLLs.

Date uploaded 6 months ago
Version 5.4.2202
Download link denikson-BepInExPack_Valheim-5.4.2202.zip
Downloads 695306
Dependency string denikson-BepInExPack_Valheim-5.4.2202

README

BepInEx logo

BepInExPack for Valheim

This is BepInEx 5.4.22 pack pre-configured for Valheim. It is maintained by Azumatt, Vapok, and Margmas in the Valheim community. If changes to the pack need to be made but BepInEx itself doesn't need to update typically we will increment the version for Thunderstore. Example: 5.4.2201, this does not mean that BepInEx itself needed to update, likely it's a small change for the game or something needed to change in the description etc.

BepInEx is a general purpose framework for Unity modding. BepInEx includes tools and libraries to

  • load custom code (hereafter plugins) into the game on launch;
  • patch in-game methods, classes and even entire assemblies without touching original game files;
  • configure plugins and log game to desired outputs like console or file;
  • manage plugin dependencies.

BepInEx is currently one of the most popular modding tools for Unity on GitHub.

This pack's contents

This pack is preconfigured and usable for Valheim modding.
In particular, the changes from base BepInEx releases are:

  • Added preconfigured BepInEx.cfg with console enabled.
  • Added scripts necessary to run both game and dedicated server on Linux machines

Installation (game, automated)

This is the recommended way to install BepInEx on the game.

  1. Download and install Thunderstore Mod Manager or r2modman
  2. Click Install with Mod Manager button on top of the page
  3. Run the game via the mod manager

Installation (server, automated)

There are some managed dedicated server that support simple and automatic BepInEx installation.
Here is a list of known ones (list updated as more is known).
Note: Some of the links may be affiliate links

ValheimServerHosting

XGamingServer

Installation (manual)

If you are installing this manually, do the following

  1. Extract the archive into a folder. Do not extract into the game folder.

  2. Move the contents of BepInExPack_Valheim folder into <Steam Location>\steamapps\common\Valheim.

  3. Check that you have installed it correctly. If done correctly, your folder will look as follows

    BepInEx, winhttp.dll, and doorstop_config.ini in Valheim folder.

  4. Follow either Windows or Linux game running instructions below:

Configuration (Windows)

No need to configure. Simply run the game. If everything is correct, you will see a console pop up.

Configuration (Linux, game)

  1. Make start_game_bepinex.sh executable with chmod u+x start_game_bepinex.sh.

  2. In Steam, go to game's properties and set game's launch arguments to

    ./start_game_bepinex.sh %command%
    

    Note to advanced users: You can change ./start_game_bepinex.sh to full path to the script. This way you can install this pack entirely outside of game folder.

  3. Run the game via Steam.

At this moment you will not see any clear indication if BepInEx works. It is suggested to test by installing a simple plugin such as MessageCenter from BepInEx.Utility.

Configuration (Linux, server)

This guide assumes you have enough knowledge working with Linux.
If not, it is suggested you use a server host that supports it out of the box.

  1. Make start_server_bepinex.sh executable with chmod u+x start_server_bepinex.sh.
  2. Edit start_server_bepinex.sh to change the launch parameter like you would with Valheim's own launch script.
  3. Run start_server_bepinex.sh to start the server.

If done correctly, you will see BepInEx bootstrap messages in the terminal.

Checking BepInEx version and load status

If BepInEx was loaded successfully into the game, you should see BepInEx version info in top left corner of the main menu:

BepInEx version in top-left corner of main menu

Useful links

Issues, questions, etc.

DO NOT ASK FOR HELP in the Official BepInEx Discord

The Valheim community runs a customized version of BepInEx and the official BepInEx folks are unable to help.

If you are having problems with BepInEx in general, mods running on Valheim, or unsure between the two, please seek assistance from ANY of the Discords listed below.

Current BepInEx for Valheim Maintainers:

CHANGELOG

Changelog

5.4.2202

  • ReadMe Updated to remove links to BepInEx Discord
  • Preloader version incremented.
  • Update made to Preloader to ensure assembly's are being patched correctly.
    • This should remove the warning message that shows when BepInEx starts.
  • Modders: Unstripped Corlibs are still removed. If you are having issues with System depenencies, please include those dependencies directly into your project.

5.4.2201

  • As of Valheim 0.217.24, There is no longer a need for the unstripped corlibs to be shipped with BepInEx.
    • This version removes the corlibs and instructs doorstop not to include them.
    • For modders, this is important, as you'll want to make sure you are referencing Unity from the Game Folder now.
Changelog History (click to expand)

5.4.22

  • Update for Valheim 0.217.22 and upgrade BepInEx to 5.4.22

5.4.2105

  • Updating Thunderstore version in Preloader.DLL

5.4.2104

  • For Unix installs, including dedicated servers, the ForceBepInExTTYDriver config setting was removed in a prior update. This is needed for servers to shut down correctly.

5.4.2103

  • Log the BepInExPack Valheim version the user is using right before the preloader completes. This is to help troubleshoot issues by stating what version of the pack you are running.

5.4.2102

  • Updated to force the Assembly entry point by default. This should prevent some issues with users having older config files.

5.4.2101

  • Updated to support Valheim 0.214.3

5.4.2100

  • Updated to BepInEx 5.4.21

5.4.1902

  • Updated to support Valheim 0.214.2

5.4.1901

  • Updated to support Valheim 0.209.5

5.4.1900

5.4.1700

5.4.1601

  • Updated unstripped DLLs for Unity 2019.4.31

5.4.1600

5.4.1502

  • Adjusted start_game_bepinex.sh to handle cmdline args better

5.4.1501

  • Updated Valheim.DisplayBepInExInfo to 2.0.0(changelog)

5.4.1500

5.4.1400

  • Updated to BepInEx 5.4.14 (changelog)
  • Updated *nix start script for games to account for new Steam game bootstrapper

5.4.1100

5.4.1001

  • Updated unstripped DLLs for Unity 2019.4.24

5.4.1000

  • Updated to BepInEx 5.4.10 (changelog)
  • Updated Valheim.DisplayBepInExInfo to 1.1.0 (changelog)

5.4.901

  • Updated README with some dedicated servers that support BepInEx by default

5.4.900

  • Updated to BepInEx 5.4.9 (changelog)
  • Updated Valheim.DisplayBepInExInfo to 1.0.1 (changelog)
  • Set PreventClose to true by default. This prevents console from being closed (and thus unsaved game being closed by accident)

5.4.800

5.4.701

  • Updated screenshot of example installation

5.4.700

  • Updated to BepInEx 5.4.7

5.4.603

  • Updated BepInEx 5.4.6 to a newer build
  • Added --enable-console true|false command-line option to enable or disable BepInEx console
  • Added --doorstop-dll-search-override command-line option to behave the same way as config's dllSearchPathOverride option

5.4.602

  • Updated BepInEx 5.4.6 to a newer build
  • Update config to write Unity logs to LogOutput.log by default
  • Added preconfigured scripts and files to run the game under Linux

5.4.601

  • Updated unstripped DLLs for Unity 2019.4.20

5.4.600

  • Adjusted README
  • Adjusted versioning to account for inter-version changes

5.4.6

  • Initial release with BepInEx 5.4.6