Участник:Voiko/Локалка

Страница-заготовка. Контент страницы находится в разработке и недоступен

Использовать данный контент нельзя
Подрядчик: Voiko

Локальный сервер Shiptest / Celadon

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

Локальный сервер

Локальный сервер, или на сленге «локалка» — это сервер Space Station 13, запущенный на вашем компьютере. Причин для его запуска может быть множество — от изучения механик игры и тестирования кораблей до разработки новых предметов, карт, механик и проверки изменений в коде.

Репозиторий Celadon [Shiptest]: GitHub — CeladonSS13/Shiptest

Мы разберём 2 популярных варианта установки локалки. 1. Немного усложнённый, но правильный. Позволяет обновлять билд, вести полноценную разработку, запускать старые версии билда. 2. Для психопатов и лентяев. (Мы такое не одобряем)

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

Приготовления и компиляция

Установка BYOND

Для запуска и компиляции Shiptest необходим BYOND v.515.1647.

Скачайте и установите подходящую для текущего билда версию BYOND. Использование слишком старой или несовместимой версии может привести к ошибкам компиляции.

Скачивание билда

Откройте репозиторий Celadon Shiptest.

Убедитесь, что скачиваете ветку [beta-dev], на данный момент она является самой актуальной. Нажмите Code → Download ZIP и дождитесь окончания скачивания.

После этого распакуйте архив в удобное место.

Например:

 C:\SS13\CeladonShiptest\

Настоятельно просим не использовать кириллицу в пути к билду, иначе столкнётесь с ошибками (например с комплияцией tgui).

Компиляция

После распаковки в основной папке должны находиться необходимые файлы проекта.

В частности, вам понадобится скрипты для компиляции в папке bin:

 build.cmd

Запустите его.

После этого начнётся компиляция игры и необходимых компонентов.
Компиляция может занять несколько минут.
При успешной сборке в журнале не должно быть ошибок компиляции.

В качестве результата должен появиться файл в главной папке:

 shiptest.dmb

Если компиляция завершилась ошибкой: не переходите к запуску сервера. Сначала исправьте ошибки, указанные компилятором. Воспользуйтесь руководством по популярным ошибкам ниже, либо обратитесь в канал dev в нашем Discord.

Настройка администратора

Права администратора выдаются автоматически на локальном сервере. Если запускаете только для себя - следуйте дальше по инструкции, но если настраиваете сервер для друзей, то для получения прав администратора на локальном сервере необходимо добавить Ckey в конфигурацию.

Откройте:

 config/admins.txt

Добавьте сkey других игроков.

Список доступных административных рангов можно посмотреть в:

 config/admin_ranks.txt

Для локального тестирования обычно достаточно высокого ранга вроде Host.

После изменения конфигурации перезапустите сервер.

Запуск

После успешной компиляции консоль пропадёт, а в основной папке у вас должен появиться:

 shiptest.dmb

Используйте скрипт из той же папки bin для запуска сервера.

server.cmd

Если всё прошло успешно, то на панели задач вы заметите зелёную иконку Dream Daemon, которая уже наверняка инициализирует сервер. Откройте её.

Настройки Dream Daemon

Во время запуска через Dream Daemon доступны несколько важных параметров.

Port

Port — порт, на котором будет работать сервер. Стандартный порт 1337. Если другой процесс уже использует этот порт, сервер не сможет его занять.

Security

Security отвечает за ограничения доступа BYOND к файлам.

Доступны несколько режимов:

Trusted: Минимальные ограничения. Удобно использовать на собственной локалке при разработке.

Safe: Более ограниченный режим.

Ultrasafe: Максимальные ограничения. Может приводить к постоянным запросам разрешений на доступ к файлам.

Для локальной разработки обычно используется Trusted.

Используйте Trusted осознанно: он предоставляет серверу значительно больше доступа к локальным файлам.

Visibility

Visibility определяет видимость сервера в BYOND Hub.

Public: Сервер может отображаться публично.

Private: Сервер ограничен и не предназначен для общего публичного доступа.

Invisible: Сервер не отображается в хабе.

Для обычного локального тестирования удобнее использовать Invisible.

Подключение к локальному серверу

Если Dream Daemon запущен на вашем компьютере и использует порт 1337, подключиться к нему можно через:

 byond://localhost:1337

Если используется другой порт, замените 1337 на соответствующее значение.

Обновление локалки

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

В первую очередь сохраните:

 config/ data/

После этого:

Скачайте новую версию билда. Распакуйте её в отдельную папку. Перенесите необходимые конфигурационные файлы. При необходимости перенесите пользовательские данные. Проверьте изменения конфигурации. Запустите build.cmd. Убедитесь, что компиляция завершилась успешно. Запустите новый shiptest.dmb.

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

Запуск для разработки

Если вы занимаетесь разработкой Shiptest, удобнее всего работать через Visual Studio Code и Dream Maker.

Перед запуском убедитесь, что:

BYOND установлен. Используется подходящая версия BYOND. Исходный код находится в пути без кириллицы. shiptest.dme открывается корректно. BUILD.bat выполняется без ошибок. Ваш BYOND-ключ добавлен в config/admins.txt. Dream Daemon не использует старую версию shiptest.dmb. После изменения кода сервер был повторно скомпилирован.

Быстрый цикл разработки

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

 Изменение кода => Компиляция => Запуск сервера => Тестирование => Исправление кода => Повторная компиляция

Для небольшой правки можно использовать Dream Maker:

Откройте shiptest.dme. Внесите изменения. Выполните Build → Compile. Запустите сервер. Проверьте результат.

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

Не создаётся shiptest.dmb

Проверьте:

Установлен ли BYOND.
Совместима ли версия BYOND с билдом.
Не повреждены ли файлы проекта.
Что именно написано в журнале компиляции.

Dream Daemon не запускает сервер

Проверьте:

Не занят ли указанный порт.
Не запущен ли второй сервер на том же порту.
Не блокирует ли подключение Windows Firewall.
Не остался ли запущенным старый экземпляр сервера.

Сервер запускается, но карта работает неправильно

Проверьте:

Соответствует ли карта текущему билду;
Правильно ли указаны .dmm-файлы;
Не изменялись ли связанные с картой ресурсы;

Полезные ссылки

1. Celadon Shiptest — GitHub
2. Оригинальный Shiptest — GitHub
3. Celadon Wiki
4. BYOND
5. Официальное руководство Shiptest по запуску сервера