Special arguments
Page is updated to match version 0.7
This page describes how to properly enter special arguments.
{location}
Syntax: <X>;<Y>;<Z>;{world};[yaw];[pitch]
Defaults:
- yaw: 0
- pitch: 0
Special cases:
- Location can also be one of reserved words. All reserver words can be changed in configuration.
- 'here' - current position of the player typing the command (can't be used in console)
- 'block' - location of the block the player is currently looking at (can't be used in console)
- 'player' - location of a player doing the quest
Examples | |
---|---|
100;70;100;world | x 100, y 70, z 100, world 'world' |
-285;120;-35;this | the world player is currently in |
here | players current location (including yaw & pitch) |
50.5;50.5;50.42;this;20.3;48 | yaw 20.3, pitch 48 |
{region}
Not available in 0.6.
Syntax: <region type>[|additional data]
Defaults: none
Types:
- ANYWHERE - location matches anywhere
- WORLD|{world} - location matches in the defined world
- SPHERE|{location}|<range> - location maches inside the defined sphere (range is positive real number)
- CUBOID|{location}|{location} - location matches inside the defined cuboid
Special cases: none
Examples | ||
---|---|---|
WORLD | matches anywhere in default nether world | |
SPHERE | matches up to 13.5 blocks from current position | |
CUBOID | matches everything between selected block and center of the map |
{world}
Syntax: world name
Defaults: none
Special cases:
- world name can also be word 'this', which means world the player typing the command is currently in (can't be used in console)
- reserved word 'this' can be changed in config
Examples | |
---|---|
world_nether | |
this |
{enchants}
Syntax: {enchant},{enchant},...
Examples | |
---|---|
damage_all:5,knockback:2 | |
32:3,33:1,34:2 |
{enchant}
Syntax: <enchant ID or name>:<numeric level>
Defaults: none
Special cases: none
Examples | |
---|---|
ARROW_DAMAGE:5 | Power V |
18:4 | Bane of Arthropods IV |
oxygen:3 | Respiration III |
{item}/{block}
Syntax: <item ID or name>[:item data]
Defaults:
- [item data] - ANY item data where applicable OR 0
Special cases: none
Examples | |
---|---|
3 | dirt |
wood:2 | birch wood |
351:12 | light blue dye |
{hand}
See {item}
{occasion}
Syntax: <occasion>[:delay in seconds]
Defaults:
- [delay in seconds] - 0
Occasions:
- -1 = Quest start
- -2 = Quest cancel
- -3 = Quest complete
- non-negative number = objetive with that ID complete
Special cases: none
Examples | |
---|---|
-3 | on quest completion |
-2:10 | 10 seconds after quest cancel |
2 | on completion of objective ID 2 |
{entity}
Syntax: bukkit entity name or entity ID
Defaults: none
Special cases: none
Examples | |
---|---|
creeper | well... creeper |
56 | ghast |
{color}
Syntax: bukkit color name or color ID
Defaults: none
Special cases: none
Examples | |
---|---|
magenta | |
3 | light blue |
{click}
Syntax: left / right / push / any
Defaults: none
Special cases:
- push means pressure plate interaction
- unknown word is counted as ANY
Examples | |
---|---|
right | |
push | |
whatever | unknown, counts as ANY |
{potion effect}
version 0.6 uses colon ':' as a separator.
Syntax: <effect ID or name>;<duration>[;amplifier]
Defaults:
- [amplifier] - 0 (lvl 1 effect)
Special cases: none
Examples | ||
---|---|---|
14;30 | 30 seconds of invisibility | |
speed;120;1 | 2 minutes of lvl 2 speed | |
heal;0 | healing potion lvl 1 |