BIKINGS
=======
A craftable, fully animated bicycle for Valheim.
Arcade handling, ridiculous stunts, enemy bowling, destructive riding and a
radio that plays your own music while you ride.
Build a Viking bicycle from wood, bronze nails and bronze, then ride it across
tenth century Scandinavia.
The wheels roll, the cranks turn and your character actually pedals. The
rider's legs stay locked to the pedals, hands stay on the grips and the whole
bike leans naturally into corners.
QUICK START
===========
There are two ways to get a bicycle.
Press F7 while playing to instantly spawn a bicycle near your character.
This is the fastest way to get riding and is useful for testing the mod.
You can also build the bicycle normally using the Hammer.
Open the Hammer menu.
Open the Misc category.
Build the Bicycle using
10 Wood
10 Bronze Nails
1 Bronze
Press E to get on.
Press E again to get off.
Bicycles persist through relogs and server restarts and can be removed using
the Hammer.
THE FUN STUFF
=============
BOWL YOUR ENEMIES
-----------------
Ride into a Greydwarf at full sprint and send it flying.
About one successful hit in five becomes a MEGA launch that can send enemies
into the stratosphere.
The bicycle does not stop when hitting enemies.
Other players and tamed animals are protected and are never hit by the enemy
launch system.
Everyone else is a bowling pin.
SMASH MODE
----------
Smash Mode is enabled by default.
Plow straight through trees, rocks, bushes and structures without slowing
down.
Trees topple.
Rocks shatter.
Bushes and plants are destroyed.
Structures can be smashed.
Resources drop normally where the object was destroyed.
Destructible objects do not stop the bicycle.
WARNING
Smash Mode also affects player buildings.
This includes your own buildings.
Ride responsibly.
Or do not.
BUNNY HOPS
-----------
Hold the hop key to charge your jump.
A quick tap produces a small hop that can clear small obstacles.
The longer you hold the button, the higher the bicycle jumps.
The maximum jump height can be configured.
At extreme settings the maximum height can reach 50 metres.
You can jump over walls, onto rooftops and even onto Fuling huts.
WHEELIES AND STOPPIES
---------------------
Lean backwards while sprinting to perform a wheelie.
Lean forwards while braking to perform a stoppie.
Wheelies and stoppies can be enabled or disabled in the configuration.
AIR CONTROL
-----------
You keep control of the bicycle while jumping or flying from hills and ramps.
A and D steer the bicycle while airborne.
W adds a small amount of forward movement.
S drags the bicycle backwards.
Numpad 8 pitches the nose of the bicycle down.
Numpad 2 pitches the nose of the bicycle up.
Use these controls to correct the bicycle in the air and try to stick the
landing.
ONE HAND CRUISING
-----------------
Hold the left mouse button and the bicycle automatically pedals while steering
towards wherever the camera is looking.
Rapidly tap W or hold Shift to sprint pedal.
While sprint pedalling your character stands on the pedals and the bicycle
rocks underneath the rider.
YOUR OWN RADIO
--------------
Bikings includes a built in radio system.
Drop your own music files into the Bikings Radio folder and cruise through
Valheim listening to your own soundtrack.
Supported music formats are
MP3
WAV
OGG
The radio includes
Now Playing display
Next track control
Radio off control
Volume control
Songs are automatically detected when placed inside the Radio folder.
CONTROLS
========
KEYBOARD
--------
F7
Instantly spawn a bicycle near your character.
LEFT MOUSE HOLD
Pedal automatically and steer towards wherever the camera is looking.
W HOLD
Pedal at normal cruise speed.
W TAP RAPIDLY
Sprint pedal.
The rider stands up on the pedals and travels faster.
SHIFT HOLD
Sprint pedal.
S
Brake.
Continue holding to reverse.
A AND D
Steer the bicycle.
The bicycle leans into turns.
Steering also works while airborne.
SPACE HOLD AND RELEASE
Charge a bunny hop.
The longer Space is held, the higher the bicycle jumps.
Maximum height is controlled by BunnyHopMaxHeight.
NUMPAD 8
Lean forwards.
On the ground this can perform a stoppie.
While airborne this pitches the bicycle nose down.
NUMPAD 2
Lean backwards.
On the ground this can perform a wheelie.
While airborne this lifts the bicycle nose up.
E
Get on or get off the bicycle.
N
Play the next radio track.
B
Turn the radio off.
LEFT BRACKET
Decrease radio volume.
RIGHT BRACKET
Increase radio volume.
IN THE AIR
----------
The bicycle remains controllable after leaving the ground.
A and D steer.
W adds a little forward movement.
S drags the bicycle backwards.
Numpad 8 pitches the nose down.
Numpad 2 pitches the nose up.
GAMEPAD CONTROLS
----------------
B HOLD
Pedal.
Rapidly tap B to sprint pedal.
RIGHT TRIGGER
Pedal and sprint pedal.
A
Brake and reverse.
LEFT TRIGGER
Brake and reverse.
X HOLD AND RELEASE
Charge and perform a bunny hop.
Y
Get off the bicycle.
RIGHT BUMPER
Play the next radio track.
LEFT BUMPER
Turn the radio off.
LEFT STICK
Steer the bicycle.
The Left Stick also controls leaning while airborne.
Every keyboard and gamepad control can be remapped through the configuration.
RADIO MUSIC SETUP
=================
Open your Valheim profile.
Open
BepInEx
Then open
plugins
Then open
Bikings
Then open
Radio
Place your MP3, WAV or OGG music files inside the Radio folder.
The music is detected automatically.
While riding, press N to move to the next track.
Press B to turn the radio off.
Use the Left Bracket and Right Bracket keys to change volume.
CONFIGURATION
=============
Every setting can be changed while the game is running.
No restart is required.
USING CONFIGURATION MANAGER
---------------------------
If you use ConfigurationManager by shudnal, press F1 while in game.
Find Bikings in the list.
Settings changed through the menu apply immediately.
CONFIGURATION FILE
------------------
You can also edit the configuration file directly.
The file is located at
BepInEx\config\com.marcthetruthwithin.valheimbike.cfg
The game watches this file while running.
Changes apply live while playing.
SPEED SETTINGS
==============
BaseSpeed
Controls the normal cruising top speed of the bicycle.
SprintSpeedMultiplier
Controls how much faster the bicycle travels while sprint pedalling.
Acceleration
Controls how quickly the bicycle reaches its target speed.
Braking
Controls the strength of the bicycle brakes.
HANDLING SETTINGS
=================
TurnRate
Controls steering sharpness.
Increase this value for tighter turns.
Decrease it for more stable steering.
SmallObstacleHeight
Objects shorter than this value can be ridden through instead of stopping the
bicycle.
Examples include dropped food, plants, grass and small stones.
SmallObstacleWidth
Objects narrower than this value can be ridden through regardless of height.
Examples include saplings, shoots and thin stalks.
Shrubs, bushes and pickable plants automatically part as you ride through
them.
RIDING SETTINGS
===============
SendEnemiesFlying
Default value is True.
When enabled, riding into monsters and wild animals at sufficient speed sends
them flying.
About one hit in five can trigger a much larger launch.
Other players and tamed animals are never hit.
EnemyHitDamage
Controls blunt damage dealt when riding into an enemy.
Damage is scaled by speed.
Set this value to 0 if you want enemies to fly without taking damage.
The setting can be increased up to 500 damage.
EnemyLaunchPower
Controls how far enemies are launched.
1 gives normal enemy bowling.
Higher settings create stronger launches.
The setting can reach up to 10 times normal launch power.
EnemyLaunchMinSpeed
Controls the minimum speed required for a proper enemy launch.
Below this speed enemies are pushed aside instead.
DestructionMode
This is Smash Mode.
Enabled by default.
When enabled, the bicycle can destroy trees, rocks, bushes and structures
without slowing down.
Destroyed objects provide their normal resource drops.
WARNING
This also affects player buildings, including your own.
FallOffBike
Default value is False.
False means the rider does not fall from the bicycle during hard crashes.
True allows hard crashes to throw the rider over the handlebars.
Wheelies
Turns wheelies and stoppies on or off.
BunnyHopMinHeight
Controls the jump height produced by a quick tap of the bunny hop button.
BunnyHopMaxHeight
Controls the maximum bunny hop height after fully charging the jump.
The maximum setting can reach approximately 50 metres.
BunnyHopChargeTime
Controls how long the bunny hop button must be held to reach maximum jump
height.
LeanAngle
Controls how far the bicycle leans into corners.
CameraAutoFollow
Controls whether the camera automatically swings back behind the bicycle while
riding.
ANIMATION SETTINGS
==================
PedalCadenceScale
Controls how quickly the rider's legs pedal relative to bicycle speed.
SeatHipHeight
Controls the rider's hip position while seated.
Increase this value if the rider appears to sink too far into the saddle.
MULTIPLAYER
===========
Bikings supports multiplayer.
Every player using the world should have the mod installed.
The world host especially needs Bikings installed.
Only one player can ride each bicycle at a time.
When a bicycle is already being used, other players see it as occupied.
Other players can see the rider's full pedalling animation.
Other players can hear the bicycle chain.
Whoever is riding the bicycle controls its movement for everyone.
Bicycles persist through relogs and server restarts like normal build pieces.
IMPORTANT
Keep Bikings installed when loading a world containing bicycles.
If the world is loaded without the mod installed, saved modded bicycles can be
removed from the world.
INSTALLATION
============
R2MODMAN
--------
Find Bikings on Thunderstore.
Install the mod.
Launch Valheim through r2modman.
THUNDERSTORE MOD MANAGER
------------------------
Find Bikings on Thunderstore.
Install the mod.
Launch Valheim through the Thunderstore Mod Manager.
MANUAL INSTALLATION
-------------------
Install BepInExPack Valheim by denikson from Thunderstore.
Download Bikings.
Open the downloaded Bikings package.
Copy the Bikings folder into
BepInEx\plugins
Launch Valheim.
REQUIREMENTS
============
BepInExPack Valheim
Bikings should be installed by every player in multiplayer.
COMPATIBILITY
=============
Bikings was built and tested against the current Valheim build available at
the time of release.
The bicycle functions as a normal custom build piece.
It can be used with existing Valheim characters and worlds.
HAVING TROUBLE
==============
Want a bike immediately
Press F7 while playing to spawn one near your character.
Want to build one normally
Open the Hammer menu.
Go to Misc.
The recipe is
10 Wood
10 Bronze Nails
1 Bronze
If your radio has no music, place MP3, WAV or OGG files inside the Radio folder
located inside the Bikings plugin folder.
If you need to change controls, speed, handling, jumping, enemy launching or
animations, open the F1 Configuration Manager menu and find Bikings.
A NOTE FROM THE MAKER
=====================
I make music too.
If cruising through the Meadows at sunset did something for you, have a listen
to my Celtic music album
Way Of The Wind
It is exactly the kind of travelling music I had in mind for rides through
Valheim.
You can find it on Bandcamp by searching for
Designers of Sleep Way Of The Wind
Bikings is free and always will be.
If the mod made you smile and you would like to support the person behind it,
picking up a copy of the album would genuinely make my day.
Sharing the mod with a friend helps too.
Either way, ride on.
RIDE FAST
BOWL OFTEN
SMASH RESPONSIBLY
