Skip to main content
The Translation Config entry configures all available languages, storage paths, and detection behavior.

​
Configuration

​
mainLanguage
String
default:"en_GB"
The default fallback language if a translation is missing.
​
translationsFolder
String
default:"Translate"
Directory name (inside extension folder) containing JSON translation files.
​
forceClientLocaleOnJoin
Boolean
default:"false"
If true, attempts to set the player’s language to match their Minecraft client settings on join.
​
runLanguageActionsOnJoin
Boolean
default:"false"
If true, executes onChangeActions also when a player joins the server.
​
openSelectorCommandOverride
String
Optional custom command alias to open the language selector menu.

​
Language Definitions

The languages list defines available locales.
​
name
String
required
Unique ID (e.g., en_GB). Matches the JSON filenames.
​
displayName
String
required
User-friendly name shown in menus (e.g., English).
​
flag
String
Banner flag pattern code (e.g. from needcoolshoes.com) or head texture.
​
minecraftCodes
List<String>
List of Minecraft locale codes (e.g. en_us, en_gb) that map to this language.
​
fallbackLanguages
List<String>
Chain of languages to check if a key is missing in this one.
​
onChangeActions
List<Ref<TriggerableEntry>>
Actions triggered when a player switches to this language.