Skip to content

Instantly share code, notes, and snippets.

Embed
What would you like to do?
New Minecraft target selector syntax!

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:

  • 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 - Range, number above 0. Default 0 ("No range limit")
  • m - Game mode, number above 0. Default -1 ("No mode limit")
  • c - Max count of results. Default 0 ("No count limit"). Numbers below 0 will make it return the last x amount of entries.

Selectors:

  • p - Closest player.
  • a - A list of all players.
  • r - A random player.

All selectors are lists, but only p has 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

@p[r=5]

Closest person within 5 blocks. If there's nobody within 5 blocks, the command will fail.

@a[x=100,y=64,z=-100,c=10,r=5]

Closest 10 players within 5 blocks of 100,64,-100.

@p[0,64,0,c=-2]

The furthest 2 players from 0,64,0.

@a[,,,10,c=5]

The closest 5 players within 10 blocks of your current position.

@wenjinghuan999
Copy link

wenjinghuan999 commented Oct 28, 2012

It would be nice if I can know whether a command is successfully executed, for example output a redstone signal on the opposite side

@Webmetz
Copy link

Webmetz commented Oct 28, 2012

Posted the original version these on http://www.minecraftforum.net/topic/1487156-new-command-block-commands-list/page__gopid__18816142#entry18816142

Would be nice to have the ability to target mobs.
Creatures (Passive, Hostile, Player):
@nc Nearest
@ac All
@rc Random
@fc Farthest
Passive (Animals, Villagers, etc)
@np Nearest
@ap All
@rp Random
@fp Farthest
Hostile (Skeletons, Zombies, Etc)
@nh Nearest
@ah All
@rh Random
@fh Farthest
EntityNames (Specify an Entity name, or comma delimited list of entity names. Eg. 'Cow,Sheep,Chicken')
@n'EntityNames' Nearest
@A'EntityNames' All
@r'EntityNames' Random
@f'EntityNames' Farthest

/equip (target) (item | north | south | west | east | up | down)
If the item is equipment, it attempts to equip it on the target in its logical spot, causing whatever is equipped in that slot to go into inventory if it has one and dropped if it doesn't or doesn't have a free spot.
Extra Info: If a direction is chosen, it will choose the first valid item from adjacent container on that side and apply it to the target without consuming it.

/apply (target) (item | north | south | west | east | up | down)
If the item is a consumable item (food, potion, not thrown item), it applies the effects of it instantly to the targets.
Extra Info: If a direction is chosen, it will choose the first valid item from adjacent container on that side and apply it to the target without consuming it.

/give (target) (item | north | south | west | east | up | down)
Gives an item to the target. If the target is a NPC, it will attempt to put it in its hand
Extra Info: If a direction is chosen, it will choose the first valid item from adjacent container on that side and apply it to the target without consuming it.

/spawner state (on | 1 | off | 0 | toggle) (north | south | west | east | up | down)
Will set the state of a spawner, preventing it from acting normally. If a direction is not specified, targets all adjacent spawners (if command block), or the targeted spawner (if player).

/spawner set (entityID) (north | south | west | east | up | down)
Overwrites the entity of a spawner. If a direction is not specified, targets all adjacent spawners (if command block), or the targeted spawner (if player).

/spawner trigger (north | south | west | east | up | down)
Triggers a spawner to prematurely spawn. If a direction is not specified, targets all adjacent spawners (if command block), or the targeted spawner (if player).

Someone else posted the original version these on http://www.minecraftforum.net/topic/1487156-new-command-block-commands-list/#entry18116528 I modified them slightly.

/spawn (entityID) (x) (y) (z) (number to spawn)
Spawns an entity. Spawns 1 if a number is not specified.

/block place (block ID) (x) (y) (z)
Places a block at the specified coordinates with a block matching the block ID.

/block set (block ID) (x) (y) (z)
Replaces a block at the specified coordinates with a block matching the block ID. Can be used to remove a block by setting 0 as the block ID.

Note on above, would be nice to be able to do a set of coordinates. Perhaps using {[x,y,z],[x,y,z]} format in order to target multiple locations.

@Durandle
Copy link

Durandle commented Nov 24, 2012

you guys do know that the move command is redundant /move 10 2 10 is the same as /tp ~10 ~2 ~10 since 1.4.4 or earlier

@Durandle
Copy link

Durandle commented Nov 24, 2012

@king92197
the problem probably is that you haven't specified a location to send everyone to the command "/tp @A[180,84,23,64]" translates to "teleport everyone in radius of 64 blocks from location 180,84,23 to ..." see the problem?

@ZeroErrors
Copy link

ZeroErrors commented Nov 26, 2012

I found something that would be useful,
If you were to have wildcard's for the coordinates for example @A[,0,,2] this will get all the players with a y value of 2 or less.
You could use something like '/tp @A[,0,,2] 0 65 0' and teleport everyone that is at y=2 or less so they don't fall into the void.

@tschoffelen
Copy link

tschoffelen commented Jan 10, 2013

"number above 0. Default 0". Shouldn't that be 'number 0 or higher' or something like that?

@MTandi
Copy link

MTandi commented Feb 18, 2013

An implementation of selected player variables can add a lots of new possibilities and minimize amount of command blocks needed for some commands.

For example we can use one command block in re-spawn area to send players in different places depending on class.
/tp @r[0,0,0,5] 10 10 Class*10
Where "Class" is score from scoreboard (or their Level). It acts like "~" in tp command. Players with class 1 will be teleported at z=10, with class 2 at z=20 etc.

It will be also possible to arrange players on pedestal in order of their kills or experience at the end of the match.

If we need 3 players to stay in correct order depending on their role, we can use:
/testfor @A[0,0,Role*10,5].
And it will output signal strength of 3 if all players stay in their places.

And lots more.

@Sidneys1
Copy link

Sidneys1 commented Nov 19, 2014

Updated fork here (as of MC 1.8). No pull request feature on Gist, Dinnerbone needs to update this.

@SkadetteTayne
Copy link

SkadetteTayne commented Oct 20, 2015

how do you make a command block only say something once when the person gets within your specified range of the command block?

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