Введение
Эта документация пройдет следующие этапы:

• Настройка файлов и путей
• Создание шрифтов
• Размещение файлов в папке модуля
• Создание текстурных атласов 
• Как использовать шрифты в Bannerlord

Предпосылки

• Файл TrueTypeFont для шрифта. Например (OpenSans-Regular.ttf)
• Mount & Blade II: Bannerlord - Modding Kit - загружается из Steam.
• Знания о создании текстурных атласов пользовательского интерфейса (см.: Создание и загрузка текстурных атласов пользовательского интерфейса).

Настройка файлов и путей

• Перейдите в Mount & Blade II Bannerlord\GUI\GauntletUI\Fonts.
• Убедитесь, что два файла ниже существуют в каталоге. Мы будем использовать их для генерации данных нашего шрифта.
  • GenerateFont.bat
  • GenerateFontSettings.txt
• Переместите файл шрифта .ttf в каталог.
• В нашем примере мы будем использовать файл шрифта с именем OpenSansRegular.ttf.
• Откройте файл: «GenerateFontSettings.txt».
• Значения по умолчанию для GenerateFontSettings.txt:

• -fontpath {FONT\_PATH.ttf}
  -outputpath {OUTPUT\_PATH.png}
  -atlassize 2048 2048
  -size 64
  -angle 8
  -range 16
  -padding 16
  -smooth 0
  -smoothingConstant 0.5-mode 1

• Здесь нам нужно изменить переменные-заполнители {FONT_PATH.ttf} и {OUTPUTPATH.png} на фактические пути.
• Пути здесь относятся к каталогу: …\bin\Win64_Shipping_wEditor, если вы не укажете полный путь.
• Обратите внимание, что если вы хотите использовать пути, содержащие пробелы, вам нужно поместить их в кавычки.
• Настройка -fontpath:
  • В нашем примере переменная должна быть: -fontpath OpenSansRegular.ttf.
• Настройка -outputpath:
  • Эта переменная определяет, где должен быть размещен файл .png. Мы должны использовать путь файла .png к несуществующему файлу, который будет создан в процессе создания атласа.
  • В нашем примере мы устанавливаем переменную -outputpath как: -outputpath OpenSansRegular.png.
• Содержимое GenerateFontSettings.txt теперь должно выглядеть так:

-fontpath OpenSansRegular.ttf
-outputpath OpenSansRegular.png
-atlassize 2048 2048
-size 64
-angle 8
-range 16
-padding 16
-smooth 0
-smoothingConstant 0.5-mode 1

Если сгенерированный файл .png не содержит всех символов для вашего шрифта, рассмотрите возможность увеличения -atlassize.

Создание шрифтов 

• Теперь, когда файлы добавлены и установлены правильные пути для генератора, запустите GenerateFont.bat.
• Если все настроено правильно, программа не выдаст никаких ошибок и сгенерирует 3 файла в каталоге, который вы определили как свой -outputpath.
  • В нашем примере это 3 файла:
    • OpenSansRegular.fnt
    • OpenSansRegular.bfnt
    • OpenSansRegular.png
• Если вы видите какие-либо ошибки в пакетном сценарии, убедитесь, что переменные -fontpath и -outputpath установлены правильно.
• В нашем примере 3 сгенерированных файла расположены в каталоге *…\bin\Win64_Shipping_wEditor*, поскольку мы указали относительный путь.

Размещение файлов в папке модуля

• На шаге выше мы создали 3 файла. Теперь нам нужно поместить эти файлы в наш модуль.

Файлы шрифтов

• Перейдите в папку {ВАШ_МОДУЛЬ}\GUI\Fonts. Если в вашем модуле нет папки Fonts, создайте ее.
• Переместите сгенерированные файлы .fnt и .bfnt в папку Fonts, в нашем примере они называются OpenSansRegular.fnt и OpenSansRegular.bfnt.

Файл изображения

• Перейдите в папку {ВАШ_МОДУЛЬ}\GUI\SpriteParts. Если в вашем модуле нет папок GUI или SpriteParts, создайте их.
• В папке SpriteParts создайте пустую папку с именем ui_custom_fonts.
• Если у вас нет файла Config.xml в папке SpriteParts, создайте его тоже.
• На этом этапе в папке SpriteParts должна быть папка с именем ui_custom_fonts и файл с именем Config.xml.
• Теперь мы можем переместить наш файл .png в папку ui_custom_fonts. В нашем примере файл называется OpenSansRegular.png.

Конфигурация

• Чтобы иметь возможность использовать наш шрифт в игре, нам нужно указать в нашем файле Config.xml, что наш шрифт должен загружаться автоматически.
• Содержимое Config.xml должно включать следующую конфигурацию:
  

  <Config>
      <SpriteCategory Name="ui_custom_fonts">
          <PackAllSpritesToUniqueTextures/>
          <SingleChannel/>
          <AlwaysLoad/>
          <EdgeSize Value="0" />
      </SpriteCategory>
  </Config>
  

• Обратите внимание, что ui_custom_fonts здесь происходит от имени папки, которую вы создали в {ВАШ_МОДУЛЬ}\GUI\SpriteParts.

Создание текстурных атласов

• Теперь необходимо сгенерировать текстурные атласы шрифта, используя файл .png, созданный в последнем процессе.
• Мы кратко расскажем, как добавить новый шрифт в таблицы спрайтов. Подробное пояснение см. в разделе Создание и загрузка текстурных атласов пользовательского интерфейса.
  • Запустите генератор спрайтов, просто запустив Mount & Blade II Bannerlord\bin\Win64_Shipping_wEditor\TaleWorlds.TwoDimension.SpriteSheetGenerator.exe.
  • Если все настроено правильно, вывод генератора спрайтов должен выглядеть так:
  • Вы должны импортировать шрифт через Браузер ресурсов в игре. Что было объяснено в документе выше.

Использование недавно добавленных шрифтов 

• Если мы все сделали правильно, мы сможем использовать наши недавно добавленные шрифты в игре.
• Чтобы использовать шрифт, мы можем объявить его имя в кисти, например:
  

  <Brush Name="CustomBrush.With.New.Font" Font="OpenSansRegular" TextHorizontalAlignment="Right">
      <Styles>
          <Style Name="Default" FontColor="#F4E1C4FF" TextGlowColor="#000000FF" TextOutlineColor="#000000FF" TextOutlineAmount="0.01" TextGlowRadius="0" TextBlur="0" FontSize="20" />
      </Styles>
  </Brush>
  

• Теперь любые виджеты, которые используют эту кисть, будут отображаться с использованием нашего недавно добавленного шрифта.

Установка шрифтов по умолчанию для языка

• Для некоторых языков могут потребоваться собственные пользовательские шрифты. Если это ваш случай, вы можете установить шрифт по умолчанию для своего языка.
• Для этого создайте файл с именем {ВАШ_МОДУЛЬ}Languages.xml и поместите его в папку: {ВАШ_МОДУЛЬ}\GUI\Fonts .
• Обратите внимание, что вы должны дать файлу *Languages.xml уникальное имя, и оно всегда должно заканчиваться на "Languages" (например, _MyModuleLanguages.xml_ ). Для получения дополнительной информации см.: Добавление и переопределение ресурсов.
• В файле новых языков вы можете определить новый языковой узел, переопределить существующие и изменить язык игры по умолчанию.
• Языковые узлы используются для сопоставления встроенных шрифтов с вашими пользовательскими шрифтами.
• Например, если вы хотите установить шрифты по умолчанию для турецкого языка, ваш узел должен выглядеть так:
  

  <Languages>
      <!-- Turkish -->
      <Language id="Türkçe" DefaultFont="OpenSans-Regular" LineSeperatorChar="-">
          <Map From="FiraSansExtraCondensed-Light" To="OpenSans-Regular"/>
          <Map From="FiraSansExtraCondensed-Medium" To="OpenSans-Regular"/>
          <Map From="FiraSansExtraCondensed-Regular" To="OpenSans-Regular"/>
          <Map From="Galahad" To="OpenSans-Regular"/>
          <Map From="Galahad_Numbers_Bold" To="OpenSans-Regular"/>
      </Language>
  </Languages>
  

• Здесь мы установили шрифт по умолчанию для турецкого языка как «OpenSansRegular». А также сопоставили некоторые встроенные шрифты с нашими пользовательскими.
• После сохранения этого файла должны быть установлены шрифты по умолчанию для вашего языка, и вы должны увидеть правильный шрифт для вашего языка.