Voiko: Поехали

2026-09-21T14:06:32Z

Поехали

Новая страница

{{В процессе создания|worker=Voiko}}

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

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

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

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

Репозиторий '''Celadon [Shiptest]:'''
[https://github.com/CeladonSS13/Shiptest GitHub — CeladonSS13/Shiptest]

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

<blockquote> '''Важно:''' названия файлов могут изменяться между версиями билда, поэтому при возникновении расхождений ориентируйтесь на структуру актуального репозитория. </blockquote>
== Приготовления и компиляция ==

=== Установка BYOND ===

Для запуска и компиляции Shiptest необходим [https://www.byond.com/download/build/515/ BYOND v.515.1647].

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

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

Откройте [https://github.com/CeladonSS13/Shiptest репозиторий Celadon Shiptest].

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

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

Например:

<pre> C:\SS13\CeladonShiptest\ </pre>
'''Настоятельно просим не использовать кириллицу в пути к билду, иначе столкнётесь с ошибками (например с комплияцией tgui).'''

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

В частности, вам понадобится скрипты для компиляции в папке '''bin''':
<pre> build.cmd </pre>
Запустите его.

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

В качестве результата должен появиться файл в главной папке:
<pre> shiptest.dmb </pre> <blockquote>
'''Если компиляция завершилась ошибкой:''' не переходите к запуску сервера. Сначала исправьте ошибки, указанные компилятором. Воспользуйтесь руководством по популярным ошибкам ниже, либо обратитесь в канал '''dev''' в нашем '''Discord'''.</blockquote>
== Настройка администратора ==
'''Права администратора выдаются автоматически на локальном сервере'''. Если запускаете только для себя - следуйте дальше по инструкции, но если настраиваете сервер для друзей, то для получения прав администратора на локальном сервере необходимо добавить '''Ckey''' в конфигурацию.

Откройте:

<pre> config/admins.txt </pre>
Добавьте '''сkey''' других игроков.

Список доступных административных рангов можно посмотреть в:
<pre> config/admin_ranks.txt </pre>
Для локального тестирования обычно достаточно высокого ранга вроде <code>Host</code>.

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



== Запуск ==

После успешной компиляции консоль пропадёт, а в основной папке у вас должен появиться:
<pre> shiptest.dmb </pre>

Используйте скрипт из той же папки '''bin''' для запуска сервера.
<pre>server.cmd</pre>

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

== Настройки Dream Daemon ==

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

=== Port ===

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

=== Security ===

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

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

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

; <code>Safe</code>
: Более ограниченный режим.

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

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

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

; <code>Visibility</code> определяет видимость сервера в BYOND Hub.

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

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

; <code>Invisible</code>
: Сервер не отображается в хабе.

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

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

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

<pre> byond://localhost:1337 </pre>
Если используется другой порт, замените <code>1337</code> на соответствующее значение.



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

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

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

<pre> config/ data/ </pre>
После этого:

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

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

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

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

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

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

<pre> Изменение кода => Компиляция => Запуск сервера => Тестирование => Исправление кода => Повторная компиляция </pre>
Для небольшой правки можно использовать Dream Maker:

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

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

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

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

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

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

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

Проверьте:

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

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

1. [https://github.com/CeladonSS13/Shiptest Celadon Shiptest — GitHub] 
2. [https://github.com/shiptest-ss13/Shiptest Оригинальный Shiptest — GitHub] 
3. [https://wiki.celadon.pro/ Celadon Wiki] 
4. [https://www.byond.com/download/build/515/ BYOND] 
5. [https://github.com/shiptest-ss13/Shiptest/blob/master/.github/RUNNING_A_SERVER.md Официальное руководство Shiptest по запуску сервера]

Участник:Voiko/Локалка - История изменений

Voiko: Поехали