手冊:font_metadata.json

font_metadata.json是附加包中用於自訂字型的檔案，其完整路徑為<RP>/font/font_metadata.json。不同附加包的font_metadata.json檔案會按照資源堆疊的順序合併後再進行載入。

格式

•  font_metadata.json：根物件。
  • ^*version：該檔案的格式版本，目前只能為1。
  •  fonts：要定義的字型。
    • ：要定義的一個字型。
      • ^*font_format：該字型的格式，可以填寫bitmap、ttf、ttfmsdf或msdf，分別代表點陣圖、TrueType、TrueType MSDF和單純的MSDF（多通道有向距離場）字型。
      • ^*font_name：該字型的名稱。
      •  generate_pages_on_start：如果存在該欄位，將在啟動時生成分頁。
        • ：一個或一段分頁。如果為一個整數，則代表一個單獨的分頁。如果是一個物件，則代表一段連續的分頁。
          •  first_page：一段分頁中的第一頁。
          •  last_page：一段分頁中的最後一頁。
      •  lowPerformanceCompatible：是否針對低效能裝置最佳化。如果開啟，在低效能裝置上將顯示「Low performance device detected, will use a backup font instead of <該字型名>」並將該字型的顯示切換為目前遊戲設定的預設字型。
      • 點陣圖字型額外欄位 參見Template:Nbt inherit/font/bitmap/template
      • TrueType字型額外欄位 參見Template:Nbt inherit/font/ttf/template
      • TrueType MSDF字型額外欄位 參見Template:Nbt inherit/font/ttfmsdf/template
      • MSDF字型額外欄位 參見Template:Nbt inherit/font/msdf/template
  •  font_aliases：要定義的字型別名。
    • ：要定義的一個字型別名。
      • ^*alias：該別名的名稱，為將用於JSON UI內的字型名。
      • ^*fonts：該別名引用的字型。
        • ：一個引用字型。
          • ^*font_reference：字型的引用名稱，為在font_metadata.json/fonts中定義的字型名。
          •  font_ranges：該引用的範圍，可以指定僅引用一定範圍內的字元。如果不指定該欄位，則將引用全部字元。
            • ：一個範圍。
              • ^*first：該範圍的第一個字元所在的Unicode碼的10進位表示整數。
              • ^*last：該範圍的最後一個字元所在的Unicode碼的10進位表示整數，如果和first一致意味著僅引用一個字元。
          •  font_language_code：該引用的字型語言程式碼。
      •  font_scale_factor：該別名的字型縮放因子，預設為0.0。