messages.yml Reference
plugins/AstralCore/messages.yml contains all localised message templates. Values use MiniMessage formatting and support <placeholder> inline variables that are substituted at send time.
Default file
# Teleportation
cannot-teleport-self: "You cannot teleport yourself."
teleport-player-self-success: "You have teleported yourself to <target>."
teleport-player-self-failure: "Failed to teleport yourself to <target>. Please try again later."
teleport-others-success: "You have teleported <source> to <target>."
teleport-others-failure: "Failed to teleport <source> to <target>. Please try again later."
teleport-success-other: "You have teleported <player> to <x> <y> <z>."
teleport-success: "You have been teleported to <x> <y> <z>."
teleport-failure: "Teleportation failed. Please try again later."
teleport-world: "You have been teleported to <world>"
teleport-here-success: "You have teleported <source> to you."
teleport-here-failure: "Failed to teleport <source> to you. Please try again later."
# Discord
discord-already-linked: "Your account is already linked to Discord."
discord-link-failure: "Failed to link your account to Discord. Please try again later."
discord-link-success: "Your account has been successfully linked to <name>."
discord-link-url: "Click here to link your account to Discord"
# Give
item-not-found: "Item <item> not found."
give-item-success: "You have given x<amount> <item> to <player>."
give-item-failure: "Failed to give to <player>. Please try again later."
# Miscellaneous
player-not-found: "Player <player> not found."
no-permission: "You do not have permission to perform this action."
Message Reference
Teleportation
Key | Placeholders | Sent when |
|---|
cannot-teleport-self
| — | Player tries to teleport to themselves |
teleport-player-self-success
| <target> player name
| Self-teleport succeeded |
teleport-player-self-failure
| <target> player name
| Self-teleport failed |
teleport-others-success
| <source>, <target>
| Admin teleported one player to another (admin receives this) |
teleport-others-failure
| <source>, <target>
| Admin-initiated teleport failed |
teleport-success-other
| <player>, <x>, <y>, <z>
| Admin teleported a player to coordinates |
teleport-success
| <x>, <y>, <z>
| Player was teleported to coordinates |
teleport-failure
| — | Generic teleport failure |
teleport-world
| <world>
| Player teleported to a world |
teleport-here-success
| <source>
| /tphere succeeded (admin receives this)
|
teleport-here-failure
| <source>
| /tphere failed
|
Discord
Key | Placeholders | Sent when |
|---|
discord-already-linked
| — | Player runs /discord link but already linked |
discord-link-failure
| — | Linking process errored |
discord-link-success
| <name> Discord account name
| Linking succeeded |
discord-link-url
| — | Clickable link text shown to the player |
Items
Key | Placeholders | Sent when |
|---|
item-not-found
| <item> item ID
| Requested item ID doesn't resolve to a known item |
give-item-success
| <amount>, <item>, <player>
| /give succeeded
|
give-item-failure
| <player>
| /give failed
|
Miscellaneous
Key | Placeholders | Sent when |
|---|
player-not-found
| <player> name
| Command target player doesn't exist |
no-permission
| — | Player lacks required permission |
Adding global variables
All variables defined in config.yml are available as MiniMessage tags inside message values:
# config.yml
variables:
prefix: "<gray>[<aqua>Server</aqua>]</gray> "
# messages.yml
no-permission: "<prefix>You do not have permission."
23 April 2026