Astral Realms Documentation Help

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