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!