messages.yml Reference
plugins/AstralTown/messages.yml holds 193 message keys. Values are MiniMessage and resolve the global AstralCore variable tags (<info>, <success>, <warning>, <error>).
This page lists every key grouped by domain. Variable placeholders (%player_name%, %town_*%, %target_name%, …) are substituted at send time; for a full inventory see Placeholders.
Town lifecycle
Key | Use |
|---|
INVALID_TOWN_NAME
| Name failed the regex / blacklist. |
INVALID_TOWN_NAME_LENGTH
| Name length out of range. |
TOWN_NAME_TAKEN
| Duplicate name. |
PLAYER_ALREADY_IN_TOWN
| Self-explanatory. |
TOWN_CREATED
| Success message. |
TOWN_CREATE_FAILED
| Generic creation failure. |
TOWN_LIMIT_REACHED/TOWN_LIMIT_REACHED_OTHER
| Quota errors (self / on behalf of another). |
TOWN_NAME_UPDATED
| Rename success. |
TOWN_MOTD_UPDATED/TOWN_MOTD_CLEARED/TOWN_MOTD_TOO_LONG
| MOTD. |
TOWN_SPAWN_UPDATED
| /town spawn set.
|
TOWN_UPDATE_FAILED
| Generic update failure. |
TOWN_DELETED/TOWN_DELETE_FAILED
| Disband. |
TOWN_DELETE_CONFIRMATION/TOWN_DELETE_CANCELLED
| Two-step disband flow. |
TOWN_DELETE_ONLY_OWNER
| Non-owner attempted disband. |
Spawn
Key | Use |
|---|
SPAWN_NOT_IN_TOWN_CLAIM
| Spawn must be inside the town. |
NO_TOWN_SPAWN_SET
| /town spawn with no spawn set.
|
TELEPORTED_TO_TOWN_SPAWN
| Teleport success. |
CANNOT_OBSTRUCT_TOWN_SPAWN
| Block placement attempt. |
Claims & auto-claim
Key | Use |
|---|
CHUNK_ALREADY_CLAIMED
| Target chunk owned by another town. |
CHUNK_NOT_CLAIMED
| Unclaim target not owned. |
CHUNK_CLAIM_SUCCESS/CHUNK_UNCLAIM_SUCCESS
| Standard confirmations. |
CHUNK_CLAIM_FAILED/CHUNK_UNCLAIM_FAILED
| Generic failures. |
CHUNK_CLAIM_LIMIT_REACHED
| max-claims reached.
|
CHUNK_CLAIM_NOT_ADJACENT
| Adjacency rule. |
CLAIM_DISABLED_IN_WORLD
| World excluded. |
CLAIM_NEAR_OTHER_TOWN
| min-distance-between-towns.
|
CLAIM_INSUFFICIENT_FUNDS
| Bank shortfall. |
CLAIM_TOO_CLOSE_FROM_SPAWN
| min-distance-from-spawn.
|
AUTO_CLAIM_ENABLED/AUTO_CLAIM_DISABLED
| Toggle. |
AUTO_CLAIM_FAILED_WORLD
| Tried to enable in disallowed world. |
Roles
Key | Use |
|---|
ROLE_CREATION_TITLE/ROLE_EDITION_TITLE
| Dialog headers. |
ROLE_CREATION_NAME_FIELD/ROLE_CREATION_DESCRIPTION_FIELD/ROLE_CREATION_BASE_ROLE_FIELD
| Field labels. |
ROLE_CREATION_NONE_OPTION
| "No base role" entry. |
ROLE_CREATION_CONFIRM/ROLE_CREATION_CANCEL
| Buttons. |
ROLE_DELETION_TITLE/ROLE_DELETION_CONFIRM/ROLE_DELETION_CANCEL
| Deletion dialog. |
ROLE_CREATED/ROLE_UPDATED/ROLE_DELETED
| Confirmations. |
ROLE_ALREADY_EXISTS/ROLE_INVALID_NAME
| Validation. |
ROLE_NOT_FOUND
| Lookup miss. |
CANNOT_DELETE_DEFAULT_ROLE
| Default-role guard. |
ROLE_DELETION_NO_REASSIGNMENT
| Members would be left without a role. |
ROLE_PERMISSIONS_UPDATED/PERMISSION_ADDED/PERMISSION_REMOVED
| Permission edits. |
ROLE_DEFAULT_STATUS_UPDATED
| Default-role marker changed. |
Members & invitations
Key | Use |
|---|
INVITATION_SENT
| After /town invite. |
INVITATION_ALREADY_SENT
| Pending invitation exists. |
INVITATION_RECEIVED
| Recipient notification. |
INVITATION_ACCEPTED/INVITATION_DECLINED
| Recipient confirmation. |
INVITATION_ACCEPTED_NOTIFICATION/INVITATION_DECLINED_NOTIFICATION
| Inviter notification. |
INVITATION_EXPIRED
| Auto-expired. |
INVITATION_CANCELLED
| Inviter-cancelled. |
INVITATION_NOT_FOUND/INVITATION_ALREADY_ANSWERED
| Lookup failures. |
NO_PENDING_INVITATION
| /town accept with nothing pending.
|
CANNOT_INVITE_SELF
| Self-target. |
CANNOT_INVITE_BANNED_PLAYER
| Banned target. |
MEMBER_JOIN_NOTIFICATION
| Town notice on join. |
MEMBER_KICKED/MEMBER_KICK_FAILED/MEMBER_KICK_NOTIFICATION
| Kick flow. |
MEMBER_LEFT_TOWN/MEMBER_LEAVE_FAILED/MEMBER_LEAVE_NOTIFICATION
| Leave flow. |
CANNOT_LEAVE_OWNED_TOWN
| Owner cannot leave. |
CANNOT_KICK_SELF/CANNOT_KICK_OWNER
| Kick guard. |
MEMBER_ROLE_UPDATED/MEMBER_ROLE_UPDATE_NOTIFICATION/MEMBER_ROLE_UPDATE_FAILED
| Role assignment. |
CANNOT_MODIFY_SELF_ROLE/CANNOT_MODIFY_HIGHER_ROLE/CANNOT_MODIFY_OWNER_ROLE
| Guards. |
Bank & ownership
Key | Use |
|---|
BANK_DEPOSIT_SUCCESS/BANK_WITHDRAW_SUCCESS
| Confirmations. |
BANK_INSUFFICIENT_FUNDS
| Shortfall. |
BANK_TRANSACTION_FAILED
| Generic failure. |
CANNOT_TRANSFER_OWNERSHIP_TO_SELF
| Self-transfer. |
CANNOT_TRANSFER_OWNERSHIP_TO_NON_MEMBER
| Recipient not a member. |
TRANSFER_OWNERSHIP_SUCCESS/TRANSFER_OWNERSHIP_FAILED
| Confirmations. |
TRANSFER_OWNERSHIP_FAILED_MEMBER_QUOTA/TRANSFER_OWNERSHIP_FAILED_OWNER_QUOTA
| Recipient quota check. |
Bans
Key | Use |
|---|
PLAYER_ALREADY_BANNED/PLAYER_BANNED/PLAYER_UNBANNED
| Ban / unban confirmations. |
PLAYER_BAN_NOTIFICATION/PLAYER_UNBAN_NOTIFICATION
| Town notice. |
CANNOT_BAN_SELF/CANNOT_BAN_OWNER
| Ban guard. |
CANNOT_UNBAN_SELF/CANNOT_UNBAN_NOT_BANNED_PLAYER
| Unban guard. |
CANNOT_ENTER_BANNED_TOWN
| Movement block. |
Warps
Key | Use |
|---|
INVALID_WARP_NAME/WARP_NAME_TAKEN
| Validation. |
WARP_NOT_IN_TOWN_CLAIM
| Create outside claims. |
WARP_LIMIT_REACHED
| Quota. |
WARP_CREATED/WARP_UPDATED/WARP_DELETED
| Confirmations. |
WARP_CREATE_FAILED/WARP_UPDATE_FAILED/WARP_DELETE_FAILED
| Generic failures. |
WARP_NOT_FOUND
| Lookup miss. |
TELEPORTED_TO_WARP
| Teleport. |
WARP_TELEPORT_BANNED
| Banned target. |
CANNOT_OBSTRUCT_WARP
| Block placement guard. |
WARP_PINNED/WARP_UNPINNED
| Favourites toggle. |
Subzones
Key | Use |
|---|
SUBZONE_SELECT_CORNER_1/SUBZONE_FIRST_CORNER_SELECTED
| Corner-pick flow. |
SUBZONE_SELECT_CORNER_2/SUBZONE_SECOND_CORNER_SELECTED
| Corner-pick flow. |
INVALID_SUBZONE_NAME/ALREADY_EXISTING_SUBZONE
| Validation. |
SUBZONE_NOT_IN_TOWN_CLAIM/SUBZONE_OVERLAPPING
| Geometry validation. |
SUBZONE_LIMIT_REACHED
| Quota. |
SUBZONE_CREATION_EXPIRED/SUBZONE_CREATION_CANCELLED/SUBZONE_CREATION_ALREADY_IN_PROGRESS
| Flow control. |
SUBZONE_CREATED/SUBZONE_CREATION_FAILED
| Confirmation. |
SUBZONE_CREATION_DIALOG_*
| Dialog labels (TITLE, NAME_FIELD, DESCRIPTION_FIELD, COPY_FROM, INHERIT_SETTINGS_FIELD, CONFIRM, CANCEL). |
SUBZONE_UPDATE_DIALOG_TITLE
| Edit dialog title. |
SUBZONE_UPDATED/SUBZONE_CUBOID_UPDATED/SUBZONE_SETTINGS_UPDATED
| Confirmations. |
SUBZONE_DELETED/SUBZONE_DELETE_FAILED
| Delete flow. |
SUBZONE_NOT_FOUND
| Lookup miss. |
SUBZONE_NO_DEFAULT_ROLE
| Missing role guard. |
SUBZONE_ALREADY_MEMBER
| Duplicate add. |
SUBZONE_MEMBER_ADDED/SUBZONE_MEMBER_REMOVED
| Confirmations. |
SUBZONE_ACCESS_GRANTED/SUBZONE_ACCESS_REVOKED
| Synonyms for menus. |
SUBZONE_MEMBER_PROMOTED/SUBZONE_MEMBER_DEMOTED
| Role cycle. |
SUBZONE_MEMBER_PROMOTED_NOTIFICATION/SUBZONE_MEMBER_DEMOTED_NOTIFICATION
| Target notification. |
Chat, particles, visitors, selection
Key | Use |
|---|
CHAT_ENABLED/CHAT_DISABLED
| Town chat toggle. |
CHAT_FORMAT/BROADCAST_FORMAT
| Templates. |
PARTICLES_VIEW_ENABLED/PARTICLES_VIEW_DISABLED
| Toggle. |
PARTICLES_VIEW_DISABLED_IN_WORLD
| World excluded. |
VISITOR_ENTERED_TOWN/VISITOR_LEFT_TOWN
| VISITORS_NOTIFICATIONS setting.
|
TOWN_SELECTED/TOWN_ALREADY_SELECTED
| Selection. |
MEMBER_JOIN_NETWORK_NOTIFICATION/MEMBER_JOIN_NETWORK_ENABLED/MEMBER_JOIN_NETWORK_DISABLED
| Member-join pings. |
ONLINE_MEMBERS_HEADER/ONLINE_MEMBERS_ONLINE_ENTRY/ONLINE_MEMBERS_OFFLINE_ENTRY
| /town online.
|
Generic
Key | Use |
|---|
PLAYER_HAS_NO_TOWNS
| Listing fallback. |
SETTINGS_UPDATED
| Bulk settings save confirmation. |
TOWN_NOT_FOUND/PLAYER_NOT_FOUND
| Lookup misses. |
NO_PERMISSION
| Generic perms failure. |
ERROR_OCCURRED
| Catch-all error. |
OWNER_ROLE
| Label for owner in member lists. |
SELECTED/NOT_SELECTED
| Boolean labels. |
ENABLED/DISABLED
| Boolean labels. |
TOWN_BALANCE
| Balance display template. |
NO_TOWN_SELECTED
| Selection guard. |
NO_DESCRIPTION
| Fallback for empty description fields. |
Last modified: 25 July 2026