Files
BarotraumaModServer/docs/Info.md
SlavaVlad 1b55091908
Some checks failed
Build & Deploy / deploy (push) Has been cancelled
init update
2026-06-08 17:37:33 +03:00

11 KiB
Raw Permalink Blame History

Ниже — рабочая инструкция для Ubuntu 24.04 по запуску Barotrauma Dedicated Server с модами и Lua for Barotrauma. Для обычных модов на выделенном сервере нужно, чтобы файлы модов были доступны на сервере и были прописаны в config_player.xml; для Lua дополнительно нужно включить Lua Patch/скриптинг и затем активировать C#-скриптинг в клиенте/лаунче сервера[2][4][8].

1) Что нужно заранее

  • Сервер Barotrauma Dedicated Server установлен через Steam/SteamCMD[11].
  • Есть клиентская копия Barotrauma на вашем ПК, где вы можете подписаться на моды в Workshop, чтобы они скачались локально[2][4].
  • Моды, которые вы хотите использовать, совместимы между собой и с вашей версией игры.
  • Для Lua for Barotrauma сервер должен уметь загрузить Lua Patch; в хостинге это обычно отдельный переключатель, а в локальной установке — это делается через загрузку/установку Lua из консоли и последующее включение скриптинга в игре[1][8].

2) Установка самого выделенного сервера на Ubuntu 24.04

Официальная инструкция рекомендует запускать сервер из каталога Barotrauma Dedicated Server после установки, например через ./DedicatedServer[11].

  • Обновите систему и установите базовые зависимости:
sudo apt update
sudo apt install -y lib32gcc-s1 lib32stdc++6 tmux screen wget
  • Если сервер не стартует из-за старых библиотек, на wiki Barotrauma отдельно упоминается libssl1.0.0 для некоторых Linux-сборок[11].
    На Ubuntu 24.04 этот пакет обычно не нужен и может отсутствовать в стандартных репозиториях, поэтому сначала проверьте запуск без него.

  • Зайдите в каталог сервера:

cd ~/.steam/steamapps/common/Barotrauma\ Dedicated\ Server
  • Запустите сервер:
./DedicatedServer

Это соответствует официальному способу запуска на Linux/nix[11].

3) Как поставить обычные моды на сервер

Официальная wiki описывает такой путь: подписаться на моды в Steam Workshop на своём клиенте, затем скопировать файлы модов на сервер и включить их через config_player.xml[2][4].

Шаг 3.1 — скачать моды на клиенте

  • На вашем ПК откройте Steam Workshop Barotrauma.
  • Подпишитесь на нужные моды.
  • Запустите Barotrauma, чтобы Steam скачал файлы модов локально[2][4].

Шаг 3.2 — найти файлы модов

На клиенте моды обычно лежат в каталоге WorkshopMods/Installed, а для сервера их часто копируют в LocalMods[10].
Встречающийся рабочий путь на Linux-серверах и в гайдах:

  • LocalMods/<ИмяМода>/filelist.xml[10]
  • либо содержимое, которое соответствует WorkshopMods/Installed на клиенте[10]

Шаг 3.3 — скопировать моды на сервер

Скопируйте папку мода на сервер в каталог LocalMods.
Пример:

/home/container/LocalMods/MyMod/filelist.xml

или

/path/to/barotrauma-server/LocalMods/MyMod/filelist.xml

В гайдах и инструкциях для dedicated server именно LocalMods используется как место, откуда сервер подхватывает установленный мод[10].

Шаг 3.4 — прописать моды в config_player.xml

Официальная wiki говорит, что активные пакеты контента нужно добавить в config_player.xml на сервере[2][4].

Откройте файл:

nano /path/to/barotrauma-server/config_player.xml

Найдите блок с контент-пакетами и добавьте строки вида:

<contentpackages>
  <corepackage path="Content/ContentPackages/Vanilla.xml" />
  <regularpackages>
    <package path="LocalMods/MyMod/filelist.xml" />
    <package path="LocalMods/AnotherMod/filelist.xml" />
  </regularpackages>
</contentpackages>

Для отдельных сборок и серверных конфигураций встречается и замена стандартного ванильного пакета на путь из LocalMods/.../filelist.xml, если это именно кор-пакет сборки[7][10]. Но для обычных модов безопаснее не заменять ванильный пакет, а добавлять моды в regularpackages[4][10].

Шаг 3.5 — перезапустить сервер

После сохранения config_player.xml перезапустите сервер.
После этого моды должны быть доступны на сервере[2][4].

4) Как включить Lua for Barotrauma

По результатам найденных инструкций, Lua для Barotrauma обычно включается так: сервер запускается с Lua Patch, после чего в игре/консоли выполняется установка, а затем активируется C# scripting[1][8].

Вариант для локального/самостоятельно запущенного сервера

  • Запустите сервер с нужными модами.
  • Подключитесь к нему клиентом.
  • Откройте консоль на сервере/в игре и выполните команду установки Lua, которую в видео-гайде показывают как install cl lua или аналогичную команду установки Lua Patch[1].
  • После установки перезапустите игру/сервер.
  • Затем в интерфейсе игры включите C# scripting / Enable C Sharp scripting[1].

Важное замечание

В разных гайдах и сборках команда/механика установки Lua может отличаться, а у хостингов это часто делается отдельной настройкой Install Lua Patch = Enabled[8].
Для вашего случая на Ubuntu 24.04 я бы ориентировался на такой порядок:

  • сначала установить и проверить обычный сервер;
  • затем включить/установить Lua Patch;
  • затем включить моды;
  • затем включить скриптинг.

5) Практический рабочий порядок установки

  1. Установить Barotrauma Dedicated Server на Ubuntu 24.04[11].
  2. Запустить сервер один раз, чтобы он создал конфиги[11].
  3. На клиенте подписаться на нужные моды в Workshop и дождаться загрузки[2][4].
  4. Скопировать файлы модов на сервер в LocalMods[10].
  5. Отредактировать config_player.xml, добавив моды в <regularpackages>[2][4][10].
  6. Запустить сервер и проверить, что моды загрузились[11].
  7. Установить/включить Lua Patch[1][8].
  8. Подключиться клиентом, включить C# scripting в интерфейсе игры, если это требуется вашей сборкой Lua[1].
  9. Проверить логи сервера, если мод не подхватился.

6) Частые проблемы

  • Сервер стартует, но модов нет
    Обычно это означает, что моды не скопированы на сервер или не прописаны в config_player.xml[2][4][10].

  • Не совпадают пути к файлам
    Проверьте, что путь указывает именно на LocalMods/<ИмяМода>/filelist.xml или на тот путь, который использует ваша сборка[7][10].

  • Lua не активируется
    Для Lua часто нужен не только пакет модов, но и отдельная активация patch/скриптинга, как показано в гайдах и у хостеров[1][8].

  • На Ubuntu 24.04 не запускается бинарник
    Сначала проверьте стандартный запуск ./DedicatedServer; проблема с дополнительными библиотеками встречается не у всех, и не все старые зависимости актуальны для 24.04[11].

7) Минимальный пример структуры

Barotrauma Dedicated Server/
├─ DedicatedServer
├─ config_player.xml
├─ LocalMods/
│  ├─ ModA/
│  │  └─ filelist.xml
│  └─ ModB/
│     └─ filelist.xml
└─ ...

И фрагмент config_player.xml:

<contentpackages>
  <corepackage path="Content/ContentPackages/Vanilla.xml" />
  <regularpackages>
    <package path="LocalMods/ModA/filelist.xml" />
    <package path="LocalMods/ModB/filelist.xml" />
  </regularpackages>
</contentpackages>

8) Что я могу сделать дальше

Если хотите, я могу сразу написать готовый bash-скрипт для Ubuntu 24.04, который:

  • создаст пользователя для сервера,
  • скачает/обновит Dedicated Server,
  • разложит папки LocalMods,
  • и покажет, как автоматически править config_player.xml.

Источники: [1], [2], [4], [8], [10], [11]