SS220 - Вклад [ru]

Руководство по разработке

2024-04-23T23:49:27Z

Aloe: Почему у нас была ссылка на труп? Не знаю! Теперь не будет.

<div style="width:99%" class="toccolours">
<span style="font-size:1.8em;">'''Пособие к Paracode: Гайд'''</span>[[Файл:IconConstruction.png|справа]]<br>
<span style="font-size:1.2em;">
Это руководство предназначено для обучения новичков успешной работе с '''Paracode.'''<br>
Пожалуйста, прочитайте гайд полностью от верха до низа.
{{toc_right}}
'''Чтобы максимально удобно и эффективно вносить изменения в код вам будут нужны эти три вещи:'''
# Текстовый редактор (VSCode крайне рекомендован)
# Github
# Сам BYOND редактор - Dream Maker

== Быстрая навигация ==
<span style="font-size:1.4em;">[[#Я абсолютный новичок|Я абсолютный новичок]]</span> <br>
[[#Малые изменения|Я хочу внести малые изменения или/и я спрайтер]] <br>

=== Рабочее пространство ===
* [[#Устанавливаем и настраиваем Visual Studio Code|Мне нужно установить\настроить VS Code]]
* [[#Установка и настройка Github|Мне нужно настроить Git/Github]]
* [[#Настройка и использование Github Desktop|Я хочу использовать Github Desktop (Дружелюбно к новичкам)]]
* [[#Setting up & Using TortoiseGit|Я хочу использовать TortoiseGit (Не для новичков)]]
* [[#Forking ParaCode|Я загрузил всё вышеперечисленное, как мне получить и настроить репозиторий?]]

=== Внесение изменений ===
* [[#Делаем изменения|Ок, у меня есть конфигурация репозитория, как мне менять содержимое?(Pull Requests)]]
* [[#Учимся кодить|Ок, я завершил настройку своих изменений! Как мне закодировать/внести вклад на сервер?]]
* [[#Делаем Pull Request (ПР)|Как мне создать Pull Request и отправить свои изменения через Desktop GitHub?]]
* [[#Как делать предложения правок на GutHub|Я заметил ошибку, как о ней сообщить?]]

=== Работа с редакторами ===
* [[Руководство по маппингу|У меня образование архитектора космический станций и я хочу внести изменения на карту]]
* [[Руководство по спрайтингу|Я свободный художник-академик и хочу поработать со спрайтами]]

=== Дополнительно ===
* [[#Учимся использовать TGUI|Как использовать TGUI для создания красивых интерфейсов?]]
* [[Как делать перевод игры]]?
* [[Запуск локального сервера|Как запустить локалку через Dream Daemon?]]
* [[Запуск локального сервера#Запуск по кодерски|Как запустить локалку через VSC?]]

=== Для продвинутых ===
* [[Настройка базы данных|Настройка БД на локалке]]
* [[Структура кода SS13]]
* [[Форматирование текста]]
* [[SS13 для опытных программистов]]
----
Вы также можете помочь с переводом гайдов и их дополнением для будущих потомков: [[Руководство по редактированию вики]]

==Я абсолютный новичок==
Итак, вы в ситуации, с которой сталкивался каждый разработчик Paradise. Как мне научиться работать и привносить свой вклад? Как мне добавить свой код к коду сервера? Что ж, тут несколько шагов, как начать работу и загрузить ресурсы.

Просто прочитайте этот гайд пока не дойдёте до конца. Пока вы следуете этим шагам всё должно быть в порядке!

<center>[[File:ContributingFlowchartRU.png|800px]]</center>

==Малые изменения==
Возникают ситуации, когда вы являетесь спрайтером или человеком, которому нужно поменять всего пару значений, а кодера по таким пустякам дергать не хочется. Да и зачем накидывать на кодеров такую работу, если можно сделать самому, правильно? <br>
В этом плане вам повезло, так как это руководство и создано для новичков и тех, кто никогда не работал с кодом или трогал только конфиги в разных играх. Выше находится [[#Я абсолютный новичок|гайд для новичков]], в нём по пунктам объяснено как вам нужно вклиниваться в разработку для занесения изменений. <br>
После того как вы освоите базу для внесения изменений, вы сможете тратить буквально минуты на свои собственные идеи и быть действительно полезным. А у "более крутых кодеров" будет больше времени на крупные фичи, фиксы и рефакторы. <br>
Самостоятельность - это хорошо.

Если вкратце по пунктам описать что вам потребуется:
* [[#Устанавливаем и настраиваем Visual Studio Code|Visual Studio Code]] - для внесения изменений
* [[#Настройка и использование Github Desktop|GitHub Desktop]] - для загрузки изменений
* [[#Forking ParaCode|Репозиторий]] - ваш личный билд куда вы вносите изменения
* [[#Делаем Pull Request (ПР)|Pull Request]] - для добавления изменений в основной билд
* Дождаться правок после внесения изменений в основной билд, если они будут
* Ждать, пока изменение не зальют на основной билд.
* ...
* Profit!

При внесении малых изменений, наподобие уменьшения урона у оружия, добавления другой иконки, изменения описания/названия, обязательно убедитесь, что всё корректно работает и именно так как вы и хотели, и вы ничего лишнего не затронули.

<div class="toccolours mw-collapsible mw-collapsed" style="width:99%;">
<span style="font-size:1.2em;">'''Как может затронуться что-то лишнее?'''</span><br>
<div class="mw-collapsible-content">
Вы можете допустить опечатку, случайно поставить пробел не в том месте. В любом случае, Github Desktop покажет вам все ваши изменения и вы сможете увидеть, где могли допустить ошибку. <br>
Но также, у предмета есть "наследование", и все его внутренние переменные передаются его детям, что может внести изменения также и другим вещам. Возьмем например два предмета (родитель и дочь) с путями <code>food/cake</code> и <code>food/cake/chocolate</code>. Нам нужно изменить им описание <code>desc</code>. У первого предмета в коде написан <code>desc</code>, когда у второго он не написан. Это означает что описание предмета <code>food/cake/chocolate</code> будет взято(наследоваться) у <code>food/cake</code>, и все изменения этого предмета будут также влиять на дочерние. Чтобы этого избежать, вам всего-лишь нужно добавить дочерним предметам недостающую переменную со значениями, если вы не хотите чтобы они тоже менялись.
</div></div>

<div class="toccolours mw-collapsible mw-collapsed" style="width:99%;">
<span style="font-size:1.2em;">'''Пример: Добавление одежды для должности интерна'''</span><br>
<div class="mw-collapsible-content">
Вы дошли до внесения изменений, но еще не внесли сами изменения, так как не понимаете как? Вы хотите добавить одежду или изменить её, но запутались что именно вам нужно делать? Тогда данный пункт гайда для вас. В нём мы разберем как сделать одно из простейших изменений, а также продемонстрируется интересная фича.

Возьмём в пример одежду доктора и сделаем из неё новую одежду для интерна, на английском мы знаем что название профессии Medical Doctor. Воспользуемся поиском VSC, чтобы найти его одежду. <br>
[[File:MakeClothes1.png]]

Находим одежду <code>medical doctor's jumpsuit</code> в файле <code>medsci.dm</code>. Перейдем к самому файлу и посмотрим что в нём находится. <br>
[[File:MakeClothes2.png]]

Разберем по порядку:
* /obj/item/clothing/under/rank/medical - путь нашего объекта, который наследует всё что в нём написано, наследует методы и параметры одежды <code>/clothing/</code>, типа предмета <code>/item/</code> и типа объекта <code>/obj/</code>.
* '''name''' - название нашей одежды
* '''desc''' - описание нашей одежды метода предмета <code>/item/</code>
* '''icon_state''' - название иконки лежащей на земле или в инвентаре, которая берется из файла <code>'icons/obj/clothing/uniforms.dmi'</code>
* '''item_color''' - название нашего слоя одежды на мобе, который берется из файла <code>'icons/mob/uniform.dmi'</code>. 4 спрайта в одном файле для каждого из 4-х направлений (Север, Восток, Запад, Юг)
* '''permeability_coefficient''' - коэффициент проницаемых болезней в тело куклы. 1 - обычная величина. А 0.5 - уменьшенная проницаемость (лучше стойкость)
* '''armor''' - коэффициенты защиты одежды. В нашем случае он слегка устойчив к биозаражению (10). 100 - максимальная величина.

Теперь сделаем одежду, наследующую все переменные с нашей докторской одежды, чтобы у неё тоже были те же данные с коэффициентами проницаемости и бронёй, но при этом другая иконка и название. <br>
Создадим в коде одежду интерна: <br>
[[File:MakeClothes3.png]]

Разберем по порядку
* /obj/item/clothing/under/rank/medical'''/intern''' - создаем новый тип объекта, путем добавления <code>/intern</code> к пути изначального объекта. Благодаря этому он наследует всё что было определено в объектах по этим путям.
* '''name''' - новое название нашей одежды. Теперь это одежда интерна.
* '''icon_state''' - название иконки одежды нашего интерна добавленного в файл.
* '''item_color''' - название слоя нашей одежды на кукле, который мы добавили в файл

Теперь разберем как добавлять файлы одежды.
Для начала откроем необходимый нами файл, находящиеся по заданным путям, в данном случае мы возьмём за пример слой одежды на кукле, находящийся по пути <code>'icons/mob/uniform.dmi'</code>. <br>
[[File:MakeClothes4.png]]

После открытия файла, необходимо теперь найти одежду доктора по известному нам названию слоя <code>"medical"</code> <br>
[[File:MakeClothes5.png]]

Экспортируем (скачаем) слой одежды. <br>
[[File:MakeClothes6.png]]

Изменяем наш слой одежды через редакторы, конвертируя файл в .png или в самом Dream Maker. Но спрайтеры рекомендуют использовать Asperite

Если вы начинающий спрайтер, то не забудьте ознакомиться с [[Руководство по спрайтингу|руководством для спрайтеров]]. Он поможет вам соориентироваться в поиске файлов. <br>
Если у вас остаются вопросы, вы хотите продвинутой разработки и гайд вам в этом уже не помогает, вы всегда можете обратиться за помощью к другим начинающим разработчикам, спрайтерам и кодерам. <br>

Новая одежда интерна и её иконка: <br>
[[File:MakeClothes7.png]]

После того, как новая одежда была создана, нам необходимо её импортировать (загрузить): <br>
Это не обязательно, если одежда уже была нарисована в файле с помощью Копирования Dream Maker. <br>
Для иконки мы проделываем тоже самое в его пути. <br>
[[File:MakeClothes8.png]]

Результат импортирования: <br>
Не забудьте сохранить файл. Горячие клавиши сохранения: '''Ctrl + S'''. Если на файле присутствует знак звездочки *, это означает что файл не сохранен. <br>
[[File:MakeClothes9.png]]

Теперь необходимо проверить, нормально ли отрисовывается одежда на кукле при надевании. <br>
[[Запуск локального сервера#Запуск по кодерски|Чтобы проверить, необходимо запустить локалку.]] <br>

Если локалка правильно настроена и у вас появились "щитспавн кнопки", откройте Game Panel, где вы сможете заспавнить нужный вам объект, в нашем случае мы в спавн объектов вписываем путь нашего предмета: <code>/obj/item/clothing/under/rank/medical/intern</code>. <br>
На самом деле достаточно вписать только <code>/intern</code> и он сразу выдаст вам все похожие варианты объектов на это слово. <br>
[[File:MakeClothes10.png]]

Теперь оденем нашу куклу и проверим всё ли стабильно отрисовывается и нет ли никаких артефактов (например полупрозрачные символы, которые вы случайно могли оставить). <br>
Сравним его также с обычной одеждой доктора. <br>
[[File:MakeClothes11.png]]

Добавление одежды успешно. Слой стабильно отрисовывается и нас всё устраивает. <br>
Теперь можно переходить к пункту загрузки изменений и добавить новую одежду интерна в билд. <br>

<div class="toccolours mw-collapsible mw-collapsed" style="width:99%;">
<span style="font-size:1.2em;">'''Интересная фича'''</span><br>
<div class="mw-collapsible-content">
Вы можете сделать одежду для альтернативных названий должностей, для этого вам предстоит зайти в файлы профессий находящиеся по пути <code>"code/game/jobs/job/"</code> <br>
В этой папке находятся файлы, которые определяют, во что будет одета та или иная должность и её должностные свойства. <br>
Возьмём всё также в пример файл медицинских должностей: <code>"code/game/jobs/job/medical.dm"</code> <br>

Находим интересующую нас должность или добавляем новую. В случае должности интерна это будет выглядеть так: <br>
[[File:MakeClothes12.png]]

У должности интерна определяется во что он будет одет: <code>outfit = /datum/outfit/job/doctor/intern</code>

Определяются альтернативные названия: <code>alt_titles = list("Student Medical Doctor", "Medical Assistant")</code>

Для каждого слота доступного игроку, определяется во что будет одета кукла при заходе на должность. <br>
Так как должность интерна наследуется от должности доктора, то он одевается сначала в него, а потом в то, что определяется по новому пути. <br>
Так, униформа от доктора у него будет отличаться и он будет одет в новую одежду для интерна: <br>
<code>uniform = /obj/item/clothing/under/rank/medical/intern</code> <br>

Для альтернативных названий, с помощью копирования данного кода с заданием пути, возможно определить, во что будет одета альтернативная должность: <br>
[[File:MakeClothes13.png]]

В данном коде указывается, что "Medical Assistant" будет одет в униформу <code>/obj/item/clothing/under/rank/medical/intern/assistant</code> <br>
А "Student Medical Doctor" будет одет в специальную светло-зеленый комплект одежды с головой <code>head</code> и униформой <code>uniform</code>
</div></div>
</div></div>

<div class="toccolours mw-collapsible mw-collapsed" style="width:99%;">
<span style="font-size:1.2em;">'''Пример: Модуль'''</span>
<div class="mw-collapsible-content">

И так, мы добавили нашу одежду. Но разработчики говорят непонятное слово "модуль" без которого не примут наш ПР. Что же это такое?

Модуль в данном случае - это возможность объединить изменения двух билдов, путем накладывания изменений одного билда на билд-родитель, без прямого изменения кода билда-родителя чтобы уберечь нас от будущих проблем с кодом (мерж-конфликты).

В этом нет ничего сложного, особенно если вы не делаете что-то новое, а просто добавляете всё ту же одежду интерна, что мы и сделали выше.

'''Краткий гайд как вносить изменения через модуль:'''

# Определяем что за изменение мы вносим и к чему оно относится.
# Находим или создаем папку с модулем в<code>/modular_ss220/</code> для нашего изменения.
## Если создаем, то также вписываем нашу папку с модулем в <code>/modular_ss220/modular_ss220.dme</code>
# Вносим изменение в папку с нашим модулем <code>/modular_ss220/'название_модуля/'</code>
# ...
# Profit!

'''Подробный гайд как вносить изменения через модуль:'''

<div class="toccolours mw-collapsible mw-collapsed" style="width:99%;">
<span style="font-size:1.2em;"><u>Определение типа изменения</u></span>
<div class="mw-collapsible-content">

И так, чтобы начать, нам нужно определиться, что у нас за изменение. В нашем случае это одежда интерна, значит это одежда (clothing).
Но какой у него может быть тип для нашего модуля? Абсолютно такой же, как если бы он был изменением вне модуля.

Всё очень просто. Одежда в одежду. Изменения работ - к работам. Добавление новых объектов - к объектам и тому подобное.

<u>Но у меня нестандартная ситуация!</u>

Что-ж. Представим что нашей одежды не существует как абстрактного класса и вообще это кусок информации, а не объект. Что же тогда нам делать и как определить его тип?

Для этого нам нужно выделить главное сходство наших изменений которые мы вносим. В нашем случае мы хотим чтобы гуманоиды носили одежду и поэтому добавляем их. Это могут быть штаны, очки, ботинки, верх одежды и т.п. Что их объединяет? Их нужно носить, это одежда, они для мобов. Но добавили мы сами объекты одежды, не мобов, не возможность ношения, а только одежду. Значит останавливаемся на типе "одежда" - это и будет наш тип для нашего нового модуля "clothing".

</div></div>
<div class="toccolours mw-collapsible mw-collapsed" style="width:99%;">
<span style="font-size:1.2em;"><u>Модульная папка</u></span>
<div class="mw-collapsible-content">

Мы определили что наш тип изменений относится к одежде, значит нам нужно либо создать, либо найти папку модуля "clothing".
Давайте проверим, существует ли такая папка уже? Через Visual Studio Code нажмем горячие клавиши '''Ctrl + P''', открыв "поиск по файлам", пишем туда наш тип, проверяем что он нам выдал.

[[Файл:CtrlP clothing.png|безрамки|701x701пкс]]

И так, у нас 2 файла и оба "clothing". Смотрим рядом путь куда он ведет. Нам повезло! Такой модуль уже существует и на это указывает <code>modular_ss220\clothing</code>

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

<u>Модульной папки не существует</u>[[Файл:Example code modular.png|мини]]И такое бывает, значит мы создадим наш новый, в этом ничего сложного.

# Нам необходимо найти модульную папку <code>modular_ss220/example</code> и всё через тот же поиск '''Ctrl + P''' или инспектор файлов (EXPLORER), по умолчанию находящийся слева.
# Выделяем нашу всю модульную папку <code>modular_ss220/example</code> и дублируем её, копируя '''Ctrl + C''' и вставляя '''Ctrl + V''' в общий модуль. Путь скопированной папки: <code>modular_ss220/example copy</code> - убедитесь, что папка правильно расположена и это её путь.
# Переименовываем файлы, в нашем случае в clothing Путь переименованной папки: <code>modular_ss220/clothing</code>
# В файле <code>modular_ss220/clothing/_clothing.dme</code> переименовываем "example" в "clothing". Так мы подключили наши файлы к нашей модульной папке.
# Добавляем строку пути к нашему файлу в основном модуле <code>/modular_ss220/modular_ss220.dme</code>

И на этом всё.

[[Файл:Example code module rename2.png|безрамки|423x423пкс]]

<u>Подробнее о файлах:</u>

<code>/modular_ss220/modular_ss220.dme</code> - файл, подключающий все модули для работы их с билдом. Сюда добавляются модульные <code>.dme</code>

<code>/modular_ss220/example/_example.dme</code> - файл, подключающий все наши файлы с кодом <code>.dm</code> в этом модуле.

<code>/modular_ss220/example/_example.dm</code> - файл, в котором хранится информация о нашем модуле. Его название, кто автор. В дальнейшем это отображается в modpack'е в игре.

Здесь же хранятся файлы инициализации на случай, если вам нужно дополнить глобальные списки.

</div></div>
<div class="toccolours mw-collapsible mw-collapsed" style="width:99%;">
<span style="font-size:1.2em;"><u>Изменение в модуль</u></span>
<div class="mw-collapsible-content">

И так, у нас есть модульная папка и мы знаем куда и что делать. Что дальше? А собственно всё. Дальше начинается всё та же разработка как и везде.
Ну почти.

<div class="toccolours mw-collapsible mw-collapsed" style="width:99%;">
<span style="font-size:1.2em;"><u>Как добавить новый объект?</u></span>
<div class="mw-collapsible-content">

Точно также как и объекты вне модуля, только в наш модуль. Создавайте для них них папки, файлы и не забывайте вносить их в ваш модульный <code>.dme</code>
</div>
</div><div class="toccolours mw-collapsible mw-collapsed" style="width:99%;">
<span style="font-size:1.2em;"><u>Как внести изменения в уже имеющийся объект?</u></span>
<div class="mw-collapsible-content">

А вот здесь уже интереснее, всё зависит от того какого типа изменения.

<u>Изменения переменной</u>

Представим что нам нужно изменить униформу <code>/obj/item/clothing/under/rank/civilian/chef</code>

Для этого в коде мы пишем:

<code>/obj/item/clothing/under/rank/civilian/chef</code>

И далее что хотим изменить, например новую иконку, имя и описание:

<code>/obj/item/clothing/under/rank/civilian/chef</code>

<code> name = "chef's red uniform"</code>

<code> desc = "Униформа повара с пуговицами на одну сторону."</code>

<code> icon = 'modular_ss220/clothing/icons/object/under.dmi'</code>

<code> icon_state = "chef_red"</code>

<code> item_color = "chef_red"</code>

<code> sprite_sheets = list(</code>

<code> "Human" = 'modular_ss220/clothing/icons/mob/under.dmi',</code>

<code> "Vox" = 'modular_ss220/clothing/icons/mob/species/vox/under.dmi',</code>

<code> )</code>

Как видите, ничего особенного, всё тоже самое. Теперь объект будет тот же самый, но с нашими новыми значениями.

Также важно приметить путь 'icon', для него вам необходимо писать полный путь к вашему файлу с иконкой.

<u>Внесение дополнительных значений в список</u>

Но что делать если у объекта имеется список, например:

<code>/obj/item/example</code>

<code> var/list/example_list = list(item1, item2, item3)</code>

К сожалению, но нам нельзя просто так в переопределении этого объекта в нашем модуле написать знак равно <code>=</code>, ведь нам нужно сохранить элементы в списке, мы же не хотим просто так дублировать код, верно? Для этого есть изящное решение, мы вносим наши значения прямо во время загрузки этого объекта при инициализации:

<code>/obj/item/example/Initialize(mapload)</code>

<code> . = ..()</code>

<code> example_list |= list(item4, item5, item6)</code>

И так, что мы делаем?

<code>Initialize(mapload)</code> - функция определения перед спавном объекта. В этот момент у нас уже есть все загруженные переменные и списки, соответственно мы добавляем новые в уже существующие.

<code>. = ..()</code> - наследование от родителя. НЕОБХОДИМАЯ вещь для нашего модуля, так как позволяет вносить изменения в функции с сохранением её работы. Вызывать её мы можем в любом месте нашего кода. Мы с его помощью Задаем текущее состояние состоянием родителя.

<code>.</code> - текущее исполнение и определение состояния функции TRUE/FALSE/значения.

<code>..()</code> - функция исполнения родителя

<code>example_list |= list()</code> - мы добавляем к имеющемуся списку наш список с элементами.

<u>Изменение функции</u>

Будь то функция инициализации или любая другая функция <code>/proc/</code>

Разницы абсолютно никакой с тем же что мы сделали в примере выше.

Представим что у нас есть функция которую нам нужно изменить:

<code>/obj/item/example/proc/do_thing()</code>

Наше решение - это вызвать эту же функцию, вызвать её наследование и после дописать наш код.

Например:

<code>/obj/item/example/do_thing()</code>

<code> . = ..()</code>

<code> do_our_thing()</code>

В данном случае функция сначала исполнит родителя, а уже потом выполнит наш код.

<code>/obj/item/example/do_thing()</code>

<code> do_our_thing()</code>

<code> . = ..()</code>

Теперь функция сначала выполнит наш код, а уже потом код родителя.

<code>/obj/item/example/do_thing()</code>

<code> if(!..()) // или по другому можно написать: if(..() == FALSE)</code>

<code> return</code>

<code> do_our_thing()</code>

Теперь, если наша родительская функция вернет значение <code>FALSE</code>, то мы прерываем выполнение функции с помощью <code>return</code> и не выполняем нашу часть кода.

</div>
</div>
</div>
</div>
</div>
</div>

==Устанавливаем и настраиваем Visual Studio Code==
=== Установка VScode===

* Идём на вебсайт VSCode's: https://code.visualstudio.com/
* Загружаем и устанавливаем актуальную версию.

=== Установка VSCode плагинов===
Когда вы откроете Paradise репозиторий, у вас появится уведомление об установке некоторых рекомендованных дополнений, они просто устанавливаются по данному алгоритму

* Перейдите на вебсайт VScode и загрузите плагины
* Нажатие "Установка" перенаправит вас в VSCode где вы можете установить и перезагрузить его

Вот пара плагинов, которые крайне полезны для кодинга в DM
* Подсветка синтаксиса: https://marketplace.visualstudio.com/items?itemName=gbasood.byond-dm-language-support
* Поиск символов: https://marketplace.visualstudio.com/items?itemName=platymuus.dm-langclient
</div>
<br>
<div class="toccolours mw-collapsible" style="width:99%">
==Установка и настройка Github==
Эта часть про установку и настройку Git и созданию Github аккаунта.
===Установка Git Bash===
* Переходим: http://git-scm.com/downloads
* Загружаем Windows Git программу, подходящую вашей операционной системе (оно должно будет выглядеть как "Git-2.18.0-64-bit.exe")
* Устанавливаем его и оставляем всё в стандартном режиме (просто пропускаем всё кнопкой next).
* Дожидаемся конца установки.
* Готово!
===Регистрируемся в Git===
(Пропустите, если у вас уже есть аккаунт)
Вам нужен будет аккаунт, чтобы привносить изменения в репозиторий (Место, где хранится код) должным образом.
* Переходим: https://github.com/
* Нажимаем '''Sign up''' в правом верхнем углу.
* Вводим свою почту
* Придумываем пароль
* Создаём себе крутой ник
* Соглашаемся или отказываемся от рассылки.
* Решаем капчу и создаём аккаунт!
* Готово!

===Скрываем свою почту (Опционально, рекомендуется)===
Некоторые из вас не захотят показывать в своём резюме, что они работали над какими-то сомнительными проектами. Или более приближённо, сообщество SS13 мрачно и полно ужасов, и вам захочется защитить свою почту (или использовать подставную почту в первую очередь).

О, и вам наверняка захочется редактировать ERP сервера под альтернативным именем.

По умолчанию включено, но лучше перестраховаться
* Заходим в аккаунт на Github
* В правом верхнем углу нажимаем на свой профиль
* Появится список, выбираем "настройки"
* Переходим к Emails
* Включаем настройку Keep my email addresses private. Теперь Github будет использовать безответны письма при операциях.
* Теперь вы защищены лучше!

===Настраиваем Git (Опционально)===
* Переходим: https://help.github.com/articles/set-up-git/#setting-up-git
* Следуя гайду выше, вы можете установить Git для Windows если хотите, однако это не рекомендуется
* Теперь у вас есть полностью настроенный Git, но если вы неграмотны в написании кода, как я, то вам захочется иметь какую-нибудь причудливую графику!

===Дополнительная помощь===
<div class="toccolours mw-collapsible mw-collapsed" style="width:99%;">
<span style="font-size:1.2em;">'''Вспомогательные видео (на английском) для лучшего понимания Github'''</span><br>
<div class="mw-collapsible-content">
<span style="font-size:1.4em;">[https://www.youtube.com/watch?v=ZDR433b0HJY Введение в Git с Scott Chacon от GitHub]<br>[https://www.youtube.com/watch?v=MYP56QJpDr4 Git from bits up]<br>
[https://www.youtube.com/watch?v=4XpnKHJAok8 Linus Torvalds (Тот парень, которой изобрёл Linux и Git)]</span>
</div></div></div>
<br>
<div class="toccolours mw-collapsible" style="width:99%">
==Форк кода Парадайза==

;Репозиторий
:Версия кода, может быть один или несколько оригинальных, на которых собирается проверенный на других репозиториях код.

;Форкинг
:Создание своего ответвления от оригинального кода, создание репозитория

Теперь посетите [https://github.com/ss220club/Paradise-SS220 Paradise Github репозиторий] Вам нужно будет нажать кнопку <code>Fork</code> в правом верхнем углу.

[[File:ForkingParacode.png]]

Ого, у вас теперь есть свой репозиторий! Фактически репозиторий — полная копия оригинального кода, отличие лишь в том, что они не связаны и любые ваши изменения не влияют на оригинал. Теперь, давайте скомбинируем ваш репозиторий и VS Code! Вернитесь в VS Code и перезапустите его. Под меню контроля ресурсов (выглядит как ветка дерева) нажмите <code>Clone Repository</code>.

Это должно будет выглядеть так:

[[File:VSCodeSidebar.png]]

Если этой кнопки там нет, то вы можете нажать комбинацию <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> что бы открыть список команд, затем введите туда <code>Git: Clone</code> и нажмите <kbd>Enter</kbd>.

Теперь, вставьте URL репозитория, который вы создали пару шагов назад. Для этого зайдите в свой репозиторий через меню профиля, а после возьмите ссылку страницы. Оно должно быть похоже на такую ссылку: <code><nowiki>https://github.com/ваше</nowiki> имя/имя репозитория</code> Далее выберите папку, в которой будет хранится локальный репозиторий. Процесс загрузки может занять много времени, налейте себе чаю. После загрузки откройте эту папку в VS Code. Теперь у вас есть локальная копия кода!

===Расширения VS Code===
Нажмите на кнопку <code>Extensions</code> (расширения) на левой панели (выглядит как кучка квадратов), или нажмите комбинацию <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>X</kbd>. Вы должны будете увидеть количество рекомендованных расширений. Если нет, пропишите <code>@recommended</code> в поисковую строку. По крайней мере вы захотите установить необходимые расширений из списка ниже. Рекомендованные расширения не обязательны, но значительно облегчат вам работу.

====Необходимые расширения====

; BYOND DM Language Support
:Подсветка синтаксиса для языка DM
; DreamMaker Language Client
:Необычные функции, такие как отладка и переход к определениям
; EditorConfig for VS Code
:Загружает стандартную конфигурацию редактора для кодовой базы
; ESlint
:Предоставляет список для Javascript (этот необходим только если вы планируете работать с TGUI)

====Рекомендованные расширения====
; GitLens
:Предоставляет классные фичи, такие как возможность выбрать строчку и увидеть время последней редакции и кто её редактировал
; Error Lens
:Подсветка строк кода, в которых есть ошибки и показывание ошибок в той же строчке
; GitHub Pull Requests
:Позволяет сделать запрос помощи прямо из редактора
; Git Graph
:Позволяет более визуально удобно работать с ветвями
; Bracket Pair Colorizer 2
:Подкрашивает скобки в разные цвета, позволяя не запутаться в их количестве

===Добавляем Paracode как верхний репозиторий===
Нам надо добавить главный Paradise репозиторий в качестве удалённого репозитория.

чтобы сделать это, откройте командную палитру, введите <code>Git: Add Remote</code> и нажмите <kbd>Enter</kbd>. Далее, вам предложит ввести URL ссылку , а потом и имя удалённого репозитория. Вводим <code>https://github.com/ss220club/Paradise-SS220</code> в качестве URL, и <code>upstream</code> в качестве имени. После завершения вы будете иметь главный Paradise репозиторий в качестве верхнего удалённого: Это позволит вам легко отправлять запросы о помощи позже.
</div>

<div class="toccolours mw-collapsible" style="width:99%">

==Делаем изменения==
Во-первых, давайте поговорим о '''ветвях'''. Первое, что надо выполнить - это сделать новую ветвь в вашем ответвлении. Это важно, потому что вам никогда не следует делать изменения в вашу обычную ветвь (оригинальную) вашего ответвления. Ей стоит оставить в чистом состоянии.
<br>
'''Для каждого PR, который вы создаёте делайте новую ветку.''' Таким образом, каждый ваш индивидуальный проект будет иметь свою собственную ветвь. Изменения одной ветки не будут влиять на другие ветки, так что вы сможете работать над несколькими проектами одновременно.
===Создание ветвей===
Чтобы создать новую ветвь, откройте source control на боковой панели. Перейдите к More Actions menu (выглядит как <code>...</code>) и нажмите <code>Checkout to...</code> , типа такого:

[[File:VSCodeBranching.png]]

Теперь нажмите "Create new branch". В этом гайде я буду создавать новую шляпу, поэтому именем моей ветки будет <code>hat-landia</code>. Если вы посмотрите в левый нижний угол, вы увидите, что VS Code автоматически проверил нашу ветку:[[File:VSCodeBranchExample.png]]
<br>
Запомните, '''никогда не изменяйте главную ветвь!''' Вы можете работать с любой веткой сколько вам угодно, пока фиксируете изменения в отдельной (новосозданной) ветке.
<br>
Вперёд! Меняйте код как хотите! Это гайд по тому, как вносить изменения, не по тому, что вам вносить! Так что я не расскажу вам как именно вам кодить, создавать спрайты или менять карту. Если вам нужна будет помощь, попробуйте спросить в канале <code>#ss13-трекер</code> или дождитесь кого-то из кодеров в онлайне в дискорде.

===Изменения кода===
Вы можете найти код для редактирования во владке "Explorer" (два листа бумаги) в боковой панели; если вам надо найти файл или строку кода, и вы знаете его имя или расположение, то вы можете использовать поиск, он находится в боковой панели под Explorer.
<br>

<pre>Стиль старой школы: если вы хотите использовать DreamMaker вместо этого, можете редактировать их там - как только вы их сохраните, VS Code обновит ваши изменения и вы сможете продолжать следовать гайду здесь.</pre>

Теперь сохраняем свои изменения. Если вновь взглянем на контроль ресурсов (Source Control), мы увидим, что у нас появилось несколько изменений. Git нашёл каждое изменение, которое вы сделали со своим форком на вашем компьютере! Даже если вы изменили единственный пробел в одной строчке кода, Git найдёт это изменение. Просто убедитесь, что вы сохранили свои файлы.
===Тестируем свой код===
Самый простой способ протестить свои изменения, это нажать '''F5''' или воспользоваться меню '''run and debug''' под контролем ресурсов'''.''' Это скомпилирует ваш код, запустит сервер и присоединит вас к нему, а так же выдаст вам права администратора. Это также запустит дебаггер, который поможет вам изучить, что могло пойти не так, когда ошибка закроет вам игру. Если вы хотите не запускать дебаггер, то нажмите '''Ctrl + F5''' для запуска. Запуск сервера может занять длительное время, не надо постоянно останавливать и перезапускать запуск.

Это не сделает вас админом в игре автоматически, для этого вам надо скопировать всё из <code>/config/example</code> и вставить это в <code>/config</code>. Затем надо будет отредактировать <code>/config/admins.txt</code> , добавив строчку <code>ваше имя в byond - Hosting Provider</code> в список, по аналогии с примером, который уже будет в файле.

Это компилирует код в dmb файл. Затем вы можете запустить Dream Daemon, выбрать файл dmb, установить Security(безопасность) на Trusted(Доверенное) и нажать GO, чтобы запустить сервер. После запуска сервера вы можете нажать на новую кнопку над кнопкой GO/STOP (которые теперь красные), чтобы подключиться.

[[File:DreamDaemon.png]]

Обязательно проверяйте не только свои изменения, но и косвенные. Убедитесь, что они больше ничего не затронули с чем это могло быть взаимосвязано.
Например поменяв модификатор скорости усваивания у родительского реагента, вы также затрагиваете скорость усваивания дочерних.

===Изменения в вашу ветку===
Наведите указатель мыши на слово '''Changes''' и нажмите знак плюса, чтобы подготовить все измененные файлы. Это должно выглядеть так:

[[File:VSCodeStageChanges.png]]

Или выберите каждый файл, который вы хотите изменить по отдельности. Staged Changes — это изменения, которые вы собираетесь отправить в коммит, а затем в Pull Request. Как только вы это сделаете, они появятся на новой вкладке «Staged Changes»

[[File:VSCodeStagedChanges.png]]

Нажмите на один из файлов кода, которые вы изменили! Вы увидите всплывающее окно сравнения исходного файла с новым файлом. Здесь вы можете видеть, строка за строкой, каждое сделанное вами изменение. Красные линии — это строки, которые вы удалили или изменили, а зеленые — это строки, которые вы добавили или обновили. Вы даже можете включить или отключить отдельные строки с помощью меню More Actions <code>(...)</code> в правом верхнем углу.

Теперь, когда вы подготовили свои изменения, вы готовы сделать коммит. В верхней части панели вы увидите раздел Message «Сообщение». Введите имя, описывающее ваши изменения в коммите и описание, если необходимо. Будьте лаконичны! По вашему коммиту должно быть понятно какие изменения оно совершает.

Убедитесь, что вы проверили новую ветку, созданную ранее, и нажмите на галочку! Это сделает ваш коммит и добавит его в вашу ветку. Это должно выглядеть так:

[[File:VSCodeCommit.png]]

Ну вот! Вы успешно внесли изменения(commit) в свою ветку(branch). Он все еще «неопубликован» и находится только на вашем локальном компьютере, на что указывает значок маленького облака и стрелки в левом нижнем углу.

===Публикация на GitHub===
Щелкните значок GitHub на левой боковой панели, выглядящий как кошка в кругу. Теперь вам нужно щелкнуть знак +, который появляется в левом верхнем углу, например:

[[File:VSCodeCreatePR.png]]

Затем выберите верхний репозиторий (upstream repo) и нацельтесь на главную ветку(master branch). Вы сможете выбрать название вашего PR. Расширение сделает ваш PR с выбранным вами заголовком и описанием по умолчанию. '''ПЕРЕД ОТПРАВКОЙ:''' убедитесь, что вы правильно создали PR и следовали шаблону описания.

Примечание к журналам изменений (ChangeLogs). Журналы изменений должны быть ориентированы на игрока, то есть они должны быть понятными и применимыми к обычному пользователю, не знакомому с кодингом. Будьте как можно более проще,
<pre>Исправление(fix): Исправлена ошибка с X, когда вы Y
Фича(tweak): усилен X, чтобы наносить Y больше урона. </pre>

Избегайте написания гигантских журналов изменений и внутренних изменений кода, которые явно не влияют на игровой процесс игрока. Это все примеры того, что вы не должны добавлять:
<pre>tweak: добавлен флаг NO_DROP к элементу X.
tweak: рефакторинг ДНК, чтобы CPU лучше работал
</pre>

ShareX — очень полезный инструмент для внесения вклада, так как он позволяет создавать гифки для отображения ваших изменений. вы можете скачать его, [https://getsharex.com/ здесь]

если все пойдет хорошо, ваш PR должен выглядеть так:

[[Файл:ExamplePR.png|600px]]

Если вы хотите добавить больше изменений(коммитов) в свой PR, все, что вам нужно сделать, это просто отправить эти коммиты в ветку.

</div>

<div class="toccolours mw-collapsible" style="width:99%">

==Учимся кодить==
Теперь, когда всё настроено, осталось сделать последний штрих. Изучить логику и код. Ну ладно, не совсем последний штрих. Не бойся, хоть это одна из сложных вещей, есть масса гайдов по Dream Maker, а также кодеры, которые вам помогут! Главное правило изучение - не просите делать всё за вас, а то вы так ничего не изучите. Всё дается не сразу и поэтому стоит набраться терпения и сил. Кодерами не рождаются, ими становятся, пересилив себя ради создания хороших вещей!

[https://wiki.ss13.ru/index.php?title=All_about_the_code Переведенный гайд] <br>
[https://secure.byond.com/docs/ref/info.html# DM Reference] <br>
[https://github.com/tgstation/tgstation/blob/master/.github/guides/STYLE.md TG STYLE] <br>
[https://github.com/tgstation/tgstation/blob/master/.github/guides/STANDARDS.md TG STANDARDS] <br>

</div>
<div style="width:99%" class="toccolours">

<span style="font-size:1.8em;">'''СТОЯТЬ! Если ты только начинаешь и уверен что готов двигаться дальше, то можешь ознакомиться с инструкциями ниже по настройке твоих IDE и дополнительной информацией.'''</span>
</div>

<div class="toccolours mw-collapsible" style="width:99%">
==Настройка и использование Github Desktop==
* Заходим на: https://desktop.github.com/
* Скачиваем Github Desktop для своей системы.
* Дожидаемся окончания установки!
* Следуем шагам для регистрации/логина на GitHub..

===Ответвление [Fork]===
Читаем [[#Forking ParaCode|данный гайд по ответвлению.]][[Файл:CloneRepo.png|мини|Выпадающее меню]]

===Создание локального репозитория===
* Открываем Github Desktop
* Выбираем "File", "Clone repository.."
* Выбираем ваш ответвленный Paradise репозиторий
* Выбираем локальный путь куда будет клонирован репозиторий
* Нажмите Clone и дождитесь окончания
*Теперь у вас есть локальный репозиторий на вашем устройстве

===Обновление вашего репозитория===
* Перед тем как начать работу, вы должно обновить ваш master
* Откройте Github Desktop и выберите ваш репозиторий
*Нажмите на ''Current Branch'' в верхней части экрана
*Выберите ваш ''master'', для нашего билда это '''master''' <small>(рекомендуем его переименовать в master220)</small>
* Кликните внизу на ''Choose a branch to merge into '''master''''' <small>(или master220)</small>
* Найдите ''upstream/master branch'' и выберите его.
* Нажмите на ''Merge '''upstream/master''' into '''master''''' <small>(или master220)</small>
[[Файл:Branch.png|мини|Branch в GitHub Desktop]]

===Ответвляем от репозитория [Branch]===
*'''Branch-ветвление вашего репозитория очень важно для организации ваших коммитов (изменений), у вас должна быть отдельная ветка для каждого несвязанного изменения кода (например, если вы хотите создать несколько новых спрайтов для одного элемента и изменить свойства другого, они должны быть в отдельных ветках). Запросы на слияние (Pull Request) работают с ветками (Branch), а не с коммитами, это позволит вам создавать отдельные запросы на слияние для каждого изменения. Это упростит весь процесс и избавит всех от головной боли...'''
* Откройте Github Desktop и выберите ваш репозиторий
*Нажмите на Current Branch в верхней части экрана
*В выпадающем меню нажмите на New Branch
* Задайте ему название зависимое от ваших изменений и нажмите Create branch

===Переключение между branch-ветвями===
* Откройте Github Desktop и выберите ваш репозиторий
* Нажмите на выпадающее меню Current branch и выберите branch-ветку на который хотите переключиться.
* If you have open changes then it might fail. Either stash, commit or discard the open changes and try again. Если у вас есть изменения, это может привести к ошибке. Вы можете их зафиксировать, оставить в предыдущей ветке, отменить изменения и повторить попытку.
[[Файл:Commit Change.png|мини|Внесение изменения]]

===Делаем Commit-изменение===
* Коммит — это подтвержденное изменение файлов в вашем репозитории, именно так вы постоянно вносите изменения в файлы в вашем репозитории, поэтому старайтесь не вносить коммит, не убедившись, что он работает (хотя последующие коммиты могут это исправить).
*Как и было ранее сказано, вы должны использовать разные версии веток-branch'ей для внесения ваших commit-изменений. '''Не вносите изменение в ваш master.''' Он должен оставаться чистым, чтобы вы могли использовать его для создания последующих веток и откатов при нужде.
*Чтобы внести свои изменения-commit'ы, вам нужно отредактировать файлы с помощью встроенных инструментов редактирования BYOND или любого другого инструмента редактирования, такого как Visual Studio Code ([[Руководство по разработке#Устанавливаем и настраиваем Visual Studio Code|Как его установить?]]), который рекомендуем для разработки. Обязательно соблюдайте стандарты кодирования при внесении изменений!
* Откройте Github Desktop и выберите ваш репозиторий
* Повторно проверьте внесенные вами изменения.
* Назовите внесенные изменения.
* Опционально, опишите внесенные вами изменения.
* Нажмите ''Commit to "BRANCH_NAME"''
*Ваши изменения внеслись в вашу ветку, вы можете повторно увидеть их во вкладке History

===Делаем Pull Request (ПР)===
* Открываем Github Desktop и выбираем ваш репозиторий
* Нажимаем на Public branch
* Переходим на ваш GitHub репозиторий, к примеру: https://github.com/NAME/Paradise
* Нажимаем '''Pull Request''' на самом верху
* Заполняем форму с изменениями, после чего создает Pull Request.
* You're done! In many cases there will be issues pointed out by other contributors, unfortunate merge conflicts, and other things that will require you to revisit your pull request.
*Готово! Во многих случаях в ваших изменениях могут обнаружиться ошибки, на которые указали другие участники, либо же неудачные конфликты слияния или другие вещи, которые потребуют от вас пересмотра вашего запроса на включение.
*Не забудьте убедиться что у вас всё верно и постарайтесь получить одобрение от других участников разработки.
*Теперь вам необходимо ожидать внесения ваших изменений в родительский репозиторий.
</div>

<div class="toccolours mw-collapsible" style="width:99%">

==Setting up & Using TortoiseGit==

<div class="toccolours mw-collapsible mw-collapsed" style="width:99%;">
<span style="font-size:1.2em;">'''Настройка на английском. Для новичков рекомендуем по прежнему использовать Github Desktop'''</span><br>
<div class="mw-collapsible-content">

* Go here: http://code.google.com/p/tortoisegit/wiki/Download
* Download the right TortoiseGit for your system.
* When installing, click '''OpenSSH''' rather than TortoisePLink
* Finish installing.
* '''RESTART YOUR COMPUTER THIS IS NOT A DRILL.'''

===Forking Code===
See [[#Forking ParaCode|this]]

===Downloading the Code===
* Find a place you don't mind the code sitting.
* Right click and choose '''Git Clone...'''
* The URL field should be filled with the URL of your Fork. If not, paste it in.
* Click Next and watch flying tortoises bring you your code.

===Setting up TortoiseGit===
* Right click '''on the folder that was created''' (usually called Paradise), and go to '''TortoiseGit''' and then click on '''Settings'''.
* Click on '''Remote''' under '''Git'''.
* There should be one thing on the list of remotes, with the name: '''origin'''.
* You're now adding the main repository as a source you can pull updates from.
* In the '''Remote''' box type in '''upstream'''.
* In the '''URL:''' box put: https://github.com/ss220-space/Paradise.git
* Click '''Add New/Save'''.
* Click '''Ok'''.
* Almost done!

===Updating your Repository===
* Updating your repo with the master should be done before trying anything.
* Right-click the folder your repo is in and select '''TortoiseGit''' then '''Pull'''.
* Click the radial button next to '''Remote''' and make sure '''upstream''' (or whatever you called it) is selected next to it.
* The '''remote branch''' should be set to '''master'''.
* Then click '''Ok'''. This will pull the latest changes from the master repo.

===Making a Branch===
Branching your repo is very important for organising your commits, you should have a different branch for each unrelated code change (e.g. if you wanted to make some new sprites for one item and change the properties of another these should be in seperate branches), as Pull requests work off branches rather than commits this will allow you to make a seperate Pull Request per change. Doing this streamlines the whole process and will save everyone a bunch of headaches.

* Right-click in your working folder. Then choose '''TortoiseGit''', and '''Create Branch...'''
* Type in your new branch name
* (Optional) Tick '''Switch to new branch'''
* Press '''Okay''' and your new branch is created

====Switching between Branches====
* Right-click in your working folder. Then choose '''TortoiseGit''', and '''Switch/Checkout...'''
* Choose your Branch then press '''Okay'''

===Making a Commit===
* A commit is confirmed change of the files in your repo, it's how you make changes permanently to the files in your repo, so try not to commit without making sure it works (though subsequent commits can fix it).
* As said before, you should use different branches to separate your commits/changes. Don't commit to master. It should be clean, so you can fall back on it if needed.
* To make your commits, you need to edit the files using BYOND's inbuilt editing tools. Make sure to follow coding standards when making your changes! When you're finished, right click the folder you're working with and choose '''Git Commit -> "[Your Branch Name]"''' (Example: Git Commit -> "My_First_Branch")
* You can then select only the files you want to be committed by ticking or unticking them. You should also write a detailed commit summary, detailing what happened in that commit.
* Click '''Ok''' and the commit will be committed to your local repo!

===Making a Pull Request===
* Right-click in your working folder. Then choose '''TortoiseGit''', and '''Push...'''
* Set '''Local''' and '''Remote''' to the name of the branch you committed before. (e.g. My_First_Branch)
* Under Destination, set Remote: to '''origin'''.
* Click '''Ok'''. This'll upload your changes to your remote repo (the one on GitHub).
* Head to your GitHub repo e.g https://github.com/NAME/Paradise
* Click '''Pull Request''' at the top right.
* Fill out a summary and then create the pull request.
* You're done! In many cases there will be issues pointed out by other contributors, unfortunate merge conflicts, and other things that will require you to revisit your pull request.
* Optionally, view Clean Commits for a guide on cleaner commit logs, '''cleaner commits help maintainers review!'''

===Clean commits / Squashing commits(Optional)===
* Your commit logs are filthy, full of one or two line commits that fix an error that makes you look bad, and the commit is called "Whoops" or "oops"
* Navigate to your '''local version of the branch'''
* Ensure it is up to date with the '''remote'''
* Go to '''Show log'''
* Select all the commits associated with this change or PR
* Right click and choose '''Combine to one commit'''
* This will open up the standard commit interface for TortoiseGit, with the commit logs of the selected commits merged together
* Perform the normal routine for a commit
* Go to '''push''' your branch to the '''remote branch'''
* Ensure '''Force Overwrite Existing Branch (may discard changes)''' is selected to make sure the PR/Remote updates to contain just this squashed commit
</div>

</div></div></div>

==Как делать предложения правок на GutHub==
=== Окно изменений PR'а ===
# Статус ПРа.
## Open - открыт. ПР готов принимать правки и быть замерженым в проект.
## Merged - занесен в билд. Нет смысла предлагать правки
## Closed - закрыт по какой-либо причине. В большинстве случаев нет смысла предлагать правки, если автор не собирается открывать
## Draft - ПР в разработке. Правки нужны только если автор не против или он сам попросил
# Список измененных файлов. Можно нажать чтобы быстро переместиться
# Наведите курсор на строку и нажмите на плюсик, если хотите внести правку
# Путь к файлу, можно быстро скопировать и использоваться в вашей IDE
# Завершение занесения правок
[[Файл:Review1_small.png]]

=== Написание правки ===
Не обязательно что это будет именно правка. Возможно вы решили просто прокомментировать строку, так как знаете более лучший способ решения или у вас возник какой-то вопрос.
# Строка к которой применяется правка или комментарий
# Кнопка для внесения предложения по изменению строки
# Внесение правки в "общий пул"
# Завершение написания правок и окончание ревью
[[Файл:Review2.png]]

=== Окончание ревью ===
# Кнопка завершения ревью со всем пулом правок.
# Вердикт. Написание комментария ко всему пулу внесенных вами правок.
# Прокомментировали код. Возможно что-то стало непонятно или нашли более лучшее решение.
# С кодом все в порядке и возражений нету.
# Вы запросили изменения, надо что-то исправить.
[[Файл:Review4.png]]

=== Отображение правки ===
Если вы являетесь автором PR'а и вам внесли правки:
# Принять заносимую правку для внесения в ваш PR/Branch
# Вводная строка для комментирования правки
# Отметить что вы решили эту проблему, загрузили правку и вмешательства более не требуются (до следующих правок).
[[Файл:Review3.png]]

<div class="toccolours mw-collapsible" style="width:99%">

==Учимся использовать TGUI==
Если вы все еще новичок, рекомендуется больше узнать о DM, прежде чем переходить к TGUI. Все наши пользовательские интерфейсы (кроме элементов OOC, таких как панели администратора) сделаны с использованием TGUI или должны быть преобразованы в TGUI в какой-то момент в будущем. (Вот куда это ведет!)

TGUI использует InfernoJS (на основе reactJS), который является расширением для javascript. Учиться может быть сложно, потому что это совершенно другой язык, но не бойтесь! Есть много руководств, которым вы можете следовать.

===Guides===
TGUI прост, но его трудно понять тому, кто с ним не знаком. ПРОЧИТАЙТЕ ЭТИ РУКОВОДСТВА. И да. Они на английском.

Обязательно прочитайте их по порядку
* [https://developer.mozilla.org/en-US/docs/Web/JavaScript/A_re-introduction_to_JavaScript A re-introduction to JavaScript]
* [https://reactjs.org/docs/hello-world.html Guide to using ReactJS] <- На самом деле мы не используем react, но полезно для изучения
* [https://infernojs.org/docs/guides/components Brief rundown of InfernoJS]
* [https://github.com/ss220-space/Paradise/blob/master/tgui/docs/tutorial-and-examples.md TGUI Tutorials and Examples]

</div>

{{Contribution Guides}}

[[Категория:Руководства]]

Тесла-двигатель

2023-11-28T16:31:59Z

Aloe: Немного обновил руководство по тесле, а главное удалил строку про пересбор эммитеров.

{{TOC_right}}
== Видеогайд по настройке ==
‎<youtube width="600" height="300">d4Rd4lAWhSQ</youtube>

==Как настроить тесла-двигатель==
[[File:Engine zone.png|thumb|right|350px|Зона расположения блока двигателя]]
<span style="color:#ff0000">'''Новичкам крайне рекомендуется обратиться к более опытным [[инженер]]ам.'''</span>
Современная, эффективная и более безопасная альтернатива сингулярности, тесла-двигатель расположен на западной части инженерного отдела, в космосе.

На самом деле, настроить и поддерживать Теслу не так трудно. Это руководство рассчитано на то, что вы будете это всё делать в одиночку, в случаях, если, например, вы — единственный, кто на это согласился, или же другие решили, что у них есть дела поважнее. В первую очередь вам необходимо знать, какие инструменты нужно принести с собой в зону сдерживания Теслы; в принципе, их можно легко и быстро насобирать в инженерном отделе.

<div class="toccolours mw-collapsible mw-collapsed" style="width:20%">
'''Вам понадобятся'''
<div class="mw-collapsible-content">
*[[File:Mod_Engineering.png|20px]] Инженерный модсьют
*[[File:EmergencyOxygenTank.png|32px]] Баллон с воздухом
*[[File:Mask_breathmask.png|32px]] Дыхательная маска
*[[File:Wrench.png|32px]] Разводной ключ
</div></div>

А теперь можно приступить к работе.

''Примечание: Каждый раздел настройки аппаратуры вы можете выполнить самостоятельно или с помощью коллег. Порядок выполнения не имеет значения, но главное, чтобы раздел финальной подготовки выполнялся в последнюю очередь.''

===[[File:SMES.png]] Настройка [[СКАН]]ов (<abbr title="Super Magnetic Energy Storage">SMES</abbr>)===
[[СКАН]]ы расположены в количестве 5 штук в инженерном отделе (1 слева - [[СКАН]] контура защиты двигателя; 4 справа - основные [[СКАН]]ы, которые питают станцию).

Убедитесь, что на четырёх [[СКАН]]ах справа параметр <code>Charging</code> выставлен на <code>Off</code> (на зарядку (<code>Input</code>)) и на <code>Online</code> (на вывод (<code>Output</code>)). На левом выставьте значение вывода на 150 000 Вт; зарядку всех [[СКАН]]ов отключите. '''Отключение вывода энергии на [[СКАН]]ах может привести к перебоям в работе силового поля или в залпах эмиттеров'''.

<span style="color:#ff0000">'''Если вы оставите зарядку правых [[СКАН]]ов включённой, они будут забирать заряд из левого [[СКАН]]а, из-за чего у вас не останется энергии для запитывания эмиттеров, и они могут отключиться в самый неудобный момент.'''</span>

===Настройка ускорителя частиц (Particle Accelerator)===
<span style="color:#ff0000">'''Старайтесь не толкать двигатель, пока он не закреплён разводным ключом. Если вы случайно вытолкнули какую-то часть двигателя со своего места, перетащите её обратно на место, а затем поверните (<kbd>ПКМ</kbd> → <code>Rotate</code>) её в правильное положении.'''</span>

#Возьмите [[File:Wrench.png|32px]] разводной ключ и закрутите им на все 6 частей двигателя и [[File:Control box.png|32px]] контрольной панели. Таким образом вы зафиксируете все части двигателя, о чём вы увидите 7 уведомлений <code>You secure the external bolts</code>. Убедитесь, что стрелка на контрольной панели повернута вниз, и, если нет, поверните контрольную панель до тех пор, пока стрелка не встанет в правильном направлении.
#Возьмите [[File:CableCoils.png|32px]] моток кабелей и добавьте (<kbd>ЛКМ</kbd>) проводку на все 6 частей двигателя и контрольной панели. О проделанной работе вы увидите 7 уведомлений <code>You add some wires</code>.
#Возьмите [[File:Screwdriver_tool.png|32px]] отвёртку и закрепите (<kbd>ЛКМ</kbd>) ей провода на всех 6 частях двигателя и контрольной панели. О проделанной работе вы увидите 7 уведомлений <code>You close the access panel</code>.
#Откройте контрольную панель (<kbd>ЛКМ</kbd>) и нажмите кнопку <code>Run Scan</code>.
#*Если будет появляться ошибка <code>Unable to detect parts</code>, то значит, что вы что-то пропустили в предыдущих пунктах.
#*Если появится сообщение <code>All parts in place</code>, то вы можете продолжить.

<span style="color:#ff0000">'''Пока еще не стоит нажимать на <code>Toggle Power</code>!'''</span>

===Настройка Теслы===

#Откройте хранилище, которое находится ниже [[СКАН|СКАНа]] контура защиты и вытащите [[Файл:Tesla generator.png|32px]] генератор шара Теслы. После доставьте его в зону содержания двигателя и закрепите его в центре при помощи [[File:Wrench.png|32px]]разводного ключа . Если вы хотите настроить [[сингулярность|сингулярный двигатель]], просмотрите [[Singularity Engine|соответствующее руководство]].
#Перед выходом в вакуум экипируйтесь [[File:EmergencyOxygenTank.png|32px]] дыхательным баллоном и [[File:Mask_breathmask.png|32px]] маской, а также опционально активируйте модуль, чтобы не улететь куда-нибудь в невесомости.
#Активируйте (<kbd>ЛКМ</kbd>) все четыре [[File:Emitter.png|32px]] эмиттера.
#*<span style="color:#ff0000">'''Не стойте перед работающими эмиттерами!'''</span>
#*Не забудьте заблокировать эмиттеры, кликнув по ним своей [[File:Id regular.png|32px]] ID-картой, чтобы предотвратить злонамеренное нарушение сдерживания Теслы.
#Проходя ''с внешней стороны'' круга силового поля, кликните по всем восьми[[File:Field_generator.png|32px]] генераторам поля, чтобы активировать их. Подбирайте тайминг, чтобы не попасть по залпы [[File:Emitter.png|32px]] эмиттеров, когда будете проходить по всем генераторам.
#*Вскоре после активации всех генераторов вы увидите [[File:Containment_field.gif|32px]] линии силового поля, соединенные этими самыми генераторами и окружающие зону сдерживания Теслы.
#*<span style="color:#ff0000">'''Ни в коем случае не входите в силовое поле!'''</span>
#Когда линии силового поля замкнут зону сдерживания, возвращайтесь в отсек ускорителя частиц.

''<span style="color:#ff0000">Примечание:</span> Если эмиттеры работают сбойно, убедитесь, что вы отключили прием энергии на [[file:SMES.png|32px]] [[СКАН|СКАНе]] (SMES) в комнате с ускорителем частиц и выставлено значение выходной энергии из него больше чем 150 kw, а также отключен прием энергии на [[СКАН|СКАНах]], которые заряжаются от СМЕСА находящегося в комнате с ускорителем частиц.''

===Финальная подготовка===

#Откройте меню [[File:Control box.png|32px]] контрольной панели.
#Нажмите кнопку '''Включить питание (<code>Toggle Power</code>)''', чтобы включить подачу питания.
#Установите параметр '''мощность частиц (<code>Particle Strength</code>)''' на <code>2</code>.
#Подойдите к окну и наблюдайте за процессом. Вы увидите, как ускоритель частиц будет порционно выпускать потоки зелёных частиц, и через несколько секунд образуется[[File:Tesla_ball.gif|32px]] энергетический шар Теслы!

В отличие от сингулярности, Тесла сама по себе не может прийти в критическое состояние, в котором она могла бы прорвать систему сдерживания, так что вы можете либо отключить ускоритель частиц, либо оставить его работающим на высокой мощности для максимальной выработки электроэнергии.

===[[File:SMES.png]] Возвращаясь к [[СКАН]]ам===

#Вернитесь к расположенным справа [[СКАН]]ам. Они подают электричество на большую часть станции. Убедитесь, что сумма вывода питания как минимум такая же, сколько станция потребляет целиком. Обычно станция потребляет энергию в пределах 200 000 Вт. Чтобы проверить, достаточно ли [[СКАН]]ы выводят энергии, воспользуйтесь '''монитором электросети (<code>Grid Power Monitoring Computer</code>)''', расположенным слева сверху в отсеке двигателя. Убедитесь, что значение '''суммарной выработки (<code>Total Power</code>)''' намного выше значения '''суммарного потребления (<code>Total Load</code>)'''; в противном случае приборы по всей станции начнут постепенно отключаться.
#Когда тесла-двигатель начнет вырабатывать энергию, пройдитесь по всем четырем [[СКАН]]ам и выставьте зарядку на '''автоматический режим зарядки (<code>Charge Mode: Auto</code>)'''. Выставьте уровень заряда выше уровня вывода энергии, чтобы каждый [[СКАН]] накапливал заряд со временем. При зарядке должно показываться сообщение '''частично заряжается (<code>Charging</code>),''' а процент '''накопленного заряда (<code>Stored Capacity</code>)''' будет медленно повышаться.
#Мощность вывода энергии с левого [[СКАН]]а не играет особой роли, поскольку его заряд преимущественно уходит на то, чтобы запитывать эмиттеры и отсек двигателя. Когда же двигатель запущен, теперь он будет поддерживать работу эмиттеров, однако вам всё ещё рекомендуется оставить левый [[СКАН]] включенным и заряжающимся на случай экстренной ситуации.
#Если всё сделано верно, то [[File:APC.png|32px]] [[ЛКП]] в отсеке двигателя (расположенный сверху от левого [[СКАН]]а) будет заряжаться.

<div class="toccolours mw-collapsible mw-collapsed" style="width:99%">
'''Небольшая заметка по предотвращению нарушения сдерживания:'''
<div class="mw-collapsible-content">
По всей станции проходит две главных электроцепи. <span style="color:orange">Жёлтая</span> запитывает отсек двигателя и зону сдерживания (включая эмиттеры), в то время, как <span style="color:red">красная</span> запитывает остальную станцию. Просмотреть расположение проводов вы можете в статье про [[Maintenance|техническое обслуживание]].

<span style="color:orange">Жёлтая цепь</span> подаёт заряд от двигателя и левого [[СКАН]]а, в то время, как <span style="color:red">красная</span> подаёт заряд от четырёх правых [[СКАН]]ов. Все пять [[СКАН]]а заряжаются от <span style="color:orange">жёлтой цепи</span> цепи.

Помимо этого, большая часть энергии, протекающая по цепи, вместо запитывания всего подключенного к ней оборудования поступает преимущественно на зарядку [[СКАН]]ов. Это значит, что если значение суммы зарядки [[СКАН]]ов выше суммарного значения вывода энергии от двигателя и левого [[СКАН]]а, то '''эмиттеры быстро отключатся, а вместе с ними и силовое поле'''. Не забывайте смотреть на '''монитор производительности двигателя (Engine Power Monitoring Computer)''', стоящий прямо под монитором состояния электросети. Следите, чтобы значение '''суммарной выработки (<code>Total Power</code>)''' всегда было значительно выше '''суммарного потребления (<code>Total Load</code>)'''!
</div></div>

==Поддержка работоспособности==

В отличие от [[сингулярность|сингулярности]], тесла-двигатель после включения способен работать сам по себе неограниченное количество времени. Без постороннего вмешательства нет никакого риска на то, что Тесла прорвет зону сдерживания или прекратит работу.

==Оптимизация ускорителя частиц==

===Улучшение [[ЛКП]]===

#Разблокируйте[[File:APC.png|32px]] [[ЛКП]], расположенный снизу от левого [[СКАН]]а, кликнув на нем своей [[File:Id regular.png|32px]] ID-картой.
#Принудительно '''включите <code>On</code>''' питание '''оборудования (<code>Equipment</code>)'''. Именно принудительно, а не '''автоматический режим (<code>Auto</code>'''.
#*Таким образом, вы обеспечите то, что в случае, если [[ЛКП]] разрядится, наиболее важное инженерное оборудование будет работать до талого и отключится в последнюю очередь. Для большей экономии энергии можно отключить и освещение, но тогда вы не увидите возможных нарушителей в инженерном отделе.
#Разблокируйте крышку панели, '''сняв (<code>Disengaged</code>)''' у неё '''блокировку крышки (<code>Cover Lock</code>)'''.
#Откройте (<kbd>ЛКМ</kbd>) панель [[File:Crowbar.png|32px]] монтировкой.
#Вытащите (<kbd>ЛКМ</kbd>) из [[ЛКП]] старый аккумулятор (пустой рукой).
#Найдите любой другой аккумулятор и вставьте его в [[ЛКП]].
#Закройте (<kbd>ЛКМ</kbd>) панель [[File:Crowbar.png|32px]] монтировкой.
# Проверьте меню [[ЛКП]] и убедитесь, что всё работает как надо.
#Заблокируйте [[ЛКП]] своей ID-картой.

=== Улучшение [[СКАН]]ов ===

Крайней не рекомендуется улучшать [[СКАН]]ы, а потом менять значения приема и отдачи энергии. Данная процедура может вызвать сбой в работе эммитеров, а в последствии и выпуск двигателя из зоны содержания.

==Отключение двигателя ==
Увы, но двигатель Теслы невозможно отключить стандартными способами. Он не теряет энергию со временем(в отличии от Сингулярности) и поэтому просто отключить двигатель будет недостаточно. Вы можете, например, увести её в космос при помощи оборудования, которое притягивает её, или как-либо ещё. Придумайте что-то!

==Нестандартные конфигурации сдерживания ==
Стандартная конфигурация системы сдерживания Теслы не самая эффективная, и существует множество вариаций размещения генераторов полей, эмиттеров, проводки и заземлителей, при которых можно добиться различных показателей производительности и надежности. Пока обеспечивается активность и стабильность работы силового поля перед включением ускорителя частиц, вы вольны экспериментировать как угодно и сколько угодно.

== В качестве оружия==
<blockquote>Согласно правилам сервера, вы ни в коем случае '''не имеете права саботировать''' работу тесла-двигателя! Исключением является наличие у вас, согласно вашей роли [[предатель|предателя]], цели на угон шаттла (''hijack the shuttle''). Однако в любом случае имеет смысл использовать <code>[[ahelp]]</code>, прежде чем связываться с тесла-двигателем.</blockquote>

Тесла — одна из главных зол для станции. Жутко опасная уже сама по себе при нарушении сдерживания, она становится неумолимой машиной смерти и разрушения, если контролировать траекторию её движения с помощью '''сингулярных маячков (<code>Singularity Beacon</code>)'''. Смертельно опасна для всех, кому не повезёт вовремя запереться в шкафчике или прихватить себе хардсьют и изолирующие перчатки. Вероятно, самый драматичный способ завершить раунд в качестве [[предатель|предателя]].

Саботирование сдерживания Теслы — непростая задача для [[предатель|предателя]], маскирующегося под обычного члена экипажа, и если вас поймают за этим, то [[Глоссарий#Робаст|заробастят]] предельно быстро.

В общем и целом, для этого вам необходимо отключить силовое поле, сдерживающее Теслу. Это можно сделать, отключив эмиттеры. Другой вариант — отключить [[ЛКП]] в инженерном отделе, однако если вы не [[инженер]] и вас раскрыли, то живым вы на [[Харон|экстренный шаттл]] точно не попадёте.

==Смотрите также==
*[[Сингулярный двигатель|Руководство по двигателю на сингулярности]]
*[[Двигатель Суперматерии|Руководство по двигателю на суперматерии]]
*[[Солнечные панели|Руководство по солнечной энергии]]
*[[Руководство по турбине]]
*[[Термоэлектрогенератор|Руководство по термоэлектрогенератору]]


[[Категория:Руководства по источникам электроэнергии]]

Файл:Tesla generator.png

2023-11-28T16:11:22Z

Aloe:

Генератор для шара теслы

Файл:Engine zone.png

2023-11-28T15:40:36Z

Aloe:

Зона расположения блока двигателя