The system recognizes 91 commands!
Search:

echo (Common)

reload (Common)

yaml (Common)


absorption (Entity)

addaitask (Entity)

air (Entity)

burn (Entity)

cast (Entity)

defuse (Entity)

detonate (Entity)

drop (Entity)

editentity (Entity)

equip (Entity)

flag (Entity)

glow (Entity)

heal (Entity)

hurt (Entity)

invisible (Entity)

lookat (Entity)

mount (Entity)

prime (Entity)

remove (Entity)

removeaitasks (Entity)

spawn (Entity)

target (Entity)

teleport (Entity)

unflag (Entity)

vanish (Entity)


createinventory (Items)

forgetinventory (Items)

give (Items)

rememberinventory (Items)


actionbar (Player)

advancement (Player)

ban (Player)

cooldown (Player)

createbossbar (Player)

editbossbar (Player)

feed (Player)

hotbar (Player)

kick (Player)

narrate (Player)

pardon (Player)

removebossbar (Player)

removerespawn (Player)

setrespawn (Player)

tablist (Player)

take (Player)

tell (Player)

title (Player)


addto (Queue)

assert (Queue)

choose (Queue)

define (Queue)

determine (Queue)

else (Queue)

foreach (Queue)

goto (Queue)

if (Queue)

inject (Queue)

mark (Queue)

pause (Queue)

random (Queue)

repeat (Queue)

require (Queue)

resume (Queue)

run (Queue)

stop (Queue)

undefine (Queue)

wait (Queue)

while (Queue)


announce (Server)

execute (Server)

savedata (Server)

shutdown (Server)


httpserver (Webizen2)


deleteworld (World)

difficulty (World)

editblock (World)

explode (World)

gamemode (World)

loadworld (World)

playeffect (World)

playsound (World)

removegamerule (World)

setblock (World)

setgamerule (World)

strike (World)

unloadworld (World)

viewdistance (World)

weather (World)
echo
Common Commandecho
SourceDenizen2Core at: Denizen2Core-master/src/main/java/com/denizenscript/denizen2core/commands/commoncommands/EchoCommand.java on line 9
Required Addon(s)None
Arguments<text to echo>
Argument LimitsFrom 1 to 1 arguments.
Short Descriptionechoes text back to the input command line.
Last Updated2016/04/02
Is Procedural?true
Full DescriptionEchoes text back to the input command line.
TODO: Explain more?
Example
# This example outputs the text "Hello World!" to console.
- echo "Hello World!"
reload
Common Commandreload
SourceDenizen2Core at: Denizen2Core-master/src/main/java/com/denizenscript/denizen2core/commands/commoncommands/ReloadCommand.java on line 11
Required Addon(s)None
Arguments[debug boolean]
Argument LimitsFrom 0 to 1 arguments.
Short Descriptionreloads the script engine, recalculating any scripts available.
Last Updated2016/08/07
Is Procedural?false
Full DescriptionReloads the script engine, recalculating any scripts available.
TODO: Explain more?
Example
# This example reloads all scripts.
- reload
yaml
Common Commandyaml
SourceDenizen2Core at: Denizen2Core-master/src/main/java/com/denizenscript/denizen2core/commands/filecommands/YamlCommand.java on line 20
Required Addon(s)None
Arguments<id> 'create'/'load'/'save'/'set'/'setobject'/'remove'/'close' [path] [value]
Argument LimitsFrom 2 to 4 arguments.
Short Descriptionhandles and manipulates YAML-formatted data.
Last Updated2016/04/02
Is Procedural?false
Full DescriptionHandles and manipulates YAML-formatted data.
This system can work entirely in RAM, but also interacts within the file system so far as the
implementing engine permits.
You can create a dataset in memory, or load a dataset from disk, or save to disk, or set a value, or setobject
an object-defined value, or remove a key, or close a dataset (preventing it from being accessed further).
Note that depending on sub-command, the path argument can refer to either the YAML key or a disk file path.
Note that YAML format includes the specification that a key is split along the dot '.' symbol.
So for key 'a.b.c', it will output key 'a' contains key 'b' contains key 'c'.
An ID must be included to uniquely identify a YAML dataset while its held in memory.
IDs are case-insensitive currently, but it is good practice to use consistent casing.
This is NOT a guaranteed property: case-sensitivity may be enabled in the future!
Note that internal YAML data is manipulated as strings.
Also, lists in the set command are automatically split to a YAML list - this only happens if the input is a list-typed object.
It is strongly recommended to use the 'setobject' subcommand to more accurately track objects with their types where possible!
TODO: Set/Read MAPS support!
Example
# This example creates an empty YAML file, and remembers it as file ID 'test'.
- yaml 'test' create
Example
# This example loads a YAML file 'mydata.yml' in the default data folder, and remembers it as file ID 'test'.
- yaml 'test' load 'mydata'
Example
# This example edits the YAML data loaded as ID 'test' to now have the key 'a.b' set to 'demo'.
- yaml 'test' set 'a.b' 'demo'
Example
# This example edits the YAML data loaded as ID 'test' to now have the key 'a.b' set to an integer of 5, as an object!
- yaml 'test' setobject 'a.b' '<integer[5]>'
Example
# This example edits the YAML data loaded as ID 'test' to no longer have the key 'a.b'.
- yaml 'test' remove 'a.b'
Example
# This example saves the YAML data loaded as ID 'test' to file 'mydata.yml'.
- yaml 'test' save 'mydata'
Example
# This example forgets the YAML file loaded as 'test'.
- yaml 'test' close
absorption
Entity Commandabsorption
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/entity/AbsorptionCommand.java on line 14
Required Addon(s)None
Arguments<entity> <value>
Argument LimitsFrom 2 to 2 arguments.
Named Argoperation (TextTag) Sets whether the command will add or set the value.
Short Descriptionchanges the absorption points of an entity.
Last Updated2018/06/15
Is Procedural?false
Full DescriptionChanges the absorption points of an entity. You can specify whether
the command will 'add' or 'set' the points. Defaults to 'add'.
Example
# This example increases the player's absorption points by 10 (5 golden hearts).
- absorption <player> 10
addaitask
Entity Commandaddaitask
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/entity/AddAITaskCommand.java on line 38
Required Addon(s)None
Arguments<entity> <task type>
Argument LimitsFrom 2 to 2 arguments.
Named Argpriority (IntegerTag) Sets the priority to run this task.
Named Arggoal (TextTag) Sets to which goal will the task be added.
Named Argspeed (NumberTag) Sets the speed parameter for task types 'attack_living', 'range', 'run_around' and 'wander'.
Named Argmemory (BooleanTag) Sets the memory parameter for task type 'attack_living'.
Named Argclose_speed (NumberTag) Sets the close_speed parameter for task type 'avoid_entity'.
Named Argfar_speed (NumberTag) Sets the far_speed parameter for task type 'avoid_entity'.
Named Argdistance (NumberTag) Sets the distance parameter for task types 'avoid_entity', 'range' and 'watch_closest'.
Named Argchance (IntegerTag/NumberTag) Sets the chance parameter for task types 'find_target' (IntegerTag), 'swim' (NumberTag), 'wander' (IntegerTag) and 'watch_closest' (NumberTag).
Named Argtarget (EntityTypeTag) Sets the target parameter for task types 'find_target' and 'watch_closest'.
Named Argdelay (DurationTag) Sets the delay parameter for task type 'range'.
Short Descriptionadds an AI task to an entity's goal.
Last Updated2018/06/15
Is Procedural?false
Full DescriptionAdds an AI task to an entity's goal. Priority defaults to 0. The lower the priority is,
the sooner the task will run in the goal. The default goal is 'normal'.
Note: adding a task won't overwrite existing tasks of the same type.
Related information: <@link explanation AI Goal Types>AI goal types<@/link>.
Related information: <@link explanation AI Task Types>AI task types<@/link>.
Related commands: <@link command removeaitasks>removeaitasks<@/link>.
Example
# Makes the zombie in front of the player sink in water.
- addaitask <player.target_entities[type:zombie].get[1]> swim --chance 0.0 --priority -10 --goal normal
air
Entity Commandair
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/entity/AirCommand.java on line 14
Required Addon(s)None
Arguments<entity> <duration>
Argument LimitsFrom 2 to 2 arguments.
Named Argtype (TextTag) Sets of what type the air level will be.
Named Argoperation (TextTag) Sets whether the command will add or set the value.
Short Descriptionchanges the air level of the entity.
Last Updated2017/04/19
Is Procedural?false
Full DescriptionChanges the air level of the entity. Optionally specify a type ('remaining' or 'maximum')
to adjust the specified air level type. Defaults to 'remaining'. Also specify whether
the command will 'add' or 'set' the value. Defaults to 'add'.
Example
# This example completely fills the air bar of the player
- air <player> <player.max_air> --operation set
burn
Entity Commandburn
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/entity/BurnCommand.java on line 14
Required Addon(s)None
Arguments<entity> <duration>
Argument LimitsFrom 2 to 2 arguments.
Named Argoperation (TextTag) Sets whether the command will add or set the value.
Short Descriptionsets an entity on fire.
Last Updated2018/06/15
Is Procedural?false
Full DescriptionSets an entity on fire for the specified duration. You can also specify whether
the command will 'add' or 'set' the duration. Defaults to 'add'.
Example
# This example sets the player on fire for additional 5 seconds.
- burn <player> 5s
cast
Entity Commandcast
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/entity/CastCommand.java on line 30
Required Addon(s)None
Arguments<entity> <effect> <duration>
Argument LimitsFrom 3 to 3 arguments.
Named Argamplifier (IntegerTag) Sets the potion effect amplifier.
Named Argambient (BooleanTag) Sets whether the effect will be ambient or not.
Named Argparticles (BooleanTag) Sets whether the effect will show particles or not.
Short Descriptioncasts a potion effect on an entity.
Last Updated2017/04/01
Is Procedural?false
Full DescriptionCasts a potion effect on an entity for the specified duration.
Particles are set to true by default, and ambient to false.
Related information: <@link explanation Potion Effect Types>potion effect types<@/link>.
Example
# This example casts 'poison' on the player for 5 seconds
- cast <player> poison 5s
defuse
Entity Commanddefuse
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/entity/DefuseCommand.java on line 12
Required Addon(s)None
Arguments<entity>
Argument LimitsFrom 1 to 1 arguments.
Short Descriptiondefuses an explosive entity.
Last Updated2018/01/10
Is Procedural?false
Full DescriptionDefuses an explosive entity. Inverse of <@link command prime>prime<@/link>.
Example
# This example defuses the creeper the player is looking at.
- defuse <player.target_entities[type:creeper].get[1]>
WarningThis command does not work in Sponge during last testing.
detonate
Entity Commanddetonate
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/entity/DetonateCommand.java on line 12
Required Addon(s)None
Arguments<entity>
Argument LimitsFrom 1 to 1 arguments.
Short Descriptioninstantly detonates an explosive entity.
Last Updated2018/01/10
Is Procedural?false
Full DescriptionInstantly detonates an explosive entity.
Example
# This example detonates the creeper the player is looking at.
- detonate <player.target_entities[type:creeper].get[1]>
drop
Entity Commanddrop
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/entity/DropCommand.java on line 17
Required Addon(s)None
Arguments<item> <location>
Argument LimitsFrom 2 to 2 arguments.
Short Descriptiondrops an item.
Last Updated2017/05/05
Is Procedural?false
Full DescriptionDrops an item at the specified location.
Related information: <@link explanation Item Types>item types<@/link>.
Tag<[drop_entity]> (EntityTag) returns the item entity that was dropped.
Example
# Drops a diamond at the player's feet.
- drop diamond <player.location>
editentity
Entity Commandeditentity
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/entity/EditEntityCommand.java on line 19
Required Addon(s)None
Arguments<entity> <map of properties>
Argument LimitsFrom 2 to 2 arguments.
Short Descriptionedits an entity.
Last Updated2016/09/26
Is Procedural?false
Full DescriptionEdits an entity to have the specified map of new properties.
Example
# Lights the player on fire.
- editentity <player> fire_ticks:999999
equip
Entity Commandequip
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/entity/EquipCommand.java on line 20
Required Addon(s)None
Arguments<entity> <equipment map>
Argument LimitsFrom 2 to 2 arguments.
Short Descriptionequips an entity according to a given equipment map.
Last Updated2017/03/03
Is Procedural?false
Full DescriptionEquips an entity according to a given equipment map.
Valid equipment keys: HEAD, CHESTPLATE, LEGGINGS, BOOTS, HAND, OFF_HAND
TODO: Saddle, Horse_Armor
TODO: Explain more!
Example
# This example equips a player with a full set of iron armor.
- equip <player> head:iron_helmet|chestplate:iron_chestplate|boots:iron_boots|leggings:iron_leggings
flag
Entity Commandflag
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/entity/FlagCommand.java on line 27
Required Addon(s)None
Arguments<entity>/'server' <map of flags to set>
Argument LimitsFrom 2 to 2 arguments.
Named Argduration (DurationTag) Sets the duration to apply to the flags being set.
Short Descriptionflags an entity with some data.
Last Updated2017/02/15
Is Procedural?false
Full DescriptionAdds or edits flags on an entity (including players, etc.).
See also the <@link command unflag>unflag command<@/link>.
Example
# Mark the player as a VIP.
- flag <player> vip:true
Example
# Increase the player's XP by 5, reverting to 0 (unset) after one minute.
- flag <player> xp:<player.flag[xp].add[5]||5> --duration 1m
glow
Entity Commandglow
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/entity/GlowCommand.java on line 13
Required Addon(s)None
Arguments<entity> <state>
Argument LimitsFrom 2 to 2 arguments.
Short Descriptionmanages the glowing outline of an entity.
Last Updated2018/06/15
Is Procedural?false
Full DescriptionManages the glowing outline of an entity.
TODO: Allow setting glow color (might require scoreboard weirdness)
Example
# This example makes the player glow.
- glow <player> true
heal
Entity Commandheal
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/entity/HealCommand.java on line 15
Required Addon(s)None
Arguments<entity> <amount>
Argument LimitsFrom 2 to 2 arguments.
Named Argtype (TextTag) Sets of what type the health will be.
Named Argoperation (TextTag) Sets whether the command will add or set the value.
Short Descriptionchanges the health of the entity.
Last Updated2017/04/19
Is Procedural?false
Full DescriptionChanges the health of the entity. Optionally specify a type ('remaining' or 'maximum')
to adjust the specified health type. Defaults to 'remaining'. Also specify whether
the command will 'add' or 'set' the value. Defaults to 'add'.
Example
# This example heals the player for 4 points (2 hearts)
- heal <player> 4
hurt
Entity Commandhurt
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/entity/HurtCommand.java on line 30
Required Addon(s)None
Arguments<entity> <amount>
Argument LimitsFrom 2 to 2 arguments.
Named Argabsolute (BooleanTag) Sets whether the damage is absolute or not.
Named Argtype (TextTag) Sets of what type the damage will be.
Short Descriptiondamages the entity for the specified amount.
Last Updated2017/04/01
Is Procedural?false
Full DescriptionDamages the entity for the specified amount. This damage is absolute by default.
Related information: <@link explanation Damage Types>damage types<@/link>.
Example
# This example hurts the player for 4 points (2 hearts) of damage
- hurt <player> 4
invisible
Entity Commandinvisible
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/entity/InvisibleCommand.java on line 13
Required Addon(s)None
Arguments<entity> <state>
Argument LimitsFrom 2 to 2 arguments.
Short Descriptionchanges the invisibility state of an entity.
Last Updated2018/02/11
Is Procedural?false
Full DescriptionChanges the invisibility state of an entity. Invisible entities can't be seen,
but update packets are still sent to the server and clients.
Related commands: <@link command vanish>vanish<@/link>.
Example
# Makes the player invisible.
- invisible <player> true
lookat
Entity Commandlookat
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/entity/LookAtCommand.java on line 14
Required Addon(s)None
Arguments<entity> <location>
Argument LimitsFrom 2 to 2 arguments.
Short Descriptionmakes an entity look at a location.
Last Updated2017/10/02
Is Procedural?false
Full DescriptionMakes a living entity look at a location. This will rotate the entity's head, but not its body.
Example
# This example makes the target entity of the player look at him in the eye
- lookat <player.entities_on_cursor.get[1]> <player.eye_location>
mount
Entity Commandmount
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/entity/MountCommand.java on line 13
Required Addon(s)None
Arguments<entity> <entity list>
Argument LimitsFrom 2 to 2 arguments.
Short Descriptionmounts all the entities in the list onto the given entity.
Last Updated2017/02/12
Is Procedural?false
Full DescriptionMounts all the entities in the list onto the given entity.
TODO: Explain more!
Example
# This example mounts the player on the nearest minecart (or errors if there is none!)
- mount <player.location.nearby_entities[type:minecart|range:3].get[1]> <player>
prime
Entity Commandprime
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/entity/PrimeCommand.java on line 12
Required Addon(s)None
Arguments<entity>
Argument LimitsFrom 1 to 1 arguments.
Short Descriptionprimes an explosive entity.
Last Updated2018/01/10
Is Procedural?false
Full DescriptionPrimes an explosive entity. Inverse of <@link command defuse>defuse<@/link>.
Example
# This example primes the creeper the player is looking at.
- prime <player.target_entities[type:creeper].get[1]>
WarningThis command does not work in Sponge during last testing.
remove
Entity Commandremove
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/entity/RemoveCommand.java on line 13
Required Addon(s)None
Arguments<entity list>
Argument LimitsFrom 1 to 1 arguments.
Short Descriptionremoves a list of entities.
Last Updated2017/04/02
Is Procedural?false
Full DescriptionRemoves a list of entities from the world.
Related commands: <@link command spawn>spawn<@/link>.
Example
# This example removes all zombies within a 3 block range of the player
- remove <player.location.nearby_entities[type:zombie|range:3]>
removeaitasks
Entity Commandremoveaitasks
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/entity/RemoveAITasksCommand.java on line 29
Required Addon(s)None
Arguments<entity> <task type>
Argument LimitsFrom 2 to 2 arguments.
Named Arggoal (TextTag) Sets to from which goal the tasks will be removed.
Short Descriptionremoves AI tasks from an entity's goal.
Last Updated2018/01/27
Is Procedural?false
Full DescriptionRemoves all AI tasks of the specified type from an entity's goal.
Related information: <@link explanation AI Goal Types>AI goal types<@/link>.
Related information: <@link explanation AI Task Types>AI task types<@/link>.
Related commands: <@link command addaitask>addaitask<@/link>.
Example
# Makes the zombie in front of the player stop wandering around.
- removeaitasks <player.target_entities[type:zombie].get[1]> wander --goal normal
spawn
Entity Commandspawn
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/entity/SpawnCommand.java on line 34
Required Addon(s)None
Arguments<entity type> <location> [map of properties]
Argument LimitsFrom 2 to 4 arguments.
Named Argcause (TextTag) Sets what caused this entity to spawn.
Named Argaitasks (MapTag) Sets a map of AI tasks (each of which takes a map itself as a value) to apply to the entity on spawn.
Short Descriptionspawns a new entity.
Last Updated2018/06/10
Is Procedural?false
Full DescriptionSpawns an entity of the specified entity type or from a script at a location.
Optionally, specify a MapTag of properties to spawn the entity with those values
automatically set on it. The MapTag can also contain an "orientation" key with a
LocationTag and a "clear_ai_tasks" key with either a "normal" or "target" TextTag.
You can also specify a MapTag with task types as keys and MapTags of properties as
values to give the entity some custom behavior on spawn.
Related information: <@link explanation Entity Types>entity types<@/link> and <@link explanation Spawn Causes>spawn causes<@/link>.
Related commands: <@link command remove>remove<@/link>.
Tag<[spawn_success]> (BooleanTag) returns whether the spawn passed.
Tag<[spawn_entity]> (EntityTag) returns the entity that was spawned (only if the spawn passed).
Example
# Spawns a sheep that feels the burn.
- spawn sheep <player.location> display_name:<texts.for_input[text:Bahhhb]>|max_health:300|health:300|fire_ticks:999999|is_sheared:true
Example
# Spawns the custom mob "cool_zombie" with the "breeding" spawn cause.
- spawn cool_zombie <player.location> --cause breeding
Example
# Spawns a skeleton, clears its AI Tasks for goal "normal", and then makes it sink on water.
- spawn skeleton <player.location> clear_ai_tasks:normal --aitasks swimming:<map[chance:0].escaped>
target
Entity Commandtarget
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/entity/TargetCommand.java on line 12
Required Addon(s)None
Arguments<entity> <target entity>
Argument LimitsFrom 2 to 2 arguments.
Short Descriptionsets the target entity of an entity's AI.
Last Updated2018/01/16
Is Procedural?false
Full DescriptionSets the target entity of an entity's AI. This overrides the AI's target selector.
Example
# This example makes an iron golem in front of the player attack him.
- target <player.target_entities[type:iron_golem].get[1]> <player>
teleport
Entity Commandteleport
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/entity/TeleportCommand.java on line 12
Required Addon(s)None
Arguments<entity> <location>
Argument LimitsFrom 2 to 2 arguments.
Named Argrotation (LocationTag) Sets the entity's rotation.
Short Descriptionteleports the entity to a location.
Last Updated2017/10/18
Is Procedural?false
Full DescriptionTeleports the entity to a location. Optionally specify a rotation.
TODO: Explain more!
Example
# This example teleports the player five blocks upward
- teleport <player> <player.location.add[0,5,0]>
unflag
Entity Commandunflag
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/entity/UnflagCommand.java on line 22
Required Addon(s)None
Arguments<entity>/'server' <list of flags to remove>
Argument LimitsFrom 2 to 2 arguments.
Short Descriptionremoves a list of flags from an entity.
Last Updated2017/02/15
Is Procedural?false
Full DescriptionRemoves flags from an entity (including players, etc.).
See also the <@link command flag>flag command<@/link>.
Example
# Mark the player as no longer VIP.
- unflag <player> vip
vanish
Entity Commandvanish
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/entity/VanishCommand.java on line 14
Required Addon(s)None
Arguments<entity> <state>
Argument LimitsFrom 2 to 2 arguments.
Named Argignore_collisions (BooleanTag) Sets whether this vanished entity can collide with other entities.
Named Arguntargetable (BooleanTag) Sets whether this vanished entity can be selected as a target.
Short Descriptionchanges the vanish state of an entity.
Last Updated2018/02/11
Is Procedural?false
Full DescriptionChanges the vanish state of an entity. Vanished entities don't send packets to clients,
but they can still affect collisions or target selection server-side. This can be adjusted
with the "ignore_collisions" and "untargetable" named arguments.
but update packets are still sent to the server and clients.
Related commands: <@link command invisible>invisible<@/link>.
Example
# Vanishes the player and makes it untargetable and uncollidable.
- vanish <player> true --ignore_collisions true --untargetable true
createinventory
Items Commandcreateinventory
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/items/CreateInventoryCommand.java on line 15
Required Addon(s)None
Arguments<type>
Argument LimitsFrom 1 to 1 arguments.
Short Descriptioncreates a new inventory.
Last Updated2017/06/11
Is Procedural?false
Full DescriptionCreates a new inventory of the given type.
See also the <@link command rememberinventory>rememberinventory command<@/link>.
Savecreateinventory_inv (InventoryTag) returns the created inventory.
Example
# This example creates an inventory and saves it in definition "test_inv".
- createinventory CHEST --save test_inv
forgetinventory
Items Commandforgetinventory
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/items/ForgetInventoryCommand.java on line 13
Required Addon(s)None
Arguments<inventory/name>
Argument LimitsFrom 1 to 1 arguments.
Short Descriptionforgets a remembered inventory.
Last Updated2018/06/05
Is Procedural?false
Full DescriptionForgets an inventory that was remembered.
See also the <@link command rememberinventory>rememberinventory command<@/link>.
Example
# This example forgets the inventory named "Test".
- forgetinventory "Test"
give
Items Commandgive
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/items/GiveCommand.java on line 27
Required Addon(s)None
Arguments<inventory/entity> <item>
Argument LimitsFrom 2 to 2 arguments.
Short Descriptiongives an inventory an item.
Last Updated2018/06/05
Is Procedural?false
Full DescriptionGives an inventory an item. Input an entity that carries an inventory (such as a player) to give to that entity's inventory.
Related information: <@link explanation Item Types>item types<@/link>.
TODO: Explain more!
Example
# This example gives the player a stone.
- give <player> stone
rememberinventory
Items Commandrememberinventory
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/items/RememberInventoryCommand.java on line 12
Required Addon(s)None
Arguments<inventory> <name>
Argument LimitsFrom 2 to 2 arguments.
Short Descriptionremembers an inventory until shutdown.
Last Updated2018/06/05
Is Procedural?false
Full DescriptionRemembers an inventory until shutdown.
Does not persist shutdowns. // TODO: Make persistable! Ideally an argument to this command for persistent or not.
Will exactly store the original inventory - meaning a player inventory remembered will still be owned by that player.
TODO: Clear way to duplicate an existing inventory to form a new rememberd inventory.
Can take any inventory type.
See also the <@link command forgetinventory>forgetinventory command<@/link>.
The inventory will be accessible as "shared/<name>".
Inputting an already used name will override it.
Saverememberinventory_inv (InventoryTag) returns the remembered inventory.
Example
# This example remembers the player's inventory as "Test", and stores it in definition "my_inv".
- rememberinventory <player.inventory> "Test" --save my_inv
actionbar
Player Commandactionbar
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/player/ActionBarCommand.java on line 15
Required Addon(s)None
Arguments<player> <message>
Argument LimitsFrom 2 to 2 arguments.
Short Descriptionsends an actionbar message to a player a message.
Last Updated2016/09/22
Is Procedural?false
Full DescriptionSends an actionbar message to a player a message.
TODO: Explain more!
Example
# This example sends the current player the message "hello there!" in their action bar.
- actionbar <player> "hello there!"
advancement
Player Commandadvancement
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/player/AdvancementCommand.java on line 15
Required Addon(s)None
Arguments<player> <id> <state>
Argument LimitsFrom 3 to 3 arguments.
Short Descriptionmanages the state of a player's advancement.
Last Updated2018/02/06
Is Procedural?false
Full DescriptionManages the state of a player's advancement. Set the state
to true to grant the advancement, and to false to revoke it.
Example
# This example grants the advancement "iron_man" to the player.
- advancement <player> iron_man true
Example
# This example revokes the advancement "legend" from the player.
- advancement <player> legend false
ban
Player Commandban
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/player/BanCommand.java on line 26
Required Addon(s)None
Arguments<PlayerTag>/<IP> [duration] [reason]
Argument LimitsFrom 1 to 3 arguments.
Named Argsource (TextTag) Sets the source of this ban.
Short Descriptionbans a player.
Last Updated2017/04/08
Is Procedural?false
Full DescriptionBans a player or IP for the specified duration, or permanently if no duration
is specified. Optionally specify the reason and source of the ban.
Note that this command will not automatically kick the player from the server.
Related commands: <@link command pardon>pardon<@/link> and <@link command kick>kick<@/link>.
Example
# This example bans the current player for 1 hour.
- ban <player> 1h
cooldown
Player Commandcooldown
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/player/CooldownCommand.java on line 13
Required Addon(s)None
Arguments<player> <item type> [duration]
Argument LimitsFrom 2 to 3 arguments.
Short Descriptionsets an item type's cooldown for a player.
Last Updated2018/01/07
Is Procedural?false
Full DescriptionSets an item type's cooldown for a player. If no duration is specified,
the cooldown is reset to 0. This cooldown is visually represented in the
hotbar slot and must not be confused with the attack indicator.
Related information: <@link explanation Item Types>item types<@/link>.
Example
# This example gives the player's diamond sword a 4 second cooldown.
- cooldown <player> diamond_sword 4
createbossbar
Player Commandcreatebossbar
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/player/CreateBossBarCommand.java on line 23
Required Addon(s)None
Arguments<id> <title> [player list]
Argument LimitsFrom 2 to 3 arguments.
Named Argcolor (TextTag) Sets the color of this BossBar.
Named Argcreate_fog (BooleanTag) Sets whether this BossBar should create fog.
Named Argdarken_sky (BooleanTag) Sets whether this BossBar should darken the sky.
Named Argoverlay (TextTag) Sets the overlay of this BossBar.
Named Argpercent (NumberTag) Sets the completion percent of this BossBar.
Named Argplay_music (BooleanTag) Sets whether this BossBar should play music.
Named Argvisible (BooleanTag) Sets whether this BossBar should be visible.
Short Descriptioncreates a server BossBar.
Last Updated2018/01/29
Is Procedural?false
Full DescriptionCreates a server BossBar with the given ID and title. You can also specify
a list of players to automatically add them to the bar once it's created, or add
then yourself later on.
Related commands: <@link command editbossbar>editbossbar<@/link> and <@link command removebossbar>removebossbar<@/link>.
Example
# This example creates a BossBar with ID 'MyBossBar' and title 'Hello folks!' for all online players.
- createbossbar MyBossBar "Hello folks!" <server.online_players>
Example
# This example creates a fancy BossBar with ID 'FancyBossBar' and title 'Look at me!' for the current player.
- createbossbar FancyBossBar "Look at me!" <player> --overlay NOTCHED_12 --color PURPLE
editbossbar
Player Commandeditbossbar
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/player/EditBossBarCommand.java on line 25
Required Addon(s)None
Arguments<id> [title]
Argument LimitsFrom 1 to 2 arguments.
Named Argcolor (TextTag) Sets the color of this BossBar.
Named Argcreate_fog (BooleanTag) Sets whether this BossBar should create fog.
Named Argdarken_sky (BooleanTag) Sets whether this BossBar should darken the sky.
Named Argoverlay (TextTag) Sets the overlay of this BossBar.
Named Argpercent (NumberTag) Sets the completion percent of this BossBar.
Named Argplay_music (BooleanTag) Sets whether this BossBar should play music.
Named Argvisible (BooleanTag) Sets whether this BossBar should be visible.
Named Argadd_players (ListTag) Sets the players that will be added to the BossBar.
Named Argremove_players (ListTag) Sets the players that will be removed from the BossBar.
Short Descriptionedits a server BossBar.
Last Updated2018/01/29
Is Procedural?false
Full DescriptionEdits the properties of the specified server BossBar.
You can also add or remove players to it.
Related commands: <@link command createbossbar>createbossbar<@/link> and <@link command removebossbar>removebossbar<@/link>.
Example
# This example edits the BossBar with ID 'MyBossBar', changing its title to 'I'm watching!'.
- editbossbar MyBossBar "I'm watching!"
Example
# This example edits the fancy BossBar with ID 'FancyBossBar', removing the player from it.
- editbossbar FancyBossBar --remove_players <player>
feed
Player Commandfeed
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/player/FeedCommand.java on line 14
Required Addon(s)None
Arguments<player> <amount>
Argument LimitsFrom 2 to 2 arguments.
Named Argtype (TextTag) Sets of what type the food level will be.
Named Argoperation (TextTag) Sets whether the command will add or set the value.
Short Descriptionchanges the food level of the player.
Last Updated2017/04/19
Is Procedural?false
Full DescriptionChanges the food level of the player. Optionally specify a type ('hunger', 'saturation'
or 'exhaustion') to adjust the specified food level type. Defaults to 'hunger'. Also
specify whether the command will 'add' or 'set' the value. Defaults to 'add'.
Example
# This example completely fills the hunger bar of the player
- feed <player> 20 --operation set
hotbar
Player Commandhotbar
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/player/HotbarCommand.java on line 15
Required Addon(s)None
Arguments<player> <value>
Argument LimitsFrom 2 to 2 arguments.
Named Argoperation (TextTag) Sets whether the command will add or set the value.
Short Descriptionchanges the hotbar slot currently selected by the player.
Last Updated2017/04/20
Is Procedural?false
Full DescriptionChanges the hotbar slot currently selected by the player. Optionally specify
whether the command will 'add' or 'set' the value. Defaults to 'set'.
Example
# This example sets the selected hotbar slot of the player to the first one
- hotbar <player> 1
kick
Player Commandkick
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/player/KickCommand.java on line 14
Required Addon(s)None
Arguments<player> [reason]
Argument LimitsFrom 1 to 2 arguments.
Short Descriptionkicks a player with the specified reason.
Last Updated2017/03/28
Is Procedural?false
Full DescriptionKicks a player with the specified reason.
Related commands: <@link command ban>ban<@/link> and <@link command pardon>pardon<@/link>.
TODO: Explain more!
Example
# This example kicks the current player from the server given the reason "Spam".
- kick <player> "Spam"
narrate
Player Commandnarrate
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/player/NarrateCommand.java on line 15
Required Addon(s)None
Arguments<message>
Argument LimitsFrom 1 to 1 arguments.
Short Descriptiontells the most relevant player a message. Convenience helper only.
Last Updated2017/01/31
Is Procedural?false
Full DescriptionTells the most relevant player a message.
This is a CONVENIENCE HELPER only. The <@link command tell>Tell Command<@/link> should be preferred!
TODO: Explain more!
Example
# This example tells the current player the message "hello there!" in the chat box.
- narrate "hello there!"
pardon
Player Commandpardon
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/player/PardonCommand.java on line 18
Required Addon(s)None
Arguments<PlayerTag>/<IP>
Argument LimitsFrom 1 to 1 arguments.
Short Descriptionpardons a player.
Last Updated2017/04/08
Is Procedural?false
Full DescriptionPardons a player or IP, removing its ban.
Related commands: <@link command ban>ban<@/link> and <@link command kick>kick<@/link>.
Example
# This example pardons the current player.
- pardon <player>
removebossbar
Player Commandremovebossbar
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/player/RemoveBossBarCommand.java on line 13
Required Addon(s)None
Arguments<id>
Argument LimitsFrom 1 to 1 arguments.
Short Descriptionremoves a server BossBar.
Last Updated2018/01/29
Is Procedural?false
Full DescriptionRemoves the specified server BossBar.
Related commands: <@link command createbossbar>createbossbar<@/link> and <@link command editbossbar>editbossbar<@/link>.
Example
# This example removes the BossBar with ID 'MyBossBar'.
- removebossbar MyBossBar
removerespawn
Player Commandremoverespawn
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/player/RemoveRespawnCommand.java on line 20
Required Addon(s)None
Arguments<player> <world>
Argument LimitsFrom 2 to 2 arguments.
Short Descriptionremoves a respawn location for the player.
Last Updated2018/06/15
Is Procedural?false
Full DescriptionRemoves the respawn location for the player in the specified world.
Related commands: <@link command setrespawn>setrespawn<@/link>.
Example
# This example removes the player's respawn point in their current world.
- removerespawn <player> <player.location.world>
WarningThis command doesn't work due to not being implemented in Sponge yet.
setrespawn
Player Commandsetrespawn
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/player/SetRespawnCommand.java on line 20
Required Addon(s)None
Arguments<player> <location>
Argument LimitsFrom 2 to 2 arguments.
Named Argforce (BooleanTag) Sets whether this respawn position is forced.
Short Descriptionsets a respawn location for the player.
Last Updated2018/06/15
Is Procedural?false
Full DescriptionSets a respawn location for the player. A player can only have one respawn location
per world. You can also specify if the position to respawn at is forced or can
be varied for safety.
Related commands: <@link command removerespawn>removerespawn<@/link>.
Example
# This example sets the player's respawn point in their current world to their current location.
- setrespawn <player> <player.location>
WarningThis command doesn't work due to not being implemented in Sponge yet.
tablist
Player Commandtablist
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/player/TabListCommand.java on line 15
Required Addon(s)None
Arguments<player> <header> <footer>
Argument LimitsFrom 3 to 3 arguments.
Short Descriptionsets the header or footer of a player's tablist.
Last Updated2018/02/04
Is Procedural?false
Full DescriptionSets the header or footer of a player's tablist.
Example
# This example changes both the header and footer of the player's tablist.
- tablist <player> "Hello!" "Bye!"
Example
# This example only changes the header of the player's tablist.
- tablist <player> "I'm a header!" <player.tablist_footer>
Example
# This example only changes the footer of the player's tablist.
- tablist <player> <player.tablist_header> "I'm a footer!"
take
Player Commandtake
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/player/TakeCommand.java on line 17
Required Addon(s)None
Arguments<player> <item>
Argument LimitsFrom 2 to 2 arguments.
Named Argoperation (TextTag) Sets the matching operation that will be used. Available types are "item", "item_exact" and "item_type".
Short Descriptiontakes an item from a player.
Last Updated2018/01/01
Is Procedural?false
Full DescriptionTakes an item from a player. The "item" operation takes items that exactly match the
item specified, ignoring its quantity. The "item_exact" operation only takes items that
exactly match the item specified and its quantity. The "item_type" operation takes every
time whose type matches the specified item's type. Operation defaults to "item".
Example
# This example takes 5 plain stone blocks from the player.
- take <player> stone/5
Example
# This example takes an items of type "dirt" from the player.
- take <player> dirt --operation item_type
tell
Player Commandtell
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/player/TellCommand.java on line 16
Required Addon(s)None
Arguments<player list> <message>
Argument LimitsFrom 2 to 2 arguments.
Short Descriptiontells a list of players a message.
Last Updated2017/09/25
Is Procedural?false
Full DescriptionTells a list of players a message.
TODO: Explain more!
Example
# This example tells the current player the message "hello there!" in the chat box.
- tell <player> "hello there!"
title
Player Commandtitle
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/player/TitleCommand.java on line 16
Required Addon(s)None
Arguments<player> <title> [subtitle]
Argument LimitsFrom 2 to 3 arguments.
Named Argaction_bar (FormattedTextTag) Sets the message that will be shown to the player in the action bar.
Named Argfade_in (DurationTag) Sets the fade in time.
Named Argstay (DurationTag) Sets the stay time.
Named Argfade_out (DurationTag) Sets the fade out time.
Short Descriptionsends a title to a player.
Last Updated2017/04/24
Is Procedural?false
Full DescriptionSends a title to a player. Optionally specify fade in, stay and fade out times.
These times all default to 1 second.
Example
# This example sends the title "hello there!" to the player.
- title <player> "hello there!"
addto
Queue Commandaddto
SourceDenizen2Core at: Denizen2Core-master/src/main/java/com/denizenscript/denizen2core/commands/queuecommands/AddtoCommand.java on line 15
Required Addon(s)None
Arguments<definition> 'raw/parsed/list/map' <values>
Argument LimitsFrom 3 to -1 arguments.
Short DescriptionAdds all input to a definition, optionally parsing tags.
Last Updated2016/11/24
Is Procedural?true
Full DescriptionAdds all input to a definition, optionally parsing tags.
The definition must exist before hand.
Can go across multiple lines!
Note that raw values will include ALL input, even quotes!
Note that it will trim spaces on each line automatically though.
If you specify 'list', it will add each item to the definition as a list tag.
Note that if the definition is not a list tag, it will become one, which could damage its data in some cases.
Note that if you specify a list as a single entry, it will become a sub-list rather than splitting into the main list.
TODO: Explain more!
Tag<def[<TextTag>]> (Dynamic) returns the updated definition's value.
Example
# This example adds "potato" to the end of definition "test".
- define test "hi"
- addto test raw potato
Example
# This example adds a long bit of information to the definition "test".
- define test "Hello World"
- addto test raw
  and all who inhabit it.
  In the end,
  it doesn't even matter anymore.
Example
# This example adds some new entries to the list definition "mylist".
- define mylist <list[a|b]>
- addto mylist list c d e
Example
# This example adds a new entry to the map definition "mymap".
- define mymap <map[a:1]>
- addto mymap map b 2
assert
Queue Commandassert
SourceDenizen2Core at: Denizen2Core-master/src/main/java/com/denizenscript/denizen2core/commands/queuecommands/AssertCommand.java on line 10
Required Addon(s)None
Arguments<required boolean> <error message>
Argument LimitsFrom 2 to 2 arguments.
Short Descriptionthrows an error if the specified boolean is false.
Last Updated2016/08/11
Is Procedural?true
Full DescriptionThrows an error if the specified boolean is false.
TODO: Explain more!
Example
# This example throws an error.
- assert false "This is an error message!"
choose
Queue Commandchoose
SourceDenizen2Core at: Denizen2Core-master/src/main/java/com/denizenscript/denizen2core/commands/queuecommands/ChooseCommand.java on line 14
Required Addon(s)None
Arguments<choice>
Argument LimitsFrom 1 to 2 arguments.
Short Descriptionselects and runs the sub-block matching the given choice, or the default sub-block.
Last Updated2017/11/10
Is Procedural?true
Full DescriptionSelects and runs the sub-block matching the given choice, or the default sub-block.
TODO: Explain more!
Example
# This example always echoes "hi".
- choose 3:
  - case 3:
    - echo "hi"
Example
# This example always echoes "hi".
- choose 4:
  - case 3:
    - echo "nope"
  - default:
    - echo "hi"
define
Queue Commanddefine
SourceDenizen2Core at: Denizen2Core-master/src/main/java/com/denizenscript/denizen2core/commands/queuecommands/DefineCommand.java on line 12
Required Addon(s)None
Arguments<definition> <value> [queue]
Argument LimitsFrom 2 to 3 arguments.
Short DescriptionDefines a value on the current queue.
Last Updated2016/07/15
Is Procedural?true
Full DescriptionDefines a value on the current queue.
You can optionally define a value on a specific queue.
TODO: Explain more!
Tag<def[<TextTag>]> (Dynamic) returns the defined value.
Example
# This example defines the variable "test" as the value "3", then echoes it back.
- define test 3
- echo <[test]>
Example
# This example defines the variable "test" as the value "Hello World" on the queue specified by the definition "run_queue".
- define test "Hello World" <[run_queue]>
determine
Queue Commanddetermine
SourceDenizen2Core at: Denizen2Core-master/src/main/java/com/denizenscript/denizen2core/commands/queuecommands/DetermineCommand.java on line 15
Required Addon(s)None
Arguments<determination> [value]
Argument LimitsFrom 1 to 2 arguments.
Short DescriptionDefines a value on the current queue.
Last Updated2016/08/11
Is Procedural?true
Full DescriptionDetermines a value on the current queue.
Default value is true.
TODO: Explain more!
Example
# This example determines the option "cancelled" as the value "true".
- determine cancelled
else
Queue Commandelse
SourceDenizen2Core at: Denizen2Core-master/src/main/java/com/denizenscript/denizen2core/commands/queuecommands/ElseCommand.java on line 13
Required Addon(s)None
Arguments["if" <if comparisons>]
Argument LimitsFrom 0 to -1 arguments.
Short Descriptionruns a block of code if-and-only-if the comparisons return true, or no comparison is specified, and the preceding if did not run.
Last Updated2016/04/18
Is Procedural?true
Full DescriptionRuns a block of code if-and-only-if the comparisons return true,
or no comparison is specified, and the preceding <@link command if>if<@/link> did not run.
TODO: Explain more!
Example
# This example always echoes "hi".
- if false:
  - echo "This won't show"
- else:
  - echo "hi"
Example
# This example always echoes "hi".
- if true:
  - echo "hi"
- else:
  - echo "This won't show"
foreach
Queue Commandforeach
SourceDenizen2Core at: Denizen2Core-master/src/main/java/com/denizenscript/denizen2core/commands/queuecommands/ForeachCommand.java on line 20
Required Addon(s)None
Arguments"stop"/"next"/"start" [list]
Argument LimitsFrom 1 to 2 arguments.
Short Descriptionruns a block of code once for each entry in a list.
Last Updated2016/08/08
Is Procedural?true
Full DescriptionRuns a block of code once for each entry in a list.
TODO: Explain more!
Tag<def[foreach_index]> (IntegerTag) returns the current index in the loop.
Tag<def[foreach_value]> (Dynamic) returns the current object in the loop.
Tag<def[foreach_list]> (ListTag) returns the list of values in the loop.
Saveforeach_value (Dynamic) returns the current value in the loop.
Example
# This example echoes "hello" and then "world".
- foreach start hello|world:
  - echo "<def[foreach_value]>"
goto
Queue Commandgoto
SourceDenizen2Core at: Denizen2Core-master/src/main/java/com/denizenscript/denizen2core/commands/queuecommands/GotoCommand.java on line 11
Required Addon(s)None
Arguments<name>
Argument LimitsFrom 1 to 1 arguments.
Short Descriptionjumps to a code location specified by the mark command.
Last Updated2016/04/06
Is Procedural?true
Full DescriptionJumps to a code location specified beforehand by the <@link command mark>mark<@/link> command.
TODO: Explain more!
Example
# This example goes to the location "test".
- goto test
if
Queue Commandif
SourceDenizen2Core at: Denizen2Core-master/src/main/java/com/denizenscript/denizen2core/commands/queuecommands/IfCommand.java on line 26
Required Addon(s)None
Arguments<if comparisons>
Argument LimitsFrom 1 to -1 arguments.
Short Descriptionruns a block of code if-and-only-if the comparisons return true.
Last Updated2016/04/18
Is Procedural?true
Full DescriptionRuns a block of code if-and-only-if the comparisons return true.
Can be followed by an <@link command else>else<@/link> command.
TODO: Explain more!
Example
# This example always echoes "hi".
- if true:
  - echo "hi"
# This example never does anything.
- if false:
  - echo "This won't show"
inject
Queue Commandinject
SourceDenizen2Core at: Denizen2Core-master/src/main/java/com/denizenscript/denizen2core/commands/queuecommands/InjectCommand.java on line 15
Required Addon(s)None
Arguments<script>
Argument LimitsFrom 1 to 1 arguments.
Short Descriptioninjects a script into the current queue.
Last Updated2016/08/11
Is Procedural?true
Full DescriptionInjects a script into the current queue.
TODO: Explain more!
Example
# This example injects the script "test" in the current queue.
- inject test
mark
Queue Commandmark
SourceDenizen2Core at: Denizen2Core-master/src/main/java/com/denizenscript/denizen2core/commands/queuecommands/MarkCommand.java on line 9
Required Addon(s)None
Arguments<name>
Argument LimitsFrom 1 to 1 arguments.
Short Descriptionmarks a code location for the goto command.
Last Updated2016/04/06
Is Procedural?true
Full DescriptionMarks a code location for later usage with the <@link command goto>goto<@/link> command.
TODO: Explain more!
Example
# This example marks the location "test".
- mark test
pause
Queue Commandpause
SourceDenizen2Core at: Denizen2Core-master/src/main/java/com/denizenscript/denizen2core/commands/queuecommands/PauseCommand.java on line 10
Required Addon(s)None
Arguments[queue]
Argument LimitsFrom 0 to 1 arguments.
Short Descriptionpauses the current queue, or the one specified if available.
Last Updated2016/08/12
Is Procedural?false
Full DescriptionPauses the current queue, or the one specified if available.
TODO: Explain more!
Example
# This example pauses the queue.
- pause
Example
# This example runs the task script "test", then pauses it right away.
- run test
- pause <def[run_queue]>
random
Queue Commandrandom
SourceDenizen2Core at: Denizen2Core-master/src/main/java/com/denizenscript/denizen2core/commands/queuecommands/RandomCommand.java on line 18
Required Addon(s)None
Arguments
Argument LimitsFrom 0 to 2 arguments.
Short Descriptionselects and runs a randomly chosen sub-block, based on given weights.
Last Updated2017/11/10
Is Procedural?true
Full DescriptionSelects and runs a randomly chosen sub-block, based on given weights.
TODO: Explain more!
Example
# This example will either echo "A" or "B".
- random:
  - chance 1:
    - echo "A"
  - chance 1:
    - echo "b"
Example
# This example will tend to echo "A", but sometimes as well echo "B"
- random:
  - chance 10:
    - echo "A"
  - chance 1:
    - echo "b"
repeat
Queue Commandrepeat
SourceDenizen2Core at: Denizen2Core-master/src/main/java/com/denizenscript/denizen2core/commands/queuecommands/RepeatCommand.java on line 20
Required Addon(s)None
Arguments"stop"/"next"/<times>
Argument LimitsFrom 1 to 1 arguments.
Short Descriptionruns a block of code the specified number of types.
Last Updated2016/08/07
Is Procedural?true
Full DescriptionRuns a block of code the specified number of types.
TODO: Explain more!
Tag<def[repeat_index]> (IntegerTag) returns the current index in the loop.
Tag<def[repeat_total]> (IntegerTag) returns the value the repeat is counting up to.
Saverepeat_index (IntegerTag) returns the current index in the loop.
Example
# This example echoes "hi" three times.
- repeat 3:
  - echo "hi"
require
Queue Commandrequire
SourceDenizen2Core at: Denizen2Core-master/src/main/java/com/denizenscript/denizen2core/commands/queuecommands/RequireCommand.java on line 11
Required Addon(s)None
Arguments<list of definition names>
Argument LimitsFrom 1 to 1 arguments.
Short Descriptionthrows an error if the specified definition(s) are not present.
Last Updated2016/08/11
Is Procedural?true
Full DescriptionThrows an error if the specified definition(s) are not present.
TODO: Explain more!
Example
# This example throws an error if the definitions "hello" or "world" are not present.
- require hello|world
resume
Queue Commandresume
SourceDenizen2Core at: Denizen2Core-master/src/main/java/com/denizenscript/denizen2core/commands/queuecommands/ResumeCommand.java on line 10
Required Addon(s)None
Arguments<queue>
Argument LimitsFrom 1 to 1 arguments.
Short Descriptionresumes the specified queue.
Last Updated2016/08/12
Is Procedural?false
Full DescriptionResumes the specified queue.
TODO: Explain more!
Example
# This example runs the task script "test", then resumes it right away (assuming the task paused itself).
- run test
- resume <def[run_queue]>
run
Queue Commandrun
SourceDenizen2Core at: Denizen2Core-master/src/main/java/com/denizenscript/denizen2core/commands/queuecommands/RunCommand.java on line 20
Required Addon(s)None
Arguments<script> [definition map]
Argument LimitsFrom 1 to 2 arguments.
Short DescriptionRuns a script as a new queue.
Last Updated2016/04/06
Is Procedural?false
Full DescriptionRuns a script as a new queue.
Optionally add definitions to pass to the new queue.
TODO: Explain more!
Tag<[run_queue]> (QueueTag) returns the ran queue.
Saverun_queue (QueueTag) returns the queue that was created and ran.
Example
# This example runs the script "test".
- run test
Example
# This example runs the script "test" and echoes back its results after it finishes.
- &run test
- echo <[run_queue].determinations>
Example
# This example runs the script "mytask" with definitions "banana" (set to "2")
# and "potato" (set to "5").
- run mytask banana:2|potato:5
stop
Queue Commandstop
SourceDenizen2Core at: Denizen2Core-master/src/main/java/com/denizenscript/denizen2core/commands/queuecommands/StopCommand.java on line 10
Required Addon(s)None
Arguments[queue]
Argument LimitsFrom 0 to 1 arguments.
Short Descriptionstops the current queue, or the one specified if available.
Last Updated2016/08/11
Is Procedural?true
Full DescriptionStops the current queue, or the one specified if available.
TODO: Explain more!
Example
# This example echoes "hello".
- echo "hello"
- stop
- echo "This won't show"
Example
# This example runs the task script "test", then stops it right away.
- run test
- stop <def[run_queue]>
undefine
Queue Commandundefine
SourceDenizen2Core at: Denizen2Core-master/src/main/java/com/denizenscript/denizen2core/commands/queuecommands/UndefineCommand.java on line 11
Required Addon(s)None
Arguments<definition> [queue]
Argument LimitsFrom 1 to 2 arguments.
Short DescriptionDefines a value on the current queue.
Last Updated2017/02/16
Is Procedural?true
Full DescriptionRemoves a value from the current queue.
You can optionally remove a value from a specific queue.
TODO: Explain more!
Example
# This example removes the variable "test".
- undefine test
Example
# This example removes the variable "test"  from the queue specified by the definition "run_queue".
- undefine test <[run_queue]>
wait
Queue Commandwait
SourceDenizen2Core at: Denizen2Core-master/src/main/java/com/denizenscript/denizen2core/commands/queuecommands/WaitCommand.java on line 10
Required Addon(s)None
Arguments<duration>
Argument LimitsFrom 1 to 1 arguments.
Short Descriptioncauses the current queue to wait for a duration.
Last Updated2016/04/30
Is Procedural?false
Full DescriptionCauses the current queue to wait for a duration.
TODO: Explain more!
Example
# This example waits for 5 seconds.
- wait 5
Example
# This example waits for three and a half minutes.
- wait 3.5m
while
Queue Commandwhile
SourceDenizen2Core at: Denizen2Core-master/src/main/java/com/denizenscript/denizen2core/commands/queuecommands/WhileCommand.java on line 12
Required Addon(s)None
Arguments'start'/'stop'/'next' [if comparisons]
Argument LimitsFrom 1 to -1 arguments.
Short Descriptionruns a block of code repeatedly for so long as the comparisons return true.
Last Updated2017/02/19
Is Procedural?true
Full DescriptionRuns a block of code repeatedly for so long as the comparisons return true.
TODO: Explain more!
Example
# This example runs forever (until it's externally stopped, or the engine shuts down)
# and echoes "hi" every half second.
- while start true:
  - echo "hi"
  - wait 0.5s
announce
Server Commandannounce
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/server/AnnounceCommand.java on line 15
Required Addon(s)None
Arguments<message>
Argument LimitsFrom 1 to 1 arguments.
Short Descriptionannounces a message to all online players.
Last Updated2017/09/25
Is Procedural?false
Full DescriptionAnnounces a message to all online players.
Example
# This example announces to all players that the server is being shut down.
- announce "Shutting down the server!"
execute
Server Commandexecute
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/server/ExecuteCommand.java on line 13
Required Addon(s)None
Arguments'as_server'/'as_player' <command> [source]
Argument LimitsFrom 2 to 3 arguments.
Short Descriptionexecutes a command as the specified command sender.
Last Updated2016/09/22
Is Procedural?false
Full DescriptionExecutes a command as the specified command sender.
TODO: Explain more!
Example
# This example stops the server.
- execute as_server "stop"
Example
# This example makes the specified player execute 'say hi'.
- execute as_player "say hi" <player>
savedata
Server Commandsavedata
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/server/SaveDataCommand.java on line 10
Required Addon(s)None
Arguments
Argument LimitsFrom 0 to 0 arguments.
Short Descriptionsaves extra D2 data.
Last Updated2017/09/15
Is Procedural?false
Full DescriptionSaves extra D2 data, for example: Server flags.
Example
# This example saves extra D2 data.
- savedata
shutdown
Server Commandshutdown
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/server/ShutdownCommand.java on line 14
Required Addon(s)None
Arguments[reason]
Argument LimitsFrom 0 to 1 arguments.
Short Descriptionstops the server.
Last Updated2017/04/06
Is Procedural?false
Full DescriptionStops the server. Optionally specify a reason.
Example
# This example stops the server.
- shutdown
httpserver
Webizen2 Commandhttpserver
SourceWebizen2 at: Webizen2-master/src/main/java/com/denizenscript/webizen2/commands/HttpServerCommand.java on line 17
Required Addon(s)Webizen2
Arguments"start"/"stop" <port>
Argument LimitsFrom 2 to 2 arguments.
Short Descriptionstarts or stops an HTTP server on the specified port.
Last Updated2016/08/28
Is Procedural?false
Full DescriptionStarts or stops an HTTP server on the specified port. The server will listen for incoming
HTTP requests and will fire off related ScriptEvents.
Note that a valid port must be in the (inclusive) range of [0, 65535] (the latter number is calculated as 2^16 - 1).
TODO: Explain more!
Example
# This example starts an HTTP server on port 8080.
- httpserver start 8080
deleteworld
World Commanddeleteworld
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/world/DeleteWorldCommand.java on line 18
Required Addon(s)None
Arguments<world name>
Argument LimitsFrom 1 to 1 arguments.
Short Descriptiondeletes an existing world.
Last Updated2017/05/16
Is Procedural?false
Full DescriptionDeletes an existing world, unloading it first if it's loaded.
Example
# Deletes the world 'Games', making sure it's unloaded.
- deleteworld Games
difficulty
World Commanddifficulty
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/world/DifficultyCommand.java on line 17
Required Addon(s)None
Arguments<world> <difficulty level>
Argument LimitsFrom 2 to 2 arguments.
Short Descriptionsets the difficulty of a world.
Last Updated2017/09/07
Is Procedural?false
Full DescriptionSets the difficulty of a world. The standard set of difficulty levels
is 'peaceful', 'easy', 'normal', and 'hard'.
Example
# Sets the difficulty to 'hard' in world 'Survival'.
- difficulty Survival hard
editblock
World Commandeditblock
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/world/EditBlockCommand.java on line 21
Required Addon(s)None
Arguments<location> <map of properties>
Argument LimitsFrom 2 to 2 arguments.
Short DescriptionEdits a block.
Last Updated2016/09/29
Is Procedural?false
Full DescriptionEdits a location in a world to have the specified map of new properties.
Example
# Edits a wool block to be blue.
- editblock <player.location> dye_color:blue
explode
World Commandexplode
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/world/ExplodeCommand.java on line 14
Required Addon(s)None
Arguments<location> <radius>
Argument LimitsFrom 2 to 2 arguments.
Named Argfire (BooleanTag) Sets whether the explosion can cause fire.
Named Argbreak_blocks (BooleanTag) Sets whether the explosion can break blocks.
Named Argdamage_entities (BooleanTag) Sets whether the explosion can damage entities.
Named Argsmoke (BooleanTag) Sets whether the explosion will have smoke particles.
Short Descriptioncreates an explosion.
Last Updated2017/09/08
Is Procedural?false
Full DescriptionCreates an explosion with the specified radius at certain location. Note that common
explosion sizes are: 1 = small, 2 = medium, 3 = big, and 4+ = massive. Optionally
specify whether it can cause fire, break blocks, damage entities or spawn smoke particles.
Example
# This example creates a very big explosion at the player's location and leaves a
# crater behind, even though it will not damage any entity.
- explode <player.location> 5.5 --break_blocks true --damage_entities false
gamemode
World Commandgamemode
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/player/GamemodeCommand.java on line 16
Required Addon(s)None
Arguments<player> <gamemode>
Argument LimitsFrom 2 to 2 arguments.
Short Descriptionsets gamemode of a player.
Last Updated2017/09/10
Is Procedural?false
Full DescriptionSets the gamemode of a player. The standard set of gamemodes is
'adventure', 'survival', 'creative', and 'spectator'.
Example
# Sets the gamemode to 'creative' for player 'Joe'.
- gamemode Joe creative
loadworld
World Commandloadworld
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/world/LoadWorldCommand.java on line 30
Required Addon(s)None
Arguments<world name> <template>
Argument LimitsFrom 1 to 2 arguments.
Named Argdifficulty (TextTag) Sets the difficulty of the world.
Named Arggamemode (TextTag) Sets default gamemode of the world.
Named Argmodifiers (ListTag) Sets the generator modifiers for creating the world.
Named Arggenerator (TextTag) Sets the generator type for creating the world.
Named Argcommands_allowed (BooleanTag) Sets whether commands are allowed in the world.
Named Argenabled (BooleanTag) Sets whether the world will automatically load if an entity enters it.
Named Arggenerate_spawn_on_load (BooleanTag) Sets whether the spawn will be generated automatically on world load.
Named Arghardcore (BooleanTag) Sets whether the world is hardcore.
Named Argkeep_spawn_loaded (BooleanTag) Sets the world keeps the spawn loaded.
Named Argload_on_startup (BooleanTag) Sets whether the world is loaded automatically when the server starts.
Named Argmap_features (BooleanTag) Sets whether map features (such as villages) will be generated in the world.
Named Argpvp (BooleanTag) Sets whether pvp is enabled by default in the world.
Named Argseed (IntegerTag) Sets the seed of the world.
Named Argspawn (LocationTag) Sets the default spawn location of the world.
Short Descriptionloads an existing world, or creates a new one.
Last Updated2017/05/16
Is Procedural?false
Full DescriptionLoads an existing world, or creates it (and loads it) from a template if it doesn't exist yet.
Any world property specified will overwrite the default values of the template.
Example
# Loads the world 'Games', or creates it from the template 'overworld' if it doesn't exist yet.
- loadworld Games overworld
playeffect
World Commandplayeffect
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/world/PlayEffectCommand.java on line 25
Required Addon(s)None
Arguments<location> <effect>
Argument LimitsFrom 2 to 2 arguments.
Named Argcount (IntegerTag) Sets how many particles will be played.
Named Argoffset (LocationTag) Sets the offset of the particles.
Named Argmotion (LocationTag) Sets the motion of the particles.
Named Argvisibility (IntegerTag) Sets the visibility radius of the effect.
Short Descriptionplays an effect.
Last Updated2017/04/01
Is Procedural?false
Full DescriptionPlays an effect at certain location. Optionally specify a particle count, offset, velocity and visibility radius.
Related information: <@link explanation Particle Types>particle types<@/link>.
TODO: Explain more!
Example
# This example plays the 'heart' effect around the player.
- playeffect <player.location> heart --count 50 --offset 1,1,1
playsound
World Commandplaysound
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/world/PlaySoundCommand.java on line 28
Required Addon(s)None
Arguments<location> <sound> <volume>
Argument LimitsFrom 3 to 3 arguments.
Named Argpitch (NumberTag) Sets the pitch of the sound.
Named Argmin_volume (NumberTag) Sets the minimum volume of the sound.
Named Argcustom (BooleanTag) Sets whether the sound is custom.
Short Descriptionplays a sound.
Last Updated2017/04/24
Is Procedural?false
Full DescriptionPlays a sound at certain location. Optionally specify a pitch and minimum volume.
The custom argument will allow any input without error, regardless of whether
players have the given ID in their resource pack.
Related information: <@link explanation Sound Types>default sound types<@/link>.
TODO: Explain more!
Example
# This example plays a loud 'entity_arrow_hit' default sound at the player's location.
- playsound <player.location> entity.arrow.hit 2
Example
# This example plays a loud 'pirate_cannon' custom sound at the player's location.
- playsound <player.location> pirate_cannon 3 --custom true
removegamerule
World Commandremovegamerule
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/world/RemoveGameRuleCommand.java on line 17
Required Addon(s)None
Arguments<world> <list of rules>
Argument LimitsFrom 2 to 2 arguments.
Short Descriptionremoves custom game rules from a world.
Last Updated2017/05/16
Is Procedural?false
Full DescriptionRemoves the specified custom game rules from a world.
Note: you can't remove default minecraft game rules.
Example
# Removes the custom game rules 'xp_multiplier' and
# 'currency_multiplier' from world 'Games'.
- removegamerule Games xp_multiplier|currency_multiplier
setblock
World Commandsetblock
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/world/SetBlockCommand.java on line 16
Required Addon(s)None
Arguments<list of locations> <blocktype>
Argument LimitsFrom 2 to 2 arguments.
Named Argphysics (BooleanTag) Sets whether the block will have physics enabled or not.
Short Descriptionsets a block's type.
Last Updated2017/04/03
Is Procedural?false
Full DescriptionSets a block's type at the specified location. Physics defaults to enabled.
Related information: <@link explanation Block Types>block types<@/link>.
TODO: Explain more!
Example
# This example sets the block at a player's location to stone.
- setblock <player.location> stone
Example
# This example sets the block at a player's location to sand and doesn't update surrounding blocks.
- setblock <player.location> sand --physics false
setgamerule
World Commandsetgamerule
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/world/SetGameRuleCommand.java on line 31
Required Addon(s)None
Arguments<world> <map of rules>
Argument LimitsFrom 2 to 2 arguments.
Short Descriptionmodifies the game rules of a world.
Last Updated2017/05/16
Is Procedural?false
Full DescriptionModifies the existing game rules of a world or creates new ones according
to the map specified. Related information: <@link explanation Default Game Rules>default game rules<@/link>.
Example
# Sets the default game rule 'mob_griefing' to 'false' in world 'Games'.
- setgamerule Games mob_griefing:false
Example
# Sets the custom game rules 'xp_multiplier' and 'currency_multiplier' to
'3' and '5' respectively in world 'Adventure'.
- setgamerule Adventure xp_multiplier:3|currency_multiplier:5
strike
World Commandstrike
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/world/StrikeCommand.java on line 14
Required Addon(s)None
Arguments<location>
Argument LimitsFrom 1 to 1 arguments.
Named Argambient (BooleanTag) Sets whether the lightning will be ambient.
Short Descriptionstrikes lightning.
Last Updated2017/11/10
Is Procedural?false
Full DescriptionStrikes lightning upon a location. Optionally specify whether it will be an ambient
lightning strike. Ambient lightning strikes do not damage entities, charge creepers,
nor turn pigs into pig zombies. Lightning strikes are non-ambient by default.
Example
# This example strikes a damaging lightning upon the player.
- strike <player.location> --ambient false
unloadworld
World Commandunloadworld
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/world/UnloadWorldCommand.java on line 12
Required Addon(s)None
Arguments<world>
Argument LimitsFrom 1 to 1 arguments.
Short Descriptionunloads a world.
Last Updated2017/05/16
Is Procedural?false
Full DescriptionUnloads a world. If this world has any connected players, no operation will occur.
Example
# Unloads the world 'Games'.
- unloadworld Games
viewdistance
World Commandviewdistance
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/world/ViewDistanceCommand.java on line 12
Required Addon(s)None
Arguments<world> [view distance]
Argument LimitsFrom 1 to 2 arguments.
Short Descriptionsets the view distance of a world.
Last Updated2018/01/01
Is Procedural?false
Full DescriptionSets the view distance of a world (in chunks). This value must be between 3 and
32 inclusive. Don't specify a view distance to reset it to the world's default value.
Entities won't be visible for players further than the view distance from them.
Example
# Sets the view distance to 3 chunks in world 'Nightmare'.
- viewdistance Nightmare 3
Example
# Resets the view distance in world 'Survival'.
- viewdistance Survival
weather
World Commandweather
SourceDenizen2Sponge at: Denizen2Sponge-master/src/main/java/com/denizenscript/denizen2sponge/commands/world/WeatherCommand.java on line 16
Required Addon(s)None
Arguments<world> 'clear'/'rain'/'thunder_storm' [duration]
Argument LimitsFrom 2 to 3 arguments.
Short DescriptionSets the weather of the world.
Last Updated2017/04/03
Is Procedural?false
Full DescriptionSets the weather of the world. Optionally specify a duration.
Example
# Changes the weather in the player's world to 'rain' for 5 minutes.
- weather <player.location.world> rain 5m