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
• Three tiers of Flight Essence: Weak, Normal, and Pure (each with its own color and icon)
• Flight physics with acceleration, inertia, banking, and hover
• Fuel system with soft landing and emergency descent (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
• Visual flight effects: start burst, fuel sparks, and a glowing trail
• Ambient engine sound while flying
• 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 and go to the Misc tab. You'll see three new ships:

Ship	Required Essence	Cost
Flying Raft	Weak Flight Essence	5
Flying Karve	Flight Essence	10
Flying Longship	Pure Flight Essence	15

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

Each ship has a different fuel efficiency:

Ship	Fuel Efficiency
Flying Raft	100% (normal)
Flying Karve	70% (shorter flight)
Flying Longship	50% (half the flight time)

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

Crafting Flight Essence

All three tiers are crafted at the Forge.

Weak Flight Essence (30 s flight):

• 1x Greydwarf Eye
• 5x Resin

Flight Essence (60 s flight):

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

Pure Flight Essence (180 s flight):

• 5x Greydwarf Eye
• 5x Bronze
• 20x Resin
• 2x Iron

Flight Essence x5 (batch):

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

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

Each tier has its own color:

• Weak – green
• Normal – blue
• Pure – purple

Controls

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

Fuel

Fuel is taken from the ship's storage first, then from your inventory. The ship always burns the weakest tier first, then Normal, then Pure.

Essence	Flight Time
Weak	30 s
Normal	60 s
Pure	180 s

Ship efficiency applies to the base time. For example, a Karve burning a Normal Essence flies for 60 × 0.7 = 42 s.

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	Fuel consumption multiplier

---

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

Added

• Three tiers of Flight Essence: Weak, Normal, and Pure.
• Each tier has its own color and inventory icon.
• Fuel efficiency per ship type (Raft 100%, Karve 70%, Longship 50%).
• Ships now require a specific essence tier at build time (Raft – Weak, Karve – Normal, Longship – Pure).
• Visual flight effects: start burst, fuel sparks, and a glowing trail behind the ship.
• Ambient engine sound while flying.
• Soft landing (ship slows down near the ground instead of falling).
• Automatic emergency descent when the last essence is burned.
• Config option FuelPerMinute for tuning fuel consumption.

Fixed

• Fixed Flight Essence disappearing from player inventory after logging out and back in.
• Fixed Flight Essence disappearing from ship storage and from chests.
• Fixed Flight Essence disappearing when placed in a chest and another item is added afterwards.
• Added m_dropPrefab to Flight Essence so Valheim correctly saves and recognizes it.
• Fixed the double-flight-time bug where a single essence gave two fuel cycles instead of one.
• Fixed FuelDuration defaulting to 60 s on the first cycle, regardless of essence tier.
• Fixed FuelEfficiency not being applied to fuel consumption.
• Fixed ClaimOwnership NullReferenceException when a ship despawns mid-flight.
• 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.

Changed

• Changed Flight Essence recipe. Previously required 1x Iron. Now requires 1x Greydwarf Eye, 2x Bronze, and 10x Resin.
• Moved crafting recipe for Flight Essence from Forge to Forge (unchanged), but added two new tiers.
• Code refactor — split into classes (FlightPhysics, FlightFuel, FlightZdo, FlightStatusEffect, FlyingShipFactory, FlightFuelFactory, FuelVisuals, ShipStorageHelper, SailBlockPatch, ShipFlightPatch, FlightEffects, FlightController, FuelTier).
• 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.
• Balance of tier durations and ship efficiency is still being tuned.

0.0.5

Fixed

• Fixed Flight Essence disappearing from player inventory after logging out and back in.
• Added m_dropPrefab to Flight Essence so Valheim correctly saves and recognizes it.

Added

• Flight Essence x5 batch item.
• Translations for ship names, descriptions, HUD messages, and storage names.
• FuelPerMinute config option.

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