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:

Используйте 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:

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.

0.7.0

• Added live internet radio using the free Radio Browser API, enabled by default without an API key or account.
• Random station selection across Viking, Nordic folk, folk metal and pagan metal tags. F8 at the helm selects another station; broadcasters choose songs within their live programs.
• Nearby listeners resolve the captain's station ID and connect directly to the broadcaster. One nearest radio ship per listener, existing spatial volume and 10–40 m attenuation; stream connections stop beyond 50 m or when the helm is released.
• Added bounded MP3 streaming with NLayer 3.0.0 (MIT), background network/decoding work, two-second startup buffering, ICY metadata handling and reconnect backoff. Radio audio stays in memory and is not sent through Valheim RPCs.
• Added live Radio.Enabled and Radio.Tags settings; disable radio to restore local OGG/F8 playlists and optional file sharing. Local boat music plays during buffering or outages when available.
• MP3 streams only in this release; AAC/HLS stations are excluded. Clients may hear different delays or broadcaster advertisements; playback is not sample synchronized.
• Verified radio lifecycle and buffer tests plus actual API discovery and decoding of CeltCast and Radio Skald streams. In-game audio and two-client validation remain manual checks.

0.6.1

• Removed the 150 ms pause between chunks; up to 16 chunk requests stay in flight.
• Added bounded upload queues, alternating listeners and out-of-order reception with missing-chunk retries.
• Added live UploadLimitKBps configuration (64–4096 KiB/s), defaulting to 1024 KiB/s across all listeners.
• Downloads time out after 22 seconds without progress; selection changes and disabling sharing discard pending work.
• Kept the v1 wire format and existing disk cache; update both captain and listeners to benefit fully.
• Verified 4 MiB in approximately 4.1 seconds at simulated 100 ms RTT, plus loss, reordering, two listeners and live rate changes. Real multiplayer speed is not yet measured.

0.6.0

• Opt-in sharing of the captain's actual OGG recording through addressed routed RPCs.
• Separate send/receive settings, compressed file limit and bounded disk cache.
• Chunked downloads, SHA-256 integrity verification, timeout and stale-selection cancellation.
• Cached recordings are reused and playback starts at an approximate shared position.
• Local music remains the fallback when sharing is off or unavailable.
• Verified with protocol and simulated transport tests; real two-client gameplay validation is still required.

0.5.0

• Added a custom OGG Vorbis playlist in the tracks folder next to the DLL.
• F8 at the helm cycles extra tracks by filename, then returns to the boat default.
• Releasing and retaking the helm resets the selected track.
• The captain's selection is shared through player ZDO state; audio files and playback timestamps are not transmitted.
• Listeners missing a selected track fall back to their boat's default song.

0.4.1

• Added full Russian and English documentation, installation instructions and troubleshooting.
• Documented custom tracks, multiplayer limitations and music rights disclaimer.
• Added the published mod page to package metadata.
• Playback behavior is unchanged from 0.4.0.

0.4.0

• Separate tracks for Raft, Karve, Longship and Drakkar.
• Spatial playback while a ship's helm is occupied.
• Live volume configuration.