LoxWagon

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

0.11.2 is a public testing release for Thunderstore. LoxWagon is pre-1.0 and intended for continued singleplayer testing. Multiplayer is unverified and is not supported for this release.

	Cargo Wagon	Nomad Wagon
Storage	32 slots, 8 × 4	24 slots, 6 × 4
Maximum health	1,200	3,600
Default empty mass	65	100
Passenger seats	Two front, one rear	Two front
Equipment	Visible crates, barrels and a full-load hide cover	Covered cabin, bed, workbench, cartography table, lanterns and spare wheel

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.

New in 0.11.2

Snow on wooden and cloth surfaces now uses a light, textured dusting fitted to upward-facing geometry. This covers exposed cabin surfaces with the tarp removed without turning the cartography table white from top to bottom. Roof-edge backing also receives snow, and the rear coverage boundary no longer switches whole triangles on and off. The accepted lox-fur roof shape and snow treatment are retained. Snow remains limited to Mountain and Deep North; the shield stays snow-free.

Remote wagon bodies and articulated parts now follow one smoothed motion path, with bounded prediction and explicit physics handoffs. Seat and cabin prompts use the same interaction reach as their actions. The Cargo Wagon's standing contacts follow its curved wood floor, and both vehicle labels use Wagon while keeping distinct Hammer-menu names.

Spare-wheel rail loops fit the actual rail cross-section with rounded corners and shorter, gently sagging returns. The accepted spoke wraps, wheel position and cargo sway are unchanged.

Both wagon inventories remain public, with one person editing at a time. A passenger can open storage while another player rides the attached lox, without taking physics control from the driver. All participating players must install the same mod version.

Installation

Install with Thunderstore Mod Manager or r2modman, including these dependencies:

BepInExPack Valheim 5.4.2351
Jötunn 2.30.2

For a manual installation, install the dependencies and place LoxWagon.dll in Valheim/BepInEx/plugins/. Keep only one copy of the DLL installed. Launch the game once to create BepInEx/config/greypoint.loxwagon.cfg.

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.

Material	Cargo Wagon	Nomad Wagon
Fine Wood	80	120
Core Wood	30	80
Iron Nails	80	160
Barrel Hoops	4	8
Lox Pelts	16	24
Linen Thread	8	24

Hitching and riding

Bring a tamed lox to the front of the wagon.
Aim at either wooden shaft or the central hitch and press Use to attach it.
Mount the lox with its normal saddle and ride to pull the wagon.
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 solid footing and clear space for the body and shafts. Small bumps and slopes are tolerated; wagon passengers still need to dismount. 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. Appearance follows occupied slots, independently of item type, stack size or weight. 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/greypoint.loxwagon.cfg, then restart. These settings apply to both wagons. Existing configuration values are retained when updating.

Setting under `[Wagon]`	Default	Effect
`AllowHumanPulling`	`false`	Enables player pulling at the hitch.
`BaseChassisMass`	`65`	Cargo empty mass, clamped to 30–200. The furnished Nomad adds 35.
`CargoMassScale`	`0.30`	Mass added per unit of inventory weight, clamped to 0–1.
`FloatOnWater`	`true`	Enables buoyancy, with the wheels and axles underwater.

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. Existing Nomads use the increased base mass when reconstructed after updating.

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

Updating and reporting problems

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

Older 32-slot Nomad test builds: empty those wagons before updating. Automatic conversion and temporary overflow rows have been removed.

For this release, prioritize uncovered cabin snow, readable map/wood textures, the roof's front edge, rear steps, wheel-rope contact and standing height in the empty Cargo Wagon. Check interaction reach at seats and steps. Experimental multiplayer testing should compare remote motion during travel and driver handoffs, then verify passenger inventory edits and item counts after save/reload. Back up the world and characters; matching mod versions are required and multiplayer is not yet approved.

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

This is a pre-1.0 singleplayer test release; multiplayer validation remains outstanding.
Cabin materials, prop placement and movement are still being refined.
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 are optional. Existing compatibility handling remains, but neither is required.

Credits

LoxWagon uses Valheim's models and materials at runtime. No game assemblies or textures are distributed.

Developed with assistance from OpenAI ChatGPT in programming, debugging and documentation.