Reference

Reference

Types that act as both actions and conditions.

Items

Actions:

• give_items: Give players items. When giving items, it’ll first attempt to insert the items into a player’s inventory, if that fails, it simply drops the items at the player’s feet.
• take_items: removes items from any slot in the player’s inventory.

Conditions:

• has_items: Tests if a player has all specified items.
• does_not_have_items: Tests if a player does NOT have the specified items.

(altough only give_items is used to document, the following applies to both)

Uses

• give_items #container [world=<name>] x=<cord> y=<cord> z=<cord>

  Creates a copy of all the items in container block at the specified coordinates and uses those items to perform the action/condition.

  All <coord> values support the ~ relative coordinates.

• give_items #held-item

  Uses the item you’re holding. (Item is copied)

• give_items #inventory

  Uses every item in your inventory (Items are copied)

• give_items #hotbar

  Uses every item in your hotbar (Items are copied)

• give_items #item-list <items>

  Manually specified list of items.

  The List follows a format of: <amount>;<item>, for example: 16;stone, to use multiple items, separate entries with a comma, for example:
  16;stone, 4;egg, 1;diamond_sword[max_stack_size=16]

Examples

• give_items #held-item

• give_items #inventory

• give_items #hotbar

• give_items #item-list 1;stone

• give_items #item-list 1;stone, 14;gravel

• give_items #container world=world x=1432 y=64 z=3434

• give_items #container x=~ y=~-2 z=~

File-loaded Scripts

Actions: script_file
Conditions: test_script

Executes a script file.
See Usables Scripting for more info on Usables scripting.

Examples

• script_file debts/pay

Raw JavaScript

Actions: js
Conditions: js

Executes raw JavaScript code.

While this may be easy to set up and use, js actions may be hard to maintain later down the line, as such, it is recommended to use the script_file/test_script instead for most things.

See Usables Scripting for more info on Usables scripting.

Examples

• js player.health = 0

  lol

Actions

teleport

Teleports a player to a specified location.

Uses

• teleport

  Creates a teleport action that teleports players to the location you’re standing at right now.

• teleport [world=<name>] x=<cord> y=cord> z=<cord> [yaw=<yaw>] [pitch=<pitch>]

  Creates a teleport action that teleports players to the specified coordinates.

  The world, yaw and pitch are optional arguments that don’t have to be specified.

  If the world argument is not set, the world the player creating the action is in is used.

  If the yaw and pitch arguments are not set, then the rotation values of player being teleported are used.

Examples

• teleport

• teleport world=void x=-301.5 y=93.0 z=-637.5 yaw=-90.0

• teleport x=-301.5 y=93.0 z=-637.5

Commands (console_cmd and player_cmd)

Either performs a console command or forces the interacting player to perform a command.

Inputs for this action support Command Placeholders. You can also use the entity selector ‘@p’ as a placeholder for the player’s name.

Uses

• console_cmd <command>

Examples

• console_cmd kill %player

• player_cmd Hello, all!

Text / Messages (show_text and show_actionbar)

Shows text to a player, either in their chat or in their actionbar.

Uses

• show_text <text>

  Creates an action that shows text to a player, color codes and all other chat functions (as well as Placeholders) are supported.

Examples

• show_text &eHello, world!

play_sound

Plays a sound to the interacting player or to all players in a specified radius,

Arguments:

play_sound sound=<sound name> [channel=<val>] [pitch=<0..2>] [volume=<0..>] [play-radius=<0..>] [repeat=<1..>] [delay=<val>]

Notes:

• If both a delay and repeat are set, then, when playing the sound, after the delay ends, all the sounds are played at once, repeated.

Conditions

not (Inverted condition)

A condition that takes in another condition and inverts the result of the specified condition.

Note:
You should most likely override the error message of not conditions, because the error message is simply the error message of the inverted condition with a “NOT” prepended onto it.

Uses

• not <condition type> [<input>]

  Specifies a condition type (eg: not_alt, has_items) and an optional input for that type.

Examples

• not is_faction_member latins

• not has_items #item-list 1;minecraft:stone_pickaxe

in_world

Tests if the player is in the specified world.

Uses

• in_world

  Uses the world you’re standing in.

• in_world <world name>

  Uses the specified world.

Examples

• in_world resource1

hand

Tests if a player is using the correct hand (main-hand or off-hand)

Examples

• hand weapon.mainhand

• hand weapon.offhand

has_permission

Tests if a player has a specified permission

Uses

• has_permission <permision name>

Examples

• has_permission arcadius.warps.portal

cooldown

Places players on cooldown and denies players that are on the cooldown.

Use

• cooldown <time>

  Creates a cooldown condition.

Examples

• cooldown 30m

• cooldown 30m+35s

• cooldown 2.5m

Simple Conditions

Simple conditions require no actual input, just that you type in the name of condition.