- Shell 67.2%
- Python 17.7%
- Dockerfile 11.1%
- PHP 4%
|
|
||
|---|---|---|
| db | ||
| docs | ||
| patches | ||
| rootfs | ||
| tools | ||
| .gitignore | ||
| Dockerfile | ||
| egg-nfs-world.json | ||
| for-claude.md | ||
| LICENSE | ||
| README.md | ||
NFS World server для Pterodactyl
Готовый сервер Need for Speed: World (Soapbox Race World) в одном контейнере и egg для Pterodactyl. Создаёте сервер в панели, указываете базу данных и второй порт, и он работает. Игроки подключаются стандартным лаунчером SBRW.
Сделано для Hamy GameHosting, но подходит для любой панели.
Что внутри
| Компонент | Исходники | Зачем |
|---|---|---|
| Ядро | SBRW-Reloaded-Core (Java 11, Thorntail) | HTTP API игры и лаунчера: аккаунты, гараж, магазин, события, лобби |
| XMPP | Openfire 4.7.5 + патч SBRW + плагины restAPI, nonSASL | чат, приглашения, уведомления от сервера |
| Freeroam | WorldUnitedNFS/freeroam (Go) | синхронизация машин в свободной езде |
| Race sync | sbrw-mp-sync-2018 | ретранслятор гонок по UDP |
| Redis | Debian | матчмейкинг и присутствие игроков |
Все версии закреплены коммитами в Dockerfile. Данные (игроки, машины, параметры и таблицы
Openfire) хранятся в одной базе MySQL/MariaDB, которую выдаёт панель.
Порты
Серверу нужны два порта (два allocation в панели):
| Порт | TCP | UDP |
|---|---|---|
основной (SERVER_PORT) |
HTTP API (/Engine.svc) |
freeroam |
второй (NFSW_SECOND_PORT) |
XMPP | гонки |
Установка egg
- В панели: Admin → Nests → Import Egg →
egg-nfs-world.json. - Создайте сервер, выдайте ему два порта, память от 2 ГБ (рекомендуется 3 ГБ).
- Во вкладке сервера «Базы данных» создайте базу (MariaDB 10.6+ или MySQL 8, пустую).
- В «Настройках запуска» заполните
PUBLIC_HOST(публичный IP),NFSW_SECOND_PORT(номер второго порта) и данные базы. - Запустите. Первый запуск загружает игровые данные в базу (около минуты).
- В лаунчере SBRW: Add Server →
http://PUBLIC_HOST:ПОРТ/Engine.svc.
Настройка
- Переменные панели: название, описание, страна, Discord, сайт, баннер, лимит игроков, регистрация по приглашениям, адрес модов, SMTP для восстановления паролей.
config/parameters.ini: любой из ~200 параметров ядра (ИМЯ=значение): множители денег и репутации, уровни, экономика, автотюнинг, вебхуки Discord и так далее. Применяется при каждом запуске и перекрывает всё остальное. Командаparamsв консоли показывает текущие значения.config/freeroam.toml: радиус видимости, число видимых игроков, живая карта (FMS).config/openfire.ini: дополнительные свойства Openfire.
Консоль
help, status, players, announce <текст>, reload, setadmin <email>,
unsetadmin <email>, params [фильтр], stop.
setadmin выдаёт права администратора. Внутриигровые команды (/kick, /ban, /tune и др.) пока не работают: нужен плагин Openfire, пересылающий их в ядро.
Моды
Файлы *.mods из папки mods/ сервера лаунчер скачивает сам (ModNet включён всегда: он же ставит патчи клиента, без которых не работают способности и мультиплеер).
Обновление
Образ git.hamystudio.ru/hamygames/nfsw-server:latest пересобирается из этого репозитория.
Перезапуск сервера подтягивает новый образ; схема базы обновляется миграциями из
db/migrations автоматически. Игровые данные и аккаунты не трогаются.
Сборка
docker build -t nfsw-server .
Как устроены база, миграции и патчи, описано в docs/.
Лицензия
GPL-3.0, как у ядра SBRW. Клиентских файлов игры (EA) здесь нет: игроки используют свою копию игры через лаунчер SBRW.