VikingShanties

Viking Shanties

Updated for Valheim 1.0 (tested on 1.0.7).

Dance and headbang on boats and around campfires while Viking shanties play for everyone nearby!

Features

• Stick to the boat — Passengers are locked to the deck while emoting, no more sliding into the ocean
• Campfire singalongs — Press H near any lit fire to dance and sing
• Rest faster by the fire — Singing at a sheltered fire gets you Rested twice as fast (configurable)
• Heal faster by the fire — Singing at a fire makes your food heal you twice as fast (configurable, never on a ship)
• Regen Eitr faster by the fire — Singing at a fire makes your Eitr regenerate twice as fast (configurable, never on a ship)
• Heal your pets — Singing at a fire heals tamed wolves, boars, lox and the rest within a radius of the fire (configurable, never on a ship)
• Dance & Headbang — Cycles between dance and headbang emotes each time you press the hotkey
• Skip songs — Press Shift+H while dancing to skip to the next track
• Viking shanties — 3D spatialized audio plays from the ship or fire, audible to all nearby players and fading with distance
• 9 included tracks — Ships with a full soundtrack out of the box
• Multiplayer synced — Other players see you dancing and hear the shanty
• Crew singing — Volume increases slightly with more dancers
• Custom music — Drop your own.mp3,.ogg, or.wav files into the Shanties folder
• F1 Config Manager support — Change settings live in-game

How to Use

On a Ship

• Get on a ship as a passenger (works from seats too!)
• Press H to start dancing
• Press Shift+H to skip to the next song
• Press H again to stop

At a Campfire

• Stand near any lit fire
• Press H to start singing
• Press Shift+H to skip to the next song
• Press H again to stop

Each press cycles to the next emote and shanty.

Configuration

Works with the F1 Configuration Manager. Settings at BepInEx/config/dickdangerjustice.VikingShanties.cfg:

| Setting | Default | Description |

|---------|---------|-------------|

| Enabled | true | Enable/disable the mod |

| DanceKey | H | Hotkey to toggle dancing |

| Cooldown | 3 | Seconds between dance toggles |

| EmoteMode | Cycle | Dance, Headbang, or Cycle through both |

| SongMode | Cycle | Lock to a specific track or cycle all |

| ShantyVolume | 0.4 | Base volume (0.0 - 1.0) |

| MaxHearingDistance | 80 | How far away the shanty can be heard |

| MoreDancersLouder | true | Volume increases with more dancers |

| FadeGameMusic | true | Fade out the normal game music while you sing, and back in afterwards |

| MusicFadeAmount | 1 | How far to lower the game music while you sing (1 = silent, 0 = no change) |

| FasterRestingEnabled | true | Singing at a fire makes you Rested faster. Turn off if you consider it a cheat |

| RestingSpeedMultiplier | 2 | How much faster you get Rested while singing at a fire (1 = off, max 3) |

| FasterHealingEnabled | true | Singing at a fire makes food heal you faster. Turn off if you consider it a cheat |

| HealingSpeedMultiplier | 2 | How much faster food heals you while singing at a fire (1 = off, max 3) |

| FasterEitrEnabled | true | Singing at a fire makes Eitr regenerate faster. Turn off if you consider it a cheat |

| EitrSpeedMultiplier | 2 | How much faster Eitr regenerates while singing at a fire (1 = off, max 3) |

| PetHealingEnabled | true | Singing at a fire heals tamed creatures near the fire |

| PetHealRadius | 15 | Radius in meters around the fire in which pets are healed (3 - 100) |

| PetHealPercentPerSecond | 1 | Percent of a pet's max health healed per second (0.1 - 10) |

Custom Music

Place.mp3,.ogg, or.wav files in:

BepInEx/plugins/VikingShanties/Shanties/

The mod loads all audio files from this folder at startup and cycles through them.

Multiplayer note: Songs are synced by playlist index, not by filename. For the best experience, all players should have the same songs in the same order. The 9 bundled tracks are included with the mod, so those will always be in sync. If you add custom