Messages & Languages

Pick one of the four bundled languages and edit every message the plugin ever shows to players.

Every line of text AscendSMP shows to players lives in a language file, so you can reword anything without touching the plugin itself. Four languages ship out of the box, and each one is a plain text file you can open and edit.

Picking a language

The plugin bundles four language files in the lang/ folder: english, french, german, and spanish. Choose the active one with the language key in config.yml:

# Active language file from /lang/ (english, french, german, spanish).
# A bad/missing value falls back to english.
language: english

If the value is misspelled or missing, the plugin quietly falls back to english instead of breaking. See Configuration for the rest of config.yml.

How the files stay in sync

English is the structural source: it always contains every message key the plugin knows about. If one of the other language files is missing a key (for example after an update adds new messages), the plugin fills the gap automatically with the english text and reports what it filled in the console. Your server never shows a blank message because of a missing key.

ℹ️

Every language file starts with a `lang-version` line. Do not change it by hand: the plugin uses it to merge new messages into your file on update without wiping your edits.

Editing messages

Open lang/<name>.yml (for example lang/english.yml) in any text editor. Change the text on the right side of each key, save the file, and apply it with:

/ascend reload

No restart needed. See Commands for the full command list.

What is inside a language file

Section	What it covers
`prefix`	The short tag shown in front of most chat messages.
`general`	Shared feedback: no permission, player not found, reload success, and similar.
`admin`	Feedback for the `/ascend` admin commands (reroll, set, event, info, level, give).
`ability`	Each ability's display name plus its one-line passive and active summaries, shown in the menu, codex, and HUD.
`activation`	Messages shown when activating an ability: cooldown warnings, blocked use, `/spark` usage.
`hud`	Feedback for turning the ability HUD on and off.
`item`	Names and lore for the Ability Shard and primary ability items, plus bind and reroll feedback.
`gui`	Every label in the `/sparkgui` menu and the Ability Codex.

Colors

Both classic & color codes and &#rrggbb hex colors work everywhere, in every message:

prefix: '&#7B2FF7&lAscend &8» &r'
general:
  no-permission: '&cYou do not have permission to do that.'

&#7B2FF7 is a hex color (any shade you like), &l makes text bold, and &c is classic red. Mix them freely.

💡

Many messages contain placeholders in curly braces, such as `{player}` or `{ability}`. Keep them in your edited text; the plugin swaps them for the real values.

Stuck on something? Ask on Discord: discord.arrowtan.cc. More common questions are answered in the FAQ.