Sailwind Radio

Play your own music in Sailwind through a physical radio and speakers with 3D audio.

Install

Mod managers

Install Sailwind Radio on Thunderstore through r2modman or Thunderstore Mod Manager, then launch Sailwind through your manager. Dependencies are installed automatically.

Manual installation

1. Install BepInEx 5 in your Sailwind game folder, following its installation instructions.
2. Download and extract the Sailwind Radio ZIP. Copy its BepInEx/plugins/SailwindRadio folder into BepInEx/plugins in your Sailwind folder.
3. Launch Sailwind normally.

Controls

• Use the radio's physical Power, Previous, Pause, Next, Shuffle and Collections buttons to control playback.
• For volume knobs, click on the knob and scroll to adjust it, then click again to release it.
• On the radio, master volume controls all connected outputs, while local volume controls only the radio's built-in speaker.
• Pick up, carry, store and place the radio using Sailwind's normal item controls. Music keeps playing while the radio is carried or in inventory.
• Place a hook somewhere clever and set the radio in a tight corner, or hammer it down if you keep grabbing it off your shelf trying to skip tracks. The Aestrin radio has no handle, so it won't hang from hooks.
• Turning on a second radio turns the one currently playing off. Each keeps its own folder selection, volume, and song position saved.
• Turn a radio off and back on to reload its selected music folders after adding songs.
• With ShowSongOnHover turned on, look at a radio to see the song it is playing.

Configuration

After the first launch, close the game and edit BepInEx/config/local.sailwind.radio.cfg in your active game or mod manager profile. With Configuration Manager installed, the audio and display settings can also be changed in game.

Example folder setup: MusicFolders = D:\Music | E:\Sailing Music. Each folder is one collection, including music within its subfolders. The radio reads file metadata to display title, artist and album tags, and uses the filename when a title tag is missing.

Supported formats:

• MP3, OGG (Vorbis), WAV and FLAC files.
• M4A and AAC files on Windows. These file types are currently turned off automatically on Steam Deck and Linux (Proton).

Sample rates up to 192 kHz are supported, and surround files are mixed down to stereo.

Shop Locations

There are added shop stalls in Gold Rock City, Dragon Cliffs, Fort Aestrin and Chronos. Gold Rock City sells the Al'Ankh set, Dragon Cliffs sells the Emerald set, Fort Aestrin sells the Aestrin set and Chronos sells the original walnut set. GRC's stall is between the shipyard and port office, DC's is near the boxed food seller, FA's is near the Inn and Chronos's is under the empty tent in the main market square.

Speakers

Speakers connect automatically to an active radio within 50 metres when both are on the same vessel or both are ashore. The Small Speaker can mount on surfaces like a hook does. Each output gets quieter with distance, and cabins/some interiors muffle sound across their boundaries.

Each regional set has the same four device roles and audio behavior. The regional radios use their own mechanical title and artist displays: character drums in Al'Ankh, split flaps in Aestrin and a writing scroll in Emerald.

Compatibility

Sailwind Radio has no known incompatibilities.

Licenses and credits

Sailwind Radio includes NLayer 1.16.0 by Mark Heath, Andrew Ward and contributors under the MIT License. Complete notices are included in THIRD_PARTY_NOTICES.md and the release download.

The source code, documentation, original audio, shaders and walnut device models are available under the MIT License. The twelve Al'Ankh, Aestrin and Emerald device models are licensed under CC BY-NC 4.0, which permits sharing and adaptation with attribution for noncommercial use. Commercial use requires separate permission from skeptic043.

AI Use

AI was used to write all of the code in this project. The original concept, design direction, testing, debugging, and release decisions are my own. If you prefer not to use mods developed with AI assistance, I understand and respect that choice.

Issues and links

Report an issue with your settings and BepInEx/LogOutput.log. Redact personal file paths and other private information before posting either one.

Source code · Licenses · Build instructions · Source attribution and dependencies · Support on Ko-fi · skeptic043

Sailwind Radio

1.4.0

New

• You can now snap large speaker and woofers together to stack them, up to 6 pieces high. Radio's can be stacked at the top as well but cannot have speakers stacked on them.
• Speakers and Woofers can be collected and moved using the cargo system, free of charge.
• Added RadioFalloff, SmallSpeakerFalloff, SpeakerFalloff and WooferFalloff settings for how far each output can be heard.
• Added a ShowSongOnHover setting that shows the song a radio is playing in hover text. Defaults to off.

Changed

• Brightened up regional displays for better readability in the dark
• Made the Al'Ankh large speaker a bit bigger

Fixed

• Radios and speakers on your boat stay audible in the boat camera
• The regional Speakers and Woofers colliders match their models better

1.3.0

New

• Added 12 new device models, 4 per region: a radio, small speaker, large speaker and woofer, 1 each for Al'Ankh, Aestrin and Emerald.
• Added mechanical title and artist displays to the regional radios. Al'Ankh uses character drums, Aestrin uses split flaps and Emerald uses a writing scroll.
• Added original mechanism sounds for each regional display. Their volume can be adjusted with MechanismVolume in the config.
• Added a Radio merchant at Chronos that sells the original walnut devices.
• Regional devices use item IDs 43044 through 43055.

Changed

• Gold Rock City now sells the Al'Ankh set, Dragon Cliffs sells the Emerald set and Fort Aestrin sells the Aestrin set.
• Reworked and simplified much of the mod's internal code so it is easier to read and maintain.

1.2.3

Fixed

• A Radio or Small Speaker kept in your inventory no longer counts as part of your boat. With Furniture Fix installed, a Small Speaker could get stuck in an inventory slot after loading a save and boarding a boat. With Deft Hands also installed, this logged an error.

1.2.2

Changed

• Radio now lets Sailwind assign purchased-item identities and complete registration before attaching Radio settings. Existing item IDs, settings and save data are unchanged.

1.2.1

Fixed

• Radios and speakers now use the game's normal purchase flow. This fixes Radio/Speaker controls not working when purchased with the Economy Overhaul mod enabled.

1.2.0

Added

• FLAC playback.
• M4A and AAC playback. These formats are turned off automatically on Steam Deck and Linux (Proton).

Fixed

• OGG tracks no longer freeze the game for about half a second when they start or are prepared as the next track.
• Long OGG files can now play.
• Starting any track should no longer cause a small frame hitch, and very long MP3s start almost immediately.
• WAV files longer than about 12 minutes now play instead of failing to decode.
• 1.1 accidentally removed the ability for the radio to hang on hooks, which has now been restored.
• A valid long track is no longer skipped as broken when selected while the radio is still preparing it.
• An error in one radio no longer stops the whole mod. The radio skips to its next track, and turns itself off if it keeps failing.

Changed

• Every format now streams from disk.
• WAV files support more variants, including 24-bit and 32-bit float.
• Files the radio cannot play are skipped with a log line naming the file.
• Removed routine shop and save-loading warnings from the log.
• The pause button no longer turns a radio on from an off state.
• The startup log line now reports how many music folders are configured, and only asks you to set MusicFolders when none are already set.

1.1.0

Changed

• Radio, Small Speaker, Speaker and Turbo Wolfer now have separate item IDs (43040–43043) and can be spawned through Sailwind's normal item system.
• Devices from older saves migrate from the old donor item to their new item IDs while keeping their saved settings and playback state.

1.0.2

Fixed

• Radio and speaker controls now work with Dizzy Fixes when PreferSittingItemLook is enabled.

Changed

• Slightly increased the Gold Rock City radio merchant's sell range to reach farther across the stall.

1.0.1

Fixed

• Trying to drop a held item near a radio or speaker no longer activates its controls.

Changed

• Replaced the Thunderstore icon with a simpler speaker design.

1.0.0

Play your own music in Sailwind through a portable radio and three matching speakers.

Added

• Play MP3, OGG and WAV files from your configured music folders. Each folder and its subfolders form a collection you can select on the radio.
• Use the radio's physical controls for power, pause, track skipping, shuffle, collections and volume. Its display shows the current track's title, artist and album when that information is available.
• Connect a Small Speaker, Speaker or Turbo Wolfer to the active radio automatically when both are on the same vessel or both are ashore and within 50 metres. Each speaker has its own power and level control.
• Buy radios and speakers from dedicated merchants in Gold Rock City, Dragon Cliffs and Fort Aestrin using each capital's local currency.
• Carry or store a playing radio, place it on a hook, or secure it with a hammer. Radio settings and playback position are saved with the item.

Configuration

• Set MusicFolders in BepInEx/config/local.sailwind.radio.cfg to the folders containing your music. Separate multiple paths with |.
• ContinueWhileSleeping is off by default and can be enabled in the same config file.