Actions

A list of all actions with examples.

Generator Actions

Keep Stage

Stay on the current stage when a generator block is mined. (Same behavior as if idle was true)

on-break:
  do: keepStage   # Only works with on-break

Previous Stage

Set the generator to the previous stage.

do: previousStage

Next Stage

Set the generator to the next stage.

do: nextStage

Set Stage

Set the generator to a specific stage.

do: setStage 1

Damage Generator

Decrease the health of the current generator stage.

# Example 1
do: damageGenerator 1-3   # Do 1 to 3 damage

# Example 2
do: damageGenerator   # Leave empty to use config.yml powerful damage options
                      # i.e. tool type, efficiency, ect..

Server Actions

Broadcast

Sends a chat message to all players on the server. Supports placeholders and color codes.

do: broadcast <This is a broadcast message>

Lightning

Strikes lightning at a specific coordinate in a given world.

Optional: world, doDamage

do: lightning world=world_name x=0 y=0 z=0 doDamage=true

Console Command

Runs a command from the server console.

do: consoleCommand <say Hello World!>

Drop Item

Drops a specific item at a given coordinate.

Optional: world

do: dropItem dirt world=world_name x=0 y=0 z=0

Drop Exp

Drops specific exp at the given coordinate. Supports amount (fixed, ranged, multi).

Optional: world, orbs

# Example 1
do: dropExp 100 orbs=100 world=world_name x=0 y=0 z=0

# Example 2
do: dropExp 10-100 x=0 y=0 z=0

# Example 3
do: dropExp 20;50;100 orbs=1-10 x=0 y=0 z=0

Spawn Particle

Spawns a particle effect at a specific coordinate.

Optional: world

do: spawnParticle particle_name world=world_name x=0 y=0 z=0

Play Sound

Plays a sound at a specific coordinate.

Optional: world

do: playSound sound_name world=world_name x=0 y=0 z=0

---

Function Actions

Stop

Ends function execution completely when called from anywhere.

function:
  do:
    - stop
    - chatMessage <This message will NOT be sent!>

Even when used inside a global function:

# Global Function
giveDiamondIfFirstJoin:
  if-not: hasPlayedBefore
  do:
    - chatMessage <This is the first time playing huh? Have a diamond!>
    - giveItem diamond 
    - stop

on-break:
  - giveDiamondIfFirstJoin
  - do: chatMessage <This message will NOT be sent!>

Return

Ends current function execution. It will only have effect on the function it is used in.

function:
  do:
    - return
    - chatMessage <This message will NOT be sent!>

When used inside a global function:

# Global Function
giveDiamondIfFirstJoin:
  if-not: hasPlayedBefore
  do:
    - chatMessage <This is the first time playing huh? Have a diamond!>
    - giveItem diamond 
    - return

on-break:
  - giveDiamondIfFirstJoin
  - do: chatMessage <This message will be sent!>

Goto

Go to a specific function in a multi function. This should be rarely need to be used, I leave for very few cases when necessary.

DANGEROUS: if used improperly it will cause a StackOverflowError and crash your server.

function:
  # Function 1
  - if: hasPermission orestack.admin
    do: goto 3   # Skip money check in function 2 if player is an admin
    
  # Function 2  
  - if-not: hasMoney 1000
    do:
      - sendChat <You don't have the money to perform this action>
      - return
  
  # Function 3
  - do: sendChat <You have 1000$ or you are an admin!>

Event Actions

Cancel Event

Stops the event that triggered the function from continuing.

Supported by: on-break

# Triggered by GeneratorMineEvent
on-break:   
  do: cancelEvent # The generator stays on the current stage and items/exp are not dropped

Set Cancelled

Manually sets whether the event is cancelled (true or false).

Supported by: on-break

on-break:
  do: setCancelled true

---

Block Actions

Strike Block

Creates a lightning effect on the block that was interacted with.

# Example 1
do: lightningAtBlock

# Example 2
do: lightningAtBlock doDamage=true

Drop Item at Block

Drops an item from the block towards the player or on top of the block.

# Example 1
do: dropItemAtBlock diamond

# Example 2
do: dropItemAtBlock diamond amount=3

# Example 3
do: dropItemAtBlock item_name amount=1-3 doFortune=true

# Example 4 (MythicMobs)
do: dropItemAtBlock MythicMobs:SkeletonKingSword   # alias: mm

# Example 5 (ExecutableItems)
do: dropItemAtBlock ExecutableItems:Free_Wifi_Crafting_Table   # alias: ei

# Example 6 (EcoItems)
do: dropItemAtBlock EcoItems:enchanted_cobblestone   # alias: ec

Spawn Particle at Block

Spawns a particle effect at the block. Particle effects are located inside effects/particles.

do: spawnParticleAtBlock particle_name 

Play Sound at Block

Plays a sound effect at the block. Sound effects are located inside effects/sounds.

do: playSoundAtBlock sound_name

---

Player Actions

Drop Item at Player

Drops an item at the player's location.

# Example 1
do: dropItemAtPlayer diamond

# Example 2
do: dropItemAtPlayer diamond amount=3

# Example 3
do: dropItemAtPlayer item_name amount=1-3 doFortune=true

# Example 4 (MythicMobs)
do: dropItemAtPlayer MythicMobs:SkeletonKingSword   # alias: mm

# Example 5 (ExecutableItems)
do: dropItemAtPlayer ExecutableItems:Free_Wifi_Crafting_Table   # alias: ei

# Example 6 (EcoItems)
do: dropItemAtPlayer EcoItems:enchanted_cobblestone   # alias: ec

Spawn Particle at Player

Spawns a particle effect at the player. Particle effects are located inside effects/particles.

do: spawnParticleAtPlayer particle_name

Play Sound at Player

Plays a sound for the player. Sound effects are located inside effects/sounds.

do: playSoundAtPlayer sound_name

Give Exp

Gives a specific amount of experience points to the player.

do: giveExp 10-20

Give Flag

Assigns a flag to the player. (Flags are not saved when the player quits the server)

do: giveFlag my_custom_flag

Give Item

Gives a material or item to the player. (If it cannot fit in the inventory it will drop on the ground)

# Example 1
do: giveItem diamond

# Example 2
do: giveItem diamond amount=3

# Example 3
do: giveItem item_name amount=1-3 doFortune=true

# Example 4 (MythicMobs)
do: giveItem MythicMobs:SkeletonKingSword   # alias: mm

# Example 5 (ExecutableItems)
do: takeItem ExecutableItems:Free_Wifi_Crafting_Table   # alias: ei

# Example 6 (EcoItems)
do: giveItem EcoItems:enchanted_cobblestone   # alias: ec

Give Money

Gives a specific amount of money to the player. (Requires Vault and economy plugin installed)

# Example 1
do: giveMoney 100

# Example 2
do: giveMoney 10-100

# Example 3
do: giveMoney 10;20;30

Take Exp

Removes a specific amount of experience points from the player.

# Example 1
do: takeExp 10

# Example 2
do: takeExp 10-100

# Example 3
do: takeExp 10;20;30

Take Flag

Removes a flag from the player.

do: takeFlag my_custom_flag

Take Item

Removes a specific item from the player's inventory.

# Example 1
do: takeItem diamond

# Example 2
do: takeItem item_name

# Example 3 (MythicMobs)
do: takeItem MythicMobs:SkeletonKingSword   # alias: mm

# Example 4 (ExecutableItems)
do: takeItem ExecutableItems:Free_Wifi_Crafting_Table   # alias: ei

# Example 6 (EcoItems)
do: takeItem EcoItems:enchanted_cobblestone   # alias: ec

Take Money

Removes a specific amount of money from the player.

# Example 1
do: takeMoney 10

# Example 2
do: takeMoney 10-100

# Example 3
do: takeMoney 10;20;30

Set Exp

Sets the player's experience points to a specific value.

# Example 1
do: setExp 10

# Example 2
do: setExp 10-100

# Example 3
do: setExp 10;20;30

Heal

Restores a specific amount of health to the player.

# Example 1
do: heal   # default amount is 20

# Example 2
do: heal 10   # 10

# Example 3
do: heal 10-100   # 10 to 100

# Example 4
do: heal 10;20;30   # 10, 20 or 30

Damage

Deals a specific amount of damage to the player.

# Example 1
do: damage   # default amount is 2

# Example 2
do: damage 10   # 10

# Example 3
do: damage 10-100   # 10 to 100

# Example 4
do: damage 10;20;30   # 10, 20 or 30

Command

Runs a command as the player.

do: command <warp spawn>

Chat Message

Sends a chat message to the player.

do: chatMessage <Hello, this is a chat message>

Message

Sends a custom message to the player. Messages are found inside messages folder.

do: message message_name

Send Chat

Sends a chat message to the player.

do: sendChat <This is a chat message!>

Send Title

Sends a title message to the player.

do: sendTitle <This is a title message!> <subtitle=This is the subtitle> fadeIn=10 stay=70 fadeOut=20

Send Actionbar

Sends an actionbar message to the player.

do: sendActionbar <This is an actionbar message!>

Send Hologram

Sends a hologram message to the player.

Optional: offsetX, offsetY, offsetZ, rangeX, rangeY, rangeZ

do: sendHologram <This is a hologram message!> duration=60 rangeX=1 rangeY=1 rangeZ=1

Strike Player

Creates a lightning effect on the player.

# Example 1
do: strikePlayer

# Example 2
do: strikePlayer doDamage=true

Set Flight

Enables or disables flight for the player.

# Example 1
do: setFlight true

# Example 2
do: setFlight false

Teleport

Teleports the player to a specific coordinate and rotation.

Open Ender Chest

Opens the player's ender chest.

do: openEnderChest

Damage Tool

Damage the player's main hand tool. Compatible with unbreaking enchant.

# Example 1
do: damageTool   # Default amount is 1

# Example 2
do: damageTool 3   # 3 damage

# Example 3
do: damageTool 1-3   # 1 to 3 damage

# Example 4
do: damageTool 1;10;100   # 1, 10 or 100 damage

Auraskills Actions

Give Aura Exp

# Example 1
do: giveAuraExp 1

# Example 2
do: giveAuraExp 10-100 skill=foraging

# Example 3
do: giveAuraExp 10;100;1000 skill=farming raw=true   # if raw multipliers are ignored

Give Aura Mana

# Example 1
do: giveAuraMana 10
  
# Example 2
do: giveAuraMana 10-20

# Example 3
do: giveAuraMana 10;50;100

Take Aura Mana

# Example 1
do: takeAuraMana 10
  
# Example 2
do: takeAuraMana 10-20

# Example 3
do: takeAuraMana 10;50;100

McMMO Actions

Give Mcmmo Exp

# Example 1
do: giveMcmmoExp 10   # default skill is mining

# Example 2
do: giveMcmmoExp 10-100 skill=woodcutting

# Example 3
do: giveMcmmoExp 10;100;1000

Take Mcmmo Exp

# Example 1
do: takeMcmmoExp 10   # default skill is mining

# Example 2
do: takeMcmmoExp 10-100 skill=woodcutting

# Example 3
do: takeMcmmoExp 10;100;1000

Reset Mcmmo Cooldowns

do: resetMcmmoCooldowns

Level Up Mcmmo Skill

do: levelUpMcmmoSkill mining