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

Материал из Space Stories Wiki
 
(не показано 7 промежуточных версий этого же участника)
Строка 2: Строка 2:
== Предварительная подготовка{{Anchor|Программы}} ==
== Предварительная подготовка{{Anchor|Программы}} ==
[[Файл:Download sign.png|64px|link=]] <big><span style="color: #fc0339">Обязательно</span> установите или обновите следующие программы!</big><br>
[[Файл: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"
=== Как узнать разрядность системы Windows? ===
<div class=nomobile>[[Файл:Фото для локалки3.gif|link=]]</div>
<div class=mobile>[[Файл:Фото для локалки3.gif|link=|мини]]</div>
=== Как узнать версия Windows 32 бит или 64 бит? ===
Для установки некоторых программ в Windows нужно знать её разрядность<br><br>
Для установки некоторых программ в Windows нужно знать её разрядность<br><br>
Если вы не знаете то:
Если вы не знаете то:
#Напишите в поисковой строке "О компьютере"<br>[[Файл:Фото для локалки1.png|link=]]
#Напишите в поисковой строке "О компьютере"
#Нажмите на выдаваемый результат поиска
#Нажмите на выдаваемый результат поиска
#В "характеристиках устройства" смотрите информацию в строке где написано "Тип системы"
#В "характеристиках устройства" смотрите информацию в строке где написано "Тип системы"
[[Файл:Фото для локалки2.png|link=]]
<div class=nomobile>[[Файл:Фото для локалки2.png|link=]]</div>
 
== Установка репозитория ==
== Установка репозитория ==
Есть два способа установки локального сервера.<br>
1. Откройте консоль (в 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>
2. В консоли вставьте и подтвердите команду:
Вот мы и установили репозиторий, но чтобы его обновить, потребуется заново скачивать 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" команду:
Либо в папке "space-station-14", [[Локальный_сервер#cmd в папке|в интерфейсе пути напишите и подтвердите команду ''"cmd"'']]<br><br>
dotnet build
3. Теперь нужно собрать проект, для этого напишите и запустите в консоли команду:
Иначе если вы хотите более стабильную сборку без вылетов, то пишите и подтверждайте через "Enter" команду:
  dotnet build --configuration Release
  dotnet build --configuration Release
4. Если после установки в консоли у вас нет ошибок, то значит что сборка выполнена успешно!
4. Если после установки в консоли у вас нет ошибок, то значит что сборка выполнена успешно!
Строка 48: Строка 40:


== Обновление локального сервера ==
== Обновление локального сервера ==
Для обновления локального сервера (если устанавливали вторым способом):<br>
Для обновления локального сервера:<br>
1. Откройте консоль и введите путь до локального сервера, в моём случае:
1. Откройте консоль и введите путь до локального сервера, в моём случае:
  cd C:\My Programs\space-station-14
  cd C:\''"Название вашей папки"''\space-station-14
2. Введите и подтвердите кнопкой "Enter" команду:
Либо в папке "space-station-14", [[Локальный_сервер#cmd в папке|в интерфейсе пути напишите и подтвердите команду ''"cmd"'']]<br><br>
2. Введите и подтвердите кнопкой команду:
  git pull origin master
  git pull origin master
3. [[Локальный_сервер#Сборка проекта|Пересоберите проект]] (можно не запускать файл "RUN_THIS.py")
3. [[Локальный_сервер#Сборка проекта|Пересоберите проект]] (можно не запускать файл "RUN_THIS.py")
Строка 58: Строка 51:
* Убедитесь что у вас установлены программы: [[Локальный_сервер#Программы|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:
# Введите в поиск "Панель управления"
# В поиске панели управления введите и откройте "Программы и компоненты"
В случае с Linux:<br><br>
В консоли введите
rpm -qa | grep .NET SDK
Удалите лишний пакет командой
sudo apt-get remove "имя пакета"
* Попробуйте удалить репозиторий и скачать его заново
* Попробуйте удалить репозиторий и скачать его заново
* Обратитесь за помощью в нашем [https://discord.gg/space-stories дискорд сервере]
* Обратитесь за помощью в нашем [https://discord.gg/space-stories дискорд сервере]
Строка 75: Строка 60:
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>
Строка 82: Строка 67:
=== Базовые команды ===
=== Базовые команды ===
<span style="color: #bababa">Консоль открывается на кнопку "~/Ё"</span>
<span style="color: #bababa">Консоль открывается на кнопку "~/Ё"</span>
*Выход в лобби (чтобы выбрать роль, карту и т.д.):
*Выход в лобби (например чтобы выбрать свободную роль):
respawn
*Перезапуск раунда:
  golobby
  golobby
*Выбрать карту:
 
restartroundnow
 
restartround
*Выбор карты:
  setmap
  setmap
*Перезапустить игру без ожидания окончания раунда:
 
  restartroundnow
  forcmap
*Начать раунд:
*Начать раунд:
  startround
  startround

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

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

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

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

Обязательно!!! перед установкой 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:\"Название вашей папки"

Либо выберете папку для установки, а затем в интерфейсе пути напишите и подтвердите команду "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