Запуск локального сервера: различия между версиями

м (Немного обновил инфу про карты)
(Чуть больше актуализации)
Строка 7: Строка 7:


==Приготовления\компиляция==
==Приготовления\компиляция==
'''ВАЖНО''': Не ставьте никакие галочки, билд сразу готов к сборке!
# [https://codeload.github.com/ss220club/Paradise-SS220/zip/refs/heads/master '''Скачайте билд Paradise SS220'''] (скачивание начнется сразу после нажатия на ссылку)
# [https://codeload.github.com/ss220club/Paradise-SS220/zip/refs/heads/master '''Скачайте билд Paradise SS220'''] (скачивание начнется сразу после нажатия на ссылку)
# После завершения скачивания, разархивируйте в любое удобное вам место.
# После завершения скачивания, разархивируйте в любое удобное вам место.
# Зайдите в разархивированную вами папку. Найдите папку <code>config</code> и зайдите в неё. Там будет папка с названием <code>example</code>, зайдите в неё. Скопируйте все 18 файлов из этой папки назад, в папку <code>config</code>. Если этого '''не сделать''' ваш персонаж будет <u>слишком</u> быстро перемещаться, и по ходу игры могут возникнуть некоторые иные проблемы.
# Зайдите в разархивированную вами папку. Найдите папку <code>config</code> и зайдите в неё. Там будет папка с названием <code>example</code>, зайдите в неё. Скопируйте файk  <code>config.toml</code> из этой папки назад, в папку <code>config</code>. Если этого '''не сделать''' ваш персонаж будет <u>слишком</u> быстро перемещаться, и по ходу игры могут возникнуть некоторые иные проблемы.
# Найдите, в основной папке, файл <code>paradise.dme</code>, откройте его. Через некоторое время откроется Dream Maker.
# Найдите, в основной папке, файл <code>paradise.dme</code>, откройте его. Через некоторое время откроется Dream Maker.
# [[Файл:ss220map.png|обрамить|Важно как наличие, так и отсутствие галок]] Чтобы скомпилировать ваш билд со сменой карты, нужно установить чекбоксы в соответствующие положения как на картинке ниже (важно, чтобы не только все чекбоксы были отмечены как указано, но и не отмеченные также были не отмеченными и у вас). Зайдите в папку <code>config</code>. В ней найдите <code>config.txt</code>. Нажмите <code>CTRL + F</code> и введите <code>Default server map</code>. Укажите необходимую карту по умолчанию написав после <code>DEFAULT_MAP /datum/map/</code> либо <code>cyberiad</code> (Кибериада, она же «Коробка»), либо <code>delta</code> (Керберос, он же «Дельта»), либо <code>cerestation</code> (Фаррагус, он же «Цере»). Сохраните документ нажав <code>CTRL + S</code>.</br>Смена карты на уже запущенном сервере происходит через права администратора во вкладке <code>Server</code> кнопка <code>Select next map</code>.
# Теперь нажмите в верхнем меню <code>Build</code> → <code>Compile</code>.
# Теперь нажмите в верхнем меню <code>Build</code> → <code>Compile</code>.  
# Подождите окончания компиляции, это займет несколько минут.
# Подождите окончания компиляции, это займет несколько минут.
# Если всё вышеперечисленное сделано вами было верно, то в конце журнала вы увидите: <pre>paradise.dmb - 0 errors, 0 warnings</pre>В этом случае можно приступать к дальнейшему запуску.
# Если всё вышеперечисленное сделано вами было верно, то в конце журнала вы увидите: <pre>paradise.dmb - 0 errors, 0 warnings</pre>В этом случае можно приступать к дальнейшему запуску.
== Смена карты ==
Если вы хотите сменить Кибериаду (карта по-умолчанию), на любоую другую, придётся провести пару манипуляций с конфигом который вы ранее достали из папки <code>example</code><br>
:1. Открываем <code>config.toml</code><br>
:2. С помощью комбинации <code>CTRL + F</code> находим строчку <code>#override_map = "/datum/map/test_tiny"</code><br>
:3. Заменяем её на:<br>
::3.1 Если вам нужна Дельта (Керберос) - <code>override_map = "/datum/map/delta"</code><br>
::3.2 Если вам нужна Цера (Фаррагус) - <code>override_map = "/datum/map/cerestation"</code><br>
::3.3 Если вам нужна Мета (Цереброн) - <code>override_map = "/datum/map/metastation"</code><br>
::3.4 Либо можете просто удалить <code>#</code>, и запустить маленькую карту, она грузится быстрее и нужна для тестов.<br>
:4. Сохраняем.<br>
:5. Компилируем билд.<br>
:6. Запускаем локалку.<br>
:7. Радуемся нужной карте, если всё сделано правильно.<br>
Для возвращения Кибериады обратно, достаточно вернуть <code>#</code> в начало строчки.


== Сохранение в базе данных ==
== Сохранение в базе данных ==
В случае, если вы хотите избежать сбрасывания настроек при каждом запуске, смотрите '''[https://wiki.ss220.space/index.php/Настройка_базы_данных руководство по настройке тут].'''
В случае, если вы хотите избежать сбрасывания настроек при каждом запуске, смотрите '''[https://wiki.ss220.space/index.php/Настройка_базы_данных руководство по настройке тут].'''


==Запуск==
== Запуск ==
[[Файл:Dream Daemon.png|обрамить|Dream Daemon]]
[[Файл:Dream Daemon.png|обрамить|Dream Daemon]]
# Найдите <code>Dream Daemon</code>, через меню «Пуск» (если вы уже установили BYOND, то Dream Daemon также у вас установлен вместе с ним) и запустите его.  
# Найдите <code>Dream Daemon</code>, через меню «Пуск» (если вы уже установили BYOND, то Dream Daemon также у вас установлен вместе с ним) и запустите его.  
Строка 77: Строка 92:
::Режим скрытности. Никто не видит ваш сервер, но подключение через ссылку по прежнему работает.
::Режим скрытности. Никто не видит ваш сервер, но подключение через ссылку по прежнему работает.


===Отображение в хабе===
===Отображение в хабе (НЕ АКТУАЛЬНО)===


Изначально ваш сервер не будет виден в хабе, даже если ваши порты открыты и режим <code>Public</code>. Это связано с тем, что изначально ваш сервер «Закрыт». Впрочем, это достаточно легко исправить, если вам это нужно.
Изначально ваш сервер не будет виден в хабе, даже если ваши порты открыты и режим <code>Public</code>. Это связано с тем, что изначально ваш сервер «Закрыт». Впрочем, это достаточно легко исправить, если вам это нужно.
Строка 108: Строка 123:


[[File:Otladka.png]]
[[File:Otladka.png]]
==У МЕНЯ НА ЛОКАЛКЕ ТЕПЕРЬ 2 КАРТЫ ОДНОВРЕМЕННО! ЧТО ДЕЛАТЬ?==
# Качаем [https://github.com/ss220-space/Paradise НОВУЮ локалку]
# Папку из архива кидаем куда угодно
# Открываем папку
# Заходим в <code>config/example</code> (1 и 2 скриншот)
# Выбрасываем все из <code>/example</code> в <code>/config</code> (2 скриншот)
# Открываем <code>config.txt</code> (3 скриншот)
# МОТАЕМ ВНИЗ
# Строку <code>#override_map = "/datum/map/test_tiny"</code> меняем на <code>override_map = "/datum/map/delta"</code> Можете оставить test_tiny и просто убрать комментарий (#). Загрузится маленькая карта, полезно для тестов так как ускоряет запуск локалки.
# СОХРАНЯЕМ
# Компилим по новой без выбора какой-либо карты в компиляторе
# Запускаем сервер через Dream Daemon и радуемся жизни что изначально стоит нужная карта
# ???
# PROFIT
[[Файл:Fix locale 2 maps 1.png|безрамки]]
[[Файл:Fix locale 2 maps 2.png|безрамки]]
[[Файл:Fix locale 2 maps 3.png|безрамки]]
[[Файл:Fix locale 2 maps 4.png|безрамки]]


{{Contribution Guides}}
{{Contribution Guides}}

Версия от 04:47, 20 октября 2023

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

Видеогайд по запуску локального сервера

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

Локальный сервер, или же на сленге "Локалка" - это сервер Space Station, запущенный на вашей локальной машине. Причин для его запуска может быть множество - от изучения функционала игры, тренировки навыка охоты на мегафауну, подрыва лимиток ... вплоть до вызова лорда Сингуло. Последовательность запуска ниже, представлена для билда [1]

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

ВАЖНО: Не ставьте никакие галочки, билд сразу готов к сборке!

  1. Скачайте билд Paradise SS220 (скачивание начнется сразу после нажатия на ссылку)
  2. После завершения скачивания, разархивируйте в любое удобное вам место.
  3. Зайдите в разархивированную вами папку. Найдите папку config и зайдите в неё. Там будет папка с названием example, зайдите в неё. Скопируйте файk config.toml из этой папки назад, в папку config. Если этого не сделать ваш персонаж будет слишком быстро перемещаться, и по ходу игры могут возникнуть некоторые иные проблемы.
  4. Найдите, в основной папке, файл paradise.dme, откройте его. Через некоторое время откроется Dream Maker.
  5. Теперь нажмите в верхнем меню Build → Compile.
  6. Подождите окончания компиляции, это займет несколько минут.
  7. Если всё вышеперечисленное сделано вами было верно, то в конце журнала вы увидите:
    paradise.dmb - 0 errors, 0 warnings
    В этом случае можно приступать к дальнейшему запуску.

Смена карты

Если вы хотите сменить Кибериаду (карта по-умолчанию), на любоую другую, придётся провести пару манипуляций с конфигом который вы ранее достали из папки example

1. Открываем config.toml
2. С помощью комбинации CTRL + F находим строчку #override_map = "/datum/map/test_tiny"
3. Заменяем её на:
3.1 Если вам нужна Дельта (Керберос) - override_map = "/datum/map/delta"
3.2 Если вам нужна Цера (Фаррагус) - override_map = "/datum/map/cerestation"
3.3 Если вам нужна Мета (Цереброн) - override_map = "/datum/map/metastation"
3.4 Либо можете просто удалить #, и запустить маленькую карту, она грузится быстрее и нужна для тестов.
4. Сохраняем.
5. Компилируем билд.
6. Запускаем локалку.
7. Радуемся нужной карте, если всё сделано правильно.

Для возвращения Кибериады обратно, достаточно вернуть # в начало строчки.

Сохранение в базе данных

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

Запуск

Dream Daemon
  1. Найдите Dream Daemon, через меню «Пуск» (если вы уже установили BYOND, то Dream Daemon также у вас установлен вместе с ним) и запустите его.
  2. Нажмите на FileOpen. Вам откроется проводник — найдите папку (Paradise-master220) в которую вы разархивировали билд, найдите в ней файл paradise.dmb, выберите его, подтвердите выбор.
  3. Подождите пару секунд, пока Dream Daemon его загрузит.
  4. В правом нижнем углу появится зеленая кнопка GOGO.png. Нажмите на неё.
  5. Ожидайте запуска сервера демоном (примерно 5–20 секунд).
  6. Над кнопкой GO GO.png появится жёлтая кнопка со стрелочкой Join.png — нажмите её, чтобы зайти на сервер.
  7. Всё. Вы получили ваш собственный сервер!
  8. Чтобы выключить сервер — нажмите на красную кнопку STOP STOP.png

Администрирование

Заходя на ваш сервер, через желтую кнопку Join , вы получаете максимальные права, дающие вам все возможности администратора. Более подробно об огромном количестве возможностей (спавн предметов и тд.), что вы получите в своё распоряжение, вы можете почитать в данном руководстве.

Запуск двух локалок на одном компьютере

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

  1. Закройте (убейте процесс) BYOND.
  2. Первую локалку мы запускаем через Dream Daemon , нажав желтую кнопку Join.png Join.
  3. После того, как первая успешно загружена, сворачиваем её. Включаем BYOND, ждем загрузки.
  4. Снова открываем Dream Daemon , подключаемся через желтую кнопку Join.png Join. Готово у вас 2 локалки.

Альтернативно можно:

  1. Открыть BYOND
  2. Зайти в ваш аккаунт (если вы ещё не зашли), и после зайти на сам сервер через Join.png Join в Dream Daemon (как обычно, т.е.).
  3. Снова открыть BYOND. Далее выйти из вашего аккаунта (Logout около вашего ника)
  4. Снова нажать на Join.png Join.
Как выглядят две локалки на одном компьютере

Прочее

Продвинутый запуск

Либо вам все равно нечего делать, либо вам интересно создать чуть-менее локальную локалку. Самое первое — разберем что это за кнопки на моменте запуска

Port
Номер порта, который Dream Daemon будет использовать для этого сервера. Если вам не нужны игроки — можете забыть об этом.
0
Dream Daemon случайно выберет порт.
Security
Отвечает за собственно, безопасность. Имеет три режима
Trusted
Никакой защиты. Рекомендуется лишь на локалках, где вы единственный игрок/все остальные ваши друзья.
Safe
Стандартная защита. Лучший вариант. Рекомендуется.
Ultrasafe
Максимальная защита! Постоянные запросы «Вы разрешаете получить доступ к НАЗВАНИЕ_ФАЙЛА?». Настоятельно не рекомендуется.
Visibility
Отвечает за отображение сервера в хабе и иных местах. Имеет три режима:
Public
Локалка видна в хабе Space Station (без ОСОБЫХ УХИЩРЕНИЙ не сработает!)
Private
Приватный режим. Ваши друзья в Byond смогут увидеть этот сервер, но все остальные — нет.
Invisible
Режим скрытности. Никто не видит ваш сервер, но подключение через ссылку по прежнему работает.

Отображение в хабе (НЕ АКТУАЛЬНО)

Изначально ваш сервер не будет виден в хабе, даже если ваши порты открыты и режим Public. Это связано с тем, что изначально ваш сервер «Закрыт». Впрочем, это достаточно легко исправить, если вам это нужно.

Вот инструкция

  1. Зайдите в папку с билдом. Найдите папку Config, откройте её.
  2. Найдите в этой папке текстовый файл config.txt. Откройте его используя что-то для просмотра кода (например Visual Studio Code, сам Dream Maker или что-то в этом духе).
  3. Используя поиск (Ctrl + А или же Ctrl + F) найдите MEDAL_HUB_ADDRESS. Удалите около него (ЛИШЬ ОКОЛО НЕГО) #, и запишите собственно название. Выше него будет описано, как его сделать, но если просто — придумайте что-то в духе Hubmakerckey.Hubname, т. е. например Honkhonkhonk.SS13.
  4. Используя поиск, найдите MEDAL_HUB_PASSWORD. Несмотря на название, это не совсем пароль. Это условное обозначение сервера, его настроить можно так: 3qb77RnAX0. Можете использовать его так, или использовать собственный MEDAL_HUB_PASSWORD. Также уберите # около него.

P.S. Возможно это НЕ сработает. Во первых — это актуально лишь для Paradise, на других серверах по иному, а во-вторых это может быть просто не правильно. Правильность все ещё уточняется, да.


Запуск по кодерски

Существует способ который позволит вам сразу скомпилировать билд и запустить вашу локалку для одного компьютера. Это полезно, если вам не нужен вторая локалка на одном компьютере для тестов, вы тестируете новые значения внесенные в код, вам нужно быстро зайти и проверить то что вы сделали, без нажатия на лишние кнопки и муторного запуска Dream Daemon.
Для этого вам понадобится Visual Studio Code (VSC)

После прохождения гайда по установке VSC, обязательно проверьте:

  1. Не выдает ли VSC никаких ошибок при открытии билда
  2. Скачали ли вы все предложенные плагины для работы с DM (для быстрой работы с кодом)
  3. Перенесли ли вы все файлы конфигов из папки /config/example в папку /config (для нормализации скорости и кнопочек)
  4. Вписали ли вы свой сикей в конфиг админов (иначе вы не сможете пользоваться кнопочками)
  5. Отсутствие запущенного Dream Daemon (иначе могут появляться ошибки с иконками)
  6. Запущенный BYOND (чтобы игра видела ваш сикей и дала кнопочки)

Как только все пункты пройдены и вы уверены что всё отлично, вы можете запустить вашу персональную локалку нажатием всего одной клавиши: F5

Либо же лично запустить отладку:

Otladka.png

Как внести свой вклад?
Общее Руководство по разработке
Сервер Настройка базы данных, Запуск локального сервера
Код Структура кода SS13, SS13 для опытных программистов, Форматирование текста, Как делать перевод игры
Маппинг Руководство по маппингу
Спрайтинг Руководство по спрайтингу
Вики Руководство по редактированию вики