LoxCarts

Build a lox-drawn cargo carrier or a covered travelling camp using Valheim's native models and materials.

LoxCarts is a fork of greypoint's LoxWagon, updated for Valheim 1.0+. The original 0.11.0 predates the 1.0 game update; this fork fixes every game-API change 1.0 introduced and continues development under the Stew_and_Brew_Labs team. All credit for the wagon design, geometry and artwork goes to the original author.

Worlds and wagons carry over: build-piece names, network prefab identities and saved data are identical to upstream 0.11.0, so existing wagons load with their inventory, damage and customization. Your old greypoint.loxwagon.cfg is migrated to the fork's config on first launch.

Both wagons have an articulated four-wheel chassis, a tamed-lox hitch, configurable cargo weight and optional flotation. Their visible cargo changes with the number of occupied inventory slots.

What changed for Valheim 1.0

• Rebuilt against the current 1.0+ game assemblies and updated for every API move 1.0 introduced (nested types, new Interactable.UseItem signature, stricter engine checks).
• Covered by a test suite that pins every game API the mod touches, so future game updates fail a test instead of silently breaking the mod.
• Fork identity: plugin GUID benjamin.loxcarts, display name LoxCarts. In-game piece names, prefabs and saved data are unchanged.

Everything else — recipes, storage, mass, physics, furnishings, cartography, lanterns, banner and cover toggles — is unchanged from upstream 0.11.0. See CHANGELOG.md for details.

Building a wagon

Both Cargo Wagon and Nomad Wagon appear in the Hammer menu. Neither requires a crafting station. Construction materials are recoverable through normal dismantling.

Hitching and riding

1. Bring a tamed lox to the front of the wagon.
2. Aim at either wooden shaft or the central hitch and press Use to attach it.
3. Mount the lox with its normal saddle and ride to pull the wagon.
4. Use a shaft or the central hitch again to detach.

Passengers can use the bench seats. To enter the upright Nomad cabin, jump onto the rear steps or use Climb Aboard. Unhitching is not required.

If a wagon overturns, detach the puller and have passengers dismount. Aim at the wagon and follow Right wagon, using alternate place + Use, normally Left Shift + E. Recovery needs enough space and reasonably level, solid ground. It preserves cargo and damage and leaves the wagon detached.

Using the Nomad Wagon

• Inventory: use the wooden chest just inside the rear opening on the workbench side. It opens the wagon's single 24-slot hold.
• Workbench: craft, repair and build within its normal station range. Nearby workbench upgrades can improve it.
• Bed: stop and unhitch, then use the bed to sleep. Alternate place + Use lets you lie down while hitched without skipping the night. Normal night, fire, enemy and wetness checks apply to sleeping. Your respawn point stays unchanged.
• Cartography: use the red ink bowl to record discoveries, or the map to read shared discoveries. Map data is saved separately for each wagon, independently of its inventory.
• Lanterns: turn the interior and rear lanterns on or off independently. They need no fuel and do not provide campfire heat.
• Cover: use the rolled hide over the rear opening to hide or restore the roof and front covering together.
• Banner: use the end of the skinny upper starboard pole to cycle through native banners and None. The pole extension appears with a banner.

Lantern, cover and banner choices are saved per wagon. The upright covered cabin supplies shelter and a minimum of comfort 5, preserving higher comfort from nearby objects. Normal resting requirements still apply. Removing the cover removes the wagon's shelter contribution and its roof/front-hide collision.

Furnishings, front provisions and lights remain when the inventory is empty. Extra cargo appears as slots fill and disappears as they empty. Independent native spice-rack strands appear progressively at 5, 13 and 24 occupied slots. The Cargo Wagon's full-load hide cover appears at 31–32 occupied slots; the Nomad's cabin cover is independent of its inventory.

Configuration

Close the game before editing BepInEx/config/benjamin.loxcarts.cfg, then restart. These settings apply to both wagons. Existing values are retained when updating (upstream greypoint.loxwagon.cfg values are migrated automatically).

Total mass is the empty mass plus inventory weight × CargoMassScale. With the defaults, 1,000 inventory weight produces a total mass of 365 for the Cargo Wagon and 400 for the Nomad. Heavier loads are harder to pull.

Flotation provides buoyancy only; the wagon has no sailing controls or boat propulsion. Set FloatOnWater to false to disable it.

Installation

Install via r2modman, Gale or Thunderstore Mod Manager (Stew_and_Brew_Labs-LoxCarts), including these dependencies:

• BepInExPack Valheim 5.4.2351
• Jötunn 2.30.2

If you previously installed the upstream LoxWagon, remove it before installing LoxCarts — keep only one copy of the mod. Existing wagons in your worlds keep working.

Manual installation: install the dependencies and place LoxCarts.dll in Valheim/BepInEx/plugins/.

Updating and reporting problems

Update through your mod manager, or close Valheim and replace the DLL manually. Cargo and 24-slot Nomad inventories use the game's normal save system.

When reporting a problem, include the mod version, what happened, steps to reproduce it and BepInEx/LogOutput.log. Screenshots are useful for geometry or material problems. See CHANGELOG.md for changes.

Current limitations

• Multiplayer validation remains outstanding (inherited from upstream).
• Collision uses simplified shapes. Small gaps and fur edges are not exact collision surfaces.
• Extreme slopes and obstacles can tip the wagon. Recovery may require clearer, more level ground.
• Visible wheel rotation is not animated.
• The rear roll toggles the cabin cover; it does not unroll across the rear doorway.

BeastsOfBurden and HUDCompass compatibility handling is carried over from upstream; neither is required.

Credits

• greypoint — original LoxWagon design, artwork and implementation.
• LoxCarts uses Valheim's models and materials at runtime. No game assemblies or textures are distributed.
• Fork maintained by benjamin.

Building from source, test suite and dockerized server tooling: see DEVELOPMENT.md.