Mepi-FlyingShips icon

FlyingShips

Build flying Viking ships powered by Flight Essence. Full flight physics, fuel system, emergency landing and status effects.

By Mepi
Last updated 17 hours ago
Total downloads 181
Total rating 1 
Categories Mods Crafting Transportation Building
Dependency string Mepi-FlyingShips-0.0.4
Dependants 0 other packages depend on this package

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2333 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.

Preferred version: 5.4.2333
ValheimModding-Jotunn-2.27.1 icon
ValheimModding-Jotunn

Jötunn (/ˈjɔːtʊn/, 'giant'), the Valheim Library was created with the goal of making the lives of mod developers easier. It enables you to create mods for Valheim using an abstracted API so you can focus on the actual content creation.

Preferred version: 2.27.1

README

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