Configure Portal Messages

Multiverse-Portals lets you configure the message sent after a portal action succeeds and the message shown when a player does not have permission to enter a portal.

Message properties

Use /mvp modify to set either property:

/mvp modify <portal-name> action-success-message <message>
/mvp modify <portal-name> no-permission-message <message>
text

Messages can use legacy colour codes such as &a and these placeholders:

PlaceholderReplaced with
{player}The name of the player or entity using the portal
{portal}The portal name

Quote a message that contains spaces. For example:

/mvp modify spawn-portal action-success-message "&aWelcome, {player}!"
/mvp modify vip-portal no-permission-message "&cYou cannot use {portal}."
text

The success message is only sent after the portal action completes successfully. By default it is disabled. The no-permission message is shown when enforce-portal-access is enabled and the player does not have multiverse.portal.access.<portal-name>.

Special values

Both message properties accept these special values:

ValueBehaviour
@disabledDo not send a message
@defaultUse the built-in localized message
@@<message-key>Use a specific key from a Multiverse-Portals locale file

The defaults are @disabled for action-success-message and @default for no-permission-message.

To restore those defaults:

/mvp modify spawn-portal action-success-message @disabled
/mvp modify spawn-portal no-permission-message @default
text

Using a locale key

Use a locale key when the message should follow each player's client language. Follow Customise Locale Messages to create the Multiverse-Portals locale files, then add the same custom key to each applicable file in plugins/Multiverse-Portals/locales/:

# multiverse-portals_en.properties
myserver.portal.welcome=&aWelcome, {player}!

# multiverse-portals_es.properties
myserver.portal.welcome=&a¡Bienvenido, {player}!
ini

Then prefix the key with @@ when assigning it to the portal:

/mvp modify spawn-portal action-success-message @@myserver.portal.welcome
text

Globally hiding permission-denied messages

To stop all portals from sending their permission-denied message, use:

/mvp config send-no-permission-messages false
text

This is a global switch. It takes precedence over each portal's no-permission-message value. Permission checks still happen while enforce-portal-access is enabled; only the message is hidden.

Last update at: 2026/08/21 16:03:04