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

Pedal Bike

A single-rider timber bicycle with assisted balance, 45-degree steering, stamina pedaling and an 8-slot rear chest. Cruise at 8 km/h or sprint up to 12 km/h. Built from Wood and Bronze Nails.

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

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.3

A single-rider timber bicycle for Valheim, powered by your character's stamina. A triangular wooden frame, spoked wheels, working front steering, animated pedals, a rear chest and a riding HUD keep it practical for village travel.

New in 0.1.3

Aim at the saddle and press E: after the owner authorizes riding, the bicycle is returned upright before the player attaches to the seat. This runs on every mount, including a parked bicycle already owned by the same player. The seat's transform is refreshed immediately so an old interpolated fallen pose is not used for attachment.

This uses the existing recovery and clearance checks, preserves cargo, restores dynamic/gravity simulation and retains the tip-protection lock. Press W to pedal after mounting. Cruise 8 km/h and Shift maximum 12 km/h remain unchanged. Close the game and replace the previous release before reloading the world.

Fixed in 0.1.2

  • Prevents the physical chassis from toppling immediately after placement. Rotation is protected from solver torques from the first simulation step; heading, slope pitch and the visible cornering lean are controlled explicitly.
  • Adds narrow low tyre contact guards to define a safe placement edge and catch deep suspension compression.
  • Returns a previously fallen bicycle upright when the current owner starts simulating it after reload or ownership transfer, with a bounded upward clearance correction. Its existing inventory and X/Z position are preserved.
  • Locks parking only after actual wheel contact, independent ground support, low speed and an upright posture. A sleeping parked bicycle retains its lock while support exists; removing support releases the lock so gravity still works.
  • Reduces normal pedaling to 8 km/h and Shift sprint to a 12 km/h ground-speed ceiling. Existing higher configuration values cannot bypass the new limits.

Close Valheim before updating, then reload the world. Existing bicycle prefab and save identities are unchanged; the new controller runs on existing bicycles as they load. Very tight geometry or a vehicle trapped underneath a structure may still obstruct clearance.

Build it

Use the normal Hammer, open the Crafting build category and select Pedal Bike while within Workbench range.

Material Amount
Wood 20
Bronze Nails 5

The rear chest has 8 inventory slots (4 x 2). One rider only. Dismount before opening the cargo chest. The bicycle cannot be dismantled while occupied; empty the chest before dismantling it.

Controls

Input Action
E at the saddle Mount
W Pedal forward
S Brake forward motion, then backpedal slowly once stopped
A / D Steer the front wheel up to 45 degrees left / right
Shift + W Pedal faster and spend more stamina
Release W / S Coast without spending pedaling stamina
E while riding Dismount
E at the rear chest Open cargo while the bicycle is unoccupied
Mouse / mouse wheel Look around / adjust riding camera distance

Only WASD and Shift control riding. There are no aircraft, engine, hover or electricity controls. Shift alone does not move the bicycle.

Defaults: 8 km/h normal pedaling and 12 km/h sprint targets, 3 / 7 stamina per second respectively. Backpedaling is limited to 3 km/h. World stamina modifiers still apply. Cornering lean is calculated from speed and steering and limited to 45 degrees. Normal pedaling is capped at 8 km/h. Ground-plane speed is limited to 12 km/h even with old higher configuration values or downhill coasting; vertical falling velocity is retained.

When stamina runs out, powered pedaling stops. Coast to recover; pedaling becomes available again after recovering a small stamina reserve. The HUD displays speed, stamina and pedaling status.

Install with Thunderstore Mod Manager

If this release is published, find Pedal Bike / Pedal_Bike in Get mods, select Download, then launch Modded. Dependencies are listed in the package manifest.

For the local ZIP:

  1. Close Valheim and choose your Valheim profile in Thunderstore Mod Manager.
  2. Install BepInExPack_Valheim by denikson and Jotunn by ValheimModding if missing.
  3. Open Settings > Profile > Import local mod, and select PedalBike-0.1.3.zip as a ZIP. Do not extract it for this route.
  4. If asked for details, use Pedal_Bike, author Arioh, version 0.1.3.
  5. Check that it is enabled in My mods, then launch Modded.

Import profile / From file is a different menu for profile exports. Use Import local mod for this mod ZIP. Keep only one active copy of PedalBike.dll in the profile.

Manual installation and dedicated servers

Install the listed BepInEx and Jotunn dependencies first. Extract the package's BepInEx folder into the chosen game/profile/server root so that the plugin ends up at:

BepInEx/plugins/PedalBike/PedalBike.dll

For multiplayer, install the same Pedal Bike version on every player's profile and on the host/dedicated server. Start Server hosts should launch their game using Modded. A friend can use the same local ZIP; public hosting is not required for playing together. The mod declares matching versions mandatory through Jotunn.

Physics control moves to the authorized rider. Other peers receive the bicycle movement, steering and pedal animation; cargo uses the game's native inventory synchronization and persistence. Only one rider is allowed. Riding and cargo access are mutually exclusive, including requests arriving during a mount. Native ward access is respected. Server administrators control synchronized tuning values.

Configuration

The file is created on first launch:

BepInEx/config/arioh.valheim.pedalbike.cfg

Pedaling setting Default Meaning
CruiseSpeedKmh 8 Normal forward target, configurable from 4 to 8 km/h
SprintSpeedKmh 12 Shift target, configurable from 6 to 12 km/h
PedalStaminaPerSecond 3 Normal pedaling cost
SprintStaminaPerSecond 7 Sprint cost; effective value is at least the normal cost

The front wheel steering limit is 45 degrees. The bicycle has explicit chassis balance, controlled cornering lean, suspension and a stationary parking lock when empty. Its starting health is 600. It uses normal gravity and wheel contact; it is intended for ground travel.

Updating or publishing

To publish this first release, upload this ZIP to the Valheim community on Thunderstore and choose your team. This local package has not been published automatically. The ZIP can be used for both publishing and Import local mod.

For later updates, keep the same team and manifest name Pedal_Bike, increase version_number, update CHANGELOG.md, and rebuild the DLL with the matching plugin version. Upload the new package; do not upload the same name/team/version twice. Updating only CHANGELOG.md does not create a new version.

Validation and release limits

Built against the installed Valheim 1.0.20, Unity 6000.0.75, BepInEx 5.4.23.5 and Jotunn 2.30.2 references. The release build and native API resolution checks pass. Offline tests cover steering, corner and lean limits, speed caps including old configuration values, stamina calculations, rider authorization, invalid/stale inputs, recovery orientation, constraint policy, slope alignment, ground support and velocity limiting. Rotation/ground adapters are used for stability tests; these do not execute Unity PhysX.

The player reported immediate toppling in 0.1.1. The 0.1.3 update has not yet been driven in a live Valheim session or tested with two connected players. Native wheel physics, slopes, collision behavior, rider hand/foot alignment, cargo saves across reloads and multiplayer ownership transfers still need in-game verification. The accompanying model image is a software render of the actual model specification, not a gameplay screenshot. No Valheim or dependency DLLs, extracted meshes or textures are included in this package.

If the bike does not appear, check BepInEx/LogOutput.log for Pedal Bike ready or Pedal Bike registration failed.

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.