HTF Custom Radio

Turns the How to Fish radio into a dial with your stations.

The in-game radio isn't a playlist player: it's a dial with channels, each sitting at its own frequency. This mod replaces what those channels play. The radio has 4 channels, so 4 of your stations are on the air at once.

Install it and you're done

Nothing to configure. The mod uses your Windows music folder and turns each subfolder into a station:

Music/
├── Lofi/      -> "Lofi" station
├── Rock/      -> "Rock" station
└── Jazz/      -> "Jazz" station

Drop music in there, load the game, pick up a radio and turn the dial.

Supported formats: .ogg, .wav, .mp3. OGG loads faster and uses less memory.

Prefer a different folder? Put it in MusicFolders (several separated by ;). Want a whole folder to be one single station instead of being split up? Set SplitSubfolders = false.

In-game keys

• F10 — skip to the next song on whatever station you're tuned into. The mod works out which one from the dial, so there's nothing to select.
• F9 — re-scan your folders without restarting the game, handy while setting stations up.

Both are rebindable in the config.

Multiplayer

Works in co-op without anyone else installing it. The tuned frequency is already synced by the game; audio plays locally on each client. Nothing can drift out of sync — you hear your library, your friend hears theirs, both on the same spot of the dial.

Everyone hearing the same thing

Read this before expecting it to work. Right now only the song name travels over the network, never the audio. That means every player must already own the same files, in a folder with the same name. If the host has Rock/song.mp3 and you have Music/song.mp3, nothing happens — the mod tells you so in the log, but nothing plays.

Automatic file transfer, so that only the host needs the music, is being worked on.

With SyncWithHost = true (the default), the host decides which song plays and when, and everyone who does have that file starts it together.

• Players without the mod are completely unaffected — the message is skipped on their end.
• If you're missing a file, your log says exactly which station and song, and you keep playing your own music.
• Set SyncWithHost = false to always hear your own library regardless of the host.

The practical way to use it today: one person picks the music, zips their station folder, and sends it to everyone else to drop into their own music folder. Same folder name, same file names.

Being upfront: this feature could not be tested in a real multiplayer session before release. If something misbehaves, turn it off and please report it.

Internet radio

StreamStations = Lofi=https://example.com/stream.mp3;Jazz=https://other.com/jazz.ogg

The URL must point at a direct audio stream (.mp3 / .ogg), like the ones internet radio stations publish. A YouTube link won't work: Unity plays audio, not web pages. If you want one specific song from YouTube, download it first and drop it in a folder.

Sharing a station pack

To hand a friend a pack with everything included, put the music inside the plugin folder:

BepInEx/plugins/HTFCustomRadio/Stations/
├── 88.5 - Lofi/
│   └── track01.ogg
└── 101.2 - Metal/
    └── whatever.mp3

The mod looks for Stations folders inside any installed plugin, so station packs can be published as separate packages that depend on this one.

Stations are assigned to the dial in alphabetical order. That's deliberate: two players with the same pack get the same order and can talk about the same station.

Options

Troubleshooting

Nothing plays. Check BepInEx/LogOutput.log. On startup the mod logs which folder it is using and which stations it found. An empty list means that folder has no audio in a supported format.

A file gets skipped. Unity failed to decode it. MP3s with unusual tags are the usual culprit — re-export to OGG.

A station stopped by itself. If a station somehow chains tracks at an impossible rate, the mod shuts it down and logs an error instead of eating your memory. Press the reload key to bring it back, and please report it.

Documentación en español: README.es.md dentro del paquete.

Changelog

1.3.2

• Arreglado un fallo silencioso: si el anfitrión emitía una emisora cuyo nombre tú no tenías, no pasaba nada y no se explicaba por qué. Ahora el log dice qué emisora falta y cuáles tienes.
• Añadidas trazas de sincronización en los dos lados: -> enviado a los demás en el anfitrión y <- recibido del anfitrión en el cliente.
• README más honesto sobre el requisito de tener los mismos archivos.

1.3.1

• SyncWithHost viene activado por defecto. A quien no tenga el mod no le afecta: FishNet descarta limpiamente los mensajes que no conoce.
• La sección del ajuste pasa de [Multijugador] a [Multiplayer]. Si lo habías puesto en false a mano, vuelve a desactivarlo.
• Arreglado: con la radio guardada en el inventario, cada reenvío del anfitrión volvía a cargar la canción. Era el mismo agujero de memoria de la 1.1.1 entrando por otra puerta.

1.3.0

• Documentación principal en inglés; el español está en README.es.md dentro del paquete.
• El archivo de configuración cambia de nombre a com.hatsuneexo.htfcustomradio.cfg. Si venías de una versión anterior y habías tocado las opciones, cópialas del archivo viejo (com.adler.htfcustomradio.cfg) o vuelve a ponerlas; el antiguo ya no se lee.
• Ya no hay que configurar nada. El mod usa tu carpeta de música de Windows por defecto y convierte cada subcarpeta en una emisora. Funciona igual aunque tu sistema la muestre como "Música", "Musique" o cualquier otro idioma.
• Añadida sincronización con el anfitrión (SyncWithHost, experimental y desactivada por defecto): el anfitrión decide qué canción suena y todos la oyen a la vez. Requiere que todos tengan el mod y los mismos archivos; por la red solo viaja el nombre de la canción.

1.2.1

• Icono nuevo.

1.2.0

• F10 salta canción en la emisora que estés escuchando. El mod detecta cuál es por el dial.

1.1.1

• Arreglado: guardar la radio en el inventario mientras sonaba música hacía que el mod recargara la pista en bucle y agotara la memoria. Al guardarla, el juego desactiva el AudioSource y el mod interpretaba que la canción había terminado.
• Arreglado: cada cambio de pista dejaba el audio anterior en memoria para siempre.
• Añadido un freno de emergencia: si una emisora encadena pistas a un ritmo imposible, se detiene sola y lo avisa en el log en vez de agotar la memoria.

1.1.0

• MusicFolders: usa carpetas de tu disco como emisoras, sin copiar nada.
• SplitSubfolders: cada subcarpeta se convierte en su propia emisora.
• F9 relee las carpetas sin reiniciar el juego.

1.0.0

• Primera versión: emisoras desde Stations/, emisoras de internet y orden aleatorio.