logo
More

Do you need an account?

Are you a player on a server, or an owner/admin?

Only people who manage a server need an account to link to the plugin. Regular players can just use /audio in-game without needing to register

Continue with registration

Player selectors

A player selector is a filter that tells OpenAudioMc who should receive a command. Use selectors to target a single player, a group of players, or every player on the server. Selectors follow Minecraft selector syntax and accept additional filters in square brackets.

Select a player by name

To target a specific player use their exact in game name. Names are case sensitive.

Command Example
/openaudiomc play John
<>Required
[]Optional

Select everyone

To target every player on the server use the all players selector.

Command Example
/openaudiomc play @a
<>Required
[]Optional

Select players by WorldGuard region

This requires WorldGuard to be installed. In some setups that use a proxy such as BungeeCord or Velocity the region selector may not function when run manually from chat. If you run into issues try executing the command from a command block.

Example targeting the region named myregion:

Command Example
/openaudiomc play @a[region=myregion]
<>Required
[]Optional

Select players by server

This selector is available when OpenAudioMc runs on a proxy such as BungeeCord or Velocity. It only works when issued from the chat or the proxy console.

Example targeting players on the server named lobby:

Command Example
/openaudiomc play @a[server=lobby]
<>Required
[]Optional

Select players by radius

Use the radius filter to target players near a point. The radius is measured in blocks.

Example targeting players within 100 blocks of the command origin:

Command Example
/openaudiomc play @a[r=100]
<>Required
[]Optional

Change the origin location

By default the origin for radius calculations is the player or command block that ran the command. Override the origin by adding x, y and z coordinates to the selector. Chain the coordinates with the radius to target players around that location.

Example targeting players within 100 blocks of coordinates 100, 100, 100:

Command Example
/openaudiomc play @a[r=100,x=100,y=100,z=100]
<>Required
[]Optional

Tips and notes

  • Selectors accept multiple filters combined inside the same brackets. For example you can combine region and radius filters where supported.
  • When using region selectors verify WorldGuard is loaded and that the region name is correct.
  • When using server selectors make sure you run the command from a proxy aware context such as proxy chat or the proxy console.
  • If a selector does not behave as expected test it in a command block to rule out chat parsing differences.

If you want I can convert these examples into a short reference snippet for your docs site or create a sample command list with common selector patterns.