Структура мода и инструменты

Где живут моды

Локальные (ещё не опубликованные) моды лежат в папке LocalMods в директории игры:

Barotrauma/LocalMods/
  МойМод/
    filelist.xml
    ...

Подписанные в Workshop моды попадают в каталог Steam Workshop и напрямую их обычно не трогают. Пока разрабатываешь — работай в LocalMods.

Минимальный мод

Самый маленький рабочий мод — это папка с одним файлом-манифестом filelist.xml:

<?xml version="1.0" encoding="utf-8"?>
<contentpackage name="Мой первый мод" modversion="1.0.0"
                gameversion="1.0.0.0" corepackage="false">
  <Item file="%ModDir%/items/myitem.xml" />
</contentpackage>

Манифест говорит игре: «загрузи items/myitem.xml как предмет (Item)». Подробно filelist.xml разберём в уроке про контент-пакеты.

Удобная раскладка файлов

Чёткая структура папок здорово упрощает жизнь, когда мод разрастётся:

МойМод/
  filelist.xml
  items/
    myitem.xml
  characters/
    mycreature.xml
  afflictions/
    myaffliction.xml
  textures/
    myitem.png
  text/
    English.xml
    Russian.xml

Имена папок — любые, игра смотрит на пути из filelist.xml, а не на названия каталогов. Но единая структура помогает не запутаться в своём же моде.

Как включить мод в игре

1. Запусти Barotrauma.
2. Открой меню Mods.
3. Найди свой мод среди доступных и перетащи в активные (enabled).
4. Следи за порядком загрузки: моды ниже по списку перезаписывают то, что выше.

Чем работать

• Редактор с подсветкой XML. VS Code, Notepad++ или любой редактор кода. Подсветка и проверка парности тегов экономят кучу нервов.
• Встроенные редакторы игры — Submarine Editor и Character Editor для визуальной работы.
• Консоль отладки в игре — показывает ошибки загрузки контента (см. устранение неполадок).
• Кодировка UTF-8 во всех файлах — обязательна, иначе кириллица превратится в кашу.

Как обычно идёт работа

1. Внёс маленькое изменение в XML.
2. Перезагрузил контент (перезапуск игры или переподключение мода).
3. Глянул результат и заодно консоль на ошибки.
4. Повторяешь мелкими шагами.

Когда основа понятна, переходи к контент-пакетам — разберём, как именно манифест связывает файлы мода с игрой.