Wagonborn

Your wagon is a truck now.

By BlackHearthx

Pull a moving cart and the road starts teaching you. Friends who shove from behind learn the same craft. Haul far, take the cart through the portal with you.

Wagonborn is a hauler’s skill pack for vanilla carts — no fancy new wagon models, just weight that answers to practice, crew help, and a cart that stays with the caravan.

Compat: If you also use TeleportEverything, that mod handles cart portals. If you also use BetterCarts, that mod handles buddy mass (helpers still earn Hauling here).

What you get

Your first session

1. Install with a mod manager (Thunderstore / r2modman). Jötunn comes with it.
2. Load a world, look at a cart, hitch with Use (E).
3. Walk while hitched. Standing still does not train.
4. Open skills — Hauling (Carreto) appears after the first XP.
5. Hover the cart to see level, pull weight, and portal note.
6. Take a portal while hitched — cart should arrive with you.

How to play

Heavier moving loads train faster. At Hauling 100, pull weight can drop by up to half — hills still matter.

In co-op, stand near a friend who is pulling. The cart gets lighter for them, and you earn Hauling while it moves. Up to four helpers count.

Controls at a glance

Compat and notes

• Host and every client need the mod.
• Do not stack BetterCarts buddy-mass options with Wagonborn’s Crew section (Wagonborn soft-defers if BetterCarts is loaded).
• TeleportEverything owns cart portal transport when both are present.
• Vanilla cart look stays vanilla.

Como usar (PT-BR)

1. Instale pelo gerenciador de mods (Jötunn vem junto).
2. Olhe a carroça e use E para acoplar / soltar.
3. Ande puxando — parado não sobe Carreto.
4. Amigos perto aliviam o peso e também sobem Carreto.
5. Portal com a carroça acoplada: ela viaja e reatacha na chegada.

Requirements

• BepInExPack Valheim
• Jötunn

Config

After first launch: BepInEx/config/com.blackhearthx.wagonborn.cfg

Identity

Do not change the GUID or skill id after release.

Changelog

1.3.3

• Hauling no longer resets after playing the character without Wagonborn (mod turned off or another mod profile). The level is kept in a backup and comes back the next time you load in with the mod

1.3.2

• Hover cleanup: compact lines, no raw $KEY_* tokens
• Map toggle is Shift+E (Valheim AltPlace), not Alt+E
• Buddy tip only when someone is helping; softer pin messages
• Parked carts no longer count you as a helper (no fake "1 nearby", no free weight cut)
• Shift+E no longer takes the cart from a friend who is pulling it; hidden pins are per player now
• Carts stay on the map when you walk away (last known spot; the host sees every cart)
• Hauling XP now scales with the real load, so it no longer drops as your skill rises; helpers earn it reliably in co-op
• Weight updates right away on hitch and unhitch instead of up to 5 seconds later
• A cart can no longer stay frozen after a portal if the re-hitch misses
• Steady hitch leash works even with portal transport turned off
• Map and buddy lines translated into all 20 languages
• Config: WeightXpScale replaced by LoadXpScale (240); MaxSkillMassReduction capped at 0.8

1.3.1

• Every cart is on the map by default; Alt+Use hides or shows that cart only (each pin is independent)

1.3.0

• Live map pin for carts (same idea as Hearthwife): moves in real time on the minimap and world map
• Alt+Use on a cart to mark or clear; hitching can auto-mark (config)
• Wheel icon on the pin so it reads as a cart, not a generic mark

1.2.2

• Removed the V hotkey hitch — attach and detach with Use (E) only

1.2.1

• Unhitch reliably: hotkey always drops the cart you are pulling (even when it is behind you)
• Out-of-place hitch no longer glues the cart within attach range
• Longer pull leash uses a finite distance (default 8 m) instead of never auto-dropping

1.2.0

• Hotkey attach / detach nearby carts (default V), even when a bit off the hitch
• Buddy help: friends near a pulled cart lighten the load
• Helpers also earn Hauling XP while the cart is moving
• Soft-defers hotkey + buddy mass to BetterCarts if that mod is loaded

1.1.0

• Attached cart teleports with you through portals and dungeon rune stones
• Cart re-attaches on arrival; exit point nudged forward so the cart fits
• Optional: cart no longer auto-detaches when you drift a few meters while pulling
• Defers to TeleportEverything if that mod is also installed (no double transport)

1.0.3

• Cache the attached cart for XP (no full-scene scan every frame)
• Guard XP until the Hauling skill is registered
• Safer cart hover text if localization is not ready
• Deploy path targets the Default Thunderstore profile

1.0.2

• Package icon with Wagonborn / Hauling Skill / blackhearthx identity

1.0.1

• Cart/wheel skill icon
• Extra language translations

1.0.0

• Hauling skill (Carreto): pull a moving cart to level up
• Higher skill makes carts easier to pull
• No visual cart upgrades