AevumAevum

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 marks panel. (%name%, %target%, %mark%, %time%)
  • list_header / list_entry / list_empty — the list panel. (%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 block

Same 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.
INFO

With PlaceholderAPI installed you can also drop %aevum_…% (and any other) placeholders into these messages — see Timer Placeholders / Stopwatch Placeholders.