Languages¶
Ember Enchants ships in seven languages: English, German, Spanish, French, Brazilian Portuguese, Russian and Simplified Chinese. Every string the plugin shows - chat messages, menu buttons, item lore, the enchanting table, the shop - comes from a language file. Nothing is hard-coded.
Choosing one¶
In config.yml:
then /ember reload. The server log confirms what loaded:
How the files work¶
All seven unpack into plugins/EmberEnchants/lang/ on first start, so you can
see what is available. en.yml is refreshed on every start so new keys appear
as the plugin gains them - do not edit it. Every other file is yours: a line
you have changed is never touched, so a wording you correct in de.yml
survives every update. Strings that a new version adds are appended to it, so
an update never leaves a translation silently missing its newest lines:
Fallback is per line, not per file. A translation that covers 80% of the plugin shows English for the other 20%, never a blank or a raw key. That is deliberate - translations are usually finished by someone else later, and a half-done one should still be usable.
Making your own¶
Copy en.yml to, say, custom.yml, change what you like - colours included,
they are part of the text on purpose - and set language: custom. Placeholders
like %player% can be moved anywhere in the sentence, or dropped if your
language reads better without one.
If you translate it into a language we do not ship, send it over on Discord and it goes into the next release with your name on it.