LoxWagon

Turn Haldor's merchant wagon into a functional lox-drawn expedition wagon.

LoxWagon makes the large merchant wagon buildable and usable as a proper Plains-era transport wagon. Hitch it to a tamed lox, ride the lox normally, and haul a large cargo inventory behind you on an articulated four-wheel chassis.

Alpha 0.7.1: Builds on the successfully play-tested articulated chassis and passenger seats. This release changes cargo placement, hide coverage, hitch access, maximum health and cargo mass tuning. These changes need in-game balance and appearance testing. Multiplayer ownership handoff and hitch restoration after reload remain under validation.

Features

• Uses the vanilla Haldor merchant wagon design at runtime. No Iron Gate game assets are distributed with this mod.
• Hitch to a tamed Lox and drive by riding the lox with its normal saddle.
• 1,200 base maximum HP, with normal repair and damage behavior.
• 32-slot cargo hold in an 8 x 4 inventory.
• Four-wheel articulated chassis with approximately:
  • +/-32 degrees of front steering yaw
  • +/-18 degrees of front pitch articulation
  • rear chassis roll locked for stability
• Visible cargo progression as occupied inventory slots increase.
• Fully loaded stage at 31-32 occupied slots with a taut lox-hide cargo cover and tie-downs.
• Two forward-facing passenger seats on the raised front bench.
• Widely spaced shafts that flare outward from the wagon mounts.
• Three larger, overlapping lox hides with varied orientations over the full-load tarp.
• Cargo weight affects handling without making the wagon impractical for lox hauling.
• Uses normal Valheim durability, repair, destruction, storage, and network systems wherever practical.

Build recipe

Build the wagon with the Hammer. No crafting station is required.

• 40 Fine Wood
• 20 Iron Nails
• 10 Black Metal
• 10 Lox Pelt
• 10 Linen Thread
• 10 Tar

Materials are recovered through normal dismantling behavior.

Using the wagon

1. Build the wagon with the Hammer.
2. Bring a tamed lox to the front shafts.
3. Aim anywhere along either shaft, or at the central hitch, and press Use to attach a nearby tamed lox.
4. Mount the lox with its normal saddle and ride normally.
5. Access the wagon inventory from the cargo interaction area.
6. Passengers can use either front bench seat.
7. Interact with either shaft or the central hitch again to detach the lox.

The wagon is lox-drawn by default. Optional player pulling can be enabled in the configuration below.

Cargo visuals

Visible cargo is based on inventory occupancy, not individual item type. As more slots are occupied, additional crates and barrels appear in the wagon bed. At 31-32 occupied slots, the full expedition load and lox-hide cover appear.

The visible cargo is cosmetic and does not add separate physics colliders. Actual cargo weight comes from the inventory mass system.

Requirements

• Valheim 1.0.16
• BepInExPack Valheim 5.4.2351
• Jotunn 2.30.2

When installed through r2modman or Thunderstore Mod Manager, the required package dependencies are declared in manifest.json and should install automatically.

Configuration

The articulated four-wheel chassis is now standard behavior. No diagnostic toggle is required.

BepInEx/config/greypoint.loxwagon.cfg contains:

[Wagon]
AllowHumanPulling = false
BaseChassisMass = 65
CargoMassScale = 0.50

• AllowHumanPulling: when enabled, the hitch uses player pulling instead of lox hitching. Off by default.
• BaseChassisMass: empty wagon mass, distributed across the articulated assembly.
• CargoMassScale: multiplier on vanilla inventory-weight contribution to wagon mass. The new default, 0.50, applies a 50% reduction; empty chassis mass stays at 65.

Restart Valheim after changing settings. Use matching versions and settings on the server and participating clients.

Upgrading

Existing configuration values are preserved. To test the new cargo balance, set CargoMassScale = 0.50 in your existing config and restart the game. This is five times the cargo mass contribution of the previous 0.10 setting.

From 0.6.1

The old Diagnostics.HumanPullTest and Diagnostics.ArticulatedChassisTest entries are removed automatically. Existing base-mass and cargo-mass settings are retained. Player pulling starts disabled under its new name; enable Wagon.AllowHumanPulling if wanted. There is no longer a rigid Cart-chassis option. Existing wagons receive the new maximum health when loaded, but their saved current HP is retained; repair them normally to reach full health.

Multiplayer status

LoxWagon uses a networked wagon root and synchronizes the articulated child chassis through the wagon's ZDO rather than creating a separate network object for every wheel.

The mod remains under controlled multiplayer testing, but the following cases still need broader validation before the mod should be treated as fully server-hardened:

• ownership handoff while hitched
• client disconnect/reconnect while attached
• hitch restoration after server restart or world reload
• simultaneous claims on the same passenger seat under latency

For multiplayer testing, install the same LoxWagon version on the server and every client.

Installation

r2modman / Thunderstore Mod Manager

Search for LoxWagon in the Valheim community and install it with dependencies.

For testing before the listing reaches the mod-manager cache, import the Thunderstore package ZIP as a local mod.

Manual installation

1. Install BepInExPack Valheim and Jotunn.
2. Place LoxWagon.dll under Valheim/BepInEx/plugins/.
3. Keep only one copy of LoxWagon.dll installed.

Compatibility

• BeastsOfBurden: not required. LoxWagon contains compatibility guards intended to prevent BeastsOfBurden from taking over this custom wagon while leaving ordinary carts alone.
• HUDCompass: not required. LoxWagon identifies itself as Wagon through the normal Vagon component.

Current limitations

• Multiplayer ownership transfer and reload-time hitch restoration remain active test areas.
• Passenger seat occupancy uses native-style proximity checks rather than an atomic network reservation.
• Extreme cross-slopes and one-wheel-up terrain have not been exhaustively tested.

About this build

Version 0.7.1 adds roll and pitch to selected crates and settles cargo toward the curved bed or previously placed cargo using conservative mesh-bounds contact checks. It enlarges and rotates the three hides, moves the lox-side attachment forward, and adds interaction targets along both shafts. The accepted seats, bench and wide shaft geometry are retained. Maximum health is now 1,200; saved damage is retained, so repair existing wagons normally.

Significant portions of the code, debugging workflow, validation tooling, and documentation were developed with assistance from OpenAI ChatGPT. The Thunderstore listing should therefore include the AI Generated category.

Building from source

Game assemblies are not bundled. Supply the managed assemblies from your target Valheim installation and BepInEx/core, plus a .NET SDK compiler.

python scripts/build.py --game-managed /path/to/valheim_Data/Managed --bepinex-core /path/to/BepInEx/core --csc /path/to/sdk/Roslyn/bincore/csc.dll --dotnet /path/to/dotnet
python validation/check_geometry.py
python validation/check_tarp.py
python scripts/package_release.py

The ContactCheck.cs harness exercises the actual cargo contact solver with Unity managed vector types. Its assembly resolver uses workspace-relative dependency paths and must be adjusted when run elsewhere.

The packaging script creates one dist/LoxWagon-0.7.1.zip containing the DLL, current documentation, manifest, icon, source and validation tools. Update plugin/manifest versions, README and changelog for each release, then rebuild before packaging. Geometry scripts check authored envelopes; they do not replace in-game rendering and handling tests.