Текущая версия от 20:05, 18 января 2025

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

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

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

.NET 9 (SDK последней версии, находится выше и левее остальных)

Python (с включённой галочкой на "Add python.exe to PATH")

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

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

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

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

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

2. Далее используйте команду

git clone https://github.com/MetalSage/space-stories-14

3. Во время установки не закрывайте консоль и не выключайте компьютер!
3.1 Если установка прервалась, то повторите команду "git clone https://github.com/MetalSage/space-stories-14" в нужной для вас папке

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

1. Запустите файл "RUN_THIS.py" (кликните два раза по нему), он находится в папке "space-stories-14" (в папке куда устанавливали)

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

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

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

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

dotnet build --configuration Release

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

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

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

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

Для обновления локального сервера:

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

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

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

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

git pull origin master

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

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

Убедитесь что у вас установлены программы: Git | .NET 9 | Python последней версии и подходящей под тип вашей операционной системы
Убедитесь что у вас установлена только одна версия .NET 9 (они иногда могут конфликтовать), в установленном виде она называется: "Microsoft .NET SDK"
Если выдаёт около 23 ошибок:
- Переустановите Python с включённой галочкой "Add python.exe to PATH"
- Запустите файл "RUN_THIS.py" повторно
  (иногда может недоcкачать файлы из-за плохого интернета или при проблеме соединения с github)
Попробуйте удалить репозиторий и скачать его заново
Обратитесь за помощью в нашем дискорд сервере

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

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

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

space-stories-14\bin\Content.Server

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

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

[game]
role_timers = false

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

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

Выход в лобби без окончания текущего раунда

respawn

Выход в лобби с окончанием раунда

golobby

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

restartroundnow

restartround

Выбор карты

setmap "название карты"

forcmap "название карты"

Начать раунд

startround

Запустить ивент (призыв дракона, ниндзя, одинокого оперативника и т.п.)

addgamerule "название режима"

@@ Строка 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/ru-ru/download/dotnet/9.0 .NET 9]</big> (SDK последней версии, находится выше и левее остальных)</div>
-<big>[https://www.python.org/downloads/ Python]</big><br>
+<div style="font-size: 25px"><big>[https://www.python.org/downloads/ Python]</big> (с включённой галочкой на "Add python.exe to PATH")</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>
-Для установки некоторых программ нужно знать разрядность Windows<br><br>
+<div class=mobile>[[Файл:Фото для локалки3.gif|link=|мини]]</div>
-Если вы не знаете то:
-#Напишите в поисковой строке "О компьютере"<br>[[Файл:Фото для локалки1.png|link=]]
-#Нажмите на выдаваемый результат поиска
-#В "характеристиках устройства" смотрите информацию в строке где написано "Тип системы"
-[[Файл:Фото для локалки2.png|link=]]
 == Установка репозитория ==
-Есть два способа установки локального сервера.<br>
+. Откройте консоль (в Windows в поисковой строке напишите "cmd" или "Командная строка"), введите ''"cd"'' и путь до папки, в которую хотите произвести установку (лучше чтобы путь до папки и сама папка были на английском)
+ cd C:\''"Название вашей папки"''
+Либо выберете папку для установки, а затем в интерфейсе пути напишите и подтвердите команду ''"cmd"'' как показано ниже {{Anchor|cmd в папке}}
+<div class=nomobile>[[Файл:Фото для локалки9.gif|link=]]</div><br>
+. Далее используйте команду
+ git clone <span style="pointer-events: none;">{{Ссылки сообщества|github}}</span>
+. Во время установки не закрывайте консоль и не выключайте компьютер!<br>
+.1 Если установка прервалась, то повторите команду "git clone <span style="pointer-events: none;">{{Ссылки сообщества|github}}</span>" в нужной для вас папке
-===== Первый и более простой в установке (<big><span style="color: #fc0339">но более неудобный</span></big> для обновления):<br> =====
+== Заключительный этап ==
-#Перейдите по ссылке на наш репозиторий <big>[https://github.com/Space-Stories/space-station-14 Space-Stories]</big><br> и скачайте ZIP файл[[Файл:Фото для локалки4.png|1000px|link=]]
+. Запустите файл "RUN_THIS.py" (кликните два раза по нему), он находится в папке "space-stories-14" (в папке куда устанавливали) <div> [[Файл:Фото для локалки5.png|link=]] </div>
-#А затем извлеките из него файлы в нужную для вас папку.<br>
+. После того как загрузка закончится и консоль закроется (если она закрывается, то значит что всё установилось), переходите в папку с установленным репозиторием через консоль:
-Вот мы и установили репозиторий, но чтобы его обновить, потребуется заново скачивать ZIP файл, а старый удалять.<br>
+  cd C:\''"Название вашей папки"''\space-stories-14
+Либо в папке "space-stories-14", [[Локальный_сервер#cmd в папке|в интерфейсе пути напишите и подтвердите команду ''"cmd"'']]<br><br>
-===== Второй способ: =====
+. Теперь нужно собрать проект, для запустите в консоли команду {{Anchor|Сборка проекта}}
-. Откройте консоль (в Windows в поисковой строке напишите "cmd" или "Командная строка") и введите "cd" и путь до папки, в которую хотите произвести установку
-например:
- cd C:\My Programs
-. Подтвердите путь кнопкой "Enter" (левее ввода должен появиться написанный вами путь)<br>
-. А затем пишите:
- git clone <nowiki>https://github.com/Space-Stories/space-station-14</nowiki>
-. Подтвердите кнопкой "Enter" и у вас начнётся установка, во время установки не закрывайте консоль и не выключайте компьютер!
-== Сборка проекта{{Anchor|Сборка проекта}} ==
-. Необходимо загрузить подмодуль, для этого запустите файл "RUN_THIS.py" в установленном репозитории<br> [[Файл:Фото для локалки5.png|link=]]<br>
-. После этого в консоли переходите в папку с установленным репозиторием, в моём случае:
-  cd C:\My Programs\space-station-14
-. Если вы собираетесь писать прототипы, то пишите и подтверждайте через "Enter" команду:
- dotnet build
-Иначе если вы хотите более стабильную сборку без вылетов, то пишите и подтверждайте через "Enter" команду:
   dotnet build --configuration Release
 . Если после установки в консоли у вас нет ошибок, то значит что сборка выполнена успешно!
@@ Строка 48: / Строка 35: @@
 == Обновление локального сервера ==
-Для обновления локального сервера (если устанавливали вторым способом):<br>
+<big>Для обновления локального сервера:</big> <br>
 . Откройте консоль и введите путь до локального сервера, в моём случае:
-  cd C:\My Programs\space-station-14
+  cd C:\''"Название вашей папки"''\space-stories-14
-. Введите и подтвердите кнопкой "Enter" команду:
+Либо в папке "space-stories-14", [[Локальный_сервер#cmd в папке|в интерфейсе пути напишите и подтвердите команду ''"cmd"'']]<br><br>
+. Введите и подтвердите кнопкой команду
   git pull origin master
 . [[Локальный_сервер#Сборка проекта|Пересоберите проект]] (можно не запускать файл "RUN_THIS.py")
-== Частые проблемы ==
+== Если возникли проблемы ==
-* Убедитесь что у вас установлены программы: [[Локальный_сервер#Программы|Git | .NET 8 | Python]]  последней версии
+* Убедитесь что у вас установлены программы: [[Локальный_сервер#Программы|Git | .NET 9 | Python]]  последней версии и подходящей под тип вашей операционной системы
-* Убедитесь что при установке Python вы поставили галочку в пункте [[Локальный_сервер#Галочка Python|"Add python.exe to PATH"]]
+* Убедитесь что у вас установлена только одна версия .NET 9 (они иногда могут конфликтовать), в установленном виде она называется: ''"Microsoft .NET SDK"''<br>
-* Убедитесь что у вас установлена только одна версия .NET 8 (они иногда могут конфликтовать)<br>
+* Если выдаёт около 23 ошибок:
-В случае если у вас Windows:
+** Переустановите Python с включённой галочкой [[Локальный_сервер#Галочка Python|"Add python.exe to PATH"]]
-#Введите в поиск "Панель управления"
+** Запустите файл "RUN_THIS.py" повторно<br> (иногда может недоcкачать файлы из-за плохого интернета или при проблеме соединения с github)
-#поиске панели управления введите и откройте "Программы и компоненты"
-У вас должен быть только один "Microsoft .NET SDK"
 * Попробуйте удалить репозиторий и скачать его заново
+* Обратитесь за помощью в нашем [{{Ссылки сообщества|discord}} дискорд сервере]
 = Дополнительная информация =
@@ Строка 69: / Строка 57: @@
 Чтобы открыть все роли:<br>
 . Перейдите по пути:<br>
-  space-station-14\bin\Content.Server
+  space-stories-14\bin\Content.Server
-. Откройте файл "server_config.toml" в любом текстовом редакторе<br>
+. Откройте файл ''"server_config.toml"'' в любом текстовом редакторе<br>
 [[Файл:Фото для локалки8.png|link=]]<br>
 . Добавьте и сохраните следующий текст:<br>
@@ Строка 77: / Строка 65: @@
 === Базовые команды ===
 <span style="color: #bababa">Консоль открывается на кнопку "~/Ё"</span>
-*Выход в лобби (чтобы выбрать роль, карту и т.д.):
+*Выход в лобби без окончания текущего раунда
+ respawn
+*Выход в лобби с окончанием раунда
   golobby
-*Выбрать карту:
- setmap
+*Перезапуск раунда
-*Перезапустить игру без ожидания окончания раунда:
   restartroundnow
-*Начать раунд:
+ restartround
+*Выбор карты
+ setmap "''название карты''"
+ forcmap "''название карты''"
+*Начать раунд
   startround
+*Запустить ивент (призыв дракона, ниндзя, одинокого оперативника и т.п.)
+ addgamerule "''название режима''"