ShipMusic

Give every voyage its own soundtrack. / Своя музыка для каждого морского похода.

Spatial ship music for Valheim: four boats, four tracks, automatic playback at the helm.

Пространственная музыка для Valheim: четыре лодки, четыре песни и автоматическое воспроизведение у руля.

---

Русский

Музыка, которая путешествует вместе с лодкой

ShipMusic добавляет источник звука прямо на лодку. Пока кто-нибудь держит руль, играет песня, назначенная этому типу судна. Когда руль свободен, музыка останавливается. При повторном начале управления трек начинается сначала.

Музыку могут слышать рулевой, пассажиры и игроки на берегу поблизости, если у них установлены мод и аудиофайлы. Звук движется вместе с лодкой и постепенно затихает по мере удаления.

Возможности

• Отдельная песня для плота, карви, длинного корабля и драккара.
• Автоматический запуск у руля — горячие клавиши не нужны.
• Воспроизведение даже на стоящей лодке, пока кто-нибудь управляет ею.
• Пространственный звук: до 10 метров — выбранная громкость, от 10 до 40 метров — плавное затухание.
• Зацикленное воспроизведение и отдельный источник на каждой лодке.
• Громкость от 0 до 100 с применением сохранённого конфига во время игры.
• Возможность заменить все песни своими файлами OGG Vorbis.

Установка

1. В r2modman выберите Valheim и нужный профиль.
2. Найдите ShipMusic by Fenikonir в разделе Online и установите вместе с зависимостями.
3. Запустите игру кнопкой Start modded.
4. Возьмитесь за руль любой из четырёх поддерживаемых лодок.

Зависимость пакета: denikson-BepInExPack_Valheim-5.4.2350. Jötunn и ConfigurationManager не требуются.

Для установки из ZIP используйте Settings → Profile → Import local mod. Если раньше вы копировали DLL вручную, перенесите старую папку ShipMusic за пределы BepInEx/plugins перед установкой через менеджер, чтобы не осталось двух копий.

Свои песни

Закройте игру и откройте папку профиля через r2modman. В BepInEx/plugins найдите папку с ShipMusic.dll. Положите аудиофайлы рядом с DLL:

Лодка	Имя файла
Плот	raft.ogg
Карви	karve.ogg
Длинный корабль	longship.ogg
Драккар	drakkar.ogg

Используйте OGG Vorbis. Простое переименование .mp3 в .ogg не конвертирует аудио. После замены файлов перезапустите игру. Перед обновлением мода сохраните копии своих песен: менеджер может заменить файлы содержимым нового пакета.

Если трек отсутствует или не загружается, лодки этого типа останутся без музыки; остальные треки продолжат работать. Старый файл music.ogg больше не используется.

Громкость

После первого запуска откройте в r2modman:

Config editor → fenikonir.shipmusic.cfg → Audio → Volume

[Audio]
Volume = 50

0 — без звука, 100 — максимальная громкость источника, по умолчанию — 50. Сохраните конфиг и вернитесь в игру: громкость применяется без перезапуска. При нуле трек продолжает идти без звука.

Настройка влияет только на ваш звук. Штатная музыка Valheim продолжает играть; при желании уменьшите её громкость в настройках игры.

Мультиплеер и ограничения

• Мод и аудиофайлы нужны каждому слушателю. Игрок без мода не услышит добавленную музыку.
• Используется синхронизированное игрой состояние руля. Отдельная установка на выделенный сервер не требуется.
• Аудиофайлы не передаются по сети. Чтобы слышать одинаковые песни, установите одинаковые файлы у всех игроков.
• Позиция трека между клиентами не синхронизирована. При подключении или загрузке лодки песня может начаться с другого момента относительно остальных слушателей.
• Поддерживаются четыре стандартных типа лодок. Лодки из других модов автоматически не поддерживаются.

Если музыка не играет, проверьте имена и формат файлов, значение Volume и сообщения Ship Music в BepInEx/LogOutput.log.

Дисклеймер о музыке

В текущую версию пакета включены сторонние музыкальные записи, используемые без полученного разрешения или лицензии правообладателей. Автор мода не заявляет права на эти композиции или записи. Все права принадлежат соответствующим правообладателям.

Рекомендуется заменить комплектные треки своей музыкой или записями, лицензия которых разрешает предполагаемое использование, особенно перед публикацией сборок, стримами и видеозаписями. Замена файлов у пользователя не устраняет вопрос прав на записи в опубликованном пакете. Этот дисклеймер не предоставляет разрешение на использование или распространение музыки.

---

English

A soundtrack that sails with your ship

ShipMusic places an audio source on the boat itself. While someone is at the helm, the track assigned to that boat type plays. When the helm is released, the music stops. Taking control again starts the song from the beginning.

The helmsman, passengers and nearby players on shore can hear the music if they have the mod and audio files installed. The sound follows the ship and fades with distance.

Features

• A separate song for the Raft, Karve, Longship and Drakkar.
• Automatic playback at the helm — no hotkeys required.
• Music also plays on a stationary ship while someone controls it.
• Spatial audio: selected volume within 10 metres, fading out between 10 and 40 metres.
• Looping playback with an independent audio source on each ship.
• Volume from 0 to 100, with saved configuration changes applied during gameplay.
• Replace every song with your own OGG Vorbis files.

Installation

1. Select Valheim and your preferred profile in r2modman.
2. Find ShipMusic by Fenikonir under Online and install it with its dependencies.
3. Launch the game using Start modded.
4. Take the helm of any supported boat.

Package dependency: denikson-BepInExPack_Valheim-5.4.2350. Neither Jötunn nor ConfigurationManager is required.

For a local ZIP, use Settings → Profile → Import local mod. If you previously installed the DLL manually, move the old ShipMusic folder outside BepInEx/plugins before installing through the manager to avoid duplicate copies.

Custom music

Close the game and open your profile folder through r2modman. Under BepInEx/plugins, locate the folder containing ShipMusic.dll. Place these audio files next to the DLL:

Boat	File name
Raft	raft.ogg
Karve	karve.ogg
Longship	longship.ogg
Drakkar	drakkar.ogg

Use OGG Vorbis audio. Renaming an .mp3 file to .ogg does not convert it. Restart the game after replacing tracks. Back up your custom songs before updating the mod: the manager may overwrite them with files from the new package.

A missing or unreadable track leaves that boat type silent without preventing other tracks from working. The old music.ogg file is no longer used.

Volume

After launching the mod once, open:

Config editor → fenikonir.shipmusic.cfg → Audio → Volume

[Audio]
Volume = 50

0 mutes the music, 100 is the maximum source volume, and 50 is the default. Save the configuration and return to the game; the volume changes without a restart. At zero volume, the track continues playing silently.

This setting only affects your own audio. Valheim's regular music continues playing; you can lower it in the game's settings if desired.

Multiplayer and limitations

• Every listener needs the mod and audio files. Players without the mod will not hear the added music.
• The mod reads the game's synchronized helm state. No separate dedicated-server installation is required.
• Audio files are not sent over the network. Install matching files on each player's computer to hear the same songs.
• Playback positions are not synchronized between clients. Joining a session or loading a ship can start your track at a different point relative to other listeners.
• The four vanilla boat types are supported. Boats added by other mods are not automatically supported.

If music does not play, check file names, audio format, Volume and the Ship Music messages in BepInEx/LogOutput.log.

Music disclaimer

The current package includes third-party music recordings used without permission or a licence obtained from the rights holders. The mod author claims no ownership of these compositions or recordings. All rights belong to their respective owners.

You are encouraged to replace the bundled tracks with your own music or recordings licensed for your intended use, especially before sharing modpacks, streaming or recording videos. Replacing files on a user's computer does not resolve the rights issue for recordings included in the published package. This disclaimer does not grant permission to use or redistribute the music.