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
• 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
• Onboard storage on every flying ship
• 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	Storage
Flying Raft	5	3x2
Flying Karve	10	4x3
Flying Longship	15	6x4

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

Crafting Flight Essence

Craft at the Forge:

• 1x Surtling Core
• 2x Iron
• 10x Resin

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

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

• Translations for ship names (Polish and English).
• Translations for ship descriptions and HUD messages.
• Translations for ship storage names.
• FuelPerMinute config option — allows adjusting fuel consumption.

Changed

• 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.
• 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
• Onboard storage

---

Credits

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

---

License

MIT