Messages

invalid-gamemode

—

/gms, /gmc, /gma, /gmsp, /gm0–/gm3 when the alias used doesn't resolve to a GameMode (CompactGamemodeCommand). /gamemode <mode> instead relies on GamemodeContextResolver, which throws ACF's own invalid-argument error for a bad <mode> token — that path never reaches this key.

gamemode-changed

%mode%

Sender changed their own gamemode via /gamemode or a /gm* alias. %mode% is the matching label below for the resulting mode.

gamemode-changed-other

%target_name%, %mode%

Sender changed another player's gamemode (essentials.gamemode.others.<mode>).

survival-mode/creative-mode/adventure-mode/spectator-mode

—

Not sent directly — substituted as the %mode% value based on the resulting GameMode.

not-repairable

—

/repair or /repair hand when the held item has no Damageable meta, or is an AstralItems custom item (ItemsAPI.isCustomItem).

item-repaired

%item_name%

/repair or /repair hand — resets the held item's damage.

all-items-repaired

%amount%

/repair all — %amount% is the number of storage-slot items whose damage was reset; sent as 0 (with no cooldown applied) when nothing in the inventory was repairable.

no-smeltable-items

—

/furnace//smelt (held item) or /furnace all when no registered FurnaceRecipe matches.

items-smelted

%amount%

/furnace or /furnace all — the total output item count (input amount × recipe result amount, summed across items for all).

no-condensable-items

—

/condense (held item) or /condense all when no condensable-items entry matches.

items-condensed

%amount%

/condense or /condense all. Note: the single-item form hardcodes %amount% to 1 regardless of how many condensed blocks were actually produced; only /condense all sends the real summed count.

nothing-to-strip

—

/strip (held item) or /strip all when nothing in scope is a strippable log (StripWoodCommand.LOGS).

items-stripped

%amount%

/strip or /strip all. Note: the single-item form hardcodes %amount% to 1; only /strip all sends the real summed input count.

not-holding-concrete-powder

—

/concrete when the held item isn't tagged Tag.CONCRETE_POWDER.

concrete-created

%amount%

/concrete or /concrete all — the converted stack size (or summed total for all). /concrete all sends this even when 0 stacks were converted; unlike condense/furnace, it has no "nothing to convert" guard.

flying-speed-set

%speed%

/speed fly [0-10], or /speed [0-10] while flying — %speed% is the raw 0–10 input, not the resulting 0.0–1.0 Bukkit fly speed actually applied.

walking-speed-set

%speed%

/speed walk [0-10], or /speed [0-10] while not flying — same raw 0–10 input.

player-time-set

%time%

/playertime <time> (/ptime) — %time% is the raw tick argument; the value is also persisted network-wide via AstralSync's PlayerTimeData.

player-time-reset

—

/playertime reset.

invalid-weather-type

—

/pweather <type> when <type> isn't storm, sun, clear, or reset.

weather-changed

%weather%

/pweather storm or /pweather sun \|clear — %weather% is the storm-weather/clear-weather label component itself.

weather-reset

—

/pweather reset.

clear-weather/storm-weather

—

Not sent directly — substituted as the %weather% value (sun and clear both resolve to clear-weather).

feed-success

—

/feed (self), and also sent to the target player when a sender runs /feed <player>.

feed-success-other

%target_name%

/feed <player> (essentials.feed.others) — sent to the sender only.

hat-success

%item_name%

/hat — equips the held item as a helmet; the previous helmet is returned to the inventory or dropped on the ground if full. Fails with main-hand-empty first if the main hand is empty.

sudo-success

%command%, %target_name%

/sudo <player> <command> — sent to the sender after command is force-run on the target via Player#performCommand.

healed

—

/heal (self), and also sent to the target player when a sender runs /heal <player>.

healed-other

%target_name%

/heal <player> (essentials.heal.others) — sent to the sender only.

not-in-fire

—

/fire when the player's fire ticks are <= 0.

extinguished-fire

—

/fire — sets fire ticks to 0.

already-on-highest-point

—

/top when the player is already at/above the highest safe point, or no safe location can be found (Nether search capped below the roof).

teleported-to-highest-point

—

/top — teleports to the highest safe block in the player's column.

not-enough-experience

—

/xpbottle <amount> [level\|exp] [bottles] or /xpbottle all [amount] — the requested XP exceeds the player's level/raw XP, the computed per-bottle total is <= 0, or (for all) the player has 0 total experience.

bottles-filled

%amount%, %exp%

/xpbottle … or /xpbottle all … — %amount% is the bottle count produced, %exp% is the XP value stored in each bottle.

invalid-experience-type

—

/xpbottle <amount> <type> … when <type> isn't level or exp.

invalid-bottle-amount

—

/xpbottle <amount> … when the requested bottle count is <= 0.

spawnwers-disabled-in-world

—

Placing a SPAWNER block is cancelled because the active server group is in disabled-spawners-groups. Ships with this typo in messages.yml (see note above).

command-disabled-in-world

—

A command is cancelled by PlayerCommandPreprocessEvent because it matches a groups-blocked-commands entry for the player's active server group.

spawners-limit-reached

—

Placing a SPAWNER block is cancelled because the target chunk's spawner count already exceeds spawners-limits.limit.

spawn-protection

—

Breaking or placing a block within spawn-protection.radius of world spawn, on a protected world, without spawnprotection.bypass. Explosion cancellation in the same radius is silent — no player to message.

cannot-sit-on-air

—

/sit when no block (or an empty block) is targeted within 5 blocks.

cannot-sit-on-block

—

/sit when the targeted block isn't tagged SLABS or STAIRS.

cannot-sit-here

—

/sit when a synthetic PlayerInteractEvent fired against the block is cancelled by another plugin.

sit-success

—

/sit — spawns an invisible, non-colliding marker ArmorStand on the block and mounts the player on it, replacing any existing sit entity for that player.

not-looking-at-candle

—

/candle when the block targeted within 5 blocks isn't candle block data.

candle-lit

—

/candle — lit an unlit candle (subject to a BlockIgniteEvent check).

candle-extinguished

—

/candle — extinguished a lit candle (subject to a PlayerInteractEvent check).

player-only-command

—

Declared on the enum and shipped in messages.yml, but not sent by any command or listener in the current source — see Commands § Player-only vs console. A console/command-block attempt at a player-only command falls back to ACF's own built-in handling instead.

main-hand-empty

—

Shared guard for /hat, /repair//repair hand, /furnace, and /condense when the main hand is empty.

inventory-full

—

Shared guard for /condense (no room for the condensed stack) and both /xpbottle forms (no free inventory slot for a bottle).

command-on-cooldown

%time%

Sent by AstralEssentials#isInCooldown/#checkCooldown, the shared cooldown helpers behind /feed, /heal, /repair [all], /furnace [all], /condense [all], /strip [all], and /concrete [all]. %time% is the remaining cooldown formatted by DurationParser.toHumanReadable; bypassed entirely by cooldown.bypass.

%mode%

The matching label constant (survival-mode/creative-mode/adventure-mode/spectator-mode), registered as-is (registerDirect("mode", mode.value())) and resolved to that label's own rendered text.

gamemode-changed, gamemode-changed-other.

%target_name%

The target Player wrapped as a PlayerPlaceholder and registered under target (registerDirect("target", new PlayerPlaceholder(target))); _name chains into the name sub-key (Player#getName).

gamemode-changed-other, feed-success-other, healed-other, sudo-success.

%item_name%

The item in hand, wrapped as an ItemStackPlaceholder under its default item namespace (registerPlaceholder(new ItemStackPlaceholder(item))); _name chains into the name sub-key (display name → item name → translatable-key fallback).

item-repaired, hat-success.

%speed%

The command's raw 0–10 integer argument (registerDirect("speed", speed)) — not the derived 0.0–1.0 fly/walk speed Bukkit actually applies.

flying-speed-set, walking-speed-set.

%time%

Two distinct sources by key: on player-time-set it's the raw tick int argument (registerDirect("time", time)); on command-on-cooldown it's DurationParser.toHumanReadable(remainingMillis), a formatted duration string.

player-time-set, command-on-cooldown.

%weather%

The clear-weather/storm-weather label component itself, registered directly (registerDirect("weather", EssentialsMessages.CLEAR_WEATHER.component()) or STORM_WEATHER). sun and clear both resolve to clear-weather.

weather-changed.

%command%

The raw command string forced onto the target via Player#performCommand (registerDirect("command", command)), unparsed.

sudo-success.

%amount%

A raw, unformatted int; meaning depends on the key — repaired-item count, smelted/condensed/stripped/concrete output count, or XP bottle count. Two keys (items-condensed, items-stripped) hardcode this to 1 on their single-item command form — only the all subcommand sends the real summed count.

all-items-repaired, items-smelted, items-condensed, items-stripped, concrete-created, bottles-filled.

%exp%

A raw, unformatted int — the XP value stored per bottle (registerDirect("exp", totalExp), or playerExperience / amount for /xpbottle all).

bottles-filled.