Valheim
You are viewing a potentially older version of this package. View Latest Version
Install with App

Details

Date Uploaded
Downloads
213
Size
68KB
ADDatHost Valheim hosting
30% off

Pedal Bike 0.1.4

A single-rider timber bicycle for Valheim with a rear chest, stamina-powered pedaling and assisted handling. Build it with Wood x20 + Bronze Nails x5 using the normal Hammer's Crafting category, within Workbench range.

New riding behavior

  • 37 km/h normal pedaling and 42 km/h Shift sprint targets on level, unobstructed ground.
  • Turning and mild hills reduce the powered speed target by at most 2 km/h combined: approximately 35-37 km/h normal or 40-42 km/h sprint. The penalty is smooth and uses the larger of the turn and hill penalties, rather than adding them.
  • Steering rotates existing momentum into the new travel direction. It no longer loses speed through the sideways tyre scrub or forward-vector projection used by the old drive.
  • Paid pedaling compensates for gravity along the slope. Either tyre contact or sufficiently close independent ground support can keep the drive working across small contact gaps.
  • The suspension chassis stays upright while the visible frame, wheels, grips and rider lean into corners. The front wheel and handlebars still turn up to 45 degrees. Turn rate is limited at high speed.
  • Low tyre placement guards are disabled while occupied so they do not snag a mild rise; they remain available while empty and during placement.
  • No custom speed or stamina HUD. A short controls message appears when mounting. The game's own stamina display remains.

These are handling targets for an unblocked route while pedaling with stamina. A wall, tree, substantial obstacle, steep/unsupported terrain, braking, stamina exhaustion or lost control input can still slow or stop the bicycle. Physics collisions remain active; the bicycle does not teleport through obstructions or hover over missing ground.

Controls

Input Action
E at the saddle Right the bicycle and mount
W Pedal forward
S Brake forward movement, then backpedal slowly after stopping
A / D Steer left / right
Shift + W Sprint pedal using more stamina
Release W / S Coast
E while riding Dismount
E at the rear chest Open cargo while unoccupied
Mouse / mouse wheel Look around / adjust camera distance

Normal pedaling costs 3 stamina per second and Shift pedaling 7 per second, before world stamina modifiers. Coasting and braking do not spend pedaling stamina. Exhaustion removes powered acceleration and hill assistance; coast to recover. Backpedaling target is 3 km/h. The ground-speed ceiling is 42 km/h.

Build and cargo

Recipe: Wood x20 + Bronze Nails x5. One rider only. The rear chest has 8 slots (4 x 2), using the native inventory and save system. Dismount before opening it. Mounting and cargo use are mutually exclusive. Empty the chest before dismantling.

The centered straight handlebar, timber frame, spoked wheels and recipe are retained. Native meshes and materials are referenced from the installed game, without distributing game assets.

Standing, parking and mounting

The chassis is protected from simulated toppling from placement onward. An unoccupied bicycle locks parking only after it is upright, sufficiently stationary and supported. The parking lock releases for riding or when support disappears; gravity remains active while unsupported.

Every authorized mount runs recovery before the player attaches to the saddle, including a fallen parked bicycle already owned by the same peer. The saddle hierarchy is refreshed immediately, stale control/brake state is cleared, and gravity/dynamic simulation are restored. Existing fallen bicycles also recover when their simulation owner begins after a world reload. Recovery retains cargo, heading and X/Z position, with a bounded upward clearance adjustment. Tight geometry can still obstruct clearance.

Installation and updates

Close Valheim. In Thunderstore Mod Manager, select the Valheim profile and install BepInExPack_Valheim by denikson and Jotunn by ValheimModding.

For this ZIP use Settings > Profile > Import local mod and select PedalBike-0.1.4.zip without extracting it. Do not use Import profile. If asked for metadata, use Pedal_Bike, author Arioh, version 0.1.4. Keep one active copy of PedalBike.dll, then launch Modded.

For a published release, install/update Pedal_Bike from Get mods. For manual or dedicated-server installation, replace:

BepInEx/plugins/PedalBike/PedalBike.dll

Install the dependencies separately and reload the world after updating. Existing bicycle prefab identity and cargo save data are retained.

The first 0.1.4 launch migrates the old speed settings to 37 / 42 km/h once. You do not need to delete the old configuration. Later custom speed settings are preserved within the supported ranges.

Multiplayer

Use the same Pedal Bike version on every player's profile and on the host/dedicated server. Start Server hosts launch their modded game. Friends may import the same local ZIP; public hosting is not required to play together. Matching patch versions are required through Jotunn.

The authorized rider owns simulation. Other peers receive movement, steering, wheel/pedal animation and the visible bank. Native inventory persistence, ward permissions, owner-validated requests, one-rider reservation, control watchdog and rider leases are retained. Remote peers do not apply duplicate drive forces.

Configuration

File created on launch:

BepInEx/config/arioh.valheim.pedalbike.cfg

Setting in Pedaling Standard default Meaning
CruiseSpeedKmh 37 Normal powered target, range 4-37 km/h
SprintSpeedKmh 42 Shift target, range 6-42 km/h; effective target is at least the normal target
PedalStaminaPerSecond 3 Normal pedaling cost
SprintStaminaPerSecond 7 Sprint cost; effective cost is at least the normal cost

Host/admin tuning is synchronized. The Compatibility / RideModelRevision entry records the one-time speed migration; it is not a riding control. Steering is capped at 45 degrees, visual lean at 45 degrees, and starting health is 600.

Publishing

The same ZIP works for local import and public upload. Upload it under the same team/name Arioh / Pedal_Bike in the Valheim community to add version 0.1.4. It has not been published automatically. Later versions must increment the DLL/plugin and manifest versions; changing only CHANGELOG.md does not update the code.

Validation and current limits

Built against installed Valheim 1.0.20, Unity 6000.0.75, BepInEx 5.4.23.5 and Jotunn 2.30.2 references. Release compilation, native API resolution and compiled integration checks pass. Offline production-rule tests cover 37/42 speed targets, a maximum combined 2 km/h handling penalty, steering, stamina and authorization. Production drive/stability tests use numerics/rigidbody/ground adapters to exercise sustained left/right turns, mild slopes, slope entry, gravity compensation, post-impact acceleration, recovery and speed limits. The compiled release contains no custom HUD.

This drive revision has not yet been tested in a live Valheim session or with two connected players. Adapter tests do not execute Unity PhysX, real terrain contacts, loaded-world migration or actual multiplayer interpolation. In-game handling, obstacle clearance and visual rider alignment still require verification.

Check BepInEx/LogOutput.log for Pedal Bike ready or Pedal Bike registration failed if the piece is missing. No Valheim, Unity, BepInEx or Jotunn DLLs, extracted game meshes or textures are bundled.

Thunderstore development is made possible with ads. Please consider making an exception to your adblock.