Skip to content

VanillaI18n API

This API is used to modify Minecraft vanilla language data.

Warning

This API is only available in 0.19.1 and later.

The actual registered class name in the script engine is VaillanI18n.

Get current language

VaillanI18n.getCurrentLanguage()

  • Return value: current language code
  • Return value type: String

Set current language

VaillanI18n.setCurrentLanguage(language)

  • Parameters:
  • language: String Language code, such as en_US or zh_CN
  • Return value: success or not
  • Return value type: Boolean

Get supported languages

VaillanI18n.getSupportedLanguages()

  • Return value: supported language code list
  • Return value type: Array<String>

Translate vanilla text

VaillanI18n.translate(key[, params][, language])

  • Parameters:
  • key: String Translation key
  • params: Array<String> (Optional) Translation parameters
  • language: String (Optional) Target language. If not provided, the current language is used
  • Return value: translated text
  • Return value type: String

Load language data from object

VaillanI18n.loadLanguage(language, data)

  • Parameters:
  • language: String Language code
  • data: Object Translation data. Each key and value must be String
  • Return value: success or not
  • Return value type: Boolean

Load language data from file

VaillanI18n.loadLanguageFromFile(language, path)

  • Parameters:
  • language: String Language code
  • path: String Language file path
  • Return value: success or not
  • Return value type: Boolean

Load language data from directory

VaillanI18n.loadLanguagesFromDirectory(path)

  • Parameters:
  • path: String Directory path
  • Return value: success or not
  • Return value type: Boolean

This function loads all .lang files in the directory.
The file name without the .lang extension is used as the language code.