Текущая версия от 15:52, 23 сентября 2024

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

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

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

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

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

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

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

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

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

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

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

Либо выберете папку для установки, а затем в интерфейсе пути напишите и подтвердите команду "cmd"

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

Либо в папке "space-station-14", в интерфейсе пути напишите и подтвердите команду "cmd"

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

dotnet build --configuration Release

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

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

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

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

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

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

Либо в папке "space-station-14", в интерфейсе пути напишите и подтвердите команду "cmd"

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

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

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

Выход в лобби (например чтобы выбрать свободную роль):

respawn

Перезапуск раунда:

golobby

restartroundnow

restartround

Выбор карты:

setmap

forcmap

Начать раунд:

startround

@@ Строка 2: / Строка 2: @@
 == Предварительная подготовка{{Anchor|Программы}} ==
 [[Файл:Download sign.png|64px|link=]] <big><span style="color: #fc0339">Обязательно</span> установите или обновите следующие программы!</big><br>
-<span style="color: #bababa">Без них ваш локальный сервер не будет работать<br><br></span>
+<span style="color: #bababa">Без них ваш локальный сервер не будет работать</span>
-<big>[https://git-scm.com/downloads Git]</big><br>
+<div style="font-size: 25px"><big>[https://git-scm.com/downloads Git]</big></div>
-<big>[https://dotnet.microsoft.com/en-us/download/dotnet/8.0 .NET 8]</big><br>
+<div style="font-size: 25px"><big>[https://dotnet.microsoft.com/en-us/download/dotnet/8.0 .NET 8]</big></div>
-<big>[https://www.python.org/downloads/ Python]</big><br>
+<div style="font-size: 25px"><big>[https://www.python.org/downloads/ Python]</big></div>
-<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: #36a1ff">Python</span> поставьте галочку в пункте "Add python.exe to PATH"{{Anchor|Галочка Python}}<br>
-[[Файл:Фото для локалки3.gif|link=]]
+Если у вас ранее был установлен <span style="color: #36a1ff">Python</span>, то <span style="color: #fc0339"><big>удалите его</big></span> и скачайте с установленной галочкой в пункте "Add python.exe to PATH"
+<div class=nomobile>[[Файл:Фото для локалки3.gif|link=]]</div>
+<div class=mobile>[[Файл:Фото для локалки3.gif|link=|мини]]</div>
 === Как узнать версия Windows 32 бит или 64 бит? ===
 Для установки некоторых программ в Windows нужно знать её разрядность<br><br>
@@ Строка 14: / Строка 16: @@
 #Нажмите на выдаваемый результат поиска
 #В "характеристиках устройства" смотрите информацию в строке где написано "Тип системы"
-[[Файл:Фото для локалки2.png|link=]]
+<div class=nomobile>[[Файл:Фото для локалки2.png|link=]]</div>
 == Установка репозитория ==
-Есть два способа установки локального сервера.<br>
+. Откройте консоль (в Windows в поисковой строке напишите "cmd" или "Командная строка"), введите ''"cd"'' и путь до папки, в которую хотите произвести установку, а дальше подтвердите кнопкой ''"Enter"'':
+  cd C:\''"Название вашей папки"''
-===== Первый и более простой в установке (<big><span style="color: #fc0339">но более неудобный</span></big> для обновления):<br> =====
+Либо выберете папку для установки, а затем в интерфейсе пути напишите и подтвердите команду ''"cmd"'' {{Anchor|cmd в папке}}
-#Перейдите по ссылке на наш репозиторий <big>[https://github.com/Space-Stories/space-station-14 Space-Stories]</big><br> и скачайте ZIP файл[[Файл:Фото для локалки4.png|1000px|link=]]
+<div class=nomobile>[[Файл:Фото для локалки9.gif|1000px|link=]]</div>
-#А затем извлеките из него файлы в нужную для вас папку.<br>
+. В консоли вставьте и подтвердите команду:
-Вот мы и установили репозиторий, но чтобы его обновить, потребуется заново скачивать ZIP файл, а также удалять прошлый репозиторий.<br>
-===== Второй способ (<big><span style="color: #00cb0c">рекомендуемый</span></big>): =====
-. Откройте консоль (в Windows в поисковой строке напишите "cmd" или "Командная строка") и введите "cd" и путь до папки, в которую хотите произвести установку
-например:
-  cd C:\My Programs
-. Подтвердите путь кнопкой "Enter" (левее ввода должен появиться написанный вами путь)<br>
-. А затем пишите:
   git clone <nowiki>https://github.com/Space-Stories/space-station-14</nowiki>
-. Подтвердите кнопкой "Enter" и у вас начнётся установка, во время установки не закрывайте консоль и не выключайте компьютер!
+. Во время установки не закрывайте консоль и не выключайте компьютер!
-== Сборка проекта{{Anchor|Сборка проекта}} ==
+== Заключительный этап{{Anchor|Сборка проекта}} ==
-. Необходимо загрузить подмодуль, для этого запустите файл "RUN_THIS.py" в установленном репозитории<br> [[Файл:Фото для локалки5.png|link=]]<br>
+. Необходимо загрузить подмодули, для этого запустите файл "RUN_THIS.py" (кликните два раза по нему), он находится в папке "space-station-14" (в папку, которую вы ранее указывали) <div> [[Файл:Фото для локалки5.png|link=]] </div>
-. После того как загрузка закончится и консоль закроется переходите в папку с установленным репозиторием по консоли, в моём случае:
+. После того как загрузка закончится и консоль закроется (если она закрывается, то значит что подмодули установились), переходите в папку с установленным репозиторием через консоль:
-  cd C:\My Programs\space-station-14
+  cd C:\''"Название вашей папки"''\space-station-14
-. Если вы собираетесь писать прототипы, то пишите и подтверждайте через "Enter" команду:
+Либо в папке "space-station-14", [[Локальный_сервер#cmd в папке|в интерфейсе пути напишите и подтвердите команду ''"cmd"'']]<br><br>
- dotnet build
+. Теперь нужно собрать проект, для этого напишите и запустите в консоли команду:
-Иначе если вы хотите более стабильную сборку без вылетов, то пишите и подтверждайте через "Enter" команду:
   dotnet build --configuration Release
 . Если после установки в консоли у вас нет ошибок, то значит что сборка выполнена успешно!
@@ Строка 48: / Строка 40: @@
 == Обновление локального сервера ==
-Для обновления локального сервера (если устанавливали вторым способом):<br>
+Для обновления локального сервера:<br>
 . Откройте консоль и введите путь до локального сервера, в моём случае:
-  cd C:\My Programs\space-station-14
+  cd C:\''"Название вашей папки"''\space-station-14
-. Введите и подтвердите кнопкой "Enter" команду:
+Либо в папке "space-station-14", [[Локальный_сервер#cmd в папке|в интерфейсе пути напишите и подтвердите команду ''"cmd"'']]<br><br>
+. Введите и подтвердите кнопкой команду:
   git pull origin master
 . [[Локальный_сервер#Сборка проекта|Пересоберите проект]] (можно не запускать файл "RUN_THIS.py")
@@ Строка 58: / Строка 51: @@
 * Убедитесь что у вас установлены программы: [[Локальный_сервер#Программы|Git | .NET 8 | Python]]  последней версии и подходящей под тип вашей операционной системы
 * Убедитесь что при установке 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 дискорд сервере]
@@ Строка 76: / Строка 60: @@
 . Перейдите по пути:<br>
   space-station-14\bin\Content.Server
-. Откройте файл "server_config.toml" в любом текстовом редакторе<br>
+. Откройте файл ''"server_config.toml"'' в любом текстовом редакторе<br>
 [[Файл:Фото для локалки8.png|link=]]<br>
 . Добавьте и сохраните следующий текст:<br>
@@ Строка 83: / Строка 67: @@
 === Базовые команды ===
 <span style="color: #bababa">Консоль открывается на кнопку "~/Ё"</span>
-*Выход в лобби (чтобы выбрать роль, карту и т.д.):
+*Выход в лобби (например чтобы выбрать свободную роль):
+ respawn
+*Перезапуск раунда:
   golobby
-*Выбрать карту:
+ restartroundnow
+ restartround
+*Выбор карты:
   setmap
-*Перезапустить игру без ожидания окончания раунда:
-  restartroundnow
+  forcmap
 *Начать раунд:
   startround