Версия от 14:55, 4 января 2025

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

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

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

.NET 8 (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 8 | Python последней версии и подходящей под тип вашей операционной системы
Убедитесь что у вас установлена только одна версия .NET 8 (они иногда могут конфликтовать), в установленном виде она называется: "Microsoft .NET SDK"
Если выдаёт около 23 ошибок:
- Убедитесь что при установке Python вы поставили галочку в пункте "Add python.exe to PATH", либо переустановите Python с включённой галочкой
- Запустите файл "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 "название режима"

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