Skip to content
Retro Docs

Radio Station Framework

Modes

Section titled “Modes”

rs_radio operates through several practical workflow modes. They are not separate resources.

Station Creator/Admin Mode

Section titled “Station Creator/Admin Mode”

Admins use the Station Creator to build and publish station content from inside the game.

Typical behavior:

  • Admin opens the Station Creator with /radiostationadmin.
  • Admin creates or edits stations.
  • Station identity, genre, mic channel, and branding colors are configured in the UI.
  • Music, ads, SFX, placement, and review/publish state are managed in the UI.
  • Station Creator access is controlled by admin groups or ACE, depending on config.

Emitter FX Admin Mode

Section titled “Emitter FX Admin Mode”

Admins use the Emitter FX panel to test and tune world emitter presentation.

Typical behavior:

  • Admin opens the panel with /radioemitterfx.
  • Panel access is restricted to configured radio/admin permissions.
  • It is used for emitter preview/testing and admin-side tuning workflows.
  • Normal players do not need this panel for listening, DJing, or boombox use.

DJ-Controlled Live Mode

Section titled “DJ-Controlled Live Mode”

An active DJ controls the station from the DJ UI.

Typical behavior:

  • DJ goes live from the booth/tablet.
  • Music is loaded to Deck A or Deck B.
  • Crossfader and master volume control the live mix.
  • Mic can broadcast over music.
  • Calls, weather, ads, SFX, and playlist tools are available.
  • Cohosts can participate through the supported cohost workflow.
  • If enabled, /radiotablet can be used as a DJ tablet shortcut; otherwise DJs use the booth/location workflow.

Autonomous Mode

Section titled “Autonomous Mode”

The station continues without an active DJ.

Typical behavior:

  • Scheduler rotates music and ads.
  • The station avoids dead air.
  • Autonomous-only stations can exist without a DJ booth.
  • DJs can still run player-led stations when allowed by config/state.

Listener Vehicle Mode

Section titled “Listener Vehicle Mode”

This is the normal vehicle radio flow.

Typical behavior:

  • Player opens the listener UI in a vehicle.
  • Default keybind is configured by Config.VehicleRadioKeybind.
  • /radiolistenerui opens the listener UI.
  • /radiolisten opens the listener UI or toggles vehicle radio with on, off, or toggle.
  • Player selects an available station.
  • Vehicle becomes the emitter for the selected station.
  • Vehicle audio uses distance, EQ, low-pass, ducking, and cabin muffling.
  • Listener UI actions stay tied to the vehicle the UI opened from.

Portable Boombox Mode

Section titled “Portable Boombox Mode”

This is the carried or placed prop emitter workflow.

Typical behavior:

  • Player uses the radio_boombox item.
  • Boombox can be carried, placed, picked up, or stored.
  • Other players can see carried boombox props.
  • Listener UI can control the boombox source.
  • Boombox emitters do not inherit vehicle cabin muffling.

Wearable Walkboy Mode

Section titled “Wearable Walkboy Mode”

Typical behavior:

  • Player uses the radio_walkboy item.
  • The Walkboy animates from the hand to the hip and headphones appear.
  • The carry prompt offers Open and Store without a placement control.
  • The listener UI uses the Walkboy as its portable audio context.

Private Caller Screening Mode

Section titled “Private Caller Screening Mode”

This is the first stage of call handling.

Typical behavior:

  • Listener requests a call.
  • DJ accepts the caller.
  • Caller and DJ are connected privately.
  • Caller is not yet heard by everyone.

Patched Caller Live Mode

Section titled “Patched Caller Live Mode”

This is the on-air call stage.

Typical behavior:

  • DJ patches the caller live.
  • Caller joins the station mic participant path.
  • Listeners hear the caller through the normal broadcast route.
  • DJ can return the caller to private mode or drop the call.

Cohost Mode

Section titled “Cohost Mode”

Cohosts support a live DJ without becoming a second independent DJ.

Typical behavior:

  • Live DJ invites nearby cohosts from the DJ UI, or with /radiocohost add [serverId].
  • Cohosts accept or decline through the UI, or with /radioacceptcohost and /radiodeclinecohost.
  • DJ can remove a cohost with /radiocohost remove [serverId].
  • Cohost monitor mode lets cohosts hear the active DJ/deck mix where supported.
  • Cohost UI mirrors DJ show state while DJ-only controls remain restricted.

Weather Consumer Mode

Section titled “Weather Consumer Mode”

When external weather authority is enabled, rs_radio consumes weather state.

Typical behavior:

  • reads weather from the configured weather resource
  • displays weather in DJ/listener contexts
  • supports station weather flavor
  • does not apply competing world weather

Common Commands

Section titled “Common Commands”

Normal/admin-facing commands:

  • /radiostationadmin - open Station Creator/Admin UI for authorized admins.
  • /radioemitterfx - open the Emitter FX panel for authorized admins.
  • /radiolistenerui - open or close the listener UI.
  • /radiolisten - open listener UI, or use /radiolisten on, /radiolisten off, /radiolisten toggle.
  • /radiotablet - optional DJ tablet shortcut when Config.EnableDJTabletCommand = true.
  • /radiocohost add [serverId] - invite a nearby cohost while live.
  • /radiocohost remove [serverId] - remove a cohost.
  • /radioacceptcohost - accept a pending cohost invite.
  • /radiodeclinecohost - decline a pending cohost invite.

Internal QA and troubleshooting commands may exist in source builds, but they are not part of the normal server-owner workflow.