Notifications

Notifications allow you to customize the feedback players receive when interacting with portals.
Configure sounds, action bar messages, chat messages, and titles for various portal triggers.

Commands

List Notifications

Displays all notifications configured for a portal.
Usage: /portal notification list <portal> [<trigger>]

Examples:

# List all notifications for a portal
/portal notification list spawn-portal

# List notifications for a specific trigger
/portal notification list spawn-portal entry_success

You can click on notification entries in the output to edit them.

Set Notification

Adds or updates a notification for a specific trigger.
Usage: /portal notification set <portal> <trigger> (sound|actionbar|message|title)

Sound Notifications

Play a sound when the trigger fires.
Usage: /portal notification set <portal> <trigger> sound <sound> [<sound-source>]

Examples:

# Play a simple sound on teleport success
/portal notification set spawn-portal teleport_success sound entity.enderman.teleport

# Play a sound from a specific source
/portal notification set spawn-portal entry_success sound block.portal.trigger ambient

Action Bar Notifications

Display a message on the action bar.
Usage: /portal notification set <portal> <trigger> actionbar <message>

Examples:

# Show warmup message on action bar
/portal notification set spawn-portal entry_success actionbar <gray>Teleporting in <warmup> seconds...</gray>

Chat Message Notifications

Send a chat message to the player.
Usage: /portal notification set <portal> <trigger> message <message>

Examples:

# Send a message on successful teleport
/portal notification set spawn-portal teleport_success message <gray>Welcome to spawn!</gray>

# Nag about interrupting the warmup
/portal notification set spawn-portal warmup_failure message <red>You left the portal <remaining-warmup:'#.##'> seconds early</red>

Title Notifications

Display a title and optional subtitle.
Usage: /portal notification set <portal> <trigger> title <title> [<subtitle>] [<fade-in>] <stay> <fade-out>

Examples:

# Show a simple title
/portal notification set spawn-portal teleport_success title "<gold>Welcome!</gold>" "<gray>You arrived at spawn</gray>"

# Title with custom timing (fade-in, stay, fade-out)
/portal notification set vip-portal entry_success title "<aqua>VIP Portal</aqua>" "<gray>Please wait...</gray>" .5s 3s .25s

Remove Notification

Removes a specific notification from a portal trigger.
Usage: /portal notification remove <portal> <trigger> <notification>

Examples:

# Remove a sound notification
/portal notification remove spawn-portal entry_success sound

# Remove a message notification
/portal notification remove spawn-portal teleport_success message

Triggers

Notifications can be configured for the following portal events:

Trigger	Description
`entry_failure`	Portal entry was denied (insufficient funds, lacking permission)
`entry_success`	Successfully entered the portal
`exit`	Exited the portal
`teleport_failure`	Action failed (for custom implementations / future updates)
`teleport_success`	Action succeeded (e.g., successfully teleported)
`warmup_failure`	Warmup was interrupted by entity leaving the portal
`warmup_success`	Warmup was fully awaited

Placeholders

The following placeholders can be used in notification messages:

Placeholder	Description
`<cooldown>`	The portal cooldown duration in seconds
`<warmup>`	The portal warmup duration in seconds
`<remaining-cooldown>`	The entity's remaining cooldown for the portal in seconds
`<remaining-warmup>`	The entity's remaining warmup for the portal in seconds
`<entity>`	The entity's name
`<entry-cost>`	The formatted entry cost of the portal
`<permission>`	The entry permission of the portal (or "undefined" if not set)
`<portal>`	The name of the portal

Placeholders support formatting. For example, <warmup:'#.##'> formats the warmup to two decimal places.

Migration from Previous Versions

The portal.warmup.start translation message was removed in favor of this notification system.
To recreate the same behavior, add an entry_success message notification to your portals:

/portal notification set <portal> entry_success message <gray><blue>Portals</blue> <dark_gray>»</dark_gray> Do not leave the portal for <green><warmup:'#.##'></green> seconds…</gray>

This new system provides more flexibility, allowing different messages per portal rather than a global translation.

Notifications

On this page