messages.yml
##Introduction
The messages.yml file lets you customize every message Aevum sends — command results, status and mark panels, list output and all errors. It's a single tree of keys; edit the text and run /aevum reload to apply it.
##Color & formatting
Aevum parses inline hex #RRGGBB and legacy & codes (&l, &m, &r, …) directly in the strings — no &x needed for hex. A %prefix% token at the start of most messages inserts the prefix defined at the top of the file. PlaceholderAPI placeholders also resolve when it's installed.
prefix: "#8AE695&lAevum#648268∙&r"prefix — the brand prefix prepended to most messages. (Placeholders: —)
##reload
reload:
success: "%prefix% #a0ff72Configuration reloaded."reload.success — shown after /aevum reload. (%prefix%)
##timer
The timer.* block covers every timer command result.
timer:
created: "%prefix% #a0ff72Timer #D1FFD4%name% #a0ff72created for #D1FFD4%time%#a0ff72."
exists: "%prefix% #FB7185Timer #ff9caa%name% #FB7185already exists."
not_found: "%prefix% #FB7185Timer #ff9caa%name% #FB7185does not exist."
added: "%prefix% #a0ff72Added #D1FFD4%time% #a0ff72to timer #D1FFD4%name%#a0ff72."
removed: "%prefix% #a0ff72Removed #D1FFD4%time% #a0ff72from timer #D1FFD4%name%#a0ff72."
set: "%prefix% #a0ff72Timer #D1FFD4%name% #a0ff72set to #D1FFD4%time%#a0ff72."
status: "%prefix% #D1FFD4%name%#7ea4ed%target%#a0ff72: #D1FFD4%time% #648268(#a0ff72%state%#648268)"
paused: "%prefix% #a0ff72Timer #D1FFD4%name% #a0ff72paused."
resumed: "%prefix% #a0ff72Timer #D1FFD4%name% #a0ff72resumed."
deleted: "%prefix% #a0ff72Timer #D1FFD4%name% #a0ff72deleted."
marked: "%prefix% #a0ff72Marked #D1FFD4%mark% #a0ff72on timer #D1FFD4%name%#a0ff72."
unmarked: "%prefix% #a0ff72Removed mark #D1FFD4%mark% #a0ff72from timer #D1FFD4%name%#a0ff72."
unmarked_all: "%prefix% #a0ff72Cleared all marks from timer #D1FFD4%name%#a0ff72."
mark_not_found: "%prefix% #FB7185Timer #ff9caa%name% #FB7185has no mark #ff9caa%mark%#FB7185."
marks_header: "%prefix% #a0ff72Marks of #D1FFD4%name%#7ea4ed%target%#648268:"
marks_entry: " #648268∙ #D1FFD4%mark%#648268: #7ea4ed%time%"
marks_empty: "%prefix% #FB7185#ff9caa%name%%target% #FB7185has no marks."
list_header: "%prefix% #a0ff72Timers#648268:"
list_entry: " #648268∙ #D1FFD4%name% #648268(#7ea4ed%scope%#648268, #7ea4ed%count%#648268)"
list_empty: "%prefix% #FB7185There are no timers."- created / exists / not_found — timer made, name taken, or unknown. (
%name%,%time%) - added / removed / set — time adjusted. (
%name%,%time%) - status — current time and state. (
%name%,%target%,%time%,%state%) - paused / resumed / deleted — state changes. (
%name%) - marked / unmarked / unmarked_all / mark_not_found — checkpoint actions. (
%name%,%mark%) - marks_header / marks_entry / marks_empty — the
markspanel. (%name%,%target%,%mark%,%time%) - list_header / list_entry / list_empty — the
listpanel. (%name%,%scope%,%count%)
##stopwatch
The stopwatch.* block mirrors timer.*, with reset added and created carrying no duration.
stopwatch:
created: "%prefix% #a0ff72Stopwatch #D1FFD4%name% #a0ff72created."
exists: "%prefix% #FB7185Stopwatch #ff9caa%name% #FB7185already exists."
not_found: "%prefix% #FB7185Stopwatch #ff9caa%name% #FB7185does not exist."
added: "%prefix% #a0ff72Added #D1FFD4%time% #a0ff72to stopwatch #D1FFD4%name%#a0ff72."
removed: "%prefix% #a0ff72Removed #D1FFD4%time% #a0ff72from stopwatch #D1FFD4%name%#a0ff72."
set: "%prefix% #a0ff72Stopwatch #D1FFD4%name% #a0ff72set to #D1FFD4%time%#a0ff72."
status: "%prefix% #D1FFD4%name%#7ea4ed%target%#a0ff72: #D1FFD4%time% #648268(#a0ff72%state%#648268)"
paused: "%prefix% #a0ff72Stopwatch #D1FFD4%name% #a0ff72paused."
resumed: "%prefix% #a0ff72Stopwatch #D1FFD4%name% #a0ff72resumed."
reset: "%prefix% #a0ff72Stopwatch #D1FFD4%name% #a0ff72reset."
deleted: "%prefix% #a0ff72Stopwatch #D1FFD4%name% #a0ff72deleted."
# ...mark and list keys identical in shape to the timer blockSame placeholders as the timer block. The extra reset key — (%name%) — confirms a stopwatch was returned to zero.
##error
error:
syntax: "%prefix% #FB7185Usage: #ff9caa{command} {syntax}"
no_permission: "%prefix% #FB7185You don't have permission."
not_in_game: "%prefix% #FB7185This command can only be used in-game."
invalid_number: "%prefix% #FB7185'#ff9caa{num}#FB7185' is not a valid number."
invalid_time: "%prefix% #FB7185'#ff9caa%time%#FB7185' is not a valid duration."
invalid_name: "%prefix% #FB7185'#ff9caa%name%#FB7185' is not a valid name (use letters, numbers, _ or -)."
invalid_label: "%prefix% #FB7185'#ff9caa%name%#FB7185' is not a valid label (use letters, numbers or -)."
invalid_scope: "%prefix% #FB7185'#ff9caa%scope%#FB7185' is not a valid scope (global, player or team)."
scope_conflict: "%prefix% #FB7185#ff9caa%name% #FB7185already exists with a different scope."
target_required: "%prefix% #FB7185Specify a target: #ff9caaa player/team #FB7185or #ff9caa@all#FB7185."
console_target: "%prefix% #FB7185From console you must specify a target (player/team or @all)."
player_offline: "%prefix% #FB7185Player #ff9caa%target% #FB7185is not online."
team_not_found: "%prefix% #FB7185Team #ff9caa%target% #FB7185does not exist."
no_team: "%prefix% #FB7185You are not in a team."
stella_missing: "%prefix% #FB7185Team scope requires the Stella plugin."
player_not_online: "%prefix% #FB7185Player #ff9caa{search} #FB7185is not online."
unknown_command: "%prefix% #FB7185Unknown command. Type #ff9caa/aevum help #FB7185for help."- invalid_time / invalid_name / invalid_label / invalid_scope — argument validation. (
%time%,%name%,%scope%) - scope_conflict — the name already exists under a different scope. (
%name%) - target_required / console_target — a target is needed (and is mandatory from console).
- player_offline / team_not_found / no_team / stella_missing — target resolution problems. (
%target%) - The framework errors (
syntax,no_permission,not_in_game,invalid_number,player_not_online,unknown_command) use{…}tokens:{command},{syntax},{num},{search}.
##Placeholder reference
| Token | Where | Meaning |
|---|---|---|
%prefix% |
most messages | The prefix value. |
%name% |
timer/stopwatch messages | The instance name. |
%time% |
most messages | A formatted duration. |
%state% |
status | running, paused or stopped. |
%target% |
status / marks | The owner label (player/team), or empty for global. |
%scope% |
list entry / invalid_scope | global, player or team. |
%count% |
list entry | Number of instances under the name. |
%mark% |
mark messages | A checkpoint label. |
{command} {syntax} {num} {search} |
error block | Command-framework tokens. |
With PlaceholderAPI installed you can also drop %aevum_…% (and any other) placeholders into these messages — see Timer Placeholders / Stopwatch Placeholders.