Configuration
AstralStaff loads two files on onEnable: messages.yml (into the StaffMessages enum) and config.yml (into the StaffConfiguration record). Neither is per-module — the plugin is Paper-only.
config.yml
inventory-title: "%img_internal:neg_8%<white>%img_guis:inventory%%img_internal:neg_176%%img_guis:title%%img_internal:neg_110%<font:alphabet:alphabet>inventaire</font>"
enderchest-title: "%img_internal:neg_8%<white>%img_guis:generic_27_vanilla%%img_internal:neg_176%%img_guis:title%%img_internal:neg_110%<font:alphabet:alphabet>enderchest</font>"
Key | Type | Description |
|---|
inventory-title
| Component (MiniMessage, placeholder-aware)
| Title of the /invsee mirror inventory. Rendered against the target's placeholder container, so %player_name%-style placeholders resolve to the inspected player, not the viewer. |
enderchest-title
| Component (MiniMessage, placeholder-aware)
| Title of the /ecview mirror inventory. Same placeholder container as above. |
Both keys back a ComponentWrapper, so any placeholder registered on AstralCore's player placeholder container (and the network's %img_*% /alphabet-font GUI helpers) may be used. The shipped default composes a custom GUI background image and an alphabet-font label ("inventaire" for the player inventory, "enderchest" for the ender chest) rather than a plain vanilla title.
messages.yml
Loaded into StaffMessages; every key is a MiniMessage string. CPS_TEST_STARTED, CPS_TEST_ENDED, and CPS_TEST_ALREADY_RUNNING exist in the enum but have no corresponding lines in the shipped messages.yml and are not referenced by any command or listener in the current source — no CPS-test feature is wired up; these are effectively dead entries.
Key | Used by |
|---|
vanish-enabled/vanish-disabled
| /vanish — feedback to the toggling player.
|
player-frozen/player-unfrozen
| /freeze — shown to the target, unless the -s (silent) flag is used.
|
freeze-notify/unfreeze-notify
| /freeze — shown to the staff member who ran the command, always (even when silent).
|
cannot-view-self
| /invsee and /ecview — refused when the viewer targets themselves.
|
random-teleport-success
| /srtp — on success; %target% is the visited player's name.
|
random-teleport-no-players
| /srtp — no eligible candidate on the whole network.
|
random-teleport-all-on-cooldown
| /srtp — every eligible candidate was visited within the last 10 minutes.
|
random-teleport-failure
| /srtp — the teleport itself failed (e.g. TeleportationService unavailable or errored).
|
vanish-enabled: "You are now invisible."
vanish-disabled: "You are now visible."
player-frozen: "You have been frozen by an administrator."
player-unfrozen: "You have been unfrozen by an administrator."
freeze-notify: "You have frozen %player_name%."
unfreeze-notify: "You have unfrozen %player_name%."
cannot-view-self: "You cannot open your own inventory here."
random-teleport-success: "<green>Teleported to <white>%target%</white>.</green>"
random-teleport-no-players: "<red>There is no one else online on the network to teleport to.</red>"
random-teleport-all-on-cooldown: "<red>Every online player was recently visited. Try again in a few minutes.</red>"
random-teleport-failure: "<red>Random teleport failed. Please try again.</red>"
Last modified: 25 July 2026