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.
  • synchronized automatic track transitions across Pro connected radio speakers.

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.

The plugin and client mod must use compatible protocol versions. Incompatible client builds safely fall back to vanilla playback.

In Pro connected groups, the client keeps every physical source on the same playback timeline.

Resource-pack relationship

Normally, the client mod does not require a second audio host. It obtains the required OGG track from the pack URL selected by the server.

In EXTERNAL mode, the configured URL must return the standalone generated radio ZIP directly. In BUILTIN mode, the mod uses the plugin's direct /audio/<track>.ogg endpoint.

When ItemsAdder owns resource-pack delivery, Proximity Radio reads the current combined-pack URL through the official ItemsAdder API. The client mod downloads that ZIP and extracts its assets/proximityradio track. If ItemsAdder has no valid URL yet, the mod falls back to the hosting source configured in Proximity Radio and the server logs a warning.

See Hosting with ItemsAdder for both hosting paths and the exact rebuild order.

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.