Translation Config

The Translation Config entry configures all available languages, storage paths, and detection behavior.

Configuration

mainLanguage — String

The default fallback language if a translation is missing.

translationsFolder — String

Directory name (inside extension folder) containing JSON translation files.

forceClientLocaleOnJoin — Boolean

If true, attempts to set the player's language to match their Minecraft client settings on join.

runLanguageActionsOnJoin — Boolean

If true, executes onChangeActions also when a player joins the server.

openSelectorCommandOverride — String

Optional custom command alias to open the language selector menu.

The languages list defines available locales.

name — String

Unique ID (e.g., en_GB). Matches the JSON filenames.

displayName — String

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 of Minecraft locale codes (e.g. en_us, en_gb) that map to this language.

fallbackLanguages

"> Chain of languages to check if a key is missing in this one.

onChangeActions

"> Actions triggered when a player switches to this language.