translation_config

Configure the multi-language translation system — misc entry.

Entry Information

Property	Value
Entry ID	translation_config
Type	Misc
Color	Orange
Icon	mdi:translate

Description

Main configuration entry for the translation system. Configure languages, settings, and behaviours here. Available Placeholders: - %typewriter_translate_<key>% — Get translation by key - %typewriter_translate_lang% — Player's current language name - %typewriter_translate_lang_display% — Language display name - %typewriter_translate_lang_flag% — Language flag code - %typewriter_translate_count% — Total translation count

Fields

Field	Type	Description
languages	List<LanguageConfig>	List of languages available for translation. Each language requires a unique name (e.g., 'en_GB', 'fr_FR').
mainLanguage	String	The default language used when a player's language is not found or as fallback
runLanguageActionsOnJoin	Boolean	Execute language change actions when a player joins the server
forceClientLocaleOnJoin	Boolean	Automatically set player's language based on their Minecraft client locale. Only applied on first join if no language is saved.
translationsFolder	String	Folder name for translation files (relative to TypeWriter data folder). Translation JSON files should be placed in this folder.
logLevel	Int	Log level for debugging (0-3): 0 = Errors only 1 = Info + translation counts 2 = Debug + file loading details 3 = Trace + every translation lookup
aiTranslation	AITranslationConfig	AI Translation configuration
openSelectorCommandOverride	String	Custom command to run when a player opens the language selector. If set, this command will be executed instead of opening the GUI menu. Use {player} as placeholder for the player name.

Usage Example

- entry: translation_config
  name: "Configure the multi-language translation system"
  languages: []
  mainLanguage: ""
  runLanguageActionsOnJoin: false
  forceClientLocaleOnJoin: false
  translationsFolder: ""
  logLevel: 0
  aiTranslation: ""
  openSelectorCommandOverride: ""