Skip to content


BetonQuest features a powerful notify system that allows you to display any information to your players. You can freely choose between many NotifyIO's like simple chat output, (sub)titles, advancements or sounds. They all come with unique options that allow you to customize them. Just take a look at this example configuration:

Sending custom notificationsπŸ”—

A truly custom notification can be sent using the notify event at any time. Check out the events documentation to learn how.

Changing BetonQuest's built-in notificationsπŸ”—

General notificationsπŸ”—

These can be anything from BetonQuest notifying a player that their language has been changed to sending a notice about a new changelog to an admin.

For example:
When BetonQuest fails to add a quest item to a player's inventory it will send &e*&bYour inventory is full!&e*.
This message is defined in messages.yml along with other default plugin messages. You can redefine them to your liking.

The Notify System can do much more than just changing messages, though:

All notifications will be displayed using the ChatIO and without a sound by default. You need to use notification categories to change this behaviour. These categories are pretty much just pre-defined NotifyIO settings.
Each notification in messages.yml has a special category with a reserved name assigned to it.

For example, If you would like to have the "language_changed" notification displayed as an actionbar message, you define the following:

notifications:        #General header for all notification settings
  language_changed:   #Name of the category, same as in messages.yml
    io: actionbar     #Setting the Notify IO to "actionbar"


A note about the notifications section: BetonQuest searches through all packages and just uses the first one it finds. Therefore, you should probably create just one notifications section. We will improve this in BQ 2.0.

You can add any other Notify IO setting to the category like so:

    io: actionbar     
    sound: entity.blaze.hurt  #Plays a sound while showing the notification

  changelog: #This is another category. They all need to be inside the 'notifications:' section.
    sound: entity.experience_orb.pickup      
A full list of all reserved names can be found on the IO's & Categories page.

This feature can be used to disable build-in notifications:
Just set io: to supress for any notification that you want to remove.

Objective notificationsπŸ”—

Some objectives have a notify argument that can be added to their instruction. If you do so, the objective will send a notification to the player if they progress in the objective. You can also add an interval (notify:5) - in this case the player will get a notification every 5 steps towards the completion of the objective.

The messages.yml values of these notifications look a bit strange:

blocks_to_break: '&2{1} blocks left to break'
{1} is just an internal variable (similar to the color codes) that will be replaced with a number based on the player's progression.

You can customize how these notifications are displayed using exactly the same method as for other built-in notifications.