Skip to content

Optional Client Mod

Proximity Radio Client is optional. Players without it continue through the vanilla resource-pack path.

What the client adds

  • exact joining at the current track position;
  • responsive seeking and synchronized position updates;
  • pause, resume, and stop control without losing server state;
  • mod-side spatial and directional playback;
  • local extraction of track audio from the same generated resource-pack ZIP;
  • correct stop behavior when disconnecting from the server.

The server still controls the radio. The mod cannot add tracks, tiers, or change playback without a server command.

Enable or disable support

client-mod:
  enabled: true

When disabled, every player uses the vanilla resource-pack behavior even if the mod is installed.

Install for players

  1. Use a compatible Fabric installation for the player's Minecraft version.
  2. Install the matching Proximity Radio Client build.
  3. Join the server.
  4. Run /radio status and check that the client is detected.

The direct client page is also available through /radio mod.

Resource-pack relationship

The client mod does not require a second audio host. It reads the same URL configured for the Minecraft resource pack and extracts the required OGG track locally.

The configured pack URL must return the ZIP directly, including on servers where every player uses the mod.

Mixed servers

Modded and vanilla users can listen to the same placed radio. The active track, loop, shuffle, queue, volume, and range remain shared. Only delivery and timestamp accuracy differ.

See Controls and Synchronization for vanilla join modes and synchronization points.