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

Pedal Bike

A single-rider bicycle built on native Cart wheel and joint physics. 30-degree steering, 37/42 km/h pedaling, native stamina and an 8-slot rear chest. WASD + Shift controls, with no custom speed HUD.

By Arioh
Date uploaded 3 weeks ago
Version 0.1.11
Download link Arioh-Pedal_Bike-0.1.11.zip
Downloads 42
Dependency string Arioh-Pedal_Bike-0.1.11

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

A timber bicycle built on Valheim's native Cart physics foundation, with one rider, stamina-powered pedaling and an 8-slot rear chest. Build it with Wood x20 + Bronze Nails x5 using the normal Hammer, Crafting category, within Workbench range.

Native cart foundation

This release retains the actual Cart wheel rigidbodies, convex wheel colliders, contact materials and axle joints. The wheel track is adapted to fit under the bicycle, while its visible frame, saddle, handlebars, pedals and cargo chest use the bicycle model. Chassis mass and linear damping come from the installed Cart prefab, with a lower center of mass and additional angular damping for the narrower bicycle.

A local kinematic pull point uses the native Vagon linear spring/lock arrangement in place of the walking runner. The rider remains seated. Pedaling supplies bounded assistance to the dynamic chassis; native wheels, joints, gravity and collision response determine its actual movement. The old direct-position bicycle drivetrain has been removed from the release. The Vagon walking interaction is replaced by the bicycle controls and owner reservation.

Actual wheel collision contacts provide ground support, with independent ground probes as fallback. Only the authorized simulation owner drives the chassis. Other peers receive native synchronized poses and do not run duplicate dynamic wheel simulation. The attached rider's collision pairs are temporarily excluded from their own bicycle, then restored on dismount.

Steering and slopes

  • Front wheel and handlebars steer up to 30 degrees, with a smooth input response.
  • Steering uses a horizontal world-up heading. Side slopes do not directly rotate the requested steering direction downhill.
  • The physical cart chassis can respond naturally to the ground. The visible bicycle and seated rider stay upright independently of chassis roll.
  • Cosmetic corner lean is limited to 8 degrees. Terrain pitch is smoothed and limited to 25 degrees. These visual angles do not steer the vehicle.
  • Pull-point yaw commands and actual chassis yaw are limited to 48 degrees/second to avoid abrupt high-speed turning.
  • Pedaling targets remain 37 km/h normally and 42 km/h with Shift. The ground-speed ceiling is 42 km/h. Turning and slope target reductions remain at most 2 km/h combined.

There is no artificial cap on total hill elevation. Traction, native collision geometry, stamina and joint response still matter. Steep obstacles and vertical cliffs can block a cart-based vehicle. This release does not promise that every mountain face is traversable at full speed.

Controls

Input Action
E at the saddle Right the bicycle and mount
W Pedal forward
S Brake, then continue holding to backpedal
A / D Steer left / right, up to 30 degrees
Shift + W Sprint pedal using more stamina
Release W / S Coast under native physics
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/second, sprint 7/second, before world modifiers. Braking and coasting do not spend pedaling stamina. Backpedaling target is 3 km/h. A short controls message appears on mounting; there is no custom speed/stamina HUD.

Collision, parking and saved bicycles

Native dynamic collisions now handle rolling and contact separation instead of the old broad box-sweep stop path. Chassis impacts add a small bounded pull-point recoil. Solid trees, poles and buildings remain solid. Fully enclosed or very tight geometry may still prevent escape; obstacles are not deleted or damaged by recovery code.

A supported stopped bicycle holds its pull point as a parking stand/brake. Without ground support, that pull joint is released and the native bodies fall under gravity. Every authorized mount rights the chassis and resets the native wheel poses before attaching the player.

The existing prefab/GUID, recipe, centered handlebar, one-rider layout, native saved cargo, ward checks and controls are preserved. Cargo is 4 x 2 slots. Dismount before opening it, and empty the chest before dismantling. Starting health remains 600.

Install or update

  1. Close Valheim and select 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, then select PedalBike-0.1.11.zip without extracting it. Use Import local mod, not Import profile.
  4. If metadata is requested: name Pedal_Bike, author Arioh, version 0.1.11.
  5. Keep one active PedalBike.dll. Disable/remove the previous local bike entry if importing creates a second entry. Launch Modded and reload the world.

Existing bicycles use the new prefab components after reload; their cargo/save identity is retained. Do not delete your configuration. The existing one-time speed migration already supplies 37/42 defaults for older profiles.

Manual/server path: BepInEx/plugins/PedalBike/PedalBike.dll. Install the dependencies separately.

Multiplayer and public upload

Use 0.1.11 on every player's profile and on the host/dedicated server, with both dependencies. Start Server hosts launch Modded. Friends can import this same ZIP. Matching patch versions are required through Jotunn.

The same ZIP can be uploaded under the existing Arioh / Pedal_Bike team/name in the Thunderstore Valheim community to add 0.1.11. The manifest and compiled plugin versions match. No automatic installation or public upload was performed.

Configuration

File: BepInEx/config/arioh.valheim.pedalbike.cfg.

Pedaling setting Default
CruiseSpeedKmh 37
SprintSpeedKmh 42
PedalStaminaPerSecond 3
SprintStaminaPerSecond 7

Host/admin values are synchronized. Normal speed is limited to 4-37 km/h and sprint to 6-42 km/h, at least the normal setting. Compatibility / RideModelRevision records the existing speed migration.

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. The native Cart hierarchy, wheel body/axle configuration and Vagon.AttachTo implementation were inspected from the installed game. No game DLLs, meshes, textures or serialized asset dumps are bundled.

Release compilation, installed native API resolution and compiled integration checks pass. Production rule tests cover 30-degree steering, bounded yaw/lean, speed targets, stamina and authorization. The new pull-planner tests cover bounded lead, forward/reverse, slope-independent yaw, preserved horizontal heading and upright recovery using numerics adapters.

These offline checks do not simulate native Unity wheel joints or prove live cart handling. Version 0.1.11 has not yet been played in Valheim or tested with two connected players. Real terrain traction, stability at 37/42 km/h, rider alignment and network interpolation need in-game verification.

Check BepInEx/LogOutput.log for Pedal Bike 0.1.11 loading and Pedal Bike ready. Movement diagnostics use motor=native-cart-joint, with measured actual displacement and speed. The old position-motor test results are historical and are not claimed as validation of this drivetrain.

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.