Media Sources

How to point to media and files, and what formats are supported.

Media Sources

OpenAudioMc requires internet-accessible media sources. All audio content must be available via public URLs or supported platforms.

Direct Uploads

  1. 1Visit account.openaudiomc.net/my-files
  2. 2Upload and name your file (e.g. mycoolsong)
  3. 3Use in-game: /oa play @a files:mycoolsong.mp3

Free accounts: 200MB storage, Patreons: 10GB (expandable)

SoundCloud

  • Content must be public
  • Artist must allow third-party playback
  • Not recommended for production use

Limited reliability due to artist restrictions

Custom Web Server

  • Valid domain with SSL certificate
  • Partial content support
  • Recommended formats: .mp3 or .m3u for live sources
  • Keep files under 25MB for reliability

Requires sufficient bandwidth, SSL and CORS configuration

Media Options

fadeTime(Integer)

Fade-in duration in milliseconds

id(String)

Manual reference ID for the media

loop(Boolean)

Should media loop when finished (default: false)

pickUp(Boolean)

Attempt to sync with other listeners (default: false)

expirationTimeout(Integer)

Time window (seconds) for delayed client connections

volume(Integer)

Playback volume (0-100%, relative to user settings)

muteRegions(Boolean)

Mute all regions during playback

muteSpeakers(Boolean)

Mute all speakers during playback

Example configuration:

{fadeTime:1500,id:"spawn",loop:true,pickup:true,expirationTimeout:3600000,volume:50}

Example command with options:

/oa play @a[region=showarea] https://soundcloud.com/example {muteRegions:true,muteSpeakers:true,id:"my-show"}

Javadoc related to this feature (currently based on the dev branch)