Локальный сервер: различия между версиями

Материал из Space Stories Wiki
Нет описания правки
Строка 5: Строка 5:
<big>[https://git-scm.com/downloads Git]</big><br>
<big>[https://git-scm.com/downloads Git]</big><br>
<big>[https://dotnet.microsoft.com/en-us/download/dotnet/8.0 .NET 8]</big><br>
<big>[https://dotnet.microsoft.com/en-us/download/dotnet/8.0 .NET 8]</big><br>
<big>[https://www.python.org/downloads/ Python]</big><br>
<big>[https://www.python.org/downloads/ Python]</big><br><br>
<big><span style="color: #fc0339">Также обязательно</span> перед установкой <span style="color: #0f79d4">Pyt</span><span style="color: #ffd748">hon</span> поставьте галочку в пункте "Add python.exe to PATH"</big>{{Anchor|Галочка Python}}<br>
<span style="color: #fc0339"><big>Обязательно!!!</big></span> перед установкой <span style="color: #ffd748">Python</span> поставьте галочку в пункте "Add python.exe to PATH"{{Anchor|Галочка Python}}<br>
Если у вас ранее был установлен <span style="color: #ffd748">Python</span>, то <span style="color: #fc0339"><big>удалите его</big></span> и скачайте с установленной галочкой в пункте "Add python.exe to PATH"
[[Файл:Фото для локалки3.gif|link=]]
[[Файл:Фото для локалки3.gif|link=]]
=== Как узнать версия Windows 32 бит или 64 бит? ===
=== Как узнать версия Windows 32 бит или 64 бит? ===
Строка 17: Строка 18:


== Установка репозитория ==
== Установка репозитория ==
Есть два способа установки локального сервера.<br>
1. Откройте консоль (в Windows в поисковой строке напишите "cmd" или "Командная строка"), введите ''"cd"'' и путь до папки, в которую хотите произвести установку, а дальше подтвердите кнопкой "Enter":
 
  cd C:\''"Название вашей папки"''
===== Первый и более простой в установке (<big><span style="color: #fc0339">но более неудобный</span></big> для обновления):<br> =====
2. А затем вставьте и подтвердите команду:
#Перейдите по ссылке на наш репозиторий <big>[https://github.com/Space-Stories/space-station-14 Space-Stories]</big><br> и скачайте ZIP файл[[Файл:Фото для локалки4.png|1000px|link=]]
#А затем извлеките из него файлы в нужную для вас папку.<br>
Вот мы и установили репозиторий, но чтобы его обновить, потребуется заново скачивать ZIP файл, а также удалять прошлый репозиторий.<br>
 
===== Второй способ (<big><span style="color: #00cb0c">рекомендуемый</span></big>): =====
1. Откройте консоль (в Windows в поисковой строке напишите "cmd" или "Командная строка") и введите "cd" и путь до папки, в которую хотите произвести установку
например:
  cd C:\My Programs
2. Подтвердите путь кнопкой "Enter" (левее ввода должен появиться написанный вами путь)<br>
3. А затем пишите:
  git clone <nowiki>https://github.com/Space-Stories/space-station-14</nowiki>
  git clone <nowiki>https://github.com/Space-Stories/space-station-14</nowiki>
4. Подтвердите кнопкой "Enter" и у вас начнётся установка, во время установки не закрывайте консоль и не выключайте компьютер!
3. Во время установки не закрывайте консоль и не выключайте компьютер!


== Сборка проекта{{Anchor|Сборка проекта}} ==
== Заключительный этап{{Anchor|Сборка проекта}} ==
1. Необходимо загрузить подмодуль, для этого запустите файл "RUN_THIS.py" в установленном репозитории<br> [[Файл:Фото для локалки5.png|link=]]<br>
1. Необходимо загрузить подмодули, для этого запустите файл "RUN_THIS.py" (кликните два раза по нему), он находится в папке "space-station-14" (в папку, которую вы ранее указывали) <div> [[Файл:Фото для локалки5.png|link=]] </div>
2. После того как загрузка закончится и консоль закроется переходите в папку с установленным репозиторием по консоли, в моём случае:
2. После того как загрузка закончится и консоль закроется (если она закрывается, то значит что подмодули установились) переходите в папку с установленным репозиторием через консоль:
  cd C:\My Programs\space-station-14
  cd C:\''"Название вашей папки"''\space-station-14
3. Если вы собираетесь писать прототипы, то пишите и подтверждайте через "Enter" команду:
3. Теперь нужно собрать проект, для этого напишите и запустите в консоли команду:
dotnet build
Иначе если вы хотите более стабильную сборку без вылетов, то пишите и подтверждайте через "Enter" команду:
  dotnet build --configuration Release
  dotnet build --configuration Release
4. Если после установки в консоли у вас нет ошибок, то значит что сборка выполнена успешно!
4. Если после установки в консоли у вас нет ошибок, то значит что сборка выполнена успешно!
Строка 48: Строка 37:


== Обновление локального сервера ==
== Обновление локального сервера ==
Для обновления локального сервера (если устанавливали вторым способом):<br>
Для обновления локального сервера:<br>
1. Откройте консоль и введите путь до локального сервера, в моём случае:
1. Откройте консоль и введите путь до локального сервера, в моём случае:
  cd C:\My Programs\space-station-14
  cd C:\''"Название вашей папки"''\space-station-14
2. Введите и подтвердите кнопкой "Enter" команду:
2. Введите и подтвердите кнопкой команду:
  git pull origin master
  git pull origin master
3. [[Локальный_сервер#Сборка проекта|Пересоберите проект]] (можно не запускать файл "RUN_THIS.py")
3. [[Локальный_сервер#Сборка проекта|Пересоберите проект]] (можно не запускать файл "RUN_THIS.py")
Строка 58: Строка 47:
* Убедитесь что у вас установлены программы: [[Локальный_сервер#Программы|Git | .NET 8 | Python]]  последней версии и подходящей под тип вашей операционной системы
* Убедитесь что у вас установлены программы: [[Локальный_сервер#Программы|Git | .NET 8 | Python]]  последней версии и подходящей под тип вашей операционной системы
* Убедитесь что при установке Python вы поставили галочку в пункте [[Локальный_сервер#Галочка Python|"Add python.exe to PATH"]]
* Убедитесь что при установке Python вы поставили галочку в пункте [[Локальный_сервер#Галочка Python|"Add python.exe to PATH"]]
* Убедитесь что у вас установлена только одна версия .NET 8 (они иногда могут конфликтовать)<br>
* Убедитесь что у вас установлена только одна версия .NET 8 (они иногда могут конфликтовать), в установленном виде она называется: ''"Microsoft .NET SDK"''<br>
В случае если у вас Windows:
# Введите в поиск "Панель управления"
# В поиске панели управления введите и откройте "Программы и компоненты"
# Если найдёте две программы, в названии которых "Microsoft .NET SDK", то удалите более старые версии и оставьте только самую новую
В случае с Linux:<br><br>
В консоли введите
rpm -qa | grep .NET SDK
Удалите лишние пакеты командой
sudo apt-get remove "имя пакета"
* Попробуйте удалить репозиторий и скачать его заново
* Попробуйте удалить репозиторий и скачать его заново
* Обратитесь за помощью в нашем [https://discord.gg/space-stories дискорд сервере]
* Обратитесь за помощью в нашем [https://discord.gg/space-stories дискорд сервере]
Строка 76: Строка 56:
1. Перейдите по пути:<br>
1. Перейдите по пути:<br>
  space-station-14\bin\Content.Server
  space-station-14\bin\Content.Server
2. Откройте файл "server_config.toml" в любом текстовом редакторе<br>
2. Откройте файл ''"server_config.toml"'' в любом текстовом редакторе<br>
[[Файл:Фото для локалки8.png|link=]]<br>
[[Файл:Фото для локалки8.png|link=]]<br>
3. Добавьте и сохраните следующий текст:<br>
3. Добавьте и сохраните следующий текст:<br>

Версия от 21:14, 13 августа 2024

Как установить локальный сервер?

Предварительная подготовка

Обязательно установите или обновите следующие программы!
Без них ваш локальный сервер не будет работать

Git
.NET 8
Python

Обязательно!!! перед установкой Python поставьте галочку в пункте "Add python.exe to PATH"
Если у вас ранее был установлен Python, то удалите его и скачайте с установленной галочкой в пункте "Add python.exe to PATH"

Как узнать версия Windows 32 бит или 64 бит?

Для установки некоторых программ в Windows нужно знать её разрядность

Если вы не знаете то:

  1. Напишите в поисковой строке "О компьютере"
  2. Нажмите на выдаваемый результат поиска
  3. В "характеристиках устройства" смотрите информацию в строке где написано "Тип системы"

Установка репозитория

1. Откройте консоль (в Windows в поисковой строке напишите "cmd" или "Командная строка"), введите "cd" и путь до папки, в которую хотите произвести установку, а дальше подтвердите кнопкой "Enter":

cd C:\"Название вашей папки"

2. А затем вставьте и подтвердите команду:

git clone https://github.com/Space-Stories/space-station-14

3. Во время установки не закрывайте консоль и не выключайте компьютер!

Заключительный этап

1. Необходимо загрузить подмодули, для этого запустите файл "RUN_THIS.py" (кликните два раза по нему), он находится в папке "space-station-14" (в папку, которую вы ранее указывали)

2. После того как загрузка закончится и консоль закроется (если она закрывается, то значит что подмодули установились) переходите в папку с установленным репозиторием через консоль:

cd C:\"Название вашей папки"\space-station-14

3. Теперь нужно собрать проект, для этого напишите и запустите в консоли команду:

dotnet build --configuration Release

4. Если после установки в консоли у вас нет ошибок, то значит что сборка выполнена успешно!

Запуск локального сервера

В папке репозитория запустите программы "runserver.bat" и "runclient.bat"

Обновление локального сервера

Для обновления локального сервера:
1. Откройте консоль и введите путь до локального сервера, в моём случае:

cd C:\"Название вашей папки"\space-station-14

2. Введите и подтвердите кнопкой команду:

git pull origin master

3. Пересоберите проект (можно не запускать файл "RUN_THIS.py")

Если возникли проблемы

  • Убедитесь что у вас установлены программы: Git | .NET 8 | Python последней версии и подходящей под тип вашей операционной системы
  • Убедитесь что при установке Python вы поставили галочку в пункте "Add python.exe to PATH"
  • Убедитесь что у вас установлена только одна версия .NET 8 (они иногда могут конфликтовать), в установленном виде она называется: "Microsoft .NET SDK"
  • Попробуйте удалить репозиторий и скачать его заново
  • Обратитесь за помощью в нашем дискорд сервере

Дополнительная информация

Как открыть все роли?

Чтобы открыть все роли:
1. Перейдите по пути:

space-station-14\bin\Content.Server

2. Откройте файл "server_config.toml" в любом текстовом редакторе

3. Добавьте и сохраните следующий текст:

[game]
role_timers = false

Базовые команды

Консоль открывается на кнопку "~/Ё"

  • Выход в лобби (чтобы выбрать роль, карту и т.д.):
golobby
  • Выбрать карту:
setmap
  • Перезапустить игру без ожидания окончания раунда:
restartroundnow
  • Начать раунд:
startround