Actions
BattlePass is powered in a lot of places by actions. Be aware that options like next-page may only be available in menus. Same goes for other dependent options.
Menu Action
The menu action can be used to open a menu for a player anywhere or if they have a menu open, go to the previous or next page.
The menu action also supports conditions.
= is used to represent something being the same, ! to represent when something is different.
Additionally, instead of using the menu name, you can also use close to close their currently open menu.
Format: [menu](condition) {menu-name}
Examples:1
actions:
2
- '[menu](page = 1) {portal}' # If the page is 1, take them to the portal page
3
- '[menu](page ! 1) {previous-page}' # If their page is not 1, take them to the previous page
4
- '[menu] {next-page}' # Conditions are not required
5
- '[menu] {close}' # Closes their currently opened menu
Copied!
Message Action
The message action is simple and can be used to send a message to a player.
Where appropriate, you can use the %tier% placeholder such as in the default config.
Format:
[message] {message}
Example:
Sound Action
This will play a sound for a player. You can find a list of sounds for your version by googling Minecraft sound enum .
You can optionally specify the volume and pitch of the sound (doesn't work for all due to the way Minecraft works).
Format:
[sound]{sound:volume:pitch} where you can remove volume/or pitch.
Examples:
1
actions:
2
- '[sound] {BLOCK_ANVIL_USE}'
3
- '[sound] {BLOCK_ANVIL_USE:2}'
4
- '[sound] {DOOR_CLOSE:3:2}'
Copied!
Command Action (Since v3.4)
This will execute a command as the player it's triggered for.
You can use %player% to use the player's name.
Format:
[command] {the command}
Examples:
1
actions:
2
- '[command] {bp menu rewards}'
3
- '[command] {some-command %player%}'
Copied!
Console Command Action (Since v3.4)
This will execute a command as the console.
You can use %player% to use the triggered player's name.
Format:
[console-command] {some console command}
Examples:
1
actions:
2
- '[console-command] {bc &c%player% did some thing. IDK what.}'
3
- '[console-command] {lp user %player% parent add some-group server="skyblock"}'
Copied!
Last modified 10mo ago