TeleportCarts

TeleportCarts

Take your loaded cart through portals without unloading it first. Travel with an attached cart, or use a shortcut to bring a nearby one. Compatible with Valheim 1.0 (Deep North).

<kbd>Left Shift</kbd> + <kbd>C</kbd> — Hover over a portal or dungeon entrance to bring a nearby unattached cart.

TeleportCarts supports attached carts and a shortcut for nearby unattached carts.

• Travel with an attached cart through allowed transitions.
• Bring a nearby unattached cart with a shortcut.
• Keep Valheim's native cargo restrictions in effect.

The shortcut hint appears only at a usable entrance when both server settings and your personal settings allow that transition. Pressing the shortcut checks the nearest eligible cart again.

Getting started

Install BepInExPack for Valheim and install TeleportCarts on the server and participating clients. For easier installation, use Gale. TeleportEverything adds an in-game settings panel but is optional.

For manual installation, place TeleportCarts.dll in Valheim/BepInEx/plugins/.

Attached carts travel when cart transport is allowed for that transition. To bring a nearby unattached cart, hover over a portal or dungeon entrance and press Left Shift + C (default). You can change the shortcut in ConfigurationManager.

Configuration

With TeleportEverything, open My Settings → Carts for your preferences and Server Settings → Carts for server policy. Only the host or a native server admin can save server changes. Use Save module for Carts or Save All for changed modules in the current scope. Reset defaults stages defaults until saved; Refresh reads saved settings and asks before replacing changed drafts.

The server policy is BepInEx/config/odinplus.TeleportCarts.server.yml; each player has a local preference at BepInEx/config/odinplus.TeleportCarts.yml. The server controls the maximum behavior, and player choices may only restrict it. Cart cargo always follows Valheim's native portal rules. Invalid YAML leaves the last valid policy active.

Edit the files directly or use ConfigurationManager's YAML Editor button. The server policy can be edited by the server host.

SchemaVersion: 1
Carts:
  Enabled: true
  Teleport:
    Portals:
      Enabled: true
    Dungeons:
      Enabled: true
    Basements:
      Enabled: true

SchemaVersion: 1
Carts:
  Enabled: true
  # Maximum distance from the player to detect an eligible cart, in metres.
  SearchRadius: 10
  Teleport:
    Portals:
      Enabled: true
    Dungeons:
      Enabled: true
    Basements:
      Enabled: true
Placement:
  # Moves the player forward on arrival so an attached cart can reattach, in metres.
  ForwardOffset: 0.8

The server owns the search and placement limits; player settings cannot increase them. Restricted cargo may prevent a cart from passing through a wood portal. The world settings noportals and nobossportals during a boss event also prevent cart transport.

Compatibility

| Compatible | Mod | Info | | --- | --- | --- | | Yes | TeleportEverything / TeleportBoats / TeleportCreatures | Modules can be installed together and own separate transport behavior. | | Yes | QuickTeleport | Works alongside its transition settings. | | Yes | TargetPortal | The selected destination is respected. | | Yes | CraftyCarts | Their carts can participate in cart transport. | | Yes | QuickCart | This mod adds a quick cart attachment key. | | Yes | Basements / OdinsUndercroft | Cart transitions are supported when installed. |

Troubleshooting

• Cart stayed behind: check that cart transport and the current transition are enabled for the server and your preferences.
• Cart would not pass through a portal: restricted cargo still obeys the world's portal rules. Try a portal that allows the items or unload the restricted cargo.
• Cart arrived detached: enable Enable Cart Teleport Diagnostics in ConfigurationManager and include the relevant log when asking for help.
• YAML was rejected: correct the file and save again. The last valid policy remains active.

Languages

In-game text follows the selected Valheim language: English · French · German · Brazilian Portuguese · Russian · Spanish

Support

TeleportCarts is free. If you’d like to support maintenance and future development, you can leave an optional tip on Ko-fi.

For help, find Elg in the Odin Plus Discord.