You are viewing a potentially older version of this package. View all versions.
Arioh-Pedal_Bike-0.1.4 icon

Pedal Bike

A single-rider timber bicycle: 37 km/h pedaling, 42 km/h sprint, smooth cornering and hill assistance. Includes an 8-slot rear chest and automatic mount recovery. WASD + Shift controls, with no custom speed HUD.

By Arioh
Date uploaded 2 weeks ago
Version 0.1.4
Download link Arioh-Pedal_Bike-0.1.4.zip
Downloads 38
Dependency string Arioh-Pedal_Bike-0.1.4

This mod requires the following mods to function

ValheimModding-Jotunn-2.30.2 icon
ValheimModding-Jotunn

Jötunn (/ˈjɔːtʊn/, 'giant'), the Valheim Library was created with the goal of making the lives of mod developers easier. It enables you to create mods for Valheim using an abstracted API so you can focus on the actual content creation.

Preferred version: 2.30.2
denikson-BepInExPack_Valheim-5.4.2351 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.

Preferred version: 5.4.2351

README

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.

CHANGELOG

Changelog

0.1.11

  • Rebase the bicycle on actual native Cart wheel rigidbodies, convex colliders, materials and axle joints. Copy native chassis mass/linear damping, adapt the wheel track and retain bicycle visuals/cargo.
  • Replace the walking runner with a local native-style spring pull point plus bounded pedal assistance. Native dynamic physics now determines chassis movement; remove the old direct-position drive.
  • Use actual wheel contacts for ground support, with probes as fallback. Keep dynamic owner/kinematic replica roles and temporarily exclude the attached rider from their own chassis collisions.
  • Reduce handlebars/front steering to30 degrees. Smooth yaw, cap yaw commands/chassis yaw, keep the visible rider/frame upright, and limit cosmetic lean/pitch.
  • Retain37/42 km/h, WASD/Shift/E, native stamina, one rider, eight cargo slots, recipe, prefab/GUID and saved inventory.
  • Build, native API resolution, compiled integration and offline rules/pull-planner checks pass. Native joint/terrain/multiplayer behavior still needs live verification.

0.1.10

  • Add a disabled serialized query box and bounded owner-side separation for existing object overlaps. Permit outward/non-deepening motion so S can reverse away from a stump, fence, rock, tree or lamp post.
  • Stop inward speed on head-on impact and apply a short checked outward rebound; retain solid obstacles and guard against correction into another object.
  • Reject rotations that deepen an obstacle overlap. Respect ignored collision-layer pairs and skip non-solid/view-blocking layers.
  • Preserve 37/42 km/h, large-hill assistance, controls, stamina, model, recipe, cargo/save identity and multiplayer owner authority.
  • Expanded offline contact/movement tests pass; release build, installed API resolution and compiled wiring checks pass. Live 0.1.10 gameplay verification remains pending.

0.1.9

  • Fix supported native-terrain overlap blocking forward/reverse motion at crests and uneven ground; validate both sides of the route before exempting Heightmap ground from the obstacle sweep. Trees/buildings/cliffs retain collision checks.
  • Increase ground-probe range and assisted continuous slope support to about 60 degrees. Total hill elevation is unrestricted. Use the highest supported plane and a swept 0.6 m local step-clearance attempt.
  • Hold S to brake fully, then continue into 3 km/h reverse with a near-zero brake threshold.
  • Keep 37/42 km/h targets, at most 2 km/h combined handling-target loss, stamina, controls, model, native saved cargo and all identities.
  • Add regressions for reverse after braking, bidirectional initial terrain overlap, rough humps, large sustained hills, steep hill entry, walls and terrain cliffs. The old motor fails the new overlap regression; the updated motor passes. Live 0.1.9 gameplay verification remains pending.

0.1.8

  • Replace the failed force/WheelCollider drive with an owner-controlled position motor using Rigidbody.MovePosition and swept obstacle checks. The live 0.1.7 log confirmed pedaling input but only 0-1 mm displacement despite an awake, dynamic, unlocked body.
  • Follow walkable ground with independent probes; use manual gravity when unsupported. Disable legacy wheel solvers and replicate kinematic poses to other peers.
  • Keep 37/42 km/h targets, at most 2 km/h combined turn/mild-hill loss, native stamina, WASD/Shift/E controls, visible steering/lean and no custom HUD.
  • Preserve one rider, eight cargo slots, Wood20/BronzeNails5, existing prefab/save identity and recovery before every mount.
  • Production build, installed native API resolution, offline motor/rule tests and compiled wiring checks pass. Live Valheim and multiplayer verification remain pending.

0.1.7

  • Update the package and compiled plugin version to 0.1.7 as requested.
  • Retain the movement repair and gameplay behavior from 0.1.5. No additional gameplay changes.

0.1.5

  • Repair the body-role/wake path behind reported stationary pedaling. Recheck dynamic owner mode every tick and keep the occupied bicycle awake.
  • Apply drive corrections through a bounded waking velocity-change impulse.
  • Align native ZSyncTransform kinematic/gravity caches with owner/remote state, scoped only to bicycles.
  • Add actual-displacement diagnostic logs for moving or stalled pedal attempts, with no custom HUD.
  • Retain 37/42 km/h, handling targets, controls, mount recovery, parking, Stamina, recipe and cargo.
  • Build, native API/cache-field and offline force/lifecycle checks pass. Live game verification remains pending.

0.1.4

  • Reworked ground drive to retain momentum through steering and mild hills, rather than relying on rear-tyre torque and sideways friction.
  • Normal37 km/h and Shift42 km/h; first-launch migration replaces the old8/12 settings once.
  • Combined turn/hill powered-target penalty capped at2 km/h; paid pedaling compensates slope gravity.
  • Either wheel/nearby ground support can carry drive across brief contact gaps.
  • Kept suspension upright and moved cornering lean to the model/rider; disabled occupied low tyre guards to avoid snagging rises.
  • Removed the custom speed/Stamina HUD. Kept a short mount-time control hint.
  • Retained native collision blocking, Stamina cost, recovery-before-mount, parking, one rider, eight cargo slots and recipe.
  • Added sustained left/right turn, mild-slope and slope-entry offline drive checks. Build passes; live game/multiplayer handling still needs verification.

0.1.3

  • Right the bicycle on every authorized E-to-ride action before attaching the rider to the saddle.
  • Cover same-owner parked/fallen bikes without waiting for a world reload or ownership transition.
  • Refresh the recovered seat hierarchy immediately, reset stale drive/brake/steer state and restore dynamic gravity simulation while retaining rotation protection.
  • Preserve cargo, save/prefab identity, controls, 45-degree steering, normal 8 km/h and Shift maximum 12 km/h.
  • Build and offline recovery/order checks pass; live game and multiplayer verification remain pending.

0.1.2

  • Fixed the unprotected two-wheel chassis that could fall over before the parking lock engaged.
  • Lock physical rotation from spawn; drive yaw, terrain pitch and cornering lean explicitly while retaining wheel propulsion and gravity.
  • Added narrow low tyre contact guards for placement and deep compression.
  • Recover saved fallen bikes when simulation ownership starts, without replacing the prefab or cargo.
  • Require wheel contact, independent floor support, low speed and upright posture before parking; keep sleeping parking locked until support disappears or a rider mounts.
  • Reduced normal speed to 8 km/h and Shift sprint/ground coasting limit to 12 km/h, including existing higher config values.
  • Kept 45-degree front steering, controls, stamina rates, centered handlebar, single rider, recipe and 8 cargo slots.
  • Added offline stability and constraint-policy regression checks. Live Valheim/connected-player validation of this fix remains pending.

0.1.1

  • Centered the straight handlebar over the bicycle neck and replaced the backward-swept stem with an upright stem.
  • Joined both fork legs with a crown beneath the stem.
  • Moved the visible grips and rider hand targets together to the new handlebar positions.
  • Riding controls, 45-degree steering, speed, stamina, recipe and cargo remain unchanged.

0.1.0

  • Initial single-rider pedal bicycle release.
  • Wood 20 + Bronze Nails 5 recipe in the normal Hammer's Crafting category.
  • Native-style timber frame, spoked wheels and an 8-slot rear chest.
  • Front-wheel steering limited to 45 degrees in either direction, with assisted balance and cornering lean.
  • WASD riding; S brakes then backpedals; Shift increases forward pedal speed and stamina cost.
  • Native character stamina use, animated pedals and steering, a riding HUD and an orbit camera.
  • Owner-authorized rider control, input timeout protection, native cargo persistence and multiplayer version checks.
  • Exclusive riding/cargo access and an unoccupied parking lock.
  • English interface, README and configuration descriptions.

Build and offline validation passed. Live-game and multiplayer validation remain pending for this first release.