Actions
- All actions must be linked to a zone with either the /linkaction command or the /linkexitaction command. Actions are triggered when entering a zone, and exit actions are triggered when exiting a zone.
- All actions can have a delay attached to them in order specify when the action should be run. If no delay is specified, the action will run as soon as is possible.
message
Description: When triggered, it sends a customizable message to the player that triggered it. Messages can be any color.
Requirements:
- None
Useful:
- A linked message. Use the /setzonemessage command
teleport
Description: When triggered, it will teleport the player to a designated location. The location can be anywhere, in any world, in another zone, and even in the same zone.
Requirements:
- A linked location. Use the /linklocation command. You may also need to create a location with the /setlocation command
strikeeffect
Description: When triggered, it strikes the player that activated it with a lightning bolt. This bolt does no damage; it is just an effect.
Requirements:
- None
strikeonce
Description: When triggered, it strikes the player that activated it with a lightning bolt. This lightning bolt will do damage, but not kill.
Requirements:
- None
strikekill
Description: When triggered, it strikes the player that activated it with multiple lightning bolts This action will kill the player, even if they are in creative mode.
Requirements:
- None
storeinventory
Description: When triggered, the player that triggered its inventory will be saved and cleared. This will save everything, including armor slots, enchantments, experience points, and items. This will be saved to file immediately, making it safe. It will only allow you to store your inventory if you don't already have an inventory stored. To recover your inventory, you will need to trigger a restoreinventory action.
Requirements:
- None
restoreinventory
Description: When triggered, it restores the players inventory if they had one stored. Additionally, it will only restore your inventory if your current inventory is empty. This is to prevent accidental item destruction. Experience points can still be erased by your previous experience, however.
Requirements:
- None
payteleport
Description: When triggered, it will teleport the player that triggered it if they have enough money. This action requires that Vault is running on your server.
Requirements:
- A linked location. Use the /linklocation command. You may also need to create a location with the /setlocation command
- A linked quantity of money. Use the /linkmoney command to link money to the zone.
heal
Description: When triggered, it restores a players food and health bar.
Requirements:
- None
launchdirection
Description: When triggered, it launches the player that triggered it in the direction of the linked location. The further away the location, the greater the launch velocity.
Requirements:
- A linked location. Use the /linklocation command. You may also need to create a location with the /setlocation command
Useful:
- A linked value. Use the /linkvalue command. The linked value is a multiplier that will alter the launch speed. Experiment with values until you achieve the desired result. /linkvalue accepts decimals such as .2234 etc.
placeblocks
Description: When triggered, this action will set all blocks in the linked zone to the specified block. They will remain altered until the linked duration expires. By default the duration is 200 ticks (10 seconds) At that point the region will be returned to its original state. Chest inventories and sign text are not yet supported.
Requirements:
- A linked zone. Use the /linkzone command.
Useful:
- A linked duration. Use the /linkduration command. The duration is measured in ticks. If none is specified, it will default to 200 ticks (10 seconds).
- A linked block id. Use the /linkblockid command. If none is specified it will default to 1 (stone).
- A linked damage value. Use the /linkdamagevalue command. If none is specified it will default to 0.
deactivate
Description: When triggered, the linked zone will be deactivated. Any actions linked to the deactivated zone will no longer run.
Requirements:
- A linked zone. Use the /linkzone command.
activate
Description: When triggered, it will activate the linked zone. (If it's not already active.)
Requirements:
- A linked zone. Use the /linkzone command.
clearinventory
Description: When triggered, it will clear the inventory, armor, and experience of the player that activated it.
Requirements:
- None
spawnmob
Description: When triggered, it will spawn the designated quantity of the designated mob at the designated location.
Requirements:
- A linked location. Use the /linklocation command. You may also need to create a location with the /setlocation command
- A linked mob. Use the /linkmob command.
Useful:
- A linked quantity Use the /linkquantity command. If no quantity is specified it defaults to 1.
spawnitem
Description: When triggered, it spawns the specified quantity of an item of the specified id and durability at the specified location.
Requirements:
- A linked location. Use the /linklocation command. You may also need to create a location with the /setlocation command
Useful:
- A linked quantity Use the /linkquantity command. If no quantity is specified it defaults to 1.
- A linked item id. Use the /linkblockid command. If none is specified it defaults to 367 (rotten flesh)
- A linked damage value. Use the /linkdamagevalue command.
- A linked durability. Use the /linkdurability command. It defaults to 0 if none is specified.
spawntnt
Description: When triggered, it spawns the specified amount of activated tnt at the specified location.
Requirements:
- A linked location. Use the /linklocation command. You may also need to create a location with the /setlocation command
Useful:
- A linked quantity Use the /linkquantity command. If no quantity is specified it defaults to 1.
replaceblocks
Description: When triggered, it replaces any blocks in the linked zone matching the specified replace id and replace damage value with blocks of the specified id and damage value.
Requirements:
- A linked zone. Use the /linkzone command.
- A linked block id for the block to be replaced. Only blocks matching this id will be replaced with the linked block. Use the /linkreplaceblockid command.
- A linked replace damage value. Only blocks matching the replace damage value and id will be replaced with the linked block id/damage value. Use the /linkreplacedamagevalue command.
Useful:
- A linked duration. Use the /linkduration command. The duration is measured in ticks. If none is specified, it will default to 200 ticks (10 seconds).
- A linked block id. Use the /linkblockid command. If none is specified it will default to 1 (stone).
- A linked damage value. Use the /linkdamagevalue command. If none is specified it will default to 0.
killmobs
Description: When triggered, all mobs in the specified zone will be killed. They will not drop items.
Requirements:
- A linked zone. Use the /linkzone command.
logentry
Description: When triggered, the player that triggered the action will have his name stored in the entry log for the zone that the action is attached to. This will enable the player to trigger a returnteleport action which is linked to the zone with the logentry action attached.
Requirements:
- None
Useful:
- You can check who has entered the zone with the /entrylog command
givecreative
Description: When triggered, the player that triggered the action will be set to creative mode.
Requirements:
- None
removecreative
Description: When triggered, the player that triggered it will be set to survival mode.
Requirements:
- None
removeitems
Description: When triggered, all items on the ground within the boundary of the specified zone will be removed.
Requirements:
- A linked zone. Use the /linkzone command.
returnteleport
Description: When triggered it will check if the player that triggered it is on the entrylog of the linked zone. (Meaning the player has entered the linked zone previously.) If the player has not entered the linked zone, the teleport will be denied and an "access denied" message will be sent to them. If they have entered the linked zone, they will be teleported to the linked location.
Requirements:
- A linked zone. Use the /linkzone command. The linked zone must have the entrylog action attached to it.
- A linked location. Use the /linklocation command. You may also need to create a location with the /setlocation command
emptyinvteleport
Description: When triggered, it will teleport the player that activated it to the linked location only if they have an empty inventory.
Requirements:
- A linked location. Use the /linklocation command. You may also need to create a location with the /setlocation command.
restorezone
Description: When triggered, it restores the linked zone to the state that it was in when it was last saved to the SQL database. If it was never saved nothing will happen. This currently does not support chest inventories or sign text. (Will very likely add that in a future update.)
Requirements:
- A linked zone. Use the /linkzone command. The linked zone must have been previously stored in the SQL database with the /zonestore command. If it wasn't, nothing will happen.
- A configured MySQL database. Configuration settings are stored in config.yml
launchlocation
Description: When triggered, it launches the player through the air to the linked zone. If the zone is very far away the player will fly at around y 400 until approaching the destination. If the destination is at around the same elevation as the launch zone the launch angle will be low. If
Requirements:
- A linked location. Use the /linklocation command. The player will be launched to the linked location.
guidedflight
Description: When triggered, the player that triggered it will fly at the speed specified by the linked value for the duration specified by the linked duration.
Useful:
- A linked duration. Use the /linkduration command. If no duration is specified it defaults to 200 ticks (10 seconds). The linked duration determines how long a player will gain the ability to fly.
- A linked value. Use the /linkvalue command. If no value is specified it defaults to 1. The linked value is a multiplier that determines the speed at which a player will fly.
setcondition
Description: When triggered, it changes the current condition in the world to the linked condition.
Requirements:
- A linked condition. Use the /linkcondition command. Currently the linked condition can be sun, storm, day, night, dawn, or dusk.
spacelaunch
Description: When triggered, it launches the player vertically at high speed for the linked duration.
Useful:
- A linked duration. Use the /linkduration command. If no duration is specified it defaults to 10 seconds.