messages.yml Reference
Every player-facing string lives in plugins/AstralChat/messages.yml, backed by the ChatMessages enum. Values are MiniMessage and resolve the global AstralCore variable tags (<info>, <success>, <warning>, <error>) plus the chat placeholders.
A key present in the enum but absent from the file resolves to nothing, so removing a line silences that message rather than breaking it.
Moderation
Key | Variables | When |
|---|
message-doesnt-respect-rules
| — | A filter blocked the message and defined no custom-message of its own. |
message-blocked-notification-format
| %player_…%, %message%, %reason%
| Staff notification on a blocked message, broadcast to the filter's notification-channel. |
message-filtered-notification-format
| %player_…%, %message%, %reason%
| Same, for a message that was flagged or rewritten but let through. |
message-moderation-notification-format
| %player_…%, %message%, %reason%, %score%
| Staff notification from the classifier, above the alert threshold. |
chat-muted
| — | A muted player used a per-channel command (LiteBans check). |
%player_…% is the sender as a player placeholder — %player_name% in the shipped file. %reason% is the comma-separated list of triggered filters or categories; %score% is formatted to three decimals.
Private messages
Key | Variables | When |
|---|
no-message-to-reply-to
| — | /reply with no cached partner.
|
reply-player-offline
| — | The cached partner is offline or vanished. |
private-message-error
| — | Catch-all PM failure. |
ignore-recipient
| %target_…%
| The recipient ignores the sender. |
private-message-recipient-disabled
| %target_…%
| Recipient has /togglepm off. |
cannot-message-yourself
| — | /msg <self>.
|
private-message-enabled
| — | /togglepm → on.
|
private-message-disabled
| — | /togglepm → off.
|
player-not-found
| %target_…%
| Recipient unknown, or on a server outside enabled-groups. |
Channels
Key | Variables | When |
|---|
channel-cooldown
| %time%
| Cooldown not elapsed. |
channel-currently-paused
| — | Channel is paused. |
channel-paused
| %duration%
| Confirmation of a pause action. |
channel-resumed
| — | Confirmation of a resume action. |
channel-list-header
| — | Header for /channel list. |
channel-list-entry
| %channel%
| Per-channel row. |
channel-broadcast
| %channel%, %message%
| Output of /channel broadcast. |
channel-subscribed
| %channel%
| /subscribe success.
|
channel-unsubscribed
| %channel%
| /unsubscribe success.
|
channel-already-subscribed
| %channel%
| Already subscribed. |
channel-not-subscribed
| %channel%
| Not subscribed. |
channel-no-permission
| %channel%
| Missing channel permission. |
chat-not-subscribed-no-message
| %channel%
| Speaking in a channel you are not subscribed to. |
Social spy
Key | When |
|---|
social-spy-enabled
| /socialspy → on.
|
social-spy-disabled
| /socialspy → off.
|
Ignore
Key | Variables | When |
|---|
ignore-player
| %target_…%
| /ignore success.
|
unignore-player
| %target_…%
| /unignore success.
|
cannot-ignore-staff
| %target_…%
| /ignore targeted someone holding astralchat.ignore.bypass.
|
player-not-ignored
| %target_…%
| /unignore target wasn't ignored.
|
already-ignored
| %target_…%
| /ignore target already ignored.
|
not-ignoring-anyone
| — | /ignore with no args and an empty list.
|
Key | Variables | When |
|---|
tag-equipped
| %tag%
| Equip success. |
tag-unequipped
| %tag%
| Unequip success. |
Nicknames
Key | Variables | When |
|---|
nickname-set
| %nickname%
| /nick <name> accepted.
|
nickname-reset
| — | /nick with no args.
|
nickname-too-long
| — | Longer than 16 characters. |
nickname-contains-emoji
| — | Contains a :name: emoji placeholder. |
nickname-invalid
| — | Blank, or contains anything other than letters, digits, underscores and spaces. |
Toggles and mentions
Key | When |
|---|
paid-roles-enabled/paid-roles-disabled
| toggle-paid-roles action.
|
mentions-enabled/mentions-disabled
| toggle-chat-mentions action.
|
mention-title
| Title shown to a mentioned player. %sender% resolves to the sender. |
mention-subtitle
| Subtitle paired with mention-title. |
Generic
Key | When |
|---|
no-permission
| The equip-chat-tag action targeted a tag the player lacks the permission for, or a per-channel command was used without the channel permission. |
unexpected-error
| Catch-all error — a missing snapshot, a failed menu, a timed-out lookup. |
Last modified: 03 September 2026