How to Install ValheimOne on Your PC: Difference between revisions
[wiki:ss-claude-11372] Fixes: wrong or outdated steps, labels and facts corrected, current pictures, dead links fixed, search title and description |
[wiki:wiki-operator] Reworded to the house writing rules; facts that were wrong today corrected (approved by Ryan, Nov 17) |
||
| (One intermediate revision by the same user not shown) | |||
| Line 1: | Line 1: | ||
{{#seo: | {{#seo: | ||
|title=How to Install ValheimOne on Your PC | |title=How to Install ValheimOne on Your PC: Valheim Player Guide | ||
|description=You can join a ValheimOne server with nothing installed. Install ValheimOne on your PC for the settings that need it: steps, checks, updates, removal. | |description=You can join a ValheimOne server with nothing installed. Install ValheimOne on your PC for the settings that need it: steps, checks, updates, removal. | ||
}} | }} | ||
| Line 17: | Line 17: | ||
|} | |} | ||
Each player who wants the second column installs ValheimOne. A player without it still joins and plays. They | Each player who wants the second column installs ValheimOne. A player without it still joins and plays. They get the normal game values. | ||
On Survival Servers, the cards in '''Server Config''' that need ValheimOne on each PC say "Players need ValheimOne on their PC for this". | On Survival Servers, the cards in '''Server Config''' that need ValheimOne on each PC say "Players need ValheimOne on their PC for this". | ||
| Line 23: | Line 23: | ||
[[File:valheim-server-config.png|thumb|none|720px|alt=Valheim Server Config window with Player conveniences and Death penalty cards marked Players need ValheimOne on their PC for this.|A card that only works for players with ValheimOne on their PC.]] | [[File:valheim-server-config.png|thumb|none|720px|alt=Valheim Server Config window with Player conveniences and Death penalty cards marked Players need ValheimOne on their PC for this.|A card that only works for players with ValheimOne on their PC.]] | ||
'''Note:''' If the server owner turns on '''Enforce Mod''', the server kicks anyone without ValheimOne about 15 seconds after they join. It | '''Note:''' If the server owner turns on '''Enforce Mod''', the server kicks anyone without ValheimOne about 15 seconds after they join. It's off by default. | ||
== Console players == | == Console players == | ||
Consoles | Consoles can't install mods, so there's nothing to install on Xbox, PlayStation 5 or Switch 2. | ||
Console players join a [[How to Set Up a Valheim Crossplay Server|crossplay]] ValheimOne server like any other server. They can open a shared map link in a browser, and they get everything in the first column | Console players join a [[How to Set Up a Valheim Crossplay Server|crossplay]] ValheimOne server like any other server. They can open a shared map link in a browser, and they get everything in the first column of the table. | ||
The settings in the second column never apply to a console player. If Enforce Mod is on, console players | The settings in the second column never apply to a console player. If Enforce Mod is on, console players can't stay connected, so leave it off on a crossplay server. | ||
== Install on PC == | == Install on PC == | ||
| Line 38: | Line 38: | ||
# Close Valheim. | # Close Valheim. | ||
# Open the [https://github.com/HumanGenome/ValheimOne/releases/latest latest ValheimOne release] and scroll down to '''Assets'''. Download the file that starts with <code>ValheimOne-full-</code>, for example <code>ValheimOne-full-0.13. | # Open the [https://github.com/HumanGenome/ValheimOne/releases/latest latest ValheimOne release] and scroll down to '''Assets'''. Download the file that starts with <code style="white-space:nowrap">ValheimOne-full-</code>, for example <code>ValheimOne-full-0.13.26.zip</code>. | ||
# In Steam, right click '''Valheim''', then '''Manage''', then '''Browse local files'''. This opens the game folder, the one with <code>valheim.exe</code> in it. | # In Steam, right-click '''Valheim''', then '''Manage''', then '''Browse local files'''. This opens the game folder, the one with <code>valheim.exe</code> in it. | ||
# Extract everything in the zip straight into that folder. | # Extract everything in the zip straight into that folder. | ||
# Start Valheim from Steam the normal way. A second window with scrolling text opens next to the game. That | # Start Valheim from Steam the normal way. A second window with scrolling text opens next to the game. That's BepInEx, the mod loader. Leave it open. | ||
# Join the server. It sends its settings to your game when you join. You | # Join the server. It sends its settings to your game when you join. You don't edit any file, and the server doesn't need a restart. | ||
[[File:Valheimone-release-assets-20260918.png|thumb|none|720px|alt=The Assets list on the ValheimOne GitHub release page, with the Full zip, the plugin-only zip and the source code links.|The Assets list on the release page. The Full zip is the one to download.]] | [[File:Valheimone-release-assets-20260918.png|thumb|none|720px|alt=The Assets list on the ValheimOne GitHub release page, with the Full zip, the plugin-only zip and the source code links.|The Assets list on the release page. The Full zip is the one to download.]] | ||
'''Note:''' | '''Note:''' Don't use the green Code button or the Source code links. Those are the source files. There's no mod in them. | ||
After step 4 the game folder should look like this: | After step 4 the game folder should look like this: | ||
| Line 62: | Line 62: | ||
</pre> | </pre> | ||
<code>winhttp.dll</code> and the <code>BepInEx</code> folder must sit right next to <code>valheim.exe</code>. If Windows made a folder | <code>winhttp.dll</code> and the <code>BepInEx</code> folder must sit right next to <code>valheim.exe</code>. If Windows made a folder like <code>ValheimOne-full-0.13.26</code> inside the game folder, open it and move everything in it up one level. | ||
=== If you already use BepInEx === | === If you already use BepInEx === | ||
The Full zip includes BepInEx. If BepInEx is already in your game folder for other mods, download <code>ValheimOne-0.13. | The Full zip includes BepInEx. If BepInEx is already in your game folder for other mods, download the zip without "full" in its name, like <code>ValheimOne-0.13.26.zip</code>, instead and extract it into the game folder the same way. It adds two files: <code>BepInEx/plugins/ValheimOne.dll</code> and <code>BepInEx/config/valheimone.cfg</code>. | ||
BepInEx on its own does nothing here. It only loads mods. ValheimOne is the file in <code>BepInEx/plugins</code>. | BepInEx on its own does nothing here. It only loads mods. ValheimOne is the file in <code>BepInEx/plugins</code>. | ||
| Line 76: | Line 76: | ||
== Install with a mod manager == | == Install with a mod manager == | ||
ValheimOne is | ValheimOne is on [https://thunderstore.io/c/valheim/p/HumanGenome/ValheimOne/ Thunderstore], so r2modman and Thunderstore Mod Manager can install it. | ||
# In your Valheim profile | # In r2modman or Thunderstore Mod Manager, open your Valheim profile. | ||
# Under '''Online''', search for <code>ValheimOne</code> and press '''Download'''. The manager adds '''BepInExPack_Valheim''' with it if your profile doesn't have it yet. | |||
# Start the game with '''Start modded'''. | # Start the game with '''Start modded'''. | ||
| Line 92: | Line 90: | ||
== How to tell it worked == | == How to tell it worked == | ||
* The BepInEx window shows a line | * The BepInEx window shows a line like <code>ValheimOne v0.13.26 starting</code> while the game loads. | ||
* After you join the server it shows <code>Sent VO_Hello to server</code> and then <code>Server config applied</code> with a count of values. | * After you join the server it shows <code>Sent VO_Hello to server</code> and then <code>Server config applied</code> with a count of values. | ||
* The same lines are saved in <code>BepInEx/LogOutput.log</code> in the game folder. Look there if you have no BepInEx window. | * The same lines are saved in <code>BepInEx/LogOutput.log</code> in the game folder. Look there if you have no BepInEx window. | ||
| Line 108: | Line 106: | ||
</pre> | </pre> | ||
It | It's harmless. ValheimOne is one file for servers and players, and the red lines come from a server-only part: the one that raises the player limit on a dedicated server. | ||
That part tries to change game code a player's copy of Valheim | That part tries to change game code a player's copy of Valheim doesn't have. It fails, and the mod carries on. The last line says so. | ||
Every gameplay setting loads before that part, and the settings sync with the server still starts after it. Nothing you play with is lost. | Every gameplay setting loads before that part, and the settings sync with the server still starts after it. Nothing you play with is lost. | ||
| Line 118: | Line 116: | ||
== Updating == | == Updating == | ||
To update ValheimOne, do the install again with the new zip and let it overwrite the old files. Your characters and worlds | To update ValheimOne, do the install again with the new zip and let it overwrite the old files. Your characters and worlds aren't in the game folder, so they aren't touched. | ||
Your PC and the server must be on the same version line: 0.13 with 0.13. The last number can differ. Some fixes need both sides current, so the safe rule is the latest release on the server and on every PC. | Your PC and the server must be on the same version line: 0.13 with 0.13. The last number can differ. Some fixes need both sides current, so the safe rule is the latest release on the server and on every PC. | ||
A server on Survival Servers installs the ValheimOne version Survival Servers has set each time it starts or restarts. On a self hosted server the owner replaces the file on the server. | A server on Survival Servers installs the ValheimOne version Survival Servers has set each time it starts or restarts. On a self-hosted server, the owner replaces the file on the server. | ||
=== After a Valheim patch === | === After a Valheim patch === | ||
| Line 130: | Line 128: | ||
* Check the [https://github.com/HumanGenome/ValheimOne/releases release page] for a release newer than the patch and install it. | * Check the [https://github.com/HumanGenome/ValheimOne/releases release page] for a release newer than the patch and install it. | ||
* A yellow line that starts <code>This build targets Valheim</code> means the game is newer than the mod was built for. It often still works. If a setting stops working, wait for the next release. | * A yellow line that starts <code>This build targets Valheim</code> means the game is newer than the mod was built for. It often still works. If a setting stops working, wait for the next release. | ||
* If the game | * If the game won't start, rename <code>winhttp.dll</code> to <code>winhttp.dll.off</code>. The game starts without mods. Rename it back once you have updated. | ||
If the server refuses the connection after a patch, see [[Valheim Incompatible Version Error]]. That's caused by the game version, not the mod. | |||
== Removing it == | == Removing it == | ||
| Line 150: | Line 148: | ||
; I installed BepInEx and nothing changed | ; I installed BepInEx and nothing changed | ||
: BepInEx only loads mods. ValheimOne is a separate file. Use the Full zip, which has both, or add <code>ValheimOne.dll</code> to <code>BepInEx/plugins</code>. | : BepInEx only loads mods. ValheimOne is a separate file. Use the Full zip, which has both, or add <code>ValheimOne.dll</code> to <code>BepInEx/plugins</code>. | ||
; I downloaded ValheimOne from GitHub and there | ; I downloaded ValheimOne from GitHub and there's no ValheimOne.dll in it | ||
: That was the green Code button. It gives you the source files. Use the zip under '''Assets''' on the release page. | : That was the green Code button. It gives you the source files. Use the zip under '''Assets''' on the release page. | ||
; I | ; I don't know which folder to extract into | ||
: The Valheim game folder: Steam, right click Valheim, Manage, Browse local files. <code>winhttp.dll</code> must end up next to <code>valheim.exe</code>, not inside another folder. | : The Valheim game folder: Steam, right-click Valheim, Manage, Browse local files. <code>winhttp.dll</code> must end up next to <code>valheim.exe</code>, not inside another folder. | ||
; No BepInEx window opens | ; No BepInEx window opens | ||
: <code>winhttp.dll</code> is missing or one folder too deep, or you started the game from a mod manager profile that | : <code>winhttp.dll</code> is missing or one folder too deep, or you started the game from a mod manager profile that doesn't have ValheimOne in it. | ||
; Red error lines at launch | ; Red error lines at launch | ||
: Harmless on 0.13.14 and older, gone in 0.13.15. See [[#The red error at launch| | : Harmless on 0.13.14 and older, gone in 0.13.15. See [[#The red error at launch|The red error at launch]]. | ||
; ValheimOne loads but the settings still | ; ValheimOne loads but the settings still don't apply | ||
: This one is on the server. Ask the owner to check three things in '''Server Config''': the card's own first switch ('''Turn on ...''') is on, not | : This one is on the server. Ask the owner to check three things in '''Server Config''': the card's own first switch ('''Turn on ...''') is on, not only the setting under it. '''Sync Config''' under '''Server & Query''' > '''Server controls''' is on. And the server was restarted after a card was turned on for the first time. | ||
[[File:valheim-server-config-server-controls-2026-10.png|thumb|none|720px|alt=ValheimOne Server Config open on the Server controls card, with Enforce Mod off and Sync Config on.|The Server controls card: Sync Config on, Enforce Mod off.]] | [[File:valheim-server-config-server-controls-2026-10.png|thumb|none|720px|alt=ValheimOne Server Config open on the Server controls card, with Enforce Mod off and Sync Config on.|The Server controls card: Sync Config on, Enforce Mod off.]] | ||
; It works for me but not for my friend | ; It works for me but not for my friend | ||
: Every PC needs its own install. Console players | : Every PC needs its own install. Console players can't get these settings at all. | ||
; I get kicked a few seconds after joining | ; I get kicked a few seconds after joining | ||
: The owner has Enforce Mod on. Install ValheimOne on the same 0.13 line as the server, or ask the owner to turn it off. | : The owner has Enforce Mod on. Install ValheimOne on the same 0.13 line as the server, or ask the owner to turn it off. | ||
Bugs in the mod itself go to [https://github.com/HumanGenome/ValheimOne/issues GitHub Issues]. | Bugs in the mod itself go to [https://github.com/HumanGenome/ValheimOne/issues GitHub Issues]. | ||
Latest revision as of 08:52, 17 November 2026
ValheimOne is a free mod that runs on a Valheim dedicated server. The server owner installs it on the server.
Do you need to install anything?
To join, no. A ValheimOne server accepts an unmodded game on PC or console. The live map, the browser console and the Discord alerts all run on the server and need nothing from you.
Some gameplay settings are different. The server owner sets them, but your own game is what applies them. They only work for you when ValheimOne is on your PC as well.
| Works for every player, nothing installed | Only works for players with ValheimOne on their PC |
|---|---|
| How often raids happen, the live map, the browser console, Discord alerts. | Player conveniences (carry weight, auto pickup), Player stamina, Experience rates, Death penalty, Building quality of life, Craft from chest, Station automation, Structural integrity, Container sizes, Wards, Production speeds, Cooking station, Beehive, Fermenter, Sap collector, Fire sources, Item tweaks, Item drop multiplier, Gathering, Food duration, Trader prices, Day/night length, Guardian power timers, Portals, Map sharing, Tames. |
Each player who wants the second column installs ValheimOne. A player without it still joins and plays. They get the normal game values.
On Survival Servers, the cards in Server Config that need ValheimOne on each PC say "Players need ValheimOne on their PC for this".
Note: If the server owner turns on Enforce Mod, the server kicks anyone without ValheimOne about 15 seconds after they join. It's off by default.
Console players
Consoles can't install mods, so there's nothing to install on Xbox, PlayStation 5 or Switch 2.
Console players join a crossplay ValheimOne server like any other server. They can open a shared map link in a browser, and they get everything in the first column of the table.
The settings in the second column never apply to a console player. If Enforce Mod is on, console players can't stay connected, so leave it off on a crossplay server.
Install on PC
These steps are for the Steam version of Valheim on Windows. It takes one download.
- Close Valheim.
- Open the latest ValheimOne release and scroll down to Assets. Download the file that starts with
ValheimOne-full-, for exampleValheimOne-full-0.13.26.zip. - In Steam, right-click Valheim, then Manage, then Browse local files. This opens the game folder, the one with
valheim.exein it. - Extract everything in the zip straight into that folder.
- Start Valheim from Steam the normal way. A second window with scrolling text opens next to the game. That's BepInEx, the mod loader. Leave it open.
- Join the server. It sends its settings to your game when you join. You don't edit any file, and the server doesn't need a restart.
Note: Don't use the green Code button or the Source code links. Those are the source files. There's no mod in them.
After step 4 the game folder should look like this:
Valheim/ ├── BepInEx/ │ ├── config/valheimone.cfg │ ├── core/ │ └── plugins/ValheimOne.dll ├── doorstop_config.ini ├── winhttp.dll ├── valheim.exe └── valheim_Data/
winhttp.dll and the BepInEx folder must sit right next to valheim.exe. If Windows made a folder like ValheimOne-full-0.13.26 inside the game folder, open it and move everything in it up one level.
If you already use BepInEx
The Full zip includes BepInEx. If BepInEx is already in your game folder for other mods, download the zip without "full" in its name, like ValheimOne-0.13.26.zip, instead and extract it into the game folder the same way. It adds two files: BepInEx/plugins/ValheimOne.dll and BepInEx/config/valheimone.cfg.
BepInEx on its own does nothing here. It only loads mods. ValheimOne is the file in BepInEx/plugins.
Linux and Steam Deck
The Full zip also has the Linux loader, for the native Linux version of the game. Extract it into the game folder, then set the Steam launch options for Valheim to ./start_game_bepinex.sh %command%. If the game then starts without mods, make the script executable: chmod u+x start_game_bepinex.sh.
Install with a mod manager
ValheimOne is on Thunderstore, so r2modman and Thunderstore Mod Manager can install it.
- In r2modman or Thunderstore Mod Manager, open your Valheim profile.
- Under Online, search for
ValheimOneand press Download. The manager adds BepInExPack_Valheim with it if your profile doesn't have it yet. - Start the game with Start modded.
For Vortex, the Nexus listing carries the same release. Press Mod Manager Download on the main file, then enable and deploy it.
The file lists BepInEx as its requirement. Check that the version on Nexus matches the GitHub release first.
Note: A mod manager profile and the game folder are two separate installs. Start modded loads the profile, and starting from Steam loads the game folder. Put ValheimOne in the one you launch.
How to tell it worked
- The BepInEx window shows a line like
ValheimOne v0.13.26 startingwhile the game loads. - After you join the server it shows
Sent VO_Hello to serverand thenServer config appliedwith a count of values. - The same lines are saved in
BepInEx/LogOutput.login the game folder. Look there if you have no BepInEx window. - In the game, check one setting the owner changed. Carry weight is the quick one: open your inventory and read the weight limit.
The server owner can check too. The server's own BepInEx/LogOutput.log has one line per player who joins: is modded: handshake ok for a player with ValheimOne, and is vanilla: no VO_Hello received within 15s for a player without it.
The red error at launch
On ValheimOne 0.13.14 and older, every PC install shows red lines in the BepInEx window at launch:
[Error : HarmonyX] Failed to patch void ZPlayFabMatchmaking::CreateLobby ... [Error :ValheimOne] Feature patch application failed: Server:HarmonyException ... Continuing with remaining modules.
It's harmless. ValheimOne is one file for servers and players, and the red lines come from a server-only part: the one that raises the player limit on a dedicated server.
That part tries to change game code a player's copy of Valheim doesn't have. It fails, and the mod carries on. The last line says so.
Every gameplay setting loads before that part, and the settings sync with the server still starts after it. Nothing you play with is lost.
ValheimOne 0.13.15 no longer runs that part on a player's PC, so the red lines are gone. Update and they stop.
Updating
To update ValheimOne, do the install again with the new zip and let it overwrite the old files. Your characters and worlds aren't in the game folder, so they aren't touched.
Your PC and the server must be on the same version line: 0.13 with 0.13. The last number can differ. Some fixes need both sides current, so the safe rule is the latest release on the server and on every PC.
A server on Survival Servers installs the ValheimOne version Survival Servers has set each time it starts or restarts. On a self-hosted server, the owner replaces the file on the server.
After a Valheim patch
A Valheim update can break mods until the mod catches up.
- Check the release page for a release newer than the patch and install it.
- A yellow line that starts
This build targets Valheimmeans the game is newer than the mod was built for. It often still works. If a setting stops working, wait for the next release. - If the game won't start, rename
winhttp.dlltowinhttp.dll.off. The game starts without mods. Rename it back once you have updated.
If the server refuses the connection after a patch, see Valheim Incompatible Version Error. That's caused by the game version, not the mod.
Removing it
Turn it off for now: rename winhttp.dll in the game folder to winhttp.dll.off. Rename it back to turn mods on again.
Remove ValheimOne, keep BepInEx: delete BepInEx/plugins/ValheimOne.dll and BepInEx/config/valheimone.cfg.
Remove everything the Full zip added: delete the BepInEx and doorstop_libs folders, and the files winhttp.dll, doorstop_config.ini, .doorstop_version, changelog.txt, start_game_bepinex.sh and start_server_bepinex.sh.
Your characters and worlds stay. You can still join the same server afterwards, unless Enforce Mod is on.
Troubleshooting
- The owner changed settings and nothing is different in my game
- Your game has no ValheimOne. Check the table at the top. If the setting is in the second column, install the mod.
- I installed BepInEx and nothing changed
- BepInEx only loads mods. ValheimOne is a separate file. Use the Full zip, which has both, or add
ValheimOne.dlltoBepInEx/plugins. - I downloaded ValheimOne from GitHub and there's no ValheimOne.dll in it
- That was the green Code button. It gives you the source files. Use the zip under Assets on the release page.
- I don't know which folder to extract into
- The Valheim game folder: Steam, right-click Valheim, Manage, Browse local files.
winhttp.dllmust end up next tovalheim.exe, not inside another folder. - No BepInEx window opens
winhttp.dllis missing or one folder too deep, or you started the game from a mod manager profile that doesn't have ValheimOne in it.- Red error lines at launch
- Harmless on 0.13.14 and older, gone in 0.13.15. See The red error at launch.
- ValheimOne loads but the settings still don't apply
- This one is on the server. Ask the owner to check three things in Server Config: the card's own first switch (Turn on ...) is on, not only the setting under it. Sync Config under Server & Query > Server controls is on. And the server was restarted after a card was turned on for the first time.
- It works for me but not for my friend
- Every PC needs its own install. Console players can't get these settings at all.
- I get kicked a few seconds after joining
- The owner has Enforce Mod on. Install ValheimOne on the same 0.13 line as the server, or ask the owner to turn it off.
Bugs in the mod itself go to GitHub Issues.