# Install and Configure ValheimPlus on Your Valheim Server (/docs/valheim/install-valheimplus)



import { Tab, Tabs } from 'fumadocs-ui/components/tabs';
import { Step, Steps } from 'fumadocs-ui/components/steps';

ValheimPlus is the most popular Valheim mod — it adds 45+ configurable sections covering gameplay, building, crafting, and server management. It requires **BepInEx** and must be installed on both the server and every connecting client.

> **Use the Grantapher fork.** The original ValheimPlus is no longer maintained. The active version is the [Grantapher community fork](https://thunderstore.io/c/valheim/p/Grantapher/ValheimPlus_Grantapher_Temporary/) on Thunderstore. Don't install the abandoned upstream version — it's incompatible with current Valheim.

Install ValheimPlus [#install-valheimplus]

<Tabs items={['Via Panel Mod Manager (Recommended)', 'Manual Install']}>
  <Tab value="Via Panel Mod Manager (Recommended)">
    <Steps>
      <Step>
        Enable BepInEx mode [#enable-bepinex-mode]

        In the [XGamingServer Panel](https://panel.xgamingserver.com), click **Mods** in the sidebar. Switch to **BepInEx** mode if you haven't already. See [Install Mods](/docs/valheim/mod-setup) for details.
      </Step>

      <Step>
        Search and install [#search-and-install]

        In the **Browse Mods** tab, search for **ValheimPlus Grantapher**. Click **Install** on the matching mod.
      </Step>

      <Step>
        Restart the server [#restart-the-server]

        Go to **Console** and restart for the mod to load.
      </Step>

      <Step>
        Tell players to install it too [#tell-players-to-install-it-too]

        Every player must install the **same Grantapher fork version** on their client using [r2modman](https://thunderstore.io/c/valheim/p/ebkr/r2modman/).
      </Step>
    </Steps>
  </Tab>

  <Tab value="Manual Install">
    <Steps>
      <Step>
        Download the mod [#download-the-mod]

        Get the Grantapher fork from [Thunderstore](https://thunderstore.io/c/valheim/p/Grantapher/ValheimPlus_Grantapher_Temporary/). Extract the ZIP.
      </Step>

      <Step>
        Stop the server [#stop-the-server]
      </Step>

      <Step>
        Upload to BepInEx/plugins [#upload-to-bepinexplugins]

        Click **Files** in the panel sidebar and navigate to `BepInEx/plugins/`. Upload the extracted mod files.
      </Step>

      <Step>
        Start the server [#start-the-server]

        ValheimPlus loads on startup. Tell players to install the same version client-side via r2modman.
      </Step>
    </Steps>
  </Tab>
</Tabs>

> **Warning:** Players without ValheimPlus cannot connect to a server running it. **Xbox / crossplay players cannot use ValheimPlus** — they have no way to install client-side mods.

Configure ValheimPlus [#configure-valheimplus]

After the first start with ValheimPlus loaded, a config file is generated at `BepInEx/config/valheim_plus.cfg`.

<Steps>
  <Step>
    Stop the server [#stop-the-server-1]

    Go to **Console** and stop your server.
  </Step>

  <Step>
    Open valheim_plus.cfg [#open-valheim_pluscfg]

    Click **Files** in the panel sidebar and open `BepInEx/config/valheim_plus.cfg`.
  </Step>

  <Step>
    Enable sections you want [#enable-sections-you-want]

    Each section is **disabled by default**. Set `enabled=true` to activate it. Example:

    ```ini
    [Server]
    enabled=true
    enforceMod=true
    ```
  </Step>

  <Step>
    Save and start [#save-and-start]

    Click **Save Content** and start the server from **Console**.
  </Step>
</Steps>

How Modifiers Work [#how-modifiers-work]

Most numerical values use a **percentage modifier** system:

* **Positive value** = increase. `50` means +50%
* **Negative value** = decrease. `-50` means -50%
* **Zero** = no change from vanilla

Example: `dodgeStaminaUsage=-30` means 30% **less** stamina used for dodging.

All Config Sections (45 Total) [#all-config-sections-45-total]

ValheimPlus has 45 configurable sections. Here are the most popular ones with examples:

Server [#server]

```ini title="valheim_plus.cfg"
[Server]
enabled=true
enforceMod=true
maxPlayers=20
dataRate=512
```

* `enforceMod` — require all clients to have ValheimPlus
* `maxPlayers` — override the 10-player cap
* `dataRate` — network data rate (higher = smoother, more bandwidth)

Map Sharing [#map-sharing]

```ini title="valheim_plus.cfg"
[Map]
enabled=true
shareMapProgression=true
exploreRadius=100
```

Automatically share map exploration between all players.

Craft From Containers [#craft-from-containers]

```ini title="valheim_plus.cfg"
[CraftFromChest]
enabled=true
range=20
```

Pull crafting materials from nearby chests automatically.

Advanced Building [#advanced-building]

```ini title="valheim_plus.cfg"
[AdvancedBuildingMode]
enabled=true

[FreePlacementRotation]
enabled=true
```

Precise placement and rotation of building pieces.

Production Speed [#production-speed]

```ini title="valheim_plus.cfg"
[Kiln]
enabled=true
productionSpeed=10

[Smelter]
enabled=true
productionSpeed=15
maximumItemsAllowed=30

[Fermenter]
enabled=true
fermenterDuration=1200

[Beehive]
enabled=true
honeyProductionSpeed=600
```

Speed up coal, smelting, fermenting, and honey production.

Inventory and Items [#inventory-and-items]

```ini title="valheim_plus.cfg"
[Inventory]
enabled=true
playerInventoryRows=5

[Items]
enabled=true
noTeleportPrevention=true
```

Expand inventory size. `noTeleportPrevention=true` allows ores through portals.

Player Stats [#player-stats]

```ini title="valheim_plus.cfg"
[Player]
enabled=true
baseMaxHealth=50
baseMaxStamina=75

[StaminaUsage]
enabled=true
dodge=-30
swim=-50

[Experience]
enabled=true
woodCutting=50
```

Values under `[Player]` are **bonus** amounts added to the base stats. Experience values are percentage modifiers (+50% = level 50% faster).

Building Stability [#building-stability]

```ini title="valheim_plus.cfg"
[StructuralIntegrity]
enabled=true
disableStructuralIntegrity=true
```

Disable building piece stability checks for creative building.

Ward Protection [#ward-protection]

```ini title="valheim_plus.cfg"
[Ward]
enabled=true
wardRange=30
```

Food Duration [#food-duration]

```ini title="valheim_plus.cfg"
[Food]
enabled=true
foodDurationMultiplier=50
```

+50% longer food duration.

Workbench Range [#workbench-range]

```ini title="valheim_plus.cfg"
[Workbench]
enabled=true
workbenchRange=30
workbenchAttachmentRange=10
```

Game Clock [#game-clock]

```ini title="valheim_plus.cfg"
[GameClock]
enabled=true
```

Shows the in-game time on your HUD.

Camera [#camera]

```ini title="valheim_plus.cfg"
[Camera]
enabled=true
cameraMaximumZoomDistance=10
cameraBoatMaximumZoomDistance=10
```

All Section Names [#all-section-names]

The full list of 45 config sections: `ValheimPlus`, `AdvancedBuildingMode`, `AdvancedEditingMode`, `Armor`, `Bed`, `Beehive`, `Brightness`, `Building`, `Camera`, `Chat`, `CraftFromChest`, `Durability`, `Experience`, `Fermenter`, `FireSource`, `FirstPerson`, `Food`, `FreePlacementRotation`, `Furnace`, `Game`, `GameClock`, `Gathering`, `GridAlignment`, `Hotkeys`, `Hud`, `Inventory`, `Items`, `Kiln`, `Map`, `MonsterProjectile`, `Pickable`, `Player`, `PlayerProjectile`, `Server`, `Shields`, `Smelter`, `SpinningWheel`, `Stamina`, `StaminaUsage`, `StructuralIntegrity`, `Tameable`, `Wagon`, `Ward`, `Windmill`, `Workbench`

Config Sync [#config-sync]

ValheimPlus automatically syncs the server's config to all connecting clients. Players don't need to manually update their configs — they receive the server settings on connect.

Alternatives to ValheimPlus [#alternatives-to-valheimplus]

If you prefer modular mods instead of one large mod, the community maintains a [ValheimPlus Replacements list](https://github.com/AzumattDev/Valheim-Plus-Replacements) with individual mods for each V+ feature:

* **Craft From Containers** — standalone crafting mod
* **Infinity Hammer** / **Gizmo** — advanced building
* **AzuSkillTweaks** — XP modifiers
* **ConversionSizeAndSpeed** — smelter/kiln/fermenter tweaks

The advantage: individual mods often update faster after game patches.

Troubleshooting [#troubleshooting]

Players Can't Connect [#players-cant-connect]

* Verify all players have the same ValheimPlus version (Grantapher fork)
* Check that `enforceMod=true` is set in `[Server]`
* Ensure clients installed the mod through r2modman

Settings Not Applying [#settings-not-applying]

* Make sure the section has `enabled=true`
* Check for typos in the config file
* Restart the server (config is read on startup)

Server Crashes [#server-crashes]

* Check the console for error messages
* Disable recently changed sections one at a time
* Update to the latest Grantapher fork version

Related Guides [#related-guides]

See also: [Install Mods](/docs/valheim/mod-setup) | [Recommended Mods](/docs/valheim/recommended-mods) | [Server Performance](/docs/valheim/server-performance) | [Increase Player Limit](/docs/valheim/increase-player-limit)

If you need help, join our [Discord](https://discord.xgamingserver.com/).