Messages and language
Change any message, menu text, dialog text or dashboard text, and add a translation of your own.
Every word Emberstore shows comes from the language file: chat messages, menu titles, dialog text, Discord embeds, help pages and the web dashboard. Change the wording or colours there and run /store admin reload.
The file
Three languages ship with the plugin: lang/en_US.yml (English), lang/fr_FR.yml (French) and lang/es_ES.yml (Spanish). Pick one with language in config.yml. Every key has a one-line comment saying where it shows and which placeholders it takes. The sections are:
| Section | Holds |
|---|---|
general | No permission, players only, not ready yet |
menu | Menu titles, close and back buttons, category and gateway lore, stock texts |
gateway | The name of each gateway on its button, plus code (free orders) and manual (given by staff) |
dialog | Every text of the checkout, pay and error dialogs |
purchase | Messages about a purchase: links, delivery, gifts, codes, reminders, subscriptions |
status | How order and subscription states are named |
list | History, top supporters, subscriptions, balance, referral, stats and stock lists |
admin | Admin replies, order details, test tools, staff notices and the needs review reasons |
dashboard | Chat lines about the dashboard and all the text of the dashboard pages |
discord | Embed titles and the body line |
help | The help pages and each command's description |
Formatting
Text uses MiniMessage: <#ffd166> for a colour, <bold>, <gradient:#ff6a00:#ffb000>...</gradient>, <click:run_command:'/store'> and so on. Placeholders in angle brackets such as <item> or <price> are filled in by the plugin. The dashboard page text is plain text and uses {braces} for its placeholders.
Adding a translation
Copy the file
Copy lang/en_US.yml to a new name in the same folder, for example lang/de_DE.yml.
Translate it
Change the text, keep the keys and placeholders. Leave out anything you do not want to translate.
Switch to it
Set language: de_DE in config.yml and run /store admin reload.
Any key missing from your file is taken from the built-in English copy, and the console mentions it once. If the file named in language does not exist, the console says so and English is used for everything.
Things worth changing first
| Key | Default |
|---|---|
menu.main-title | Store in an ember to amber gradient |
dialog.checkout.title | Secure Checkout |
gateway.stripe and the other gateway names | ◆ Card (Stripe), ◆ Crypto (NOWPayments) and so on |
purchase.reward-delivered | Your purchase of <item> has been delivered. |
discord.body | <player> / <item> x<quantity> / <price> / <gateway> / <order> |