Treadwell

Build roads worth taking.

Treadwell is a focused, vanilla-plus movement mod that gives Valheim's constructed roads a practical payoff:

• Dirt paths: 10% faster sprinting and 10% less sprint-stamina use by default.
• Paved roads: 20% faster sprinting and 20% less sprint-stamina use by default.
• Each of the four bonuses is independently configurable from 0% to 100%.

Only the local player's sprinting on vanilla terrain-painted paths is changed. Walking, sneaking, swimming, jumping, dodging, attacks, carts, creatures, natural terrain, cultivated soil, and building floors are untouched. A short edge-smoothing window prevents bonuses from flickering across tiny gaps in road paint, while cultivated soil, floors, leaving the ground, and other non-terrain surfaces clear them immediately.

Treadwell has no status icon, popup, sound, gameplay message, world-state change, or server requirement.

Installation

Install with r2modman or Thunderstore Mod Manager, or extract plugins/Treadwell/Treadwell.dll into your Valheim installation's BepInEx/plugins/Treadwell/ directory.

BepInExPack for Valheim 5.4.2350 is required.

Each player who wants the bonuses installs Treadwell on their own client. No server installation or configuration synchronization is required.

Configuration

Treadwell creates five settings in BepInEx/config/com.jstack424.treadwell.cfg:

• Master enable
• Dirt sprint-speed bonus percentage (default 10%)
• Dirt sprint-stamina reduction percentage (default 10%)
• Paved sprint-speed bonus percentage (default 20%)
• Paved sprint-stamina reduction percentage (default 20%)

All percentages are independently constrained to 0–100 and are read live.

If you used an earlier test build, BepInEx may retain its older values. Delete BepInEx/config/com.jstack424.treadwell.cfg once to regenerate the current defaults, or set the four percentages manually to 10, 10, 20, and 20.

Compatibility and safety

Treadwell 0.1.0 supports exactly Valheim 1.0.12 / Steam build 25253764. It validates the pinned runtime, movement hooks, terrain APIs, and paint encodings before installing either Harmony patch. An unverified game update disables Treadwell and logs the reason instead of applying uncertain movement changes.

The core road bonuses have been live-tested in Valheim. Multiplayer behavior has not yet been independently verified, and future game versions are not assumed compatible.

Source and issues

https://github.com/JStack424/Treadwell

Licensed under the MIT License.

Changelog

0.1.2

• Replaced exact runtime game-version, assembly SHA-256, and MVID blocking with a contract-based compatibility gate, so compatible client/server builds and minor Valheim patches are not disabled solely because their build identity differs.
• Kept pinned assembly hashes and MVIDs as build/reference provenance checks only.
• Added exact, unique runtime checks for every patched target, Harmony constructor/API and patch method, accessed game member, and Unity road-discovery contract; missing or ambiguous signatures still fail closed before Harmony construction or gameplay-hook installation.
• Strengthened transactional patch rollback so every cleanup step runs, gameplay entrypoints are cleared, the owned Paved Road station is restored, and incomplete restoration state is retained for a safe cleanup retry before Treadwell remains disabled.
• Preserved all paved-road placement, movement, configuration, multiplayer, and client-only behavior unchanged.

0.1.1

Release package prepared with the exact DLL bytes supplied for live validation.

• Revalidated unchanged 0.1.1 gameplay and configuration against Valheim 1.0.14, anonymous Steam dedicated-server build 25364309, and Unity 6000.0.75f1.
• Updated the fail-closed runtime fingerprint, private reference bundle, metadata/IL contracts, documentation, and deterministic test package.
• Added Paved roads without stonecutter, enabled by default, so the vanilla paved-road terrain piece can be placed outside stonecutter range.
• Replaced the unsuccessful requirement-check bypass with a direct, local recipe edit: the exact Paved Road piece's crafting-station reference is removed as Valheim enters place mode, before its piece table refreshes, and immediately before vanilla requirement checks.
• Fixed a second test-build failure caused by incorrectly requiring the live station object to carry exact stonecutter prefab and display identifiers; Treadwell now captures and clears whatever non-null station reference is attached to the exact Paved Road piece.
• Replaced brittle paved_road / $piece_pavedroad identity gates after live diagnostics proved the active entry did not match both guessed names. Discovery now uses the pinned root-Piece table structure plus one paved terrain operation, a station requirement, and one single-unit Stone resource requirement; Paved Road and station names are diagnostic only; the expected Stone resource prefab remains part of the semantic constraint.
• Traverses child components for terrain operations, requires exactly one semantic candidate, and fails closed on zero or multiple matches.
• Preserved and safely restored the captured station reference when the option is disabled, the scene unloads, or Treadwell shuts down.
• Added one-time bounded BepInEx diagnostics for successful semantic selection and for zero/ambiguous matches, including sanitized candidate shapes and names without adding in-game messages.
• Kept the normal stone cost, unlock knowledge, placement checks, hoe stamina and durability, effects, repairs, and every unrelated piece or crafting station unchanged.
• Added regression coverage for station/name independence, semantic discovery, zero/multiple-match rejection, nested terrain shapes, real place-mode and placement-check lifecycles, restoration, piece-table reloads, runtime conflicts, and setting changes.

0.1.0

Initial public release.

• Added configurable sprint bonuses for vanilla dirt paths: 10% more speed and 10% less sprint-stamina use by default.
• Added independently configurable paved-road bonuses: 20% more speed and 20% less sprint-stamina use by default.
• Constrained all four percentage settings to 0–100 and included a master enable switch.
• Preserved Valheim's Run skill, equipment, status-effect, and global movement calculations by applying multiplicative modifiers.
• Added short path-edge smoothing with immediate clearing on cultivated soil, floors, non-terrain surfaces, and leaving the ground.
• Limited all effects to the local player while sprinting; carts, creatures, other movement actions, UI, sounds, and world state are unchanged.
• Added exact fail-closed compatibility checks for Valheim 1.0.12 / Steam build 25253764.
• Live-tested the core road bonuses in Valheim.
• Added pure behavior tests, independent assembly-contract tests, pinned reference verification, deterministic packaging, and an exact five-file package audit.