# Configure Portal Settings on Your Valheim Server (/docs/valheim/portals-configuration)



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

Valheim's vanilla portals **block ores and metals** from being teleported. This forces players to transport resources by land or sea, which is a core gameplay mechanic. You can change this with the `portals` world modifier or with ValheimPlus.

What's Blocked by Default [#whats-blocked-by-default]

| Item Type                                     | Vanilla Restriction |
| --------------------------------------------- | ------------------- |
| Ores (Copper, Tin, Iron, Silver, Black Metal) | Cannot transport    |
| Metal bars and ingots                         | Cannot transport    |
| Dragon eggs                                   | Cannot transport    |
| Flametal ore                                  | Cannot transport    |
| Everything else                               | Allowed             |

Change Portal Restrictions with World Modifiers [#change-portal-restrictions-with-world-modifiers]

<Tabs items={['Via Startup', 'Via Console (Admin)']}>
  <Tab value="Via Startup">
    <Steps>
      <Step>
        Open Startup [#open-startup]

        In the [XGamingServer Panel](https://panel.xgamingserver.com), click **Startup** in the sidebar.
      </Step>

      <Step>
        Add the portals modifier [#add-the-portals-modifier]

        Add to the startup parameters:

        ```
        -modifier portals casual
        ```

        | Value       | Effect                                                |
        | ----------- | ----------------------------------------------------- |
        | `casual`    | **All items** can go through portals (including ores) |
        | *(default)* | Standard restrictions (no ores/metals)                |
        | `hard`      | More items are restricted                             |
        | `veryhard`  | Most items cannot go through portals                  |
      </Step>

      <Step>
        Restart the server [#restart-the-server]
      </Step>
    </Steps>
  </Tab>

  <Tab value="Via Console (Admin)">
    If you have admin and dev commands enabled:

    ```
    setworldmodifier portals casual
    save
    ```

    This applies the change immediately without restarting. The new value persists across server restarts.
  </Tab>
</Tabs>

Allow Ores Through Portals [#allow-ores-through-portals]

For casual servers that want unrestricted portal travel, set the modifier to `casual`. This is the most popular non-vanilla portal setting.

Make Portals More Restrictive [#make-portals-more-restrictive]

For hardcore servers:

```
-modifier portals veryhard
```

Or:

```
setworldmodifier portals veryhard
save
```

This blocks additional items, making sea/land logistics even more important.

ValheimPlus Portal Control [#valheimplus-portal-control]

ValheimPlus offers more granular control. In `BepInEx/config/valheim_plus.cfg`:

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

Setting `noTeleportPrevention = true` allows all items through portals, equivalent to the `casual` modifier. ValheimPlus also lets you whitelist specific items rather than enabling everything.

See [Install ValheimPlus](/docs/valheim/install-valheimplus).

Portal Tips for Players [#portal-tips-for-players]

* **Tag your portals** — give portal pairs matching tags (e.g., `base`, `swamp`, `mountain`)
* **Build a portal hub** — central room with portals to every destination
* **Label destinations** — use signs next to portals so players know where they go

Related Guides [#related-guides]

* [World Modifiers](/docs/valheim/world-modifiers)
* [Difficulty Presets](/docs/valheim/difficulty-presets)
* [Install ValheimPlus](/docs/valheim/install-valheimplus)