Skip to content

Instantly share code, notes, and snippets.

@benaubin
Forked from Sidneys1/gist:ff8d5d0c818e536ebf38
Created December 23, 2015 22:54
Show Gist options
  • Save benaubin/6c33ee98ddc001bc6123 to your computer and use it in GitHub Desktop.
Save benaubin/6c33ee98ddc001bc6123 to your computer and use it in GitHub Desktop.

Syntax

All target selectors start with @. The following character is the selector type. For example, @p means 'closest player'.

Target selectors may have additional, optional arguments. You can specify these in [ ], using the syntax a=0. For example, @p[a=0,b=5,c=-500].

There is a special short syntax for just specifying x, y, z and r arguments; simply list their values separated by a comma, without x=. For example: @p[100,64,-100,5] for 5 range, x=100, y=64 and z=-100. Each of these are optional and skippable by leaving them empty. For example, to just specify y coordinate: @p[,64].

Global Arguments:

(Case sensitive)

  • x - X coordinate for search center. Default is senders coordinate, or 0.
  • y - Y coordinate for search center. Default is senders coordinate, or 0.
  • z - Z coordinate for search center. Default is senders coordinate, or 0.
  • r - Maximum range, number above 0.
  • rm - Minimum range, number above 0.
  • m - Game mode, number above 0.
  • c - Max count of results. Numbers below 0 will make it return the last x amount of entries.
  • l - Maximum experience level, number above 0.
  • lm - Minimum experience level, number above 0.
  • score_name - Maximum value of a scoreboard objective named 'name'.
  • score_name_min - Minimum value of a scoreboard objective named 'name'.
  • team - Scoreboard team name.
  • name - Player or entity name.
  • dx - Volume dimension X. If dx, dy, or dz are specified, search area is cuboid area from point (x,y,z) with dimensions (dx,dy,xz)
  • dy - Volume dimension Y.
  • dz - Volume dimension Z.
  • rx - Maximum vertical orientation.
  • rxm - Minimum vertical orientation.
  • ry - Maximum horizontal orientation.
  • rym - Minimum horizontal orientation.
  • type - Entity type.

Selectors:

  • p - Closest player.
  • a - A list of all players.
  • r - A random player.
  • e - A list of all entities (including players)

All selectors are lists, but only a and e have a default count limit of 0 (unlimited). When using lists in a string context (for example, /say Hello @a) it will list all players as strings. When used as a command argument, it will iterate the command for each player in the list.

Examples

Closest person within 5 blocks. If there's nobody within 5 blocks, the command will fail. @p[r=5]

Closest 10 players within 5 blocks of 100,64,-100. @a[x=100,y=64,z=-100,c=10,r=5]

The furthest 2 players from 0,64,0. @p[0,64,0,c=-2]

The closest 5 players within 10 blocks of your current position. @a[,,,10,c=5]

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment