
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.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:
- Close Valheim and choose your Valheim profile in Thunderstore Mod Manager.
- Install BepInExPack_Valheim by denikson and Jotunn by ValheimModding if missing.
- Open Settings > Profile > Import local mod, and select PedalBike-0.1.3.zip as a ZIP. Do not extract it for this route.
- If asked for details, use Pedal_Bike, author Arioh, version 0.1.3.
- 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.