跳到正文
本頁目錄

VanillaI18n API

此 API 用於修改 Minecraft 原版語言數據。

Warning

此 API 僅在0.19.1及以後版本可用

此對象在腳本引擎內實際註冊的類名為 VaillanI18n。

獲取當前語言

VaillanI18n.getCurrentLanguage()

  • 返回值:當前語言代碼
  • 返回值類型:String

設置當前語言

VaillanI18n.setCurrentLanguage(language)

  • 參數:
  • language: String 語言代碼,如 en_US、zh_CN
  • 返回值:是否成功
  • 返回值類型:Boolean

獲取支持的語言列表

VaillanI18n.getSupportedLanguages()

  • 返回值:支持的語言代碼列表
  • 返回值類型:Array<String>

翻譯原版文本

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

  • 參數:
  • key: String 翻譯鍵名
  • params: Array<String>(可選參數) 翻譯參數
  • language: String(可選參數) 目標語言。不傳時使用當前語言
  • 返回值:翻譯後的文本
  • 返回值類型:String

從對象加載語言數據

VaillanI18n.loadLanguage(language, data)

  • 參數:
  • language: String 語言代碼
  • data: Object 語言數據,其中每個鍵和值都必須為 String
  • 返回值:是否成功
  • 返回值類型:Boolean

從文件加載語言數據

VaillanI18n.loadLanguageFromFile(language, path)

  • 參數:
  • language: String 語言代碼
  • path: String 語言文件路徑
  • 返回值:是否成功
  • 返回值類型:Boolean

從目錄加載語言數據

VaillanI18n.loadLanguagesFromDirectory(path)

  • 參數:
  • path: String 目錄路徑
  • 返回值:是否成功
  • 返回值類型:Boolean

此函數會加載目錄下所有 .lang 文件。
文件名去掉 .lang 後綴後會作為語言代碼使用。