Messages Configuration

All player-facing messages are defined in plugins/AstralSync/messages.yml. Messages use MiniMessage formatting.

Placeholders are injected at runtime with the <placeholder> syntax and are listed per message below.

To apply changes, run /sync reload.

Message Reference

`loading-data`

Sent to a player when their data begins loading from the database on join.

Placeholders: none

Default:

Loading your data from the database...

`unable-to-load-data`

Sent to a player (and used as the kick reason) when loading fails.

Placeholders: none

Default:

Unable to load your data from the database. Please contact an administrator.

`loading-snapshots`

Sent when an admin opens the snapshot browser for a player.

Placeholders: <player>

Default:

Loading <player>'s snapshots...

`no-snapshots-found`

Sent when no snapshots exist for the target player.

Placeholders: <player>

Default:

No snapshots found for <player>.

`snapshot-load-failed`

Sent when loading a specific snapshot fails.

Placeholders: <player>, <snapshot>

Default:

Failed to load snapshot <snapshot> for <player>. Please check the console for errors.

`cannot-modify-snapshot-while-online`

Sent when an admin tries to roll back a player who is currently online.

Placeholders: <player>

Default:

You cannot modify <player>'s snapshot while they are online. Please ask them to log out first.

`rollback-success`

Sent after a successful snapshot rollback.

Placeholders: <player>, <snapshot>

Default:

Rollback of <player>'s snapshot <snapshot> completed successfully.

`rollback-failed`

Sent when a rollback operation fails.

Placeholders: <player>, <snapshot>

Default:

Failed to rollback <player>'s snapshot <snapshot>. Please check the console for errors.

`adapters-list-header`

Header line for the /sync adapters output.

Placeholders: <size>

Default:

Available Adapters: (<size>)

`adapters-list-entry`

One line per registered adapter in the /sync adapters output.

Placeholders: <key>, <type>, <plugin>

Default:

- <key> | <type> registered by <plugin>

`adapters-list-empty`

Shown when no adapters are registered (should not occur in normal operation).

Placeholders: none

Default:

No adapters found.

`reloading`

Sent at the start of /sync reload.

Placeholders: none

Default:

Reloading the plugin...

`reloaded`

Sent after a successful reload.

Placeholders: none

Default:

Plugin reloaded successfully.

`reload-failed`

Sent when the reload fails.

Placeholders: none

Default:

Failed to reload the plugin. Please check the console for errors.

`unexpected-error`

Generic error message for unhandled exceptions.

Placeholders: none

Default:

An unexpected error occurred. Please contact an administrator.

`no-permission`

Sent when a player lacks the required permission.

Placeholders: none

Default:

You do not have permission to perform this action.

`snapshot-not-found`

Sent when the specified snapshot ID does not exist.

Placeholders: <player>, <snapshot>

Default:

Snapshot <snapshot> not found for <player>.

`player-not-found`

Sent when the target player cannot be found by name or UUID.

Placeholders: <player>

Default:

Player <player> not found.

24 April 2026