Utility Commands

If you edit the commands in-game don't add the - that is before all examples.

DELAY

• Info: Delays a command line for seconds

• Command: DELAY {amount}

  • {amount}: To how long you want commands to be delayed (In seconds)

• Example:

activators:
  activator0: # Activator ID, you can create as many activator on the activators list
    commands: #There will be a delay of 10 seconds between the command1 and the command2.
    - command1
    - DELAY 10
    - command2

DELAYTICK

• Info: Delays a command line for game ticks (20 ticks = 1 second)

• Command: DELAYTICK {amount}

  • {amount}: To how long you want commands to be delayed (In ticks)

• Example:

activators:
  activator0: # Activator ID, you can create as many activator on the activators list
    commands:
    - command1
    - DELAYTICK 5 # (0.25 seconds)
    - command2

IF

CURRENTLY ONLY WORKS IN PLAYER RELATED AND ENTITY RELATED COMMANDS

• Info: Executes commands if condition is met

• Command: IF {condition_without_spaces} {command1} <+> {command2} <+> ...

  • {condition_without_spaces}: The condition for the IF to decide whether it runs or not.

    • Symbols: =, !=, >=, <=, >, <

    • It supports () for priority , && for AND and || for OR

  • {command1},{command2}: The commands that will be executed

• Example:

activators:
  activator0: # Activator ID, you can create as many activator on the activators list
    commands:
    - IF %player_health%>20 say cool

activators:
  activator0: # Activator ID, you can create as many activator on the activators list
    commands:
    - IF %entity%=PIG say I'm a pig <+> SETBABY <+> say I'm now a baby pig

activators:
  activator0: # Activator ID, you can create as many activator on the activators list
    commands:
    - IF 1=1||2=3 BACKDASH 1 # 1=1 OR 2=3 -> YES because 1=1
    - IF 1=1&&2=2||2=3 BACKDASH 1 # 1=1 and 2=2 or 2=3 -> YES because 1=1 and 2=2
    - IF (1=1&&2=2)||(2=3||3=2) BACKDASH 1 # (1=1 and 2=2) or (2=3 or 3=2) -> YES because 1=1 and 2=2

WHILE

• Info: Repeats indefinitely as long as the condition is met. It is also running in async

• Command: WHILE {condition_without_spaces} {delay_in_ticks} {command1} <+> {command2} <+> ...

  • {condition_without_spaces}: The condition for the while loop to decide whether it continues or stops

  • {delay_in_ticks}: The delay before the next repetition

    • Delay supports decimals value but they are casted to the next integer (20.1 -> 20)

  • {command},{command2}: The commands that will be executed in repeat

• Example:

activators:
  activator0: # Activator ID, you can create as many activator on the activators list
    commands:
    - WHILE %player_health%>10 20 SENDMESSAGE &eHello &6While <+> effect give %player% speed 1 1

It runs async + Condition support double placeholders, example %player_x%>%player_z%

The command will be stopped if the player is offline

LOOP

• LOOP START

  • Info: First part of the command

  • Command: LOOP START: {amount}

    • {amount}: Number of times a command gets repeated. Placeholders are supported

• LOOP END

  • Info: Last part of the command

  • Command: LOOP END

• Example: (This is what you will see on config)

activators:
  activator0: # Activator ID, you can create as many activator on the activators list
    commands:
    - 'RANDOM RUN: 1'
    - 'LOOP START: 5' # (50%)
    - SENDMESSAGE &cYOU GOT AN APPLE! +++ give %player% apple 1
    - LOOP END
    - 'LOOP START: 3' # (30%)
    - SENDMESSAGE &7YOU GOT IRON! +++ give %player% iron_ingot 1
    - LOOP END
    - 'LOOP START: 2' # (20%)
    - SENDMESSAGE &aYOU GOT DIAMOND! +++ give %player% diamond 1
    - LOOP END
    - RANDOM END

This is what the ExecutableItems plugin sees when it runs

activators:
  activator0: # Activator ID, you can create as many activator on the activators list
    commands:
    - 'RANDOM RUN: 1'
    - SENDMESSAGE &cYOU GOT AN APPLE! +++ give %player% apple 1
    - SENDMESSAGE &cYOU GOT AN APPLE! +++ give %player% apple 1
    - SENDMESSAGE &cYOU GOT AN APPLE! +++ give %player% apple 1
    - SENDMESSAGE &cYOU GOT AN APPLE! +++ give %player% apple 1
    - SENDMESSAGE &cYOU GOT AN APPLE! +++ give %player% apple 1
    - SENDMESSAGE &7YOU GOT IRON! +++ give %player% iron_ingot 1
    - SENDMESSAGE &7YOU GOT IRON! +++ give %player% iron_ingot 1
    - SENDMESSAGE &7YOU GOT IRON! +++ give %player% iron_ingot 1
    - SENDMESSAGE &aYOU GOT DIAMOND! +++ give %player% diamond 1
    - SENDMESSAGE &aYOU GOT DIAMOND! +++ give %player% diamond 1
    - RANDOM END

Explanation:

When the plugin runs the commands, it duplicates the commands inside the loop commands to reduce the number of command lines in your config to make your config cleaner and since RANDOM RUN gives each command equal rates, the estimated rate will be:

• 50% chance to get an apple

• 30% chance to get iron

• 20% chance to get diamond

It supports placeholders

FOR - ENDFOR

• Command that allows you to target multiple elements inside a list

activators:
  activator0: # Activator ID, you can create as many activator on the activators list
    commands:
    - FOR [Special70, Ssomar, Vayk] > for1
    - effect give %for1% speed 60 2
    - ENDFOR for1

What exactly happened here is that the FOR command will run 3 times because inside the bracket symbols, there are 3 values which are Special70, Ssomar and Vayk.

The for1 word will be used as an "identifier" for that FOR command so we can use the placeholder for it.

So when the effect command runs for the first time, %for1% will return " Special70" then "Ssomar" for the second and "Vayk" for the third timehinhin

Don't overthink about the > symbol.

activators:
  activator0: # Activator ID, you can create as many activator on the activators list
    commands:
    - FOR [Special70, Ssomar, Vayk] > for2
    - FOR [5,4,3,2,1] > for3
    - SENDMESSAGE >> &e%for2% &a%for3%
    - ENDFOR for3
    - ENDFOR for2

What exactly happened here is that the FOR loops got stacked so the first FOR command will run the commands in it which is another FOR command that will run 5 times.

If you're gonna focus on the SENDMESSAGE command, the reason it ran 15 times because the first FOR command executed what's inside it by 3 while the second FOR command executed the SENDMESSAGE command 5 times which totals 15 times.

Output of the example 2

It works with score variable list placeholders

activators:
  activator0: # Activator ID, you can create as many activator on the activators list
    commands:
    - FOR %score_variables_myList% > for4
    - effect give %for4% speed 60 2
    - ENDFOR for4

Run commands randomly ?

RANDOM RUN / RANDOM END

• Info: A command mainly used for RNG.

• RANDOM RUN

  • Info: The first part of the command

  • Command: RANDOM RUN: {amount}

    • {amount}: The amount of commands that will be randomly selected inside of the command line. Placeholders are supported

• RANDOM END

  • Info: The other part of the command

  • Command: RANDOM END

• Example:

activators:
  activator0: # Activator ID, you can create as many activator on the activators list
    commands:
    - 'RANDOM RUN: 1'
    - give %player% coal 1
    - give %player% iron_ingot 1
    - give %player% gold_ingot 1
    - RANDOM END

This means that you have a 1/3 chance of getting coal, iron or gold

To be able to run multiple commands in one command line use +++

activators:
  activator0: # Activator ID, you can create as many activator on the activators list
    commands:
    - 'RANDOM RUN: 2'
    - give %player% diamond 1 +++ SENDMESSAGE &aYou receive &b1 Diamond
    - give %player% emerald 1 +++ SENDMESSAGE &aYou receive &21 Emerald
    - give %player% diamond_block 1 +++ SENDMESSAGE &aYou receive &b1 Diamond block
    - RANDOM END

This means that from the 3 give commands, 2 of the randomly chosen command lines will run.

activators:
  activator0: # Activator ID, you can create as many activator on the activators list
    commands:
    - 'RANDOM RUN: 1'
    - NOTHING*9
    - give %player% diamond_block 1
    - RANDOM END

This means that there's a 10% chance to give you a diamond block.

NOTHING is just a command to adjust y percentage and if you want a case where the RNG will do nothing.

It supports placeholders

NOTHING*

• Info: Mainly used for RANDOM RUN commands as a "dummy" command for RNG adjustments

• Command: NOTHING*{amount}

• Example of usage:

activators:
  activator0: # Activator ID, you can create as many activator on the activators list
    commands:
    - 'RANDOM RUN: 1'
    - NOTHING*99
    - give %player% diamond 1
    - RANDOM END

This command line means that there is a 1/100 chance it will give you a diamond

More Examples:

1. I want to make it so 99% chance it will give me dirt and 1% chance to give me diamond BUT I don't want to write 99 lines of the give dirt command.

• So here is how to do it.

activators:
  activator0: # Activator ID, you can create as many activator on the activators list
    commands:
    - 'LOOP START: 99' 
    - give %player% dirt 1
    - LOOP END

• The 99 represents that any commands inside the loop command will be duplicated 99 times. You will only see the give command and the loop command but the plugin sees 99 give commands.

• Here is what the plugin sees

activators:
  activator0: # Activator ID, you can create as many activator on the activators list
    commands:
    - give %player% dirt 1
    - give %player% dirt 1
    - give %player% dirt 1
    - give %player% dirt 1
    - give %player% dirt 1
    - give %player% dirt 1
    - give %player% dirt 1
    - give %player% dirt 1
    - give %player% dirt 1
    - give %player% dirt 1

(You get the idea.)

• So let's go back to our main objective. 99% chance to get dirt, 1% chance to get diamond. The RANDOM RUN command evenly gives the same rng rates to all the commands inside the RANDOM RUN command.

The (5%) percentage stuff is not part of the command. It's written here in the wiki for you to acknowledge the chances for that command to be selected from the list of commands

activators:
  activator0: # Activator ID, you can create as many activator on the activators list
    commands:
    - 'RANDOM RUN: 1'
    - give %player% dirt #(1/2 = 50%)
    - give %player% diamond #(1/2 = 50%)
    - RANDOM END

activators:
  activator0: # Activator ID, you can create as many activator on the activators list
    commands:
    - 'RANDOM RUN: 1'
    - give %player% dirt #(1/3 = 33%)
    - give %player% diamond #(1/3 = 33%)
    - give %player% diamond #(1/3 = 33%)
    - RANDOM END

activators:
  activator0: # Activator ID, you can create as many activator on the activators list
    commands:
    - 'RANDOM RUN: 1'
    - give %player% dirt #(1/4 = 25%)
    - give %player% dirt #(1/4 = 25%)
    - give %player% diamond #(1/4 = 25%)
    - NOTHING*1 #(1/4 = 25%)
    - RANDOM END

• After seeing these RANDOM RUN examples, we will acknowledge that it would work like this.

activators:
  activator0: # Activator ID, you can create as many activator on the activators list
    commands:
    - 'RANDOM RUN: 1'
    - 'LOOP START: 99' 
    - give %player% dirt 1  #(99/100 = 99%)
    - LOOP END
    - give %player% diamond 1 #(1/100 = 1%)
    - RANDOM END

• The total of the supposed lines is 100 so it's going to be (100 command lines / 100% = 1%) rate per command.

It supports placeholders

RANDOM RUN | RANDOM END Generator

• Click on Run

• Wait until the GUIDE message appears

• Use the generator

Or you could visit (https://special70.github.io/item%20config%20editors/executableitems_editor.html) where you can adjust the rates and have a button that evens out the rates across all of your commands. Just click the RANDOM RUN button in that website