Flying Ships

A Valheim mod that lets you build and fly Viking ships. Powered by Flight Essence, a craftable fuel you need to build the ships and keep them in the air.

Works with Valheim 1.0.

---

What it adds

• Three flying ships: Raft, Karve, and Longship
• Flight Essence, a new craftable fuel (single and x5 variant)
• Flight physics with acceleration, inertia, banking, and hover
• Fuel system with emergency landing (ships don't fall out of the sky)
• Flight Essence status icon in the effects row while flying
• Rudder icon hides during flight
• Sail stays furled while flying
• Ships bob gently when hovering in place
• Flight state syncs in multiplayer

---

Installation

Manual

1. Install BepInExPack Valheim
2. Install Jotunn
3. Drop FlyingShips.dll into BepInEx/plugins/

Mod Manager

Use r2modman or Thunderstore Mod Manager. Dependencies install automatically.

---

How to use

Building a ship

Open your hammer, go to the Misc tab. You'll see three new ships:

Ship	Flight Essence Cost
Flying Raft	5
Flying Karve	10
Flying Longship	15

You'll also need the original materials (wood, etc.) to build them.

Flying ships keep the default storage of their vanilla counterparts. No extra storage slots are added.

Crafting Flight Essence

Craft at the Forge.

Single Flight Essence:

• 1x Greydwarf Eye
• 2x Bronze
• 10x Resin

Flight Essence x5 (batch):

• 5x Greydwarf Eye
• 10x Bronze
• 50x Resin

The x5 recipe is currently experimental and may be rebalanced or removed in a future update.

Controls

Key	Action
Page Up	Start flight / ascend
Page Down	Descend / land
W / S	Forward / backward
A / D	Turn left / right

Fuel

• 1 Flight Essence = 60 seconds of flight (by default)
• Fuel is taken from the ship's storage first, then from your inventory
• When fuel runs out, the ship descends automatically. It won't crash.

---

Configuration

After the first launch, edit BepInEx/config/pl.jungle.flyingships.cfg.

Key	Default	Description
VerticalSpeed	8	Ascend/descend speed (m/s)
ForwardSpeed	12	Forward speed (m/s)
TurnSpeed	1.5	Turning speed
LevelStabilization	2	Auto-leveling strength
AccelForward	8	Forward acceleration (m/s^2)
DecelForward	6	Forward deceleration (m/s^2)
AccelVertical	6	Vertical acceleration (m/s^2)
DecelVertical	5	Vertical deceleration (m/s^2)
MaxFlightHeight	250	Maximum flight altitude (m)
MaxBank	12	Max roll angle in turns (degrees)
PitchFromAccel	0.6	Pitch angle from acceleration
HoverDamping	3	Hover damping strength
EmergencyDescentSpeed	5	Emergency descent speed (m/s)
FuelPerMinute	1	Flight Essence consumed per minute

---

Compatibility

Crossplay: Not compatible. BepInEx doesn't work with PlayFab, so this mod won't work in Crossplay mode.

Multiplayer: Server and clients both need the mod installed. Flight state syncs through ZDO.

Known issues:

• Other players see the ship flying, but without the bobbing animation. Only the pilot sees it.
• May conflict with mods that heavily modify the Ship class.

---

Changelog

0.0.5

Fixed

• Fixed Flight Essence disappearing from player inventory after logging out and back in.
• Fixed Flight Essence disappearing from ship storage.
• Added m_dropPrefab to Flight Essence so Valheim correctly saves and recognizes it.
• Fixed Flight Essence detection in ship storage (now uses prefab instead of name).
• Fixed Container on ships — the chest in Karve and Longship now works correctly.
• Removed ZNetView conflict when adding storage to ships.
• Fixed prefab initialization order so m_dropPrefab is set before Flight Essence is registered.

Added

• Added Flight Essence x5 batch item.
• Added translations for ship names (Polish and English).
• Added translations for ship descriptions and HUD messages.
• Added translations for ship storage names.
• Added FuelPerMinute config option — allows adjusting fuel consumption.

Changed

• Changed Flight Essence recipe. Previously required 1x Iron. Now requires 1x Greydwarf Eye, 2x Bronze, and 10x Resin.
• Code refactor — split into classes (FlightPhysics, FlightFuel, FlightZdo, FlightStatusEffect, FlyingShipFactory, FlightFuelFactory, FuelVisuals, ShipStorageHelper, SailBlockPatch, ShipFlightPatch).
• Config descriptions rewritten in English (standard for Valheim mods).
• README.md updated — removed excessive formatting and long dashes.

Known Issues

• Flight Essence may still disappear if old, broken items exist in the world — old ones must be discarded and new ones crafted after updating.
• Flight Essence x5 is experimental and not balanced yet.
• Raft storage may not work — needs further testing.

0.0.1

First release. Includes:

• Full flight physics (acceleration, inertia, banking, hover)
• Fuel system with emergency landing
• Flight Essence status effect
• Polish and English translations
• Rudder hidden during flight
• Sail stays furled during flight

---

Credits

Made by Mepi. Thanks to the Valheim modding community and the Jotunn team.

---

License

MIT