Half-Life на базе Xash3D

Недавно появился внутрисетевой сервер Half-Life на базе движка Xash3D FWGS.

Стало интересно разобраться в особенностях IPv6 / Yggdrasil и создать этот материал для тех, кто захочет поднять внутрисетевой сервер с нуля и кастомизировать его в дальнейшем.

Half-Life - всем известный шутер от первого лица, за 20 лет не утративший свою популярность.

Технические требования минимальны, игра работает даже на компьютерах без предустановленных видео-драйверов.

Xash3D FWGS - это мульти-платформенный движок с открытым кодом для запуска файлов игры Half-Life 1, с некоторыми доработками оригинального Xash3D.

Файлы самой игры Half-Life нужно приобрести отдельно, затем скопировать в директорию valve с установленным Xash3D FWGS.

Для сборки и запуска необходимо добавить поддержку библиотек архитектуры i386:

dpkg --add-architecture i386
apt update
apt install build-essential gcc-multilib g++-multilib python3 libsdl2-dev:i386 libfontconfig-dev:i386 libfreetype6-dev:i386

При возникновении ошибки запуска в последних версиях

Host_InitError: Can't initialize cl_dlls/client.so: vgui.so: cannot open shared object file: No such file or directory

нужно скопировать файл vgui.so уровнем выше директории valve

~/.steam/steam/steamapps/common/Half-Life/

Xash3D FWGS YGGverse Edition основан на ветке master от Xash3D FWGS, целью проекта является создание сборки, ориентированной на сеть Yggdrasil.

В рамках разработки осуществляются обратно-совместимые контрибуции.

• master - зеркало официальной master от Xash3D FWGS для обновлений
• sv-downloadurl-ipv6 - поддержка параметра sv_downloadurl_ipv6 в server.cfg, поскольку sv_downloadurl работает только с IPv4 (PR #1577)
• master-hl-ygg - замена mentality.rip на внутрисетевой master.hl.ygg (в паре с yggdrasil-masters удобен на случай обновления IP без повторной сборки клиентов)
• yggdrasil-masters - дополнительные мастер-сервера в формате 0200::/7 (на случай отсутствия Alfis DNS)
• yggdrasil-only - ветка предусматривает сборку Xash3D работающей только в рамках сети Yggdrasil, исключая запросы в клирнет (в разработке)
• yggdrasil-inclusive - ветка расширяет совместимость master с Yggdrasil, удобна для игрового сервера, работающего в обе сети, включая клирнет

Сборка не отличается от инструкций Xash3D FWGS, достаточно указать адрес репозитория (или использовать нужную ветку для слияния с официальным xash3d-fwgs):

git clone --recursive https://github.com/YGGverse/xash3d-fwgs.git
cd xash3d-fwgs
git checkout yggdrasil-only
./waf configure -T release
./waf build
./waf install --destdir=/path/to/game

В рамках релизов, публикуются бинарные пакеты для Linux что может быть удобным для начинающих пользователей.

При использовании сборок yggdrasil-only или yggdrasil-inclusive от Xash3D FWGS / YGGverse Edition, в списке «интернет игры» будут доступны все доступные внутрисетевые сервера Yggdrasil.

В остальных случаях, клиент будет работать с IPv6, но по-умолчанию ориентирован на сеть IPv4 и мастер сервер от FWGS - mentality.rip:27010

Можно вручную подключиться к заведомо известному узлу Yggdrasil из консоли с помощью тильды:

connect [300:dee4:d3c0:953b::2019]:27015

С недавних пор, удалось портировать pymaster для работы с IPv6, также имеется патч для xash3d-fwgs, позволяющий принимать IPv6 адреса от мастера.

Чтобы удалить IPv4 сервера из списка, открываем консоль и пишем:

clearmasters

затем добавляем внутрисетевой мастер сервер или несколько по очереди:

addmaster [300:dee4:d3c0:953b::2019]:27010

проверяем

listmasters

Данные настройки сохраняются после перезагрузки в файле /valve/xashcomm.lst, также можно добавить сервера вручную, по одному на строку.

* тильда работает только в режиме игры, вызов консоли также доступен из главного меню при запуске Xash3D с флагом -dev.

Для удобного запуска клиента, можно добавить его в меню приложений:

~/.local/share/half-life.desktop

[Desktop Entry]
Encoding=UTF-8
Name=Half-Life
Exec=/path/to/xash3d
Comment=Half-Life on Xash3D
Terminal=false
Icon=/path/to/hl.png
Type=Application
StartupNotify=false
Categories=Games

Затем активировать:

xdg-desktop-menu install ~/.local/share/half-life.desktop

Для разных сборок Xash3D, удобно использовать тематические иконки, например для сборки Yggdrasil:

При наличии установленного клиента с файлами игры, запуск сервера в сети Yggdrasil/IPv6 осуществляется командой:

xash3d -dedicated -port6 27015 -ip6 xxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx -noip +maxplayers 8 +map crossfire

* -noip отключает режим IPv4, если у сервера есть «белый IP» - можно разрешить подключение игроков из Clearnet: -ip xx.xx.xx.xx
* * не забываем открыть порт 27015 (указать можно любой)

Дополнительные настройки можно указать в файлах

• /valve/server.cfg - базовые настройки, такие как имя сервера (hostname)
• /valve/skill.cfg - спецификация сервера
• /valve/listip.cfg - настройки ограничения доступа
• /valve/banned.cfg

Чтобы сервер был доступен в списке мастер сервера, важно указать:

server.cfg

sv_lan 0
public 1

* стандартный мастер сервер mentality.rip фильтрует по -game valve

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

/etc/systemd/system/half-life-server.service

[Unit]
Description=Half-Life Server
After=network.target

[Service]
Type=simple
User=halflife
ExecStart=/home/halflife/xash3d -dedicated -port6 27015 -ip6 xxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx -noip +maxplayers 8 +map crossfire
StandardOutput=file:/home/halflife/server-debug.log
StandardError=file:/home/halflife/server-error.log
Restart=on-failure

[Install]
WantedBy=multi-user.target

Автозапуск:

systemctl daemon-reload
systemctl enable half-life-server
systemctl start half-life-server

FastDL - сокр. «быстрая загрузка», способ передачи дополнительных ресурсов игры клиенту сервером.

Обычно, реестр организуется средствами сервера nginx таким образом, чтобы файловая структура соответствовала структуре в директории valve:

/maps
/models
/sound
/materials

В файле server.cfg указывается URL к данным директориям:

server.cfg

sv_downloadurl "http://xx.xx.xx.xx/fastdl/half-life/"
sv_allowdownload 1

где /fastdl/half-life/ - путь к структуре файлов на сервере.

* на данный момент поддержки IPv6 для sv_downloadurl нет
* в рамках форка sv-downloadurl-ipv6 добавлена поддержка новой опции для server.cfg - sv_downloadurl_ipv6=«[IPv6]:port/path» позволяющая секурно загружать модели при подключении Yggdrasil

Утилита используется для создания файла дополнительных зависимостей в формате .res для загрузки клиентом из сервера при инициализации карты.

Может быть полезна, если требуется отправить клиенту дополнительные модели игроков, при этом не создавая форки локаций.

Есть исходники и рабочая сборка для Linux.

Принцип работы

Извлекаем зависимости карты:

Linux.64-bit /valve/maps/crossfire.bsp

В этой же директории будет создан одноименный файл с расширением .res, который можно открыть текстовым редактором и добавить нужную зависимость:

crossfire.res

// crossfire.res - created with RESGen v2.0.3.
// RESGen is made by Jeroen "ShadowLord" Bogers,
// with serveral improvements and additions by Zero3Cool.
// For more info go to http://resgen.hltools.com

// .res entries (9):
halflife.wad
sound/ambience/jetflyby1.wav
sound/ambience/siren.wav
sound/debris/beamstart11.wav
sound/weapons/electro5.wav
sound/weapons/mortarhit.wav
sound/weapons/sbarrel1.wav
sprites/muzzleflash1.spr
sprites/steam1.spr
models/player/... // добавляем в конец файла логический путь к новому файлу (на примере модели FastDL)

Файл .res должен находится в той же директории что и файл карты - /valve/maps.

Перезагружаем сервер и переподключаем клиент - кастомнный скин должен быть автоматически загружен клиентом и добавлен в директорию /valve/downloaded/models/player/…

Мастер-сервер нужен для удобного поиска игровых серверов через интерфейс игры, иначе нужно каждый раз вводить адрес/порт сервера вручную.

pymaster - это Python реализация мастер-сервера HLMaster, в рамках проекта FWGS.

Для запуска необходимо открыть порт 27010 и выполнить команду:

pymaster.py -i :: -p 27010

* в репозитории также есть пример конфигурации systemd

Чтобы pymaster начал отдавать игровые сервера клиентам, обе стороны должны быть скомпилированы или настроены на данный мастер-сервер.

В Xash3D исходники находятся в файле engine/common/netchan.h строки MASTERSERVER_ADR или в файле конфигурации /valve/xashcomm.lst
При использовании клиента с графическим интерфейсом, можно динамически указывать мастер сервер в консоли, командами listmasters/clearmasters/addmaster адрес:порт
Обновление типичных конфигураций valve - steamcomm.lst и valvecomm.lst игнорируется при запуске в оболочке Xash3D.

xash3d-master - недавний релиз мастер сервера для Xash3D, написанного на языке Rust

XashMS - асинхронный сервер для Xash3D с поддержкой IPv6 на языке C++

Чтобы оживить сервер и сделать ожидание игроков интереснее, в игру можно добавить ботов с помощью сторонних плагинов.

Самый простой способ - установка последней версии Bot Number 10.

Загружаем архив для Linux и распаковываем содержимое в корневую директорию с бинарником xash3d таким образом, чтобы директория bot была рядом с valve. Поскольку плагин являет собой расширение, он не перезаписывает файлы игры, и запускать сервер необходимо указав новый путь к директории игры:

xash3d -game bot

Важно учитывать, что при запуске из нестандартной директории, сервер будет отфильтрован большинством мастер серверов, в виду фильтрации по valve.
Чтобы решить эту проблему, можно:

• сменить пути DLL в файле gameinfo.txt
• скопировать содержимое директории bot в valve и перезапустить сервер без флага -game bot

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

bot.cfg

min_bots 1 # не ставить в 0, интерпретируется как false
max_bots 4

После запуска, настроенные в bot.cfg персонажи будут добавлены в игру. Плагин является частью проекта hlsdk-portable, при возникновении проблем, возможно потребуется собрать файл /valve/dlls/hl.so и заменить им оригинальный, хотя в случае с последней версией Steam - все работает без дополнительных действий.

На сайте есть архив с исходниками, но последнюю версию можно собрать из репозитория с файлами SDK:

git clone --recursive https://github.com/FWGS/hlsdk-portable.git
git checkout bot10
cmake -B build -S .
cmake --build build

После компиляции ветки, будет доступен только файл bot.so - остальные файлы нужно собирать отдельно.
Если для остальных файлов не нужна особая сборка, можно переименовать bot.so в bot_i486.so и смержить с официальным архивом для Linux, пока что это работает.

Открытая модификация Bot Number 10 для сервера YGGverse

1.0.0

• добавлена возможность установки min_bots=0 (PR #423)
• респавн ботов с конфигурации bot.conf (PR #422)
• поддержка дополнительных скинов

сборка

git clone --recursive https://github.com/YGGverse/hlsdk-portable.git
git checkout bot10-yggverse
cmake -B build -S .
cmake --build build

Есть бинарные релизы для более ранних систем.

В сетевой игре можно использовать графити, с помощью кнопки T. Изображение выбирается в настройках клиента, раздел «Multiplayer» - «Customize».

Чтобы создать свой логотип, изображение должно быть размером 64х64 пикселя, в палитре Grayscale и формате .BMP

Ниже рассмотрен пример обработки изображения PNG из коллекции hl-customs в редакторе GIMP:

1. Image → Scale Image → 64×64 / Quanlity: Linear
2. Layer → Transparency → Remove Alpha Channel
3. Colors → Components → Decompose
4. Colors → Invert (черный цвет считается прозрачным)
5. File → Export As.. → сохраняем по адресу /valve/logos/filename.bmp

Результат на данном примере будет иметь следующий вид

Следует заметить, что создание Ч/Б графики обусловлено возможностью выбора цвета в интерфейсе игры.

• [300:dee4:d3c0:953b::2019]:27015 - 9 ботов, только Yggdrasil

Имеется открытая конфигурация сервера, можно вносить свои предложения или использовать для организации нового сервера.

• [300:dee4:d3c0:953b::2019]:27010 - by lost+skunk

Xash3D FWGS / YGGverse Edition
Half-Life в Steam
Параметры конфигурации сервера
официальный pymaster | более чистая версия от @xdettlaff | адаптация от YGGverse на базе @xdettlaff
xash3d-master на rust | зеркало Yggdrasil
Информация о мастер-сервере
Серверные запросы с множеством полезных ссылок
Боты, совместимые с Xash3D | Bot Number 10 by YGGverse
Библиотека PHP 8 для веб разработчиков
Каталог скинов | Графити Yggdrasil | Графити IPv6