Actions - AdditionsPlus

◄ Go Back Download Features & Dependencies Actions Commands & Permissions

About the actions

An action is a string that performs a certain operation. These actions are mainly used in the AdditionsPlus plugin, but there are several other plugins that use them as well. Actions are always wrapped between square brackets [] and the action identifiers are case insensitive. An example is: [message].
Actions are often followed by a string, because most actions require more things to be specified than just the identifier. For example: [message]this is a message.

There are several action types:
INNER ([action=...]) : require inline arguments; these often return true/false, if false the action won't be executed; example: [permission].
OUTER ([action]...[/action]) : require an opening and closing tag; often have a return value; example: [math].
STANDALONE ([action]) : do not require any arguments; example: [safelanding].
NORMAL ([action]...) : require arguments; most common one; example: [message].
COMBINED ([action][anotherAction]) : does nothing on its own; must be combined with another action; example: [everyone].

All INNER, OUTER and COMBINED actions can be combined with normal ones. This way, you can create dynamic actions. For example, you can use an INNER action to check if a player has a certain permission, if true, send the player a message: [permission=my.perm][message]you have the permission my.perm!

Below is the list with all actions with their descriptions and a few examples for every action.
Please note that this list is based on the latest version of AdditionsPlus.

Click an action in the list below to get more info about it.

Actions	Description
[message]	Send a message to a player
Aliases: [msg] Examples: [message]This is a message only sent to you!
[command]	Perform a command as a player
Aliases: [player] Examples: [player]say hi
[console]	Perform a command as the console
Examples: [console]give %player% stick 1
[title]	This will send a title to the player. Use \n to switch to the subtitle. Supports color codes.
Examples: [title]&a&Welcome!\n&7%player%
[actionbar]	This will send an actionbar to a player. Supports color codes.
Aliases: [action] Examples: [actionbar]&6Welcome to our server!
[json]	This will send a json message to a player. Use a generator like this to create json messages.
Aliases: [jsonmessage], [jsonmsg] Examples: [json]["",{"text":"Text","color":"green","hoverEvent":{"action":"show_text","value":{"text":"","extra":[{"text":"More text"}]}}}]
[everyone]	This will perform the action for all online players instead of the event player only.
Examples: [msg][everyone]&a%player% joined the server!
[center]	This will send a json message to a player. Use a generator like this to create json messages.
Examples: [msg][center]&aThis is a centered message
[language]	This will only perform the action if the player has a certain Minecraft language/locale. You can find a list of Minecraft locales here. If the player does not have that locale, the action will be skipped for that player. This action works with [everyone]. Use [language=""] as base, then put the target locale between the double quotes.
Examples: [msg][everyone][language="en_us"]&aYour language is English (United States)
[delay]	This will delay the action with the specified amount of ticks (1 sec = 20 ticks). Use [delay=""] as base, then put the delay time, in ticks, between the double quotes.
Examples: [msg][delay="100"]&7This message is 5 seconds delayed.
[connect]	This will connect the player to another server. This can only be used on a bungeeCord server and the specified server must be connected to it. The names of the server are the same as the ones in the config.yml on your bungee host.
Examples: [connect]pvp
[money]	This will deposit/withdraw money to/from a player's balance. Vault must be installed in order to use this.
Examples: [money]10 [money]-10 [money]+10
[menu]	This will open a custom menu. Just add the menu name (without .yml) after it.
Examples: [menu]example
[close]	This will close the player's inventory. Do not use this after you specified the [menu] action. The menu will not open then.
Examples: [close]
[permission]	This checks if the player has the specified permission and discontinues the action if the player doesn't have it.
Examples: [permission=myperm][msg]&aYou have the specified permission
[vgroup]	This checks if the player is a member of the specified group. Vault is required in order to use this action. Also, a permission plugin is needed which should be supported by Vault.
Aliases: [vaultgroup] Examples: [msg][vgroup="donator"]&dYou are a donator
[chance]	This adds chances to the action. This should be a percentual amount between 0-100. If you set it to 50, there will be 50% chance for the action to be performed.
Examples: [msg][chance=50]&aThere is 50% chance of getting this message
[sound]	This plays a sound for a player. Make sure to play sounds matching your server version.
Examples: [sound]NOTE_PLING
[customitem]	Give a custom Additions item to a player.
Aliases: [citem] Examples: [customitem]myFirstItem
[book]	Give a custom book to a player
Examples: [book]myBook
[safelanding]	This teleports a player to the highest location at their x,z coordinates.
Examples: [safelanding]
[kick]	Kick a player from the server
Examples: [kick]&c&lU got kicked suckaa!
[teleport]	Teleports a player to the specified location
Examples: [teleport]player [teleport]x y z [teleport]World x y z [teleport]x y z pitch yaw [teleport]World x y z pitch yaw
[fly]	Toggle/set the flight of a player
Examples: [fly]true [fly]
[allowfly]	Toggles the flying allowance of a player
Examples: [allowfly]true [allowfly]
[food]	Sets the foodbar of a player
Examples: [food]20
[health]	Sets the health of a player
Examples: [health]20
[kill]	Kills a player
Examples: [kill]
[clear]	Clears the inventory of a player
Examples: [clear]
[clearchat]	Clears the chat of a player. (Actually just spams the chat with empty messages)
Examples: [clearchat]
[weather]	Sets the weather (of a world). Weather types are: SUN, RAIN and STORM.
Examples: [weather]SUN [weather]World STORM
[playerweather]	Sets the player's personal weather. Weather types are: SUN, RAIN and RESET.
Aliases: [pweather] Examples: [playerweather]RESET
[time]	Sets the time (of a world). Time type could either be DAY, NIGHT or some specific integer.
Examples: [time]DAY [time]300
[playertime]	Sets the player's personal time. Time type could either be DAY, NIGHT, RESET or some specific integer.
Aliases: [ptime] Examples: [playertime]RESET
[gamemode]	Sets the gamemode of the player. Gamemode can either be SURVIVAL, ADVENTURE, CREATIVE or SPECTATOR. Version 1.1.0 also supports the numbers 0, 1, 2 and 3.
Examples: [gamemode]CREATIVE [gamemode]1
[flyspeed]	Sets the flying speed of the player. This should be an integer between 0 and 1! Do not use ints greater than 1.
Aliases: [fspeed] Examples: [flyspeed]0.5
[flyspeed]	Sets the walking speed of the player. This should be an integer between 0 and 1! Do not use ints greater than 1.
Aliases: [wspeed] Examples: [walkspeed]0.5
[speed]	Sets the walking/flying speed of a player. Depends whether a player is flying or not. This should be an integer between 0 and 1! Do not use ints greater than 1.
Examples: [speed]0.3
[chat]	Sends a chat message as the player
Examples: [chat]I am saying something :)
[target]	This sets the action target to the specified player(s). The action will then not be performed for the 'main' player. If you want multiple players, split them by adding a , between the names/placeholders. No spaces. This especially can be used in combination with command arguments.
Examples: [target=%player%,LukasIsTheName][msg]&aYou are a target
[randomnumbergenerator]	This isn't a real action. This turns into a number you can specify. RNG stands for Random Number Generator. You can specify one or two numbers. And it will then pick a random number between them. If you only specify one, it will go from 0 to your specified number. The / on the end of the tag is required!
Aliases: [rng] Examples: [msg]This is a number between 10 and 100: [rng=10,100]
[math]	This calculates everything between the opening and closing math tag. The opening tag is [math] and the closing tag is [/math]. So the math tags will be turned into the solution.
Examples: [msg]Solution 13+7-4 = &a[math]1 3 + 7 - 4[/math]
[price]	This checks if the player has the specified amount of money. Requires Vault. This does not withdraw any money from the player's account!
Examples: [price=100][msg]&7You got a minimum of $100
[targetworld]	This sets the action target to the player(s) in the specified world(s). The action will then not be performed for the 'main' player. If you want multiple players, split them by adding a , between the world names/placeholders. No spaces.
Examples: [targetworld=%world%][msg]&aSome message for this world
[resourcepack]	This will send a resource pack installation request to the player. You have to specify a link.
Examples: [resourcepack]https://mylink.com/resourcepack
[nopermission]	This will check if the player does not have a certain permission.
Examples: [nopermission=admin.perm][msg]&cYou are not allowed to do this
[novaultgroup]	This will check if the player is not in a certain vault group.
Examples: [novaultgroup=admin][msg]&cYou are not allowed to do this
[isconsole]	This will check if the sender is the console. Useful for commands that are compatible with console and players.
Examples: [isconsole][msg]&cYou are the console
[isplayer]	This will check if the sender is a player. Useful for commands that are compatible with console and players.
Examples: [isplayer][msg]&cYou are a player
[world]	This will check if the current world is equal to something.
Examples: [world=myworldname][msg]You are in the world &bmyworldname
[return]	You can use this action to stop the plugin from executing further actions in the list. You can just put this in any action, doesn't have to be in one by itself. You can use this, for example, to do different things when players have different permissions.
Examples: [permission=rank.mpv][msg]Hi there you are an MVP [permission=rank.staff][msg]&cYou are a staff member[return] [msg]&cYou are a normal player
[if]	This feature executes a custom Javascript code and uses the value as return. So make sure that when you're using this, the return object of the code is always a boolean (true/false)! If you are using placeholders in your javascript code, make sure to put them between double quotes, because otherwise the plugin will think that it's a variable.
Examples: [if="{arg1}" === "yeet");][msg]You said yeet [if="%player%".startsWith("a");][msg]Your username starts with an a
[placeholders]	You can use this to use other online players' placeholders in an action.
Examples: [placeholders={arg1}][msg]{arg1}'s UUID is: %uuid%
[discord]	This tag can be used to send custom messages to a custom discord webhook in your Discord server. The discord hook has to be enabled and configured in the config.yml to make it work!
Examples: [discord]This is a message sent from minecraft using AdditionsPlus
[httprequest]	This tag can be used to send HTTP Requests to your/a website. This can be useful if you want to send server data to your website, to for example display the online players.
Examples: [httprequest]https://example.com/my-api.php?online-players=%sever_online%