Celadon | Wiki Shiptest - Вклад [ru]

Шаблон:LoreBox

2026-10-31T15:43:24Z

Voiko: Исправление названия фракции

{{FrameBox
| color = cc9988
| image = Tome_old.png
| title = Лор мира Celadon
| content = <center>
{{PageList
| Фракция = NT
| Изображение = Tome_old.png
| Страница = Учебник по Лору
| Цвет = Gray
| Вариация = Secondary
| Название = Учебник по Лору
}}
<div style="display: flex; flex-wrap:wrap; justify-content: center; gap: 0.5rem; margin-top: 0.5rem;">
{{Button
| Изображение = Nanotrasen_logo.svg{{!}}128px
| Страница = Nanotrasen
| Название = NanoTrasen
| Цвет = Purple
| Вариация = Secondary
| Ширина = 128px
| Размер текста = 1rem
}}
{{Button
| Изображение = Syndicate_logo.svg{{!}}128px
| Страница = Syndicate
| Название = Syndicate
| Цвет = Red
| Вариация = Secondary
| Ширина = 128px
| Размер текста = 1rem
}}
{{Button
| Изображение = InteQ_logo.png{{!}}128px
| Страница = Inteq
| Название = InteQ
| Цвет = Green
| Вариация = Secondary
| Ширина = 128px
| Размер текста = 1rem
}}
{{Button
| Изображение = SF_LOGO.svg{{!}}128px
| Страница = Solar Federation
| Название = Solar Federation
| Цвет = Yellow
| Вариация = Secondary
| Ширина = 128px
| Размер текста = 1rem
}}
{{Button
| Изображение = Elysium_Separatists.png{{!}}128px
| Страница = Elysium Separatists
| Название = Elysium Separatists
| Цвет = Green
| Вариация = Secondary
| Ширина = 128px
| Размер текста = 1rem
}}
{{Button
| Изображение = Other_Fractions_logo.png{{!}}142px
| Страница = Other Fractions
| Название = Other Fractions
| Цвет = Gray
| Вариация = Secondary
| Ширина = 128px
| Размер текста = 1rem
}}
</div>
<hr>
<div style="display: flex; flex-wrap:wrap; justify-content: center; gap: 0.5rem;">
{{Button
| Изображение = Elzuosa.png{{!}}64px
| Страница = Эльзуос
| Название = Эльзуос
| Цвет = Cyan
| Вариация = Secondary
| Ширина = 64px
| Размер текста = 1rem
}}
{{Button
| Изображение = Human.png{{!}}64px
| Страница = Человек
| Название = Человек
| Цвет = Cyan
| Вариация = Secondary
| Ширина = 64px
| Размер текста = 1rem
}}
{{Button
| Изображение = IPC.png{{!}}64px
| Страница = ИПС
| Название = ИПС
| Цвет = Cyan
| Вариация = Secondary
| Ширина = 64px
| Размер текста = 1rem
}}
{{Button
| Изображение = Kepori.png{{!}}64px
| Страница = Кепори
| Название = Кепори
| Цвет = Cyan
| Вариация = Secondary
| Ширина = 64px
| Размер текста = 1rem
}}
{{Button
| Изображение = Mothperson.png{{!}}64px
| Страница = Ниан
| Название = Ниан
| Цвет = Cyan
| Вариация = Secondary
| Ширина = 64px
| Размер текста = 1rem
}}
</div>
<div style="display: flex; flex-wrap:wrap; justify-content: center; gap: 0.5rem; margin-top: 0.5rem;">
{{Button
| Изображение = Phorid.png{{!}}64px
| Страница = Форид
| Название = Форид
| Цвет = Cyan
| Вариация = Secondary
| Ширина = 64px
| Размер текста = 1rem
}}
{{Button
| Изображение = Rachnids.png{{!}}64px
| Страница = Рахнид
| Название = Рахнид
| Цвет = Cyan
| Вариация = Secondary
| Ширина = 64px
| Размер текста = 1rem
}}
{{Button
| Изображение = Sarathi.png{{!}}64px
| Страница = Сарати
| Название = Сарати
| Цвет = Cyan
| Вариация = Secondary
| Ширина = 64px
| Размер текста = 1rem
}}
{{Button
| Изображение = Vox.png{{!}}64px
| Страница = Вокс
| Название = Вокс
| Цвет = Cyan
| Вариация = Secondary
| Ширина = 64px
| Размер текста = 1rem
}}
{{Button
| Изображение = SlimeM_uga_2.png{{!}}64px
| Страница = Слаймомен
| Название = Слаймомен
| Цвет = Cyan
| Вариация = Secondary
| Ширина = 64px
| Размер текста = 1rem
}}
</div>
<div style="display: flex; flex-wrap:wrap; justify-content: center; gap: 0.5rem; margin-top: 0.5rem;">
{{Button
| Изображение = Lanius.png{{!}}64px
| Страница = Ланиус
| Название = Ланиус
| Цвет = Cyan
| Вариация = Secondary
| Ширина = 64px
| Размер текста = 1rem
}}
{{Button
| Изображение = Tajara_sp.png{{!}}64px
| Страница = Таяра
| Название = Таяра
| Цвет = Cyan
| Вариация = Secondary
| Ширина = 64px
| Размер текста = 1rem
}}
{{Button
| Изображение = Riol.png{{!}}64px
| Страница = Риол
| Название = Риол
| Цвет = Cyan
| Вариация = Secondary
| Ширина = 64px
| Размер текста = 1rem
}}
</div>
<hr/>
'''Лор'''
<div style="display: flex; flex-wrap: wrap; gap: 0.33rem; margin-top: 0.25rem;">
{{PageList
| Изображение = Tome_old.png
| Страница = Хронология
| Цвет = Purple
| Вариация = Secondary
| Название = Хронология
}}
{{PageList
| Изображение = Tome_old.png
| Страница = :Category:Универсальные документы
| Цвет = Purple
| Вариация = Secondary
| Название = Универсальные документы
}}
{{PageList
| Изображение = Tome_old.png
| Страница = :Category:Lore
| Цвет = Purple
| Вариация = Secondary
| Название = Полный лор
}}
</div>
}}

Elysim Separatists

2026-10-31T15:40:11Z

Voiko: Voiko переименовал страницу Elysim Separatists в Elysium Separatists: Elysim, Elysum, Elysium, тьфу ты блин. Давайте к одному названию двигаться.

#перенаправление [[Elysium Separatists]]

Elysium Separatists

2026-10-31T15:40:11Z

{{ЛорНЗП|info=По всем вопросам и обратной связи обращайтесь к подрядчику.|worker=Asuraqami}}
<center>
= Слава Республике! =
</center>
<hr>
{{FactionBox
| Название = Сепаратисты Элизиума
| Логотип = Elysium Separatists.png
| Официальное название = Аль-Мухаририм Элисим аль-Умма
| Другие названия = Сепаратисты Элизиума, Сепары
| Тип базы = Зал Меджлиса Шур
| Местонахождение = Где-то в ER-24230
| Структура = Террористическая группировка
| Денонимы =
| Основан = Результат народных волнений 2524 году по Солу.
| Цвет = 298A08
| Особенности =
* Флаг носимый первой Шурой в 2524 по солу.
}}
'''Сепаратисты Элизиума''' или на элисме — '''Аль-Мухаририм Элисим аль-Умма''' - это признанная на территории Солнечной Федерации террористическая организация, что ставит во главе своих интересов свержение власти Солнечной Федерации на территории Республики Элизиум.

В данный момент в следствие множества ожесточённых конфликтов с Солнечной Федерацией, активность данной организации идёт на спад. Обычно, Сепаратисты Элизиума представляют собой националистических фанатиков, готовых пожертвовать своей жизнью ради освобождения своей нации от угнетателей.

Власть у Сепаратистов Элизиума делится на несколько Шур, которые состоят из более маленьких и автономных Джамаа́тов. Формальным правителем всей организации считается Халиф, однако он выполняет скорее идеологическую функцию, чем прямое руководство, и назначается он посредством Меджлиса Шур.

== История возникновения ==

В 2478 году по Солу произошёл Bluespace Incident, затронувший пять систем Республики Элизиум. Его воздействие было обнаружено не сразу, а способы борьбы с ним оставались неизвестны. Попытки покинуть сектор различными методами оказались безуспешными, система оказалась изолирована. Среди силовых структур региона была введена боевая готовность, начались регулярные патрули и ограничения на вылеты до выяснения обстоятельств.

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

Особое внимание уделялось поддержанию инфраструктурам энергетики, кораблестроения и телекоммуникаций. Для контроля за распределением ресурсов была введена система талонов.

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

Тем не менее после официального пресс-релиза властей с развернутым ответом ситуация частично стабилизировалась.
 <hr><blockquote> '''Граждане Республики Элизиум!'''
По независимым от нас причинам регион подвергся воздействию раннее неизвестных нам аномальных явлений, что привело к нарушению транспортных и коммуникационных линий с остальной Федерацией. Правительство сохраняет контроль над ситуацией.
Продовольственные резервы находятся под охраной силовых структур и будут перераспределяться в соответствии с нормами чрезвычайного положения. В ближайшие месяцы усилия будут сосредоточены на строительстве автономных производственных и энергетических комплексов, а также укреплении инфраструктуры жизнеобеспечения.
Уже ведутся исследования природы аномалии и поиск способов восстановления связи с внешним миром.
Гражданам рекомендуется сохранять спокойствие, соблюдать дисциплину и оказывать содействие местным властям.
<hr></blockquote> 
Реакция населения на заявление властей разделилась. Часть граждан восприняла его как подтверждение стабильности управления, другие сочли его недостаточно убедительным ввиду отсутствия конкретных сроков и ограниченного доступа к ресурсам.

За последующее столетие, проведённое в условиях изоляции, внутри поражённых аномалией систем сменилось несколько поколений. Новые поколения не застали влияния "Большой земли". Отсутствие поставок привело к снижению уровня жизни, промышленности, деградации образовательной системы и частичной утрате понимания технологических основ, ранее обеспечивавших развитие региона.

На стороне противников Федерации преимущественно оказалось рядовое население, не обладавшее опытом управления и склонное искать внешних виновников происходящего. В условиях затянувшейся изоляции начали действовать организованные группы провокаторов, использовавшие форму силовых структур для проведения карательных акций против недовольных. Это усилило недоверие к властям и ускорило радикализацию населения.

Фактическая власть концентрировалась у тех, кто контролировал немногочисленные логистические центры, колонии с возможностью сельскохозяйственного производства, а также редкие верфи, сохранившие способность строить и обслуживать корабли. Борьба за контроль над этими объектами становилась основной причиной вооружённых столкновений.

В результате системы постепенно перешли к состоянию гражданской войны. Колонии и станции фактически превратились в независимые политические образования, объединённые только географической близостью и общей угрозой, подобно '''Полисам - вольным городам''', которые ради своего выживания как правило используют тактику множества компромиссов. Это следствие внутриполитических интриг, которые в конечном итоге исключали формирование централизованной власти в условиях недоверия друг к другу. Основная конкуренция разворачивалась вокруг распределения продовольствия, энергетических ресурсов и производственных мощностей.

Война шла в течении нескольких десятков лет со средней интенсивностью, иногда с кратковременными перемириями. Важно отметить, что чем дольше шла эта борьба, тем больше реальные причины этого конфликта уходили на второй план, проходя через очередной цикл идеологических метаморфоз.
Основная цель Сепаратистов заключалась не во взятии каждой колонии, станции, или аванпоста, а в захвате ключевых стратегических объектов что дало бы им возможность контролировать ресурсы от которых все зависят. К моменту когда такое стало возможным уже минуло примерно столетие, и Bluespace аномалия завершила свой цикл.

== Положение в '''ER-24230''' ==

[[File:Elysium-Separatist_map.svg|500px|thumb|
'''Список систем попавших в Bluspace Storm:'''
<ul>
<li>ER-24229 (Octans Star),</li>
<li>ER-24230 (Fornax Prime),</li>
<li>ER-24232 (Air Prime),</li>
<li>ER-24233 (Southern Cross),</li>
<li>ER-24234 (Ultima Expansio)</li>
</ul>]]
Столетнее радиомолчание между Федерацией и изолированными секторами прекратилось, а вслед за этим начали частично прибывать корабли Военно-космических сил СФ.
Полностью восстановить порядок Федерация не могла: организовать крупномасштабную кампанию мешала нестабильность самой аномалии. Она по-прежнему время от времени закрывала сектор, но теперь — лишь на недели, а не на века. Феномен кратковременного "занавеса" делал невозможным полноценное военное присутствие, создавая зыбкое равновесие. Чем и пользуются силы Сепаратистов в своем стремлении сохранить за собой территории.

== Корабельные Префиксы ==

Корабли сепаратистов систематически используют префиксы '''ISV''' / '''ESV''', маскируясь под гражданские суда для сокрытия от сил Солнечной Федерации.

'''[https://map.celadon.pro/#Elysium С полным списком кораблей Elysium Separatist можно ознакомиться на этом сайте.]'''

== Джамаат ==
'''Джамаа́т''', это община, которая вместе с иными '''Джамаатами''' формируют Шуру. '''Джамааты''' обладают своими собственными территориями, а также властью на своих землях. '''Джамаатами''' могут считаться космические корабли, деревни, группировки или даже города.

=== Вертикаль власти в Сепаратистах Элизиума ===
'''Аль-Мухаририм Элисим аль-Умма''' имеет '''7 "Рангов"''' своих участников, а именно:

'''Халиф''' 
Назначаемый посредством '''Меджлиса Шур''', всеобщий предводитель всех участников '''Аль-Мухаририм Элисим аль-Умма'''. Обычно '''Халиф''' не ведёт командование на прямую, однако именно он является духовным лидером, именно за его честь воюют '''Шуры''', именно он, по их мнению, считается настоящим правителем Элизиума.

'''Шура аль-Каид''' 
Является '''Каидом''' самого престижного '''Джамаата''' в '''Шуре''', благодаря этому он и занимает пост эдакого '''Каида Шуры'''. Он не имеет прямой власти над остальными '''Джамаатами''' этой '''Шуры''', однако благодаря высокому престижу и уважению, остальные '''Каиды''' исполняют поручения и желания '''Шура аль-Каида''', поскольку если к нему не прислушиваться, то можно получить осуждение от иных '''Джамаатов'''.

'''Каид''' 
Является главой '''Джамаата'''. Считаясь старшим членом '''Джамаата''', именно они осуществляют командование более низкими чинами. '''Каидами''' могут быть лидеры общин, сёл, городов, или же обычные капитаны суден.

'''Ахиса`и''' 
Специалисты '''Джамаатов''', будь-то инженеры, врачи, иные люди, что обладают высоким образованием и опытом, а также священнослужители. Поскольку для существования организации требуется не только грубая сила, но и ум с хорошими навыками, '''Ахиса`и''' ценятся больше чем '''Мукатэлли''' и обладают большим авторитетом.

'''Мукатэлл''' 
Боевики '''Джамаатов'''. Именно они являются основной силой '''Аль-Мухаририм Элисим аль-Умма'''. Обычно они являются основным экипажем на космических суднах, именно они поддерживают порядок в '''Джамаатах''', и именно они совершают налёты, террористические акты, и все тёмные занятия.

'''Джана́хан''' 
Низшие в '''Джамаате'''. Они являются рядовыми участниками '''Джамаата''', обычно занимаются тем же, чем и '''Фалляхоны''', однако в отличие от тех же '''Фалляхонов''' они обладают каким-никаким уважением, и в случае конфликтов своего '''Джамаата''' они обязательно хватаются за автоматы и идут защищать свои '''Джамааты''', а также принимают участие в налётах под руководством '''Мукатэллов'''.

'''Фалляхон''' 
Состоящие в '''Джамаатах''' лишь наполовину, являются всего лишь обычными жителями, что работали, или проживали на территории '''Джамаата'''. Это были обычные селяне или городские жители, а также только их не преследовал статус террориста во всём '''Джамаате'''.

== Набор терминов и пояснения ==
'''Алмаждурин джанхуриети!''' - Слава Республике!

'''Аль-Мухаририм Элисим аль-Умма''' - Название Сепаратистов Элизиума на '''Элисме'''

'''Элисм''' - Национальный язык Республики Элизиум, что происходит от видоизменённого Арабского.

'''Шура''' - Объеденение '''Джааматов'''.

'''Джамаа́т''' - Община, или же территория что подчиняется 1 '''Шура аль-Каиду'''.

'''Каид''' - Дословно "Лидер". Обычно лидер '''Джамаата''' или Капитан судна.

'''Ахиса`и''' - Дословно "Специалист". Инженеры, врачи, учёные.

'''Мукатэлл''' - Дословно "Боевик". Обычный боец.

'''Джана́хан''' - Дословно "Подчинённый". Рядовой.

'''Фалляхон''' - Дословно "Крестьянин". Обычный житель что находится на территории '''Джамаата'''.

=== Рекомендации к отыгрышу ===

* Аль-Мухаририм Элисим аль-Умма не приемлет нахождение в своих рядах представителей других рас, за исключением ИПС, которые не более чем бездушный инструмент.

* Женщины в обществе радикальных взглядов как правило занимают гражданские должности.

* Позиция Аль-Мухаририм Элисим аль-Умма к скрещиванию человеческого тела с генами других существ, а так же любым представителям ксеновидов - крайне негативная, однако не является поводом для убийства.

* Ваши интересы в удержании контроля над территориями, и противостояния на основе идеологии над силами Федерации является более приоритетной задачей, чем анти-монопольная деятельность Синдиката. Вы находитесь в дружественных отношениях с данной организацией из-за схожести интересов в некоторых аспектах, а так же общих врагов. Однако, вам не стоит им всецело доверять.

[[Категория:Лор]]
[[Категория:Фракции]]

Участник:Voiko

2026-09-21T14:07:20Z

Voiko:

{{В процессе создания|worker=Voiko}}

https://wiki.celadon.pro/Участник:Voiko/Локалка
= Руководство по созданию спрайтов =
'''Спрайтеры''' - люди, занимающиеся внешним видом игры, делают в основном текстурки для игры. Их главная цель - сделать хорошо, а плохо - не сделать, пиксель арт не стремится сделать достоверную репрезентацию чего-то в игре, его цель - показать объект так, чтобы было ясно что это он и красиво его нарисовать. Обычно спрайты рисуются в разрешении '''32x32''' пикселя, но бывают и исключения, например спрайты мегафауны имеют большее разрешение.

== Терминология ==
Перед процессом спрайтингом нам предстоит немного ознакомиться с основными терминами.
<ol>
<li>'''Билд''' - папка, которую вы скачали с нашего репозитория, хранит в себе кодовую структуру и конечно же DMI файлики с нашими спрайтами.</li>
<li>'''DMI (Атлас)''' - формат файла .dmi, также может называться как '''Атлас'''. Грубо говоря это файл, который имеет в себе спрайты от одного до целого множества. Обычно именно их вы встретите в билде.</li>
<li>'''Спрайт''' (стейт) - спрайтшит, в котором может быть анимация и несколько направлений спрайта. .</li>
<li>'''VSC (Visual Studio Code)''' - программа, в которой мы можем просматривать код и спрайты, а также делать изменения. (Для редактирования спрайтов программа не годится, только для просмотра).</li>
<li>'''Dream Maker''' - стандартная программа, появляется при установке BYOND, через которую вы можете открыть атлас, импортировать или экспортировать файлы, а также редактировать сам спрайт. Будьте осторожны. При открытии спрайтов могут сгенерироваться изменения в коде, которые могут помешать запуску билда. </li>
</ol>
== Выбор программы ==
Рисовать спрайты можно где вашей душе угодно. Можно конечно всё делать сразу в встроенном редакторе byond, но лучше использовать что-то другое, ибо он устаревший и достаточно неудобен, а ещё может сломать вам билд. Большинство спрайтеров пользуются '''Aseprite''' - удобной программой специально для пиксель арта.
 
[[File:Aseprite_Logo.png|thumb|128px]]
[[File:Aseprite.png|thumb|128px|'''"Aseprite"''' - стандартная программа для редактирования DMI файлов.]]
Прежде, чем начать спрайтить, нам потребуется взять на вооружение программу, с помощью которой ты сможешь создавать самые различные спрайты объектов, мобов, снаряжения и не только. 
На выбор у нас имеются программы:
<ol>
<li> '''[https://www.aseprite.org/ Aseprite]''' - отличный выбор, используется очень часто. Вы можете получить его бесплатно, скомпилировав [https://github.com/aseprite/aseprite исходный код], или купить. Отдельно можно установить [https://github.com/spacestation13/aseprite-dmi плагин] для поддержки DMI.</li>
<li> '''[https://www.piskelapp.com/ Piskel]''' - бесплатный сайт, который позволяет редактировать спрайты без необходимости скачивания. Простенький интерфейс, с отсутствием поддержки DMI файлов/атласов.</li>
<li> '''[https://www.gimp.org/ GIMP]''' - бесплатный вариант, не особо модный, требует скачивания. Имеет интерфейс немного лучше, чем обычный Paint. Поддержка DMI отсутствует.</li>
<li> '''[https://www.adobe.com/ua/products/photoshop.html Adobe Photoshop]''' - платный вариант, но возможно для кого-то покажется удобным инструментом для редактирования PNG картинок. Поддержка DMI отсутствует.</li>
</ol>
В данном гайде мы будем ориентироваться на функционал программы "Aseprite", однако перед этим нам потребуется загрузить сердце нашего проекта, определится с выбором билда и загрузить его. 
Подразумевается, что вы уже ознакомлены с [[Запуск локального сервера|руководством по установке локального сервера]] и имеете на компьютере загруженный билд. 
'''Важно! НЕЛЬЗЯ, ЧТОБЫ НА ПУТИ ПРОГРАММЫ БЫЛА КИРИЛИЦА.'''
 
Также стоит заметить, что если вы используете программу, не созданную специально для пиксель арта, вам необходимо будет выбрать режим интерполяции “По соседним пикселям” чтобы ваш спрайт не превратился в мыло. 
[[File:sprite_settings1.png|384px]] 
[[File:sprite_settings2.png|384px]]

===Инструкция по установке расширений для Aseprite===
<ol>
<li>Запускаем Aseprite - '''Edit (Menu)''' - '''Preferences'''</li>
<li>Выбираем раздел '''Extensions''' - '''Add Extension''' - Прикрепляем файл '''Asesprite-DMI-Windows'''.</li>
</ol>
Если вдруг не работает расширение - выбираем его в этой же менюшке и нажимаем Enable.
 [[File:Aseprite_instruction1.webp|737px]]
====Работа расширения====
При перетаскивании DMI файла в окно Aseprite (обычное открытие не работает из-за отсутствия поддержки), открывается окно со всеми иконками.
<ol>'''В расширении можно:'''
<li>Создавать/изменять спрайт в стейте</li>
<li>Менять данные</li>
<li>Сохранять (работает как обычное сохранение) </li>
<li>Экспортировать в формат .dmi.</li>
</ol>
[[File:Aseprite_instruction2.webp|737px]]
===Полезные расширения для Aseprite===
<ul>
<li>[https://github.com/lufog/aseprite-language-russian Перевод для Aseprite] - расширение, что переводит интерфейс на русский язык.</li>
<li>[https://github.com/spacestation13/aseprite-dmi Поддержка DMI] - обязательный плагин, предоставляет возможность работать с DMI файлами.</li>
<li>[https://github.com/Seefaaa/aseprite-dmi Поддержка DMI №2] - резервный плагин, предоставляет возможность работать с DMI файлами. Не требует установки, если уже установлен плагин выше.</li>
</ul>

== Основы ==
В ''BYOND'' для спрайтов используются файлы формата '''.dmi''' - спрайт-лист (изображение, хранящее большое количество спрайтов). DMI файлы хранят в себе состояния (стейты), их направления, анимации и скорость её воспроизведения. 
Все спрайты в игре разбиты по разным файлам и разделены по файлам по категориям. Так намного проще ориентироваться в них и заниматься поиском нужного спрайта. 
'''Обычно спрайты отсортированы по своему назначению:'''
<ul>
<li>'''icons/obj''' - спрайты различных объектов</li>
<li>'''icons/mod''' - спрайты живых существ, одежды на куклах, спрайты предметов в руках и тд.</li>
<li>'''icons/turf''' - спрайты всех стен и полов.</li>
<li>'''icons/effects''' - спрайты для различных эффектов: от атак, щитов, крови на полу до оверлеев светa.</li>
</ul>

==== Создание DMI файла ====
<ol>
<li>Открываем DreamMaker (/BYOND/bin/dreammaker.exe)</li>
<li>В меню file выбираем “New Enviroment”</li>
<li>Если у вас уже есть Enviroment - переходите к 4 шагу</li>
<li>В открывшемся окне выбираем папку под работу с dmi и название файла .dme</li>
</ol>
 
[[File:sprite_settings3.png]]
 
В меню '''file -> New''' создаём новый файл (после создания .dme окошко сразу откроется), в поле Type выбираем Icon File, ниже укажите папку и название нового файла.
После создания .dmi файла, естественно, его надо заполнить. Сделать это можно несколькими способами:
Создайте новый стейт, зайдя в меню “'''Graphic -> New State'''” / нажав на синий плюс в верхнем левом углу / нажав ПКМ где угодно в открытом DMI файле.
 
[[File:sprite_settings4.png]]
 
Зайдя в меню Graphic -> import выберите ваш спрайт. Если выбранный файл не будет указаного в файле разрешении (обычно 32х32), то программа порежет ваш спрайт на куски.
 
Чтобы переименовать стейт нажмите дважды на его название (или no name, если он новый). Название стейта должно быть написано на латинице, маленькими буквами и разделением слов через нижнее подчёркивание.
 
'''Не забывайте часто сохранять ваш файл, ибо Dreammaker очень сильно любит вылетать в самый неподходящий момент.'''
==== Пример использования DMI файлов в коде ====
[[File:sprite_settings5.png|717px]]
 
Здесь, для спрайта предмета в игре, мы берём стейт под названием “'''gauze'''” из файла '''items.dmi''', в то время для спрайтов в левой и правой руке у персонажей мы указываем два разных файла '''items_lefthand''' и '''items_righthand''', откуда мы берём стейты с названием “'''gauze'''”, что мы указали в '''item_state'''.
== Работа с ДМИ, фишки приколы фейлы ==
DMI файлы состоят из '''стейтов''' - наборов спрайтов, аля спрайт-лист. В каждом файле спрайты сгруппированы в '''icon state''', по русски в стейты. В стейт можно добавить анимацию и до восьми направлений, то есть в него можно добавить до восьми отдельных спрайтов.
 
[[File:sprite_settings6.png|717px]]
 
На пике выше - два стейта: corgi и corgi_dead. Первый отвечает за спрайты корги, когда он жив, corgi_dead, соответственно, когда мёртв.
Посмотреть стейты в ДМИ файле можно просто открыв его в DreamMaker. В нём вы можете редактировать стейты внутри, количество их направлений и анимации.
=== Анимация ===
Стейты в DMI файлах можно анимировать, редактируя отдельные кадры в анимации. DreamMaker предоставляет несколько опций настройки анимации:
 
'''1. Количество кадров''' - чтобы изменить количество кадров в анимации нажимайте на стрелки на строке с '''frames''', или нажмите на пустой кадр после существующего.
 
[[File:sprite_settings7.gif|512px]]
 
'''2. Длительность кадра (Delay)''' - каждому кадру можно указать то, сколько миллисекунд (0.1 секунды) он будет длиться. Изменить это значение можно нажав на строку '''Delay''' под нужным кадром. На примере ниже на каждом кадре указано значение в 1 (0.1 секунды) и 10 (1 секунда).
 
[[File:sprite_settings9.gif|512px]]
 
[[File:sprite_settings8.gif|512px]]
 
'''3. Настройка воспроизведения анимации''' - изначально для стейта включено зацикливание анимации. Вы можете включить опцию Rewind (перемотка), чтобы анимация, после достижения последнего кадра, воспроизводилась обратно. Также вы можете указать количество повторов анимации, выбрав опцию times. При этом в окне демонстрации анимации она будет циклична.
 
[[File:sprite_settings10.gif|512px]]

===Направления===
Спрайтам можно задать несколько направлений. В игре они будут показываться в зависимости от того, в какую сторону обращён объект. Спрайт может иметь одно направление, четыре (↓, ↑, →, ←) или восемь (↓, ↑, →, ←, ↘, ↙, ↗, ↖). Выбрать количество направлений можно нажимая кнопки со стрелками над настройками анимации.
 
[[File:sprite_settings11.png|512px]]
 
У '''предметов''' используется одно направление, у '''мобов''', в основном - четыре, с некоторыми исключениями. Восемь направлений используются очень редко, например - спрайт турели.
===Стейты перемещения===
В окне редактирования имени стейта можно включить поставить галочку напротив Movement State. Эта опция позволяет игре использовать выбранный стейт при движении объекта. При этом имя стейта перемещения должно совпадать с именем основного стейта.
 
[[File:sprite_settings12.png|512px]]
 
[[File:sprite_settings13.gif|512px]]
===Добавление спрайтов в стейты===
Добавлять спрайты в стейты лучше всего вручную: копирование спрайта 32х32 в рабочей программе и вставка во встроенном редакторе спрайтов DreamMaker. Также если вы хотите попробовать что-то быстрее, но с дополнительными шагами, можете почитать гайд тут.

== Документация ==
Также для удобства предоставляем список материалов, с которыми можно ознакомиться для повышения собственной квалификации.
<ul>
<li>[http://gas13.ru/v3/tutorials/ru_sywtbapa_almighty_grass_tile.php Gas13] - Базовый гайд на русском языке, рекомендуется ознакомиться для начинающих спрайтеров. </li>
<li>[https://gamin.me/posts/4849 Gamin.me ] - Pixel Art для начинающих, на русском.</li>
<li>[https://hackmd.io/@Partheo/spriting Hackmd.oi/@Partheo] - Очень хороший гайд на английском, в целом по сске.</li>
<li>[https://wiki.taucetistation.org/Guide_to_Spriting Гайд по спрайтингу с Tau Ceti Station Wiki]</li>
<li>[https://tgstation13.org/wiki/Guide_to_spriting Гайд по спрайтингу с TGStation13 Wiki]</li>
</ul>

== Хоткеи ==
Основные сочетания клавиш для работы.
{| class="wikitable" style="width:100%; text-align:left; border:3px solid rgba(80,80,80,0.4); border-radius:12px; overflow:hidden;"

! style="width:220px; background-color:#a5b4d1; color:#000000; text-align:center;" |Категория
! style="width:220px; background-color:#a5b4d1; color:#000000;" |Хоткей
! style="background-color:#a5b4d1; color:#000000;" |Описание

|-
! rowspan="6" style="background-color:#f2b3b3; color:#000; text-align:center;" |Навигация и холст
|Ctrl + колесо мыши
|Зум
|-
|1 / 2 / 3 / 4 / 5
|Быстрый масштаб
|-
|H
|Рука (перемещение холста)
|-
|Ctrl + 0
|Подогнать под экран
|-
|Tab
|Скрыть интерфейс
|-
|Shift + Tab
|Скрыть панели

|-
! rowspan="11" style="background-color:#f2d2b3; color:#000; text-align:center;" |Основные инструменты
|B
|Brush (Кисть)
|-
|E
|Eraser (Ластик)
|-
|G
|Paint Bucket (Заливка)
|-
|I
|Eyedropper (Пипетка)
|-
|M
|Marquee (Выделение прямоугольником)
|-
|L
|Lasso (Свободное выделение)
|-
|U
|Shape Tool (Фигуры)
|-
|P
|Pencil (Карандаш)
|-
|C
|Contour / Polygon
|-
|K
|Ink (режимы рисования)
|-
|S
|Spray

|-
! rowspan="4" style="background-color:#f2e7b3; color:#000; text-align:center;" |Работа с цветом
|X
|Поменять местами foreground/background
|-
|D
|Сброс цветов (черный/белый)
|-
|Alt + клик
|Пипетка
|-
|Shift + I
|Color Picker (альтернативный)

|-
! rowspan="6" style="background-color:#b3f2c2; color:#000; text-align:center;" |Выделение
|Ctrl + A
|Выделить всё
|-
|Ctrl + D
|Снять выделение
|-
|Ctrl + Shift + I
|Инвертировать выделение
|-
|Alt + drag
|Перемещение выделения
|-
|Shift
|Добавить к выделению
|-
|Alt
|Убрать из выделения

|-
! rowspan="7" style="background-color:#b3d2f2; color:#000; text-align:center;" |Слои и кадры
|N
|Новый слой
|-
|Shift + N
|Новый слой сверху
|-
|Ctrl + Shift + N
|Новый слой с настройками
|-
|Delete
|Удалить слой/содержимое
|-
|Page Up / Page Down
|Переключение кадров
|-
|Alt + N
|Новый кадр
|-
|Alt + Delete
|Очистить слой

|-
! rowspan="7" style="background-color:#d0b3f2; color:#000; text-align:center;" |Редактирование
|Ctrl + Z
|Отмена
|-
|Ctrl + Y
|Повтор
|-
|Ctrl + X
|Вырезать
|-
|Ctrl + C
|Копировать
|-
|Ctrl + V
|Вставить
|-
|Ctrl + B
|Вставить в место
|-
|Ctrl + T
|Трансформация

|-
! rowspan="3" style="background-color:#f2b3e1; color:#000; text-align:center;" |Трансформации
|Ctrl + T
|Свободная трансформация
|-
|Shift
|Сохранять пропорции
|-
|Alt
|Масштаб из центра

|-
! rowspan="5" style="background-color:#f2e0b3; color:#000; text-align:center;" |Дополнительно
|F
|Flip (отразить)
|-
|Shift + F
|Отразить по вертикали
|-
|Ctrl + Shift + F
|Отразить по горизонтали
|-
|Ctrl + U
|Hue/Saturation
|-
|Ctrl + L
|Levels

|-
! rowspan="2" style="background-color:#b3f2cf; color:#000; text-align:center;" |Тайлы и пиксель-арт
|Ctrl + Shift + T
|Tile Mode
|-
|Shift + B
|Pixel Perfect (идеальные линии)

|-
! rowspan="4" style="background-color:#d6d6d6; color:#000; text-align:center;" |Полезные скрытые фишки
|Пробел / СКМ (зажать)
|Временно инструмент "рука"
|-
|Ctrl (зажать)
|Временно пипетка
|-
|Shift (при рисовании)
|Рисование прямых линий
|-
|Ctrl + drag
|Перемещение содержимого

|}
== Обзор объекта ==
В игре 4 типа объектов:

* '''Область''' – нас это не будет интересовать, так как вы не увидите ее в игре и достаточно wip-графики,
* '''Моб''' – люди, обезьяны, киборги, инопланетяне и другая живность на станции / кораблях / планетах,
* '''Объекты''' – машины, двери, предметы и все остальное в игре,
* '''Турф''' – стены, полы и пространство

== Требуемые спрайты по категориям объектов ==
Теперь расскажу вам, какие спрайты нужны различным типам предметов:

=== Мобы ===

* Спрайты мобов по большей части требуют четырех направлений.
* Спрайты мобов требуют спрайтов мертвых мобов .
* Если вы захотите, вы можете создать спрайт моба, который лежит.
* Если вы создаете моба, который может носить одежду, вы можете использовать Pixel_y, Pixel_x для смены одежды при кодировании моба.

==== Мобы с конечностями ====

* Человек и человеческий вид состоят из конечностей – головы, груди, двух рук и двух ног.
* Файлы находятся в icon/mob/human_parts.dmi для конечностей, имеющих заданный цвет, и в icon/mob/human_parts_greyscale.dmi для конечностей, которые можно перекрасить и начать использовать оттенки серого.
* Конечности имеют 4 кадра, как и полноценные иконки.
* Конечности также используются в качестве иконок предметов на случай расчленения.
* Именование следующее:
** [race]_l/r_arm/leg для рук и ног.
** [race]_chest(_m/f) для торса (м/ж для мужских/женских вариантов, необязательно)
** [race]_head(_m/f) для головы (м/ж для мужского/женского вариантов, необязательно)
* Дополнительные части тела, такие как хвосты ящерицы, помещаются в mutant_bodyparts.dmi.

=== Турфы ===

* Полы находятся в файле icon/turf/floors.dmi.
* Стены находятся в файле icon/turf/walls.dmi.
* Стены и полы шаттла находятся в файле icon/turf/shuttle.dmi.
* Космические плитки находятся в файле icon/turf/space.dmi.

=== Объекты ===

* Спрайты объектов находятся в папке icon/obj.
* Спрайты предметов разбросаны по всей папке.
* Спрайты предметов по большей части требуют наличия собственных спрайтов. Их можно найти в разделах icon/mob/items_lefthand.dmi и icon/mob/items_righthand.dmi.
* Спрайты одежды находятся в папке icon/obj/clothing.
* Спрайты одежды на мобах можно найти в папке icon/mob.
* Спрайты одежды по большей части требуют спрайтов, находящихся в руках. Их можно найти в разделах icon/mob/items_lefthand.dmi и icon/mob/items_righthand.dmi.
* Спрайты техники находятся в папке images/obj/machines. Хотя значительная их часть находится в папке icon/obj.
* Спрайты дверей расположены в папке icon/obj/door.
* Обычный спрайт двери требует Door_closed, Door_locked, Door_opening, Door_deny, Door_Closing, Door_open, Door_spark, o_door_opening, o_door_Closing, Panel_open, Welded и Elights. Предлагаю осмотреть door.dmi
* Укреплённым дверям требуются только спрайты открытия и закрытия, а также спрайты, когда они открыты и закрыты.

Участник:Voiko/Локалка

2026-09-21T14:06:32Z

Voiko: Поехали

{{В процессе создания|worker=Voiko}}

'''Локальный сервер Shiptest / Celadon'''

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

== Локальный сервер ==

Локальный сервер, или на сленге «локалка» — это сервер Space Station 13, запущенный на вашем компьютере. Причин для его запуска может быть множество — от изучения механик игры и тестирования кораблей до разработки новых предметов, карт, механик и проверки изменений в коде.

Репозиторий '''Celadon [Shiptest]:'''
[https://github.com/CeladonSS13/Shiptest GitHub — CeladonSS13/Shiptest]

Мы разберём 2 популярных варианта установки локалки.
1. Немного усложнённый, но правильный. Позволяет обновлять билд, вести полноценную разработку, запускать старые версии билда.
2. Для психопатов и лентяев. (Мы такое не одобряем)

<blockquote> '''Важно:''' названия файлов могут изменяться между версиями билда, поэтому при возникновении расхождений ориентируйтесь на структуру актуального репозитория. </blockquote>
== Приготовления и компиляция ==

=== Установка BYOND ===

Для запуска и компиляции Shiptest необходим [https://www.byond.com/download/build/515/ BYOND v.515.1647].

Скачайте и установите подходящую для текущего билда версию BYOND. Использование слишком старой или несовместимой версии может привести к ошибкам компиляции.

=== Скачивание билда ===

Откройте [https://github.com/CeladonSS13/Shiptest репозиторий Celadon Shiptest].

Убедитесь, что скачиваете ветку '''[beta-dev]''', на данный момент она является самой актуальной.
Нажмите '''Code → Download ZIP''' и дождитесь окончания скачивания.

После этого распакуйте архив в удобное место.

Например:

<pre> C:\SS13\CeladonShiptest\ </pre>
'''Настоятельно просим не использовать кириллицу в пути к билду, иначе столкнётесь с ошибками (например с комплияцией tgui).'''

=== Компиляция ===
После распаковки в основной папке должны находиться необходимые файлы проекта.

В частности, вам понадобится скрипты для компиляции в папке '''bin''':
<pre> build.cmd </pre>
Запустите его.

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

В качестве результата должен появиться файл в главной папке:
<pre> shiptest.dmb </pre> <blockquote>
'''Если компиляция завершилась ошибкой:''' не переходите к запуску сервера. Сначала исправьте ошибки, указанные компилятором. Воспользуйтесь руководством по популярным ошибкам ниже, либо обратитесь в канал '''dev''' в нашем '''Discord'''.</blockquote>
== Настройка администратора ==
'''Права администратора выдаются автоматически на локальном сервере'''. Если запускаете только для себя - следуйте дальше по инструкции, но если настраиваете сервер для друзей, то для получения прав администратора на локальном сервере необходимо добавить '''Ckey''' в конфигурацию.

Откройте:

<pre> config/admins.txt </pre>
Добавьте '''сkey''' других игроков.

Список доступных административных рангов можно посмотреть в:
<pre> config/admin_ranks.txt </pre>
Для локального тестирования обычно достаточно высокого ранга вроде <code>Host</code>.

После изменения конфигурации перезапустите сервер.



== Запуск ==

После успешной компиляции консоль пропадёт, а в основной папке у вас должен появиться:
<pre> shiptest.dmb </pre>

Используйте скрипт из той же папки '''bin''' для запуска сервера.
<pre>server.cmd</pre>

Если всё прошло успешно, то на панели задач вы заметите зелёную иконку Dream Daemon, которая уже наверняка инициализирует сервер. Откройте её.

== Настройки Dream Daemon ==

Во время запуска через Dream Daemon доступны несколько важных параметров.

=== Port ===

<code>Port</code> — порт, на котором будет работать сервер. Стандартный порт <code>1337</code>.
Если другой процесс уже использует этот порт, сервер не сможет его занять.

=== Security ===

<code>'''Security'''</code> отвечает за ограничения доступа BYOND к файлам.

Доступны несколько режимов:

; <code>Trusted</code>
: Минимальные ограничения. Удобно использовать на собственной локалке при разработке.

; <code>Safe</code>
: Более ограниченный режим.

; <code>Ultrasafe</code>
: Максимальные ограничения. Может приводить к постоянным запросам разрешений на доступ к файлам.

Для локальной разработки обычно используется <code>Trusted</code>.

<blockquote> Используйте <code>Trusted</code> осознанно: он предоставляет серверу значительно больше доступа к локальным файлам. </blockquote>
=== Visibility ===

; <code>Visibility</code> определяет видимость сервера в BYOND Hub.

; <code>Public</code>
: Сервер может отображаться публично.

; <code>Private</code>
: Сервер ограничен и не предназначен для общего публичного доступа.

; <code>Invisible</code>
: Сервер не отображается в хабе.

Для обычного локального тестирования удобнее использовать <code>Invisible</code>.

== Подключение к локальному серверу ==

Если Dream Daemon запущен на вашем компьютере и использует порт <code>1337</code>, подключиться к нему можно через:

<pre> byond://localhost:1337 </pre>
Если используется другой порт, замените <code>1337</code> на соответствующее значение.



== Обновление локалки ==

Перед обновлением билда рекомендуется сделать резервную копию пользовательских данных и конфигурации.

В первую очередь сохраните:

<pre> config/ data/ </pre>
После этого:

Скачайте новую версию билда.
Распакуйте её в отдельную папку.
Перенесите необходимые конфигурационные файлы.
При необходимости перенесите пользовательские данные.
Проверьте изменения конфигурации.
Запустите <code>build.cmd</code>.
Убедитесь, что компиляция завершилась успешно.
Запустите новый <code>shiptest.dmb</code>.
<blockquote> '''Не копируйте старую конфигурацию целиком вслепую.''' Между версиями могут появляться, удаляться или изменяться параметры конфигурационных файлов. </blockquote>

== Запуск для разработки ==

Если вы занимаетесь разработкой Shiptest, удобнее всего работать через '''Visual Studio Code''' и Dream Maker.

Перед запуском убедитесь, что:

BYOND установлен.
Используется подходящая версия BYOND.
Исходный код находится в пути без кириллицы.
<code>shiptest.dme</code> открывается корректно.
<code>BUILD.bat</code> выполняется без ошибок.
Ваш BYOND-ключ добавлен в <code>config/admins.txt</code>.
Dream Daemon не использует старую версию <code>shiptest.dmb</code>.
После изменения кода сервер был повторно скомпилирован.
=== Быстрый цикл разработки ===

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

<pre> Изменение кода => Компиляция => Запуск сервера => Тестирование => Исправление кода => Повторная компиляция </pre>
Для небольшой правки можно использовать Dream Maker:

Откройте <code>shiptest.dme</code>.
Внесите изменения.
Выполните '''Build → Compile'''.
Запустите сервер.
Проверьте результат.

== Частые проблемы ==

=== Не создаётся shiptest.dmb ===

Проверьте:
* Установлен ли BYOND.
* Совместима ли версия BYOND с билдом.
* Не повреждены ли файлы проекта.
* Что именно написано в журнале компиляции.

=== Dream Daemon не запускает сервер ===

Проверьте:
* Не занят ли указанный порт.
* Не запущен ли второй сервер на том же порту.
* Не блокирует ли подключение Windows Firewall.
* Не остался ли запущенным старый экземпляр сервера.

=== Сервер запускается, но карта работает неправильно ===

Проверьте:

* Соответствует ли карта текущему билду;
* Правильно ли указаны <code>.dmm</code>-файлы;
* Не изменялись ли связанные с картой ресурсы;

=== Полезные ссылки ===

1. [https://github.com/CeladonSS13/Shiptest Celadon Shiptest — GitHub] 
2. [https://github.com/shiptest-ss13/Shiptest Оригинальный Shiptest — GitHub] 
3. [https://wiki.celadon.pro/ Celadon Wiki] 
4. [https://www.byond.com/download/build/515/ BYOND] 
5. [https://github.com/shiptest-ss13/Shiptest/blob/master/.github/RUNNING_A_SERVER.md Официальное руководство Shiptest по запуску сервера]

Руководство по созданию карты

2026-08-31T11:28:26Z

Voiko: Изменён путь к конфигурации руин. Теперь не один файл, а отдельный файл для каждой руины

= Руководство по созданию карт =
'''В рядах Империи Celadon новое пополнение? Отлично!''' Представляю к вашему вниманию универсальный гайд для повышения квалификации!

== Выбор программы ==
Прежде, чем начать мапить, нам потребуется взять на вооружение программу, с помощью которой ты сможешь создавать самые различные карты корабликов, руин, станций и не только. 
На выбор у нас имеются несколько программ:
[[File:Sdmm-logo.png|thumb|128px|'''"StrongDMM"''' - это один исполняемый файл, не требующий установки.]]
<ol>
<li> '''[https://github.com/SpaiR/StrongDMM?tab=readme-ov-file StrongDMM]''' - это самый '''наилучший вариант''' из всех возможных. Программа имеет удобный интерфейс и также возможность работать с несколькими картами одновременно.</li>
<li> '''[https://fastdmm2.ss13.io/ Fastdmm2]''' - сайт, который позволяет редактировать карты без необходимости скачивания, есть возможность просто указать ссылку на GitHub. По большей части имеет не особо удобный интерфейс, данный вариант подойдёт больше для быстрого просмотра карт, чем для серьёзного маппинга.</li>
<li> '''Dream Maker''' - самый худший выбор для маппинга, интерфейс неудобный, в добавок отсутствует возможность полноценно редактировать все типы кораблей/руин. Просто забудь об этом варианте, ладно? Выкинь его из головы.</li>
</ol>
В данном гайде мы будем ориентироваться на функционал программы "StrongDMM", однако перед этим нам потребуется загрузить сердце нашего проекта, определится с выбором билда и загрузить его. 
Подразумевается, что вы уже ознакомлены с [[Запуск локального сервера|руководством по установке локального сервера]] и имеете на компьютере загруженный билд. 
'''Важно! НЕЛЬЗЯ, ЧТОБЫ НА ПУТИ ПРОГРАММЫ БЫЛА КИРИЛИЦА.'''
== Путеводитель по SDMM ==
Мы определились с программой и установили билд. Теперь смело открываем программу и первым делом нам требуется изменить Save Format на TGM, при работе с другим форматом вас будет ожидать целый легион ошибок, а нам это не нужно.
'''Заходим во вкладку File => Preferences и меняем Save Format на TGM'''. 
[[File:StrongDMM_Format.png]] 
Далее нужно открыть рабочее пространство (environment), т.е. мы находим папку с нашим установленным билдом, открываем и выбираем главный файл с форматом .dme, название может отличаться в зависимости от билда. 
К примеру "shiptest.dme" или "baystation12.dme". '''Внимание!''' Карты созданные с другими ресурсами билда, могут некорректно работать в другом билде из-за разных ресурсов! 
[[File:StrongDMM_Open.png]] 
[[File:StrongDMM_Maps.png|thumb|640px]]
Все изменения обязательно проводите в модульной папке - '''_maps/_mod_celadon'''! Всё остальное, что находится в папке '''_maps''', отключено или может создать проблем.
После загрузки рабочего пространства будет возможность открыть любую из карт. Соответственно карты (_maps/_mod_celadon) отсортированы по папкам:
<ol>
<li>'''_maps/_mod_celadon/configs''' - именно здесь происходит инициализация корабликов с помощью конфигов.</li>
<li>'''_maps/_mod_celadon/map_files''' - главные карты (ЦК).</li>
<li>'''_maps/_mod_celadon/outpost''' - различные карты аванпостов.</li>
<li>'''_maps/_mod_celadon/RandomRuins''' - различные руины, они также рассортированы по типам планет.</li>
<li>'''_maps/_mod_celadon/shuttles''' - космические корабли, внутри папки распределены по фракциям.</li>
<li>'''_maps/_mod_celadon/templates''' - шаблоны.</li>
</ol>
Основное рабочее пространство состоит из нескольких окон:
<ol>
<li>Режим курсора - именно здесь происходит инициализация корабликов с помощью конфигов.</li>
<li>Область карты (синий фон - область за пределами карты).</li>
<li>Все доступные в игре вещи, структуры и не только.</li>
<li>Префабы - варианты одного и того же объекта с измененными параметрами.</li>
<li>Поиск предметов по типу.</li>
<li>Параметры объекта. Подробнее об этом будет ниже.</li>
</ol>
[[File:StrongDMM_Interface.png]] 
Все окна удобно настраиваются по вашему желанию. 
Для этого нужно удерживая нужное окно подвигать его по экрану. Всё интуитивно понятно. 
[[File:StrongDMM_Interface2.png]] 
Скриншоты карт делаются самим StrongDMM:
<ol>
<li>Открыть панель шестерни.</li>
<li>Создать скриншот.</li>
<li>Создать скриншот выбранной зоны.</li>
<li>Сохранить скриншот в буфер обмена.</li>
</ol>
[[File:StrongDMM_Screenshots.png]]

== Хоткеи ==
<ol>
<li>Передвигать карту на '''СКМ (нажатие колёсика)''', зум на колёсико.</li>
<li>'''CTRL+1''' - переключает слой зон.</li>
<li>'''CTRL+2''' - переключает слой покрытий (turf).</li>
<li>'''CTRL+3''' - переключает слой объектов.</li>
<li>'''CTRL+4''' - переключает слой мобов.</li>
<li>Удерживание '''S + ЛКМ''' – пипетка.</li>
<li>Удерживание '''D + ЛКМ''' - удалить подсвеченный красным объект.</li>
<li>Удерживание '''R + ЛКМ''' - замена тайла выбранным объектом.</li>
<li>'''CTRL + N''' - новое рабочее пространство(environment).</li>
<li>'''CTRL + O''' - открыть карту.</li>
<li>'''CTRL + Q''' - выход из программы.</li>
<li>'''CTRL + Z''' - отменить последнее действие.</li>
<li>'''CTRL + SHIFT + Z''' - вернуть последнее отмененное действие.</li>
<li>'''CTRL + C''' - копирование; '''CTRL + V''' - вставить; '''CTRL + X''' - вырезать; '''DEL''' - очистить (как правило, речь идет о выбранной области через 3 режим, при этом, очищается области по периметру выделенной зеленым).</li>
<li>'''CTRL + D''' - отменить выделение.</li>
<li>'''CTRL + S''' - сохраняет карту.</li>
<li>'''CTRL + F''' - открыть строку поиска объекта.</li>
<li>'''F5''' - обновить слой</li>
<li>'''+''' - приблизить масштаб</li>
<li>'''-''' - отдалить масштаб</li>
</ol>
== Маппинг ==
'''A.T.O.M. - Area - Turf - Object - Mob''' 
В маппинге, в основном мы рассматриваем 4 типа:

1. [https://www.byond.com/docs/ref/#/area '''Зоны''']. Покрывают область и карты и говорят коду что это за территория и её свойства. От зоны работает вся электроника, зону запитывает АЦП и т.д. Свойства у зон бывают самые различные. От звуков и сообщений в чате до запрета телепортации.

2. [https://www.byond.com/docs/ref/#/turf '''Турфы''']. Пол и стены. Полы определяют какой в тайле будет газ, температура, скорость, гравитация, а стены понятно, надеюсь, что делают. Нельзя в один тайл (условная игровая клетка) поставить и пол и стену. Под стеной при разборе всегда будет базовый пол, если в коде не прописано иного.

3. [https://www.byond.com/docs/ref/#/obj '''Предметы'''] . Всё, что не было указано ранее. В том числе, но не заканчивая ими: лендмарки (точки спавна), простые предметы (столы, стулья), декали (и прочий декор типо мелковых рисунков), рандом спавнеры, машинерия (от лампочки, до консолей и всех труб), провода, и прочее.

4. [https://www.byond.com/docs/ref/#/mob '''Мобы''']. Все НПС. С мобами можно по-разному играться задавая им <s>скорость</s>, здоровье, урон и <s>лутдпроп (для продвинутых).</s>

=== Список переменных ===
У каждого типа есть список переменных. Перечислять все переменные, которые меняются у объектов можно долго, но главные указаны здесь:

[https://www.byond.com/docs/ref/#/%7Bnotes%7D/pixel-movement '''pix_x''' | '''pix_y'''] - Задают смещение от центра тайла. Вся настенная машинерия ставится над/под/слева/справа от нужного расположения на стене и поднимается в нужную сторону на 28-32 пикселя. (1 тайл - 32х32 пикселя)

[[File: Directions.png|thumb|256px|Наглядный пример направлений]]
[https://www.byond.com/docs/ref/#/atom/var/dir '''dir'''] - Направление.
2 - на игрока 1 - от игрока 4 - вправо 8 - влево. Если направлений больше, то и другие значения до 16.

'''anchored''' - Закрепление. Объект нельзя потянуть или сдвинуть если TRUE

'''Id''' и '''id_tag''' - Кнопочная машинерия. Для кнопки задается ''id'', для объекта ''id tag'' определяет поведение для дверей(болты, открыть, доступ и т.д) 
Если вам нужно, чтобы кнопка(id) открывала дверь/поддур и тд с 1 ''id_tag'' - прописывайте в ''id'' так ''“ВАШ ID_TAG”'' 
Если Вам нужно, чтобы кнопка(id) открывала дверь/поддур и тд с множеством ''id_tag'' - прописывайте в id так ''list(“ID_TAG1”,”ID_TAG2”)''. Вписывать можно сколько вашей душе угодно, главное соблюдайте синтаксис.

'''req_access (list)''' - Проверка на доступ любая машинерия и двери. Таблица доступов есть в руководстве по маппингу. Несколько доступов пишутся через запятую без пробелов. Если вы хотите привязать мультидоступ, то прописывайте его через запятую, например: req_access = list(1,19,43)

[https://www.byond.com/docs/ref/#/atom/var/icon '''Icon'''] и [https://www.byond.com/docs/ref/#/atom/var/icon_state '''icon_state'''] - Первый указывает путь до дми файла с кучей иконок, второй указывает какая именно иконка из кучи в этом файле будет показываться.

=== Каждое новое помещение начинается с зоны ===
Зона это основной способ взаимодействия тайлов с кодом игры. Будет ли в зоне электричество от апц, либо же она будет запитана магией, будет ли в ней гравитация, какой в ней будет эмбиент(звук окружения), машинерия и как она будет работать в ней и т.д.

Зоны на станциях не должны повторяться. Дело в том, что зона не обязательно должна располагаться близко, чтобы передавать всю информацию внутри себя. Если разместить одну и ту же зону на разных концах карты, то пожарная сигнализация будет срабатывать в обоих, даже если вторая вообще не имеет атмосферы. Это работает даже на разных Z уровнях!

Помните, что настраивать и изменять свойства зоны необходимо исключительно в коде!
=== Подробнее про Variables ===
[[File:sdmm_variables.png|thumb|256px|Область управления переменными]]
Данная область позволит вам творить самые настоящие тёмные колдунства при наличии хотя бы минимальных знаний понимания работы кода/переменных.
Зона Variables состоит из двух вкладок: Instance и Prefab.
'''Instance''' - Позволяет смотреть и менять параметры у одного объекта на карте.
'''Prefab''' - Также позволяет проверять параметры, однако менять параметры будет у всех таких же объектов на карте.
У вас также имеется возможность использовать некоторые параметры, чтобы показать только изменённые переменные.
<ol>
<li>'''Ctrl+1''' - '''Show modified only''' - Покажет только те переменные, что уже были изменены.</li>
<li>'''Ctrl+2''' - '''Show types''' - Покажет переменные не только объекта, но и также его родителей.</li>
<li>'''Ctrl+3''' - '''Show pins''' - Позволит закрепить необходимую переменную, чтобы не потерять её из виду. Она будет показываться в самом верху.</li>
<li>'''Ctrl+4''' - '''Show tmp, const, and static''' - Наши тёмные маги ещё не познали такую сильную магию. Об этом параметре особо ничего не известно. </li>
</ol>
== Создание кораблей и руин ==
Все текущие корабли находятся в папке '''_maps/_mod_celadon/shuttles''' и имеют сортировку по фракциями, а также там имеется отдельная папка для субшаттлов - '''_maps/_mod_celadon/shuttles/subshuttles'''. В этих папках хранятся сами карты, однако инициализация кораблей происходит благодаря папке '''_maps/_mod_celadon/configs'''.

=== Конфиг корабля ===
[[File:example_ship_config.png|thumb]]
В папке с конфигами вы можете ознакомиться со структурой и перенести её в ваш новый файл. 
Вы также можете изучить саму [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/_maps/ship_config_schema.json '''структуру'''] и пример [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/_maps/example_ship_config.json '''конфигурационного файла'''].
Пройдёмся по переменным:
<ol>
<li>'''map_name''' - Полное название корабля. Именно с таким названием игроки увидят ваш корабль в общем списке в лобби.</li>
<li>'''map_short_name''' - Краткое название карты. Обозначает класс корабля. Будет отображаться в манифесте. Не может содержать пробелы. Кроме букв доступны только дефис и нижнее подчёркивание.</li>
<li>'''description''' - Описание корабля. Будет отображаться при выборе корабля в лобби. Содержит в себе лор корабля.</li>
<li>'''map_path''' - Путь к файлу карты корабля. Например: "_maps\shuttles\inteq\inteq_colossus.dmm"</li>
<li>'''subshuttle''' - Здесь указывается конкретно название субшаттла. Не путь к файлу и не Датум.</li>
<li>'''enabled''' - Если "true" - доступно для покупки игроками. Если "false" - только для щитспавна.</li>
<li>'''limit''' - Допустимое количество для покупки корабля игроками.</li>
<li>'''space_spawn''' - По умолчанию корабль спавнится на аванпосту. Если "true", то корабль заспавнится в космосе.</li>
<li>'''prefix''' - Указывается префикс фракции. Доступные префиксы можно найти на [https://wiki.celadon.pro/index.php/Префиксы этой странице].</li>
<li>'''faction''' - Путь к датуму фракции. Доступные фракции находятся в этом файле: [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/mod_celadon/faction/code/faction.dm mod_celadon/faction/code/faction.dm], если нет необходимой - можно найти в другом файле: [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/code/modules/faction/faction_datum.dm code/modules/faction/faction_datum.dm].</li>
<li>'''tags''' - Указываются теги корабля. Их можно найти в этом файле: [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/_maps/ship_tags_descriptions_guide.txt _maps/ship_tags_descriptions_guide.txt]. На данный момент не используется. В будущем планируется использовать для сортировки кораблей.</li>
<li>'''namelists''' - Указываются кодовые названия списков, из которых корабль будет генерировать название корабля при его создании. Ознакомиться с доступными списками и названиями можно в этом файле:[https://github.com/CeladonSS13/Shiptest/blob/beta-dev/strings/ship_names.json strings/ship_names.json].</li>
<li>'''job_slots''' - Состоит из 3 частей. Название (название профессии при заходе на корабль), outfit (путь к снаряжению в коде), slots (количество доступных профессий). Доступный список снаряжений можно найти по пути [https://github.com/CeladonSS13/Shiptest/tree/beta-dev/mod_celadon/outfit/code mod_celadon/outfit/code], они имеют примерно такую структуру: ''/datum/outfit/job/фракция/профессия''.</li>
</ol>

=== Создание субшаттла ===
[[File:guide_subshuttle.png|thumb|256px|Пример датума субшаттла]]
Субшаттлы инициализируются не так, как обычные корабли, им не нужен конфиг. Они недоступны для покупки в общем списке лобби, но могут быть использованы в качестве дополнительного корабля внутри самого корабля или для отправки к примеру ЕРТ отряда с помощью администрации. Они создаются в отдельном файле: [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/mod_celadon/maps/code/subshuttles.dm mod_celadon/maps/code/subshuttles.dm].

Путь к картам субкораблей: '''_maps/_mod_celadon/shuttles/subshuttles'''.
=== Создание руины ===
[[File:ruins_dm.jpg|thumb]]
Руинки - это дополнительные локации, которые спавнятся на планетах. На одной планете может быть максимум одна руина.
При создании руины старайтесь использовать флору и фауну, которые предназначены для выбранной вами планеты.
Чтобы инициализировать руину вам потребуется закинуть карту в папку с руинами для необходимой планеты по пути: '''_maps/_mod_celadon/RandomRuins/'''.
Затем перейдите к файлу '''mod_celadon/maps/code/ruins/''', откройте необходимый файл DM с нужным типом планеты и пропишите датум, по примеру других руин в файле. Датум может иметь такие параметры:
<ol>
<li>'''Datum''' - ''[Обязательно]'' /datum/map_template/ruin/Планета/Название</li>
<li>'''name''' - ''[Обязательно]'' Полное название вашей руины</li>
<li>'''id''' - ''[Обязательно]'' Уникальное и краткое название руины, без нижних подчёркиваний. Используется функционирования для чёрного листа.</li>
<li>'''suffix''' - ''[Обязательно]'' Название вашего файла. Пример: anima_heirophant.dmm</li>
<li>'''description''' - ''[Обязательно]'' Описание вашей руины, лёгкий лор. Используется для страницы с информацией о руинах (в разработке). </li>
<li>'''cost''' - Влияет на вероятность спавна вашей руины. Чем выше стоимость, тем реже она может встретиться.</li>
<li>'''allow_duplicates''' - Если значение "False", то на весь раунд сможет появится только одна руинка.</li>
<li>'''ruin_tags''' - Используется для краткого описания руины. Теги можно найти здесь: [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/code/__DEFINES/ruins.dm code/__DEFINES/ruins.dm].</li>
<li>'''never_spawn_with''' - Не заспавнит руинку, если уже имеется указанная руина из вашего списка.</li>
</ol>
После создания датума перейдите к текстовому файлу '''map_catalogue_key.txt''' по пути: '''_maps/_mod_celadon/map_catalogue.txt''' и оставьте запись о руинке с размерами, тегами и путями.

=== Важная дополнительная информация ===
Обязательное правило для создания корабля и субшатла, чтобы он не был квадратным иначе, как бы вы не старались при постановке док портов, вы не сможете задать нужное вам направление.
[Wideband] На корабля обязательно должно присутствовать средство связи с другими кораблями.
Если вы хотите, чтобы ваша карта была добавлена на [https://map.celadon.pro вебкарту], то нужно обращаться непосредственно к хосту Celadon`a - Voiko.
Максимальные размеры руин: '''121x75'''. Максимальный размер корабля равен максимальному размеру ангара '''56x40'''.
Список кодов доступа (access) к шлюзам и так далее находится в файле [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/code_DEFINES/access.dm code/_DEFINES/access.dm].
При создании атмосферы на шипе не используйте стационарные танки с газами.

= Проверка перед публикацией =
<ol>
<li>Полы с воздухом или без него, как и должно быть? (обычный или безвоздушный)</li>
<li>[APC] - Есть ли в этой зоне ЛКП?</li>
<li>[Air Alarm] - Есть ли в этой зоне воздушная сигнализация?</li>
<li>[Outpost Communications Console] - Есть ли в этой зоне консоль запросов?</li>
<li>[Light] - Есть ли на территории освещение?</li>
<li>[Light Switch] - Есть ли в этом помещении выключатель света?</li>
<li>[Intercom] - Достаточно ли в этом зоне интеркомов?</li>
<li>[Camera] - Достаточно ли в этом зоне камер видеонаблюдения?</li>
<li>[Vent Scrubber] - Подключена ли зона к вентиляционному очистителю?</li>
<li>[Vent Pump] - Подключена ли зона к вентиляционному насосу?</li>
<li>[Fire Alarm & Fire Doors] - Есть ли на территории пожарная сигнализация и противопожарные шлюзы?</li>
<li>[Holopad] - Имеется ли голопад на вашем судне?</li>
<li>Все ли подключено правильно?</li>
<li>Все ли двери работают правильно?</li>
<li>Правильно ли настроены доступы на дверях, кнопках и т. д.?</li>
<li>Все ли предметы размещены правильно? (не ниже вентиляционных отверстий, скрубберов, столов)?</li>
<li>Правильно ли работает система мусоропровода?</li>
<li>Проверьте наличие неуместных или наложенных частей труб (воздушных и отводящих).</li>
<li>Проверьте, нет ли неуместного или наложенного куска провода.</li>
<li>Определите, насколько сложно проникнуть в эту область и где находятся слабые места, и соответствующим образом сбалансируйте область (например, Хранилище должно быть сделано из усиленных конструкций и электрифицированных окон, Кухня не должна быть сделана из этих материалов, а из обычных стен)</li>
<li>Проверьте, не слишком ли много пустого пространства. Если да, уменьшите его и замените остальные туннелями для обслуживания.</li>
<li>Есть ли нерушимые турфы там, где их не должно быть?</li>
</ol>

Файл:Ruins dm.jpg

2026-08-31T11:25:22Z

Voiko:

Руководство по спрайтингу

2026-07-28T12:55:40Z

Voiko: Update: Добавляем пометку, что статься в разработке

<code>[[Участник:Voiko|Находится в активной разработке]]: Voiko</code>

Спрайты важны, понимаешь? Если бы у нас не было спрайтов, мы бы сделали действительно дерьмовую текстовую ролевую игру Roblox 2010. Или, может быть, одна из тех DOS-игр, но многопользовательская. Вы вообще видели эти темы о ролевых играх на форумах? Вот это оно и есть. Очень старое и грустное. Таким образом, спрайтеры являются важными художниками в игре. Они заставляют мапперов ставить стены и полы, а кодеров использовать модульную организацию, а картинки мы бессовестно крадем и помещаем в вики, хехехе. У них великая цель, и они также могут хорошо развлечься — вы когда-нибудь видели спрайты, которые они кидают в дискорд? Это круто. Это действительно ахуенно. Искусство сложно, и люди выходят за рамки этого, чтобы создавать офигенные спрайты. Это работа со страстью. Я не могу выразить словами, насколько важно создание спрайтов (да, это пишет и переводит вики-редактор, который по совместительству спрайтер xdd). Упрощенные визуальные эффекты очень необходимы в игре, и работа спрайтеров, проделанная для того, чтобы это произошло, заслуживает высокой оценки.

О, вы искали настоящего гида. Извините. идите спрашивайте в #dev-спрайт [https://discord.gg/rxsggTJzY3 дискорда].

== Основы ==
Спрайты в SS13 хранятся в файлах dmi. По сути, это атлас-спрайтов в определенном формате. Вы помещаете в него PNG и даете ему имя — это состояние значка. Большинство dmis имеют размер 32x32. У вас может быть растровое изображение, представляющее собой статический спрайт, а гифки можно анимировать. BYOND также работает с 8 направлениями движения, но обычно вам понадобится только 4 или 1.

== ПО ==
Aseprite используется очень часто. Вы можете получить его бесплатно, скомпилировав исходный код, или купить. Некоторые люди также используют Piskel. Вы также можете использовать другое программное обеспечение для обработки изображений, например Paint.net. От себя ещё могу порекомендовать бесплатный GIMP, или платный Adobe Photoshop, хотя ни в том ни в другом нет функции работы с DMI

== Обзор объекта ==
В игре 4 типа объектов:

* '''Область''' – нас это не будет интересовать, так как вы не увидите ее в игре и достаточно wip-графики,
* '''Моб''' – люди, обезьяны, киборги, инопланетяне и другая живность на станции / кораблях / планетах,
* '''Объекты''' – машины, двери, предметы и все остальное в игре,
* '''Турф''' – стены, полы и пространство

== Формат файла DMI ==
Спрайты в SS13 упакованы в файлы .dmi. Чтобы создать новый файл dmi, откройте Dream Maker, выберите «Файл» > «Новый» и выберите «Файл значка (dmi)» в раскрывающемся меню. Напишите для него путь к файлу и нажмите ОК.

Откроется новое окно с пустым файлом. в правом верхнем углу есть два места для размеров спрайта. Большинство спрайтов имеют размер 32x32 пикселя. К сожалению, один dmi-файл не может содержать спрайты разных размеров.

Теперь щелкните правой кнопкой мыши где-нибудь на белизне. Существует два типа спрайтов: растровое изображение и фильм. Растровое изображение статично, а фильм можно анимировать и смотреть в разных направлениях, вот и вся разница. Давайте создадим спрайт фильма. (Новый фильм)

Откроется окно с четырьмя стрелками направления и тремя рамками для каждой из них, все серого цвета. Байонд понимает 8 направлений. Вы можете выбрать, сколько кадров вы хотите использовать, под самими спрайтами: 1, 4 или 8. Вы также можете выбрать, сколько кадров вы хотите иметь в анимации. Если вы создаете разнонаправленный статический спрайт, создайте фильм с 1 кадром, без анимации, но с 4 или 8 направлениями, в зависимости от того, сколько вам нужно. Если вы хотите анимировать спрайт, вас также может заинтересовать возможность установить задержку в 1/10 секунды над конкретным кадром. Хорошо, надеюсь, отсюда вы поймете, что делать. Встроенный инструмент редактирования спрайтов очень примитивен и единственное, о чем в нем стоит упомянуть, это о том, как применять альфа-фильтр. Если вы дважды щелкните любое изображение, вы попадете в редактор спрайтов, а справа от него находится вертикальный ползунок, управляющий альфа-каналом. Также стоит отметить, что копирование из редактора может вести себя немного странно, поскольку фон создается полностью, несмотря на установленный альфа-фильтр. Просто «залейте» фон цветом со значением альфа 0 или используйте «импорт», который отлично работает.

Теперь предположим, что мы сделали ваши спрайты спрайтами, вернитесь к файлу dmi (экран, который появился, когда вы впервые создали файл). Предполагая, что вы создали спрайт, вы увидите его в списке. Дважды щелкните чуть ниже фактического спрайта, и откроется окно переименования. Альтернативно выберите спрайт и нажмите F2 на клавиатуре. Дайте имя вашему спрайту. Это имя часто называют icon_state, поскольку это имя переменной, которая определяет его в коде.

Также обратите внимание, что вы можете импортировать и экспортировать файлы изображений разных типов, выбрав файлы, которые вы хотите экспортировать, в редакторе (удерживайте Ctrl, чтобы выбрать несколько), щелкнув правой кнопкой мыши и выбрав экспорт, или щелкнув правой кнопкой мыши в любом месте и выбрав импорт, чтобы импортировать. DMI похож на PNG, поэтому, если вы переименуете расширение DMI в PNG, оно должно работать во всех программах графического редактирования. Обычно это работает и в обратную сторону. Это ускоряет перекрашивание.

Надеюсь, это вся информация, которая вам нужна для создания спрайтов и файлов dmi.

== Требуемые спрайты по категориям объектов ==
Теперь расскажу вам, какие спрайты нужны различным типам предметов:

=== Мобы ===

* Спрайты мобов по большей части требуют четырех направлений.
* Спрайты мобов требуют спрайтов мертвых мобов .
* Если вы захотите, вы можете создать спрайт моба, который лежит.
* Если вы создаете моба, который может носить одежду, вы можете использовать Pixel_y, Pixel_x для смены одежды при кодировании моба.

==== Мобы с конечностями ====

* Человек и человеческий вид состоят из конечностей – головы, груди, двух рук и двух ног.
* Файлы находятся в icon/mob/human_parts.dmi для конечностей, имеющих заданный цвет, и в icon/mob/human_parts_greyscale.dmi для конечностей, которые можно перекрасить и начать использовать оттенки серого.
* Конечности имеют 4 кадра, как и полноценные иконки.
* Конечности также используются в качестве иконок предметов на случай расчленения.
* Именование следующее:
** [race]_l/r_arm/leg для рук и ног.
** [race]_chest(_m/f) для торса (м/ж для мужских/женских вариантов, необязательно)
** [race]_head(_m/f) для головы (м/ж для мужского/женского вариантов, необязательно)
* Дополнительные части тела, такие как хвосты ящерицы, помещаются в mutant_bodyparts.dmi.

=== Турфы ===

* Полы находятся в файле icon/turf/floors.dmi.
* Стены находятся в файле icon/turf/walls.dmi.
* Стены и полы шаттла находятся в файле icon/turf/shuttle.dmi.
* Космические плитки находятся в файле icon/turf/space.dmi.

=== Объекты ===

* Спрайты объектов находятся в папке icon/obj.
* Спрайты предметов разбросаны по всей папке.
* Спрайты предметов по большей части требуют наличия собственных спрайтов. Их можно найти в разделах icon/mob/items_lefthand.dmi и icon/mob/items_righthand.dmi.
* Спрайты одежды находятся в папке icon/obj/clothing.
* Спрайты одежды на мобах можно найти в папке icon/mob.
* Спрайты одежды по большей части требуют спрайтов, находящихся в руках. Их можно найти в разделах icon/mob/items_lefthand.dmi и icon/mob/items_righthand.dmi.
* Спрайты техники находятся в папке images/obj/machines. Хотя значительная их часть находится в папке icon/obj.
* Спрайты дверей расположены в папке icon/obj/door.
* Обычный спрайт двери требует Door_closed, Door_locked, Door_opening, Door_deny, Door_Closing, Door_open, Door_spark, o_door_opening, o_door_Closing, Panel_open, Welded и Elights. Предлагаю осмотреть door.dmi
* Укреплённым дверям требуются только спрайты открытия и закрытия, а также спрайты, когда они открыты и закрыты.

Правила игры

{{В процессе создания|worker=Voiko}}

= Руководство по созданию спрайтов =
'''Спрайтеры''' - люди, занимающиеся внешним видом игры, делают в основном текстурки для игры. Их главная цель - сделать хорошо, а плохо - не сделать, пиксель арт не стремится сделать достоверную репрезентацию чего-то в игре, его цель - показать объект так, чтобы было ясно что это он и красиво его нарисовать. Обычно спрайты рисуются в разрешении '''32x32''' пикселя, но бывают и исключения, например спрайты мегафауны имеют большее разрешение.

== Терминология ==
Перед процессом спрайтингом нам предстоит немного ознакомиться с основными терминами.
<ol>
<li>'''Билд''' - папка, которую вы скачали с нашего репозитория, хранит в себе кодовую структуру и конечно же DMI файлики с нашими спрайтами.</li>
<li>'''DMI (Атлас)''' - формат файла .dmi, также может называться как '''Атлас'''. Грубо говоря это файл, который имеет в себе спрайты от одного до целого множества. Обычно именно их вы встретите в билде.</li>
<li>'''Спрайт''' (стейт) - спрайтшит, в котором может быть анимация и несколько направлений спрайта. .</li>
<li>'''VSC (Visual Studio Code)''' - программа, в которой мы можем просматривать код и спрайты, а также делать изменения. (Для редактирования спрайтов программа не годится, только для просмотра).</li>
<li>'''Dream Maker''' - стандартная программа, появляется при установке BYOND, через которую вы можете открыть атлас, импортировать или экспортировать файлы, а также редактировать сам спрайт. Будьте осторожны. При открытии спрайтов могут сгенерироваться изменения в коде, которые могут помешать запуску билда. </li>
</ol>
== Выбор программы ==
Рисовать спрайты можно где вашей душе угодно. Можно конечно всё делать сразу в встроенном редакторе byond, но лучше использовать что-то другое, ибо он устаревший и достаточно неудобен, а ещё может сломать вам билд. Большинство спрайтеров пользуются '''Aseprite''' - удобной программой специально для пиксель арта.
Также стоит заметить, что если вы используете программу, не созданную специально для пиксель арта, вам необходимо будет выбрать режим интерполяции “По соседним пикселям” чтобы ваш спрайт не превратился в мыло. 
[[File:sprite_settings1.png|384px]] 
[[File:sprite_settings2.png|384px]]
[[File:Aseprite_Logo.png|thumb|128px]]
[[File:Aseprite.png|thumb|128px|'''"Aseprite"''' - стандартная программа для редактирования DMI файлов.]]
Прежде, чем начать спрайтить, нам потребуется взять на вооружение программу, с помощью которой ты сможешь создавать самые различные спрайты объектов, мобов, снаряжения и не только. 
На выбор у нас имеются программы:
<ol>
<li> '''[https://www.aseprite.org/ Aseprite]''' - отличный выбор, используется очень часто. Вы можете получить его бесплатно, скомпилировав [https://github.com/aseprite/aseprite исходный код], или купить. Отдельно можно установить [https://github.com/spacestation13/aseprite-dmi плагин] для поддержки DMI.</li>
<li> '''[https://www.piskelapp.com/ Piskel]''' - бесплатный сайт, который позволяет редактировать спрайты без необходимости скачивания. Простенький интерфейс, с отсутствием поддержки DMI файлов/атласов.</li>
<li> '''[https://www.gimp.org/ GIMP]''' - бесплатный вариант, не особо модный, требует скачивания. Имеет интерфейс немного лучше, чем обычный Paint. Поддержка DMI отсутствует.</li>
<li> '''[https://www.adobe.com/ua/products/photoshop.html Adobe Photoshop]''' - платный вариант, но возможно для кого-то покажется удобным инструментом для редактирования PNG картинок. Поддержка DMI отсутствует.</li>
</ol>
В данном гайде мы будем ориентироваться на функционал программы "Aseprite", однако перед этим нам потребуется загрузить сердце нашего проекта, определится с выбором билда и загрузить его. 
Подразумевается, что вы уже ознакомлены с [[Запуск локального сервера|руководством по установке локального сервера]] и имеете на компьютере загруженный билд. 
'''Важно! НЕЛЬЗЯ, ЧТОБЫ НА ПУТИ ПРОГРАММЫ БЫЛА КИРИЛИЦА.'''
===Инструкция по установке расширений для Aseprite===
<ol>
<li>Запускаем Aseprite - '''Edit (Menu)''' - '''Preferences'''</li>
<li>Выбираем раздел '''Extensions''' - '''Add Extension''' - Прикрепляем файл '''Asesprite-DMI-Windows'''.</li>
</ol>
Если вдруг не работает расширение - выбираем его в этой же менюшке и нажимаем Enable.
 [[File:Aseprite_instruction1.webp|737px]]
====Работа расширения====
При перетаскивании DMI файла в окно Aseprite (обычное открытие не работает из-за отсутствия поддержки), открывается окно со всеми иконками.
<ol>'''В расширении можно:'''
<li>Создавать/изменять спрайт в стейте</li>
<li>Менять данные</li>
<li>Сохранять (работает как обычное сохранение) </li>
<li>Экспортировать в формат .dmi.</li>
</ol>
[[File:Aseprite_instruction2.webp|737px]]
===Полезные расширения для Aseprite===
<ul>
<li>[https://github.com/lufog/aseprite-language-russian Перевод для Aseprite] - расширение, что переводит интерфейс на русский язык.</li>
<li>[https://github.com/spacestation13/aseprite-dmi Поддержка DMI] - обязательный плагин, предоставляет возможность работать с DMI файлами.</li>
<li>[https://github.com/Seefaaa/aseprite-dmi Поддержка DMI №2] - резервный плагин, предоставляет возможность работать с DMI файлами. Не требует установки, если уже установлен плагин выше.</li>
</ul>
== Основы ==
В ''BYOND'' для спрайтов используются файлы формата '''.dmi''' - спрайт-лист (изображение, хранящее большое количество спрайтов). DMI файлы хранят в себе состояния (стейты), их направления, анимации и скорость её воспроизведения. 
Все спрайты в игре разбиты по разным файлам и разделены по файлам по категориям. Так намного проще ориентироваться в них и заниматься поиском нужного спрайта. 
'''Обычно спрайты отсортированы по своему назначению:'''
<ul>
<li>'''icons/obj''' - спрайты различных объектов</li>
<li>'''icons/mod''' - спрайты живых существ, одежды на куклах, спрайты предметов в руках и тд.</li>
<li>'''icons/turf''' - спрайты всех стен и полов.</li>
<li>'''icons/effects''' - спрайты для различных эффектов: от атак, щитов, крови на полу до оверлеев светa.</li>
</ul>

==== Создание DMI файла ====
<ol>
<li>Открываем DreamMaker (/BYOND/bin/dreammaker.exe)</li>
<li>В меню file выбираем “New Enviroment”</li>
<li>Если у вас уже есть Enviroment - переходите к 4 шагу</li>
<li>В открывшемся окне выбираем папку под работу с dmi и название файла .dme</li>
</ol>
 
[[File:sprite_settings3.png]]
 
В меню '''file -> New''' создаём новый файл (после создания .dme окошко сразу откроется), в поле Type выбираем Icon File, ниже укажите папку и название нового файла.
После создания .dmi файла, естественно, его надо заполнить. Сделать это можно несколькими способами:
Создайте новый стейт, зайдя в меню “'''Graphic -> New State'''” / нажав на синий плюс в верхнем левом углу / нажав ПКМ где угодно в открытом DMI файле.
 
[[File:sprite_settings4.png]]
 
Зайдя в меню Graphic -> import выберите ваш спрайт. Если выбранный файл не будет указаного в файле разрешении (обычно 32х32), то программа порежет ваш спрайт на куски.
 
Чтобы переименовать стейт нажмите дважды на его название (или no name, если он новый). Название стейта должно быть написано на латинице, маленькими буквами и разделением слов через нижнее подчёркивание.
 
'''Не забывайте часто сохранять ваш файл, ибо Dreammaker очень сильно любит вылетать в самый неподходящий момент.'''
==== Пример использования DMI файлов в коде ====
[[File:sprite_settings5.png|717px]]
 
Здесь, для спрайта предмета в игре, мы берём стейт под названием “'''gauze'''” из файла '''items.dmi''', в то время для спрайтов в левой и правой руке у персонажей мы указываем два разных файла '''items_lefthand''' и '''items_righthand''', откуда мы берём стейты с названием “'''gauze'''”, что мы указали в '''item_state'''.
== Работа с ДМИ, фишки приколы фейлы ==
DMI файлы состоят из '''стейтов''' - наборов спрайтов, аля спрайт-лист. В каждом файле спрайты сгруппированы в '''icon state''', по русски в стейты. В стейт можно добавить анимацию и до восьми направлений, то есть в него можно добавить до восьми отдельных спрайтов.
 
[[File:sprite_settings6.png|717px]]
 
На пике выше - два стейта: corgi и corgi_dead. Первый отвечает за спрайты корги, когда он жив, corgi_dead, соответственно, когда мёртв.
Посмотреть стейты в ДМИ файле можно просто открыв его в DreamMaker. В нём вы можете редактировать стейты внутри, количество их направлений и анимации.
=== Анимация ===
Стейты в DMI файлах можно анимировать, редактируя отдельные кадры в анимации. DreamMaker предоставляет несколько опций настройки анимации:
 
'''1. Количество кадров''' - чтобы изменить количество кадров в анимации нажимайте на стрелки на строке с '''frames''', или нажмите на пустой кадр после существующего.
 
[[File:sprite_settings7.gif|512px]]
 
'''2. Длительность кадра (Delay)''' - каждому кадру можно указать то, сколько миллисекунд (0.1 секунды) он будет длиться. Изменить это значение можно нажав на строку '''Delay''' под нужным кадром. На примере ниже на каждом кадре указано значение в 1 (0.1 секунды) и 10 (1 секунда).
 
[[File:sprite_settings8.gif|512px]]
 
'''3. Настройка воспроизведения анимации''' - изначально для стейта включено зацикливание анимации. Вы можете включить опцию Rewind (перемотка), чтобы анимация, после достижения последнего кадра, воспроизводилась обратно. Также вы можете указать количество повторов анимации, выбрав опцию times. При этом в окне демонстрации анимации она будет циклична.

== Документация ==
Также для удобства предоставляем список материалов, с которыми можно ознакомиться для повышения собственной квалификации.
<ul>
<li>[http://gas13.ru/v3/tutorials/ru_sywtbapa_almighty_grass_tile.php Gas13] - Базовый гайд на русском языке, рекомендуется ознакомиться для начинающих спрайтеров. </li>
<li>[https://gamin.me/posts/4849 Gamin.me ] - Pixel Art для начинающих, на русском.</li>
<li>[https://hackmd.io/@Partheo/spriting Hackmd.oi/@Partheo] - Очень хороший гайд на английском, в целом по сске.</li>
<li>[https://wiki.taucetistation.org/Guide_to_Spriting Гайд по спрайтингу с Tau Ceti Station Wiki]</li>
<li>[https://tgstation13.org/wiki/Guide_to_spriting Гайд по спрайтингу с TGStation13 Wiki]</li>
</ul>

== Хоткеи ==
Основные сочетания клавиш для работы.
{| class="wikitable" style="width:100%; text-align:left; border:3px solid rgba(80,80,80,0.4); border-radius:12px; overflow:hidden;"

! style="width:220px; background-color:#a5b4d1; color:#000000; text-align:center;" |Категория
! style="width:220px; background-color:#a5b4d1; color:#000000;" |Хоткей
! style="background-color:#a5b4d1; color:#000000;" |Описание

|-
! rowspan="6" style="background-color:#f2b3b3; color:#000; text-align:center;" |Навигация и холст
|Ctrl + колесо мыши
|Зум
|-
|1 / 2 / 3 / 4 / 5
|Быстрый масштаб
|-
|H
|Рука (перемещение холста)
|-
|Ctrl + 0
|Подогнать под экран
|-
|Tab
|Скрыть интерфейс
|-
|Shift + Tab
|Скрыть панели

|-
! rowspan="11" style="background-color:#f2d2b3; color:#000; text-align:center;" |Основные инструменты
|B
|Brush (Кисть)
|-
|E
|Eraser (Ластик)
|-
|G
|Paint Bucket (Заливка)
|-
|I
|Eyedropper (Пипетка)
|-
|M
|Marquee (Выделение прямоугольником)
|-
|L
|Lasso (Свободное выделение)
|-
|U
|Shape Tool (Фигуры)
|-
|P
|Pencil (Карандаш)
|-
|C
|Contour / Polygon
|-
|K
|Ink (режимы рисования)
|-
|S
|Spray

|-
! rowspan="4" style="background-color:#f2e7b3; color:#000; text-align:center;" |Работа с цветом
|X
|Поменять местами foreground/background
|-
|D
|Сброс цветов (черный/белый)
|-
|Alt + клик
|Пипетка
|-
|Shift + I
|Color Picker (альтернативный)

|-
! rowspan="6" style="background-color:#b3f2c2; color:#000; text-align:center;" |Выделение
|Ctrl + A
|Выделить всё
|-
|Ctrl + D
|Снять выделение
|-
|Ctrl + Shift + I
|Инвертировать выделение
|-
|Alt + drag
|Перемещение выделения
|-
|Shift
|Добавить к выделению
|-
|Alt
|Убрать из выделения

|-
! rowspan="7" style="background-color:#b3d2f2; color:#000; text-align:center;" |Слои и кадры
|N
|Новый слой
|-
|Shift + N
|Новый слой сверху
|-
|Ctrl + Shift + N
|Новый слой с настройками
|-
|Delete
|Удалить слой/содержимое
|-
|Page Up / Page Down
|Переключение кадров
|-
|Alt + N
|Новый кадр
|-
|Alt + Delete
|Очистить слой

|-
! rowspan="7" style="background-color:#d0b3f2; color:#000; text-align:center;" |Редактирование
|Ctrl + Z
|Отмена
|-
|Ctrl + Y
|Повтор
|-
|Ctrl + X
|Вырезать
|-
|Ctrl + C
|Копировать
|-
|Ctrl + V
|Вставить
|-
|Ctrl + B
|Вставить в место
|-
|Ctrl + T
|Трансформация

|-
! rowspan="3" style="background-color:#f2b3e1; color:#000; text-align:center;" |Трансформации
|Ctrl + T
|Свободная трансформация
|-
|Shift
|Сохранять пропорции
|-
|Alt
|Масштаб из центра

|-
! rowspan="5" style="background-color:#f2e0b3; color:#000; text-align:center;" |Дополнительно
|F
|Flip (отразить)
|-
|Shift + F
|Отразить по вертикали
|-
|Ctrl + Shift + F
|Отразить по горизонтали
|-
|Ctrl + U
|Hue/Saturation
|-
|Ctrl + L
|Levels

|-
! rowspan="2" style="background-color:#b3f2cf; color:#000; text-align:center;" |Тайлы и пиксель-арт
|Ctrl + Shift + T
|Tile Mode
|-
|Shift + B
|Pixel Perfect (идеальные линии)

|-
! rowspan="4" style="background-color:#d6d6d6; color:#000; text-align:center;" |Полезные скрытые фишки
|Пробел / СКМ (зажать)
|Временно инструмент "рука"
|-
|Ctrl (зажать)
|Временно пипетка
|-
|Shift (при рисовании)
|Рисование прямых линий
|-
|Ctrl + drag
|Перемещение содержимого

|}
== Основы ==
Спрайты в SS13 хранятся в файлах dmi. По сути, это атлас-спрайтов в определенном формате. Вы помещаете в него PNG и даете ему имя — это состояние значка. Большинство dmis имеют размер 32x32. У вас может быть растровое изображение, представляющее собой статический спрайт, а гифки можно анимировать. BYOND также работает с 8 направлениями движения, но обычно вам понадобится только 4 или 1.

== ПО ==
Aseprite используется очень часто. Вы можете получить его бесплатно, скомпилировав исходный код, или купить. Некоторые люди также используют Piskel. Вы также можете использовать другое программное обеспечение для обработки изображений, например Paint.net. От себя ещё могу порекомендовать бесплатный GIMP, или платный Adobe Photoshop, хотя ни в том ни в другом нет функции работы с DMI

== Обзор объекта ==
В игре 4 типа объектов:

* '''Область''' – нас это не будет интересовать, так как вы не увидите ее в игре и достаточно wip-графики,
* '''Моб''' – люди, обезьяны, киборги, инопланетяне и другая живность на станции / кораблях / планетах,
* '''Объекты''' – машины, двери, предметы и все остальное в игре,
* '''Турф''' – стены, полы и пространство

== Формат файла DMI ==
Спрайты в SS13 упакованы в файлы .dmi. Чтобы создать новый файл dmi, откройте Dream Maker, выберите «Файл» > «Новый» и выберите «Файл значка (dmi)» в раскрывающемся меню. Напишите для него путь к файлу и нажмите ОК.

Откроется новое окно с пустым файлом. в правом верхнем углу есть два места для размеров спрайта. Большинство спрайтов имеют размер 32x32 пикселя. К сожалению, один dmi-файл не может содержать спрайты разных размеров.

Теперь щелкните правой кнопкой мыши где-нибудь на белизне. Существует два типа спрайтов: растровое изображение и фильм. Растровое изображение статично, а фильм можно анимировать и смотреть в разных направлениях, вот и вся разница. Давайте создадим спрайт фильма. (Новый фильм)

Откроется окно с четырьмя стрелками направления и тремя рамками для каждой из них, все серого цвета. Байонд понимает 8 направлений. Вы можете выбрать, сколько кадров вы хотите использовать, под самими спрайтами: 1, 4 или 8. Вы также можете выбрать, сколько кадров вы хотите иметь в анимации. Если вы создаете разнонаправленный статический спрайт, создайте фильм с 1 кадром, без анимации, но с 4 или 8 направлениями, в зависимости от того, сколько вам нужно. Если вы хотите анимировать спрайт, вас также может заинтересовать возможность установить задержку в 1/10 секунды над конкретным кадром. Хорошо, надеюсь, отсюда вы поймете, что делать. Встроенный инструмент редактирования спрайтов очень примитивен и единственное, о чем в нем стоит упомянуть, это о том, как применять альфа-фильтр. Если вы дважды щелкните любое изображение, вы попадете в редактор спрайтов, а справа от него находится вертикальный ползунок, управляющий альфа-каналом. Также стоит отметить, что копирование из редактора может вести себя немного странно, поскольку фон создается полностью, несмотря на установленный альфа-фильтр. Просто «залейте» фон цветом со значением альфа 0 или используйте «импорт», который отлично работает.

Теперь предположим, что мы сделали ваши спрайты спрайтами, вернитесь к файлу dmi (экран, который появился, когда вы впервые создали файл). Предполагая, что вы создали спрайт, вы увидите его в списке. Дважды щелкните чуть ниже фактического спрайта, и откроется окно переименования. Альтернативно выберите спрайт и нажмите F2 на клавиатуре. Дайте имя вашему спрайту. Это имя часто называют icon_state, поскольку это имя переменной, которая определяет его в коде.

Также обратите внимание, что вы можете импортировать и экспортировать файлы изображений разных типов, выбрав файлы, которые вы хотите экспортировать, в редакторе (удерживайте Ctrl, чтобы выбрать несколько), щелкнув правой кнопкой мыши и выбрав экспорт, или щелкнув правой кнопкой мыши в любом месте и выбрав импорт, чтобы импортировать. DMI похож на PNG, поэтому, если вы переименуете расширение DMI в PNG, оно должно работать во всех программах графического редактирования. Обычно это работает и в обратную сторону. Это ускоряет перекрашивание.

Надеюсь, это вся информация, которая вам нужна для создания спрайтов и файлов dmi.

== Требуемые спрайты по категориям объектов ==
Теперь расскажу вам, какие спрайты нужны различным типам предметов:

=== Мобы ===

* Спрайты мобов по большей части требуют четырех направлений.
* Спрайты мобов требуют спрайтов мертвых мобов .
* Если вы захотите, вы можете создать спрайт моба, который лежит.
* Если вы создаете моба, который может носить одежду, вы можете использовать Pixel_y, Pixel_x для смены одежды при кодировании моба.

==== Мобы с конечностями ====

* Человек и человеческий вид состоят из конечностей – головы, груди, двух рук и двух ног.
* Файлы находятся в icon/mob/human_parts.dmi для конечностей, имеющих заданный цвет, и в icon/mob/human_parts_greyscale.dmi для конечностей, которые можно перекрасить и начать использовать оттенки серого.
* Конечности имеют 4 кадра, как и полноценные иконки.
* Конечности также используются в качестве иконок предметов на случай расчленения.
* Именование следующее:
** [race]_l/r_arm/leg для рук и ног.
** [race]_chest(_m/f) для торса (м/ж для мужских/женских вариантов, необязательно)
** [race]_head(_m/f) для головы (м/ж для мужского/женского вариантов, необязательно)
* Дополнительные части тела, такие как хвосты ящерицы, помещаются в mutant_bodyparts.dmi.

=== Турфы ===

* Полы находятся в файле icon/turf/floors.dmi.
* Стены находятся в файле icon/turf/walls.dmi.
* Стены и полы шаттла находятся в файле icon/turf/shuttle.dmi.
* Космические плитки находятся в файле icon/turf/space.dmi.

=== Объекты ===

* Спрайты объектов находятся в папке icon/obj.
* Спрайты предметов разбросаны по всей папке.
* Спрайты предметов по большей части требуют наличия собственных спрайтов. Их можно найти в разделах icon/mob/items_lefthand.dmi и icon/mob/items_righthand.dmi.
* Спрайты одежды находятся в папке icon/obj/clothing.
* Спрайты одежды на мобах можно найти в папке icon/mob.
* Спрайты одежды по большей части требуют спрайтов, находящихся в руках. Их можно найти в разделах icon/mob/items_lefthand.dmi и icon/mob/items_righthand.dmi.
* Спрайты техники находятся в папке images/obj/machines. Хотя значительная их часть находится в папке icon/obj.
* Спрайты дверей расположены в папке icon/obj/door.
* Обычный спрайт двери требует Door_closed, Door_locked, Door_opening, Door_deny, Door_Closing, Door_open, Door_spark, o_door_opening, o_door_Closing, Panel_open, Welded и Elights. Предлагаю осмотреть door.dmi
* Укреплённым дверям требуются только спрайты открытия и закрытия, а также спрайты, когда они открыты и закрыты.

== Маппинг ==
'''A.T.O.M. - Area - Turf - Object - Mob''' 
В маппинге, в основном мы рассматриваем 4 типа:

1. [https://www.byond.com/docs/ref/#/area '''Зоны''']. Покрывают область и карты и говорят коду что это за территория и её свойства. От зоны работает вся электроника, зону запитывает АЦП и т.д. Свойства у зон бывают самые различные. От звуков и сообщений в чате до запрета телепортации.

2. [https://www.byond.com/docs/ref/#/turf '''Турфы''']. Пол и стены. Полы определяют какой в тайле будет газ, температура, скорость, гравитация, а стены понятно, надеюсь, что делают. Нельзя в один тайл (условная игровая клетка) поставить и пол и стену. Под стеной при разборе всегда будет базовый пол, если в коде не прописано иного.

3. [https://www.byond.com/docs/ref/#/obj '''Предметы'''] . Всё, что не было указано ранее. В том числе, но не заканчивая ими: лендмарки (точки спавна), простые предметы (столы, стулья), декали (и прочий декор типо мелковых рисунков), рандом спавнеры, машинерия (от лампочки, до консолей и всех труб), провода, и прочее.

4. [https://www.byond.com/docs/ref/#/mob '''Мобы''']. Все НПС. С мобами можно по-разному играться задавая им <s>скорость</s>, здоровье, урон и <s>лутдпроп (для продвинутых).</s>

=== Список переменных ===
У каждого типа есть список переменных. Перечислять все переменные, которые меняются у объектов можно долго, но главные указаны здесь:

[https://www.byond.com/docs/ref/#/%7Bnotes%7D/pixel-movement '''pix_x''' | '''pix_y'''] - Задают смещение от центра тайла. Вся настенная машинерия ставится над/под/слева/справа от нужного расположения на стене и поднимается в нужную сторону на 28-32 пикселя. (1 тайл - 32х32 пикселя)

[[File: Directions.png|thumb|256px|Наглядный пример направлений]]
[https://www.byond.com/docs/ref/#/atom/var/dir '''dir'''] - Направление.
2 - на игрока 1 - от игрока 4 - вправо 8 - влево. Если направлений больше, то и другие значения до 16.

'''anchored''' - Закрепление. Объект нельзя потянуть или сдвинуть если TRUE

'''Id''' и '''id_tag''' - Кнопочная машинерия. Для кнопки задается ''id'', для объекта ''id tag'' определяет поведение для дверей(болты, открыть, доступ и т.д) 
Если вам нужно, чтобы кнопка(id) открывала дверь/поддур и тд с 1 ''id_tag'' - прописывайте в ''id'' так ''“ВАШ ID_TAG”'' 
Если Вам нужно, чтобы кнопка(id) открывала дверь/поддур и тд с множеством ''id_tag'' - прописывайте в id так ''list(“ID_TAG1”,”ID_TAG2”)''. Вписывать можно сколько вашей душе угодно, главное соблюдайте синтаксис.

'''req_access (list)''' - Проверка на доступ любая машинерия и двери. Таблица доступов есть в руководстве по маппингу. Несколько доступов пишутся через запятую без пробелов. Если вы хотите привязать мультидоступ, то прописывайте его через запятую, например: req_access = list(1,19,43)

[https://www.byond.com/docs/ref/#/atom/var/icon '''Icon'''] и [https://www.byond.com/docs/ref/#/atom/var/icon_state '''icon_state'''] - Первый указывает путь до дми файла с кучей иконок, второй указывает какая именно иконка из кучи в этом файле будет показываться.

=== Каждое новое помещение начинается с зоны ===
Зона это основной способ взаимодействия тайлов с кодом игры. Будет ли в зоне электричество от апц, либо же она будет запитана магией, будет ли в ней гравитация, какой в ней будет эмбиент(звук окружения), машинерия и как она будет работать в ней и т.д.

Зоны на станциях не должны повторяться. Дело в том, что зона не обязательно должна располагаться близко, чтобы передавать всю информацию внутри себя. Если разместить одну и ту же зону на разных концах карты, то пожарная сигнализация будет срабатывать в обоих, даже если вторая вообще не имеет атмосферы. Это работает даже на разных Z уровнях!

Помните, что настраивать и изменять свойства зоны необходимо исключительно в коде!
=== Подробнее про Variables ===
[[File:sdmm_variables.png|thumb|256px|Область управления переменными]]
Данная область позволит вам творить самые настоящие тёмные колдунства при наличии хотя бы минимальных знаний понимания работы кода/переменных.
Зона Variables состоит из двух вкладок: Instance и Prefab.
'''Instance''' - Позволяет смотреть и менять параметры у одного объекта на карте.
'''Prefab''' - Также позволяет проверять параметры, однако менять параметры будет у всех таких же объектов на карте.
У вас также имеется возможность использовать некоторые параметры, чтобы показать только изменённые переменные.
<ol>
<li>'''Ctrl+1''' - '''Show modified only''' - Покажет только те переменные, что уже были изменены.</li>
<li>'''Ctrl+2''' - '''Show types''' - Покажет переменные не только объекта, но и также его родителей.</li>
<li>'''Ctrl+3''' - '''Show pins''' - Позволит закрепить необходимую переменную, чтобы не потерять её из виду. Она будет показываться в самом верху.</li>
<li>'''Ctrl+4''' - '''Show tmp, const, and static''' - Наши тёмные маги ещё не познали такую сильную магию. Об этом параметре особо ничего не известно. </li>
</ol>
== Создание кораблей и руин ==
Все текущие корабли находятся в папке '''_maps/_mod_celadon/shuttles''' и имеют сортировку по фракциями, а также там имеется отдельная папка для субшаттлов - '''_maps/_mod_celadon/shuttles/subshuttles'''. В этих папках хранятся сами карты, однако инициализация кораблей происходит благодаря папке '''_maps/_mod_celadon/configs'''.

=== Конфиг корабля ===
[[File:example_ship_config.png|thumb]]
В папке с конфигами вы можете ознакомиться со структурой и перенести её в ваш новый файл. 
Вы также можете изучить саму [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/_maps/ship_config_schema.json '''структуру'''] и пример [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/_maps/example_ship_config.json '''конфигурационного файла'''].
Пройдёмся по переменным:
<ol>
<li>'''map_name''' - Полное название корабля. Именно с таким названием игроки увидят ваш корабль в общем списке в лобби.</li>
<li>'''map_short_name''' - Краткое название карты. Обозначает класс корабля. Будет отображаться в манифесте. Не может содержать пробелы. Кроме букв доступны только дефис и нижнее подчёркивание.</li>
<li>'''description''' - Описание корабля. Будет отображаться при выборе корабля в лобби. Содержит в себе лор корабля.</li>
<li>'''map_path''' - Путь к файлу карты корабля. Например: "_maps\shuttles\inteq\inteq_colossus.dmm"</li>
<li>'''enabled''' - Если "true" - доступно для покупки игроками. Если "false" - только для щитспавна.</li>
<li>'''limit''' - Допустимое количество для покупки корабля игроками.</li>
<li>'''space_spawn''' - По умолчанию корабль спавнится на аванпосту. Если "true", то корабль заспавнится в космосе.</li>
<li>'''prefix''' - Указывается префикс фракции. Доступные префиксы можно найти на [https://wiki.celadon.pro/index.php/Префиксы этой странице].</li>
<li>'''faction''' - Путь к датуму фракции. Доступные фракции находятся в этом файле: [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/mod_celadon/faction/code/faction.dm mod_celadon/faction/code/faction.dm], если нет необходимой - можно найти в другом файле: [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/code/modules/faction/faction_datum.dm code/modules/faction/faction_datum.dm].</li>
<li>'''tags''' - Указываются теги корабля. Их можно найти в этом файле: [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/_maps/ship_tags_descriptions_guide.txt _maps/ship_tags_descriptions_guide.txt]. На данный момент не используется. В будущем планируется использовать для сортировки кораблей.</li>
<li>'''namelists''' - Указываются кодовые названия списков, из которых корабль будет генерировать название корабля при его создании. Ознакомиться с доступными списками и названиями можно в этом файле:[https://github.com/CeladonSS13/Shiptest/blob/beta-dev/strings/ship_names.json strings/ship_names.json].</li>
<li>'''job_slots''' - Состоит из 3 частей. Название (название профессии при заходе на корабль), outfit (путь к снаряжению в коде), slots (количество доступных профессий). Доступный список снаряжений можно найти по пути [https://github.com/CeladonSS13/Shiptest/tree/beta-dev/mod_celadon/outfit/code mod_celadon/outfit/code], они имеют примерно такую структуру: ''/datum/outfit/job/фракция/профессия''.</li>
</ol>

=== Создание субшаттла ===
[[File:guide_subshuttle.png|thumb|256px|Пример датума субшаттла]]
Субшаттлы инициализируются не так, как обычные корабли, им не нужен конфиг. Они недоступны для покупки в общем списке лобби, но могут быть использованы в качестве дополнительного корабля внутри самого корабля или для отправки к примеру ЕРТ отряда с помощью администрации. Они создаются в отдельном файле: [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/mod_celadon/maps/code/subshuttles.dm mod_celadon/maps/code/subshuttles.dm].

Путь к картам субкораблей: '''_maps/_mod_celadon/shuttles/subshuttles'''.
=== Создание руины ===
Руинки - это дополнительные локации, которые спавнятся на планетах. На одной планете может быть максимум одна руина.
При создании руины старайтесь использовать флору и фауну, которые предназначены для выбранной вами планеты.
Чтобы инициализировать руину вам потребуется закинуть карту в папку с руинами для необходимой планеты по пути: '''_maps/_mod_celadon/RandomRuins/'''.
Затем перейдите к файлу '''mod_celadon/maps/code/ruins/ruin.dm''' и пропишите датум, по примеру других руин в файле. Датум может иметь такие параметры:
<ol>
<li>'''Datum''' - ''[Обязательно]'' /datum/map_template/ruin/Планета/Название</li>
<li>'''name''' - ''[Обязательно]'' Полное название вашей руины</li>
<li>'''id''' - ''[Обязательно]'' Уникальное и краткое название руины, без нижних подчёркиваний. Используется функционирования для чёрного листа.</li>
<li>'''suffix''' - ''[Обязательно]'' Название вашего файла. Пример: anima_heirophant.dmm</li>
<li>'''description''' - ''[Обязательно]'' Описание вашей руины, лёгкий лор. Используется для страницы с информацией о руинах (в разработке). </li>
<li>'''cost''' - Влияет на вероятность спавна вашей руины. Чем выше стоимость, тем реже она может встретиться.</li>
<li>'''allow_duplicates''' - Если значение "False", то на весь раунд сможет появится только одна руинка.</li>
<li>'''ruin_tags''' - Используется для краткого описания руины. Теги можно найти здесь: [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/code/__DEFINES/ruins.dm code/__DEFINES/ruins.dm].</li>
<li>'''never_spawn_with''' - Не заспавнит руинку, если уже имеется указанная руина из вашего списка.</li>
</ol>
После создания датума перейдите к текстовому файлу '''map_catalogue_key.txt''' по пути: '''_maps/_mod_celadon/map_catalogue.txt''' и оставьте запись о руинке с размерами, тегами и путями.

=== Важная дополнительная информация ===
Обязательное правило для создания корабля и субшатла, чтобы он не был квадратным иначе, как бы вы не старались при постановке док портов, вы не сможете задать нужное вам направление.
[Wideband] На корабля обязательно должно присутствовать средство связи с другими кораблями.
Если вы хотите, чтобы ваша карта была добавлена на [https://map.celadon.pro вебкарту], то нужно обращаться непосредственно к хосту Celadon`a - Voiko.
Максимальные размеры руин: '''121x75'''. Максимальный размер корабля равен максимальному размеру ангара '''56x40'''.
Список кодов доступа (access) к шлюзам и так далее находится в файле [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/code_DEFINES/access.dm code/_DEFINES/access.dm].
При создании атмосферы на шипе не используйте стационарные танки с газами.

= Проверка перед публикацией =
<ol>
<li>Полы с воздухом или без него, как и должно быть? (обычный или безвоздушный)</li>
<li>[APC] - Есть ли в этой зоне ЛКП?</li>
<li>[Air Alarm] - Есть ли в этой зоне воздушная сигнализация?</li>
<li>[Outpost Communications Console] - Есть ли в этой зоне консоль запросов?</li>
<li>[Light] - Есть ли на территории освещение?</li>
<li>[Light Switch] - Есть ли в этом помещении выключатель света?</li>
<li>[Intercom] - Достаточно ли в этом зоне интеркомов?</li>
<li>[Camera] - Достаточно ли в этом зоне камер видеонаблюдения?</li>
<li>[Vent Scrubber] - Подключена ли зона к вентиляционному очистителю?</li>
<li>[Vent Pump] - Подключена ли зона к вентиляционному насосу?</li>
<li>[Fire Alarm & Fire Doors] - Есть ли на территории пожарная сигнализация и противопожарные шлюзы?</li>
<li>[Holopad] - Имеется ли голопад на вашем судне?</li>
<li>Все ли подключено правильно?</li>
<li>Все ли двери работают правильно?</li>
<li>Правильно ли настроены доступы на дверях, кнопках и т. д.?</li>
<li>Все ли предметы размещены правильно? (не ниже вентиляционных отверстий, скрубберов, столов)?</li>
<li>Правильно ли работает система мусоропровода?</li>
<li>Проверьте наличие неуместных или наложенных частей труб (воздушных и отводящих).</li>
<li>Проверьте, нет ли неуместного или наложенного куска провода.</li>
<li>Определите, насколько сложно проникнуть в эту область и где находятся слабые места, и соответствующим образом сбалансируйте область (например, Хранилище должно быть сделано из усиленных конструкций и электрифицированных окон, Кухня не должна быть сделана из этих материалов, а из обычных стен)</li>
<li>Проверьте, не слишком ли много пустого пространства. Если да, уменьшите его и замените остальные туннелями для обслуживания.</li>
<li>Есть ли нерушимые турфы там, где их не должно быть?</li>
</ol>

Участник:Voiko

2026-04-21T14:47:39Z

Voiko: /* Работа с ДМИ, фишки приколы фейлы */

{{В процессе создания|worker=Voiko}}

= Руководство по созданию спрайтов =
'''Спрайтеры''' - люди, занимающиеся внешним видом игры, делают в основном текстурки для игры. Их главная цель - сделать хорошо, а плохо - не сделать, пиксель арт не стремится сделать достоверную репрезентацию чего-то в игре, его цель - показать объект так, чтобы было ясно что это он и красиво его нарисовать. Обычно спрайты рисуются в разрешении '''32x32''' пикселя, но бывают и исключения, например спрайты мегафауны имеют большее разрешение.

== Терминология ==
Перед процессом спрайтингом нам предстоит немного ознакомиться с основными терминами.
<ol>
<li>'''Билд''' - папка, которую вы скачали с нашего репозитория, хранит в себе кодовую структуру и конечно же DMI файлики с нашими спрайтами.</li>
<li>'''DMI (Атлас)''' - формат файла .dmi, также может называться как '''Атлас'''. Грубо говоря это файл, который имеет в себе спрайты от одного до целого множества. Обычно именно их вы встретите в билде.</li>
<li>'''Спрайт''' (стейт) - спрайтшит, в котором может быть анимация и несколько направлений спрайта. .</li>
<li>'''VSC (Visual Studio Code)''' - программа, в которой мы можем просматривать код и спрайты, а также делать изменения. (Для редактирования спрайтов программа не годится, только для просмотра).</li>
<li>'''Dream Maker''' - стандартная программа, появляется при установке BYOND, через которую вы можете открыть атлас, импортировать или экспортировать файлы, а также редактировать сам спрайт. Будьте осторожны. При открытии спрайтов могут сгенерироваться изменения в коде, которые могут помешать запуску билда. </li>
</ol>
== Выбор программы ==
Рисовать спрайты можно где вашей душе угодно. Можно конечно всё делать сразу в встроенном редакторе byond, но лучше использовать что-то другое, ибо он устаревший и достаточно неудобен, а ещё может сломать вам билд. Большинство спрайтеров пользуются '''Aseprite''' - удобной программой специально для пиксель арта.
Также стоит заметить, что если вы используете программу, не созданную специально для пиксель арта, вам необходимо будет выбрать режим интерполяции “По соседним пикселям” чтобы ваш спрайт не превратился в мыло. 
[[File:sprite_settings1.png|384px]] 
[[File:sprite_settings2.png|384px]]
[[File:Aseprite_Logo.png|thumb|128px]]
[[File:Aseprite.png|thumb|128px|'''"Aseprite"''' - стандартная программа для редактирования DMI файлов.]]
Прежде, чем начать спрайтить, нам потребуется взять на вооружение программу, с помощью которой ты сможешь создавать самые различные спрайты объектов, мобов, снаряжения и не только. 
На выбор у нас имеются программы:
<ol>
<li> '''[https://www.aseprite.org/ Aseprite]''' - отличный выбор, используется очень часто. Вы можете получить его бесплатно, скомпилировав [https://github.com/aseprite/aseprite исходный код], или купить. Отдельно можно установить [https://github.com/spacestation13/aseprite-dmi плагин] для поддержки DMI.</li>
<li> '''[https://www.piskelapp.com/ Piskel]''' - бесплатный сайт, который позволяет редактировать спрайты без необходимости скачивания. Простенький интерфейс, с отсутствием поддержки DMI файлов/атласов.</li>
<li> '''[https://www.gimp.org/ GIMP]''' - бесплатный вариант, не особо модный, требует скачивания. Имеет интерфейс немного лучше, чем обычный Paint. Поддержка DMI отсутствует.</li>
<li> '''[https://www.adobe.com/ua/products/photoshop.html Adobe Photoshop]''' - платный вариант, но возможно для кого-то покажется удобным инструментом для редактирования PNG картинок. Поддержка DMI отсутствует.</li>
</ol>
В данном гайде мы будем ориентироваться на функционал программы "Aseprite", однако перед этим нам потребуется загрузить сердце нашего проекта, определится с выбором билда и загрузить его. 
Подразумевается, что вы уже ознакомлены с [[Запуск локального сервера|руководством по установке локального сервера]] и имеете на компьютере загруженный билд. 
'''Важно! НЕЛЬЗЯ, ЧТОБЫ НА ПУТИ ПРОГРАММЫ БЫЛА КИРИЛИЦА.'''
===Инструкция по установке расширений для Aseprite===
<ol>
<li>Запускаем Aseprite - '''Edit (Menu)''' - '''Preferences'''</li>
<li>Выбираем раздел '''Extensions''' - '''Add Extension''' - Прикрепляем файл '''Asesprite-DMI-Windows'''.</li>
</ol>
Если вдруг не работает расширение - выбираем его в этой же менюшке и нажимаем Enable.
 [[File:Aseprite_instruction1.webp|737px]]
====Работа расширения====
При перетаскивании DMI файла в окно Aseprite (обычное открытие не работает из-за отсутствия поддержки), открывается окно со всеми иконками.
<ol>'''В расширении можно:'''
<li>Создавать/изменять спрайт в стейте</li>
<li>Менять данные</li>
<li>Сохранять (работает как обычное сохранение) </li>
<li>Экспортировать в формат .dmi.</li>
</ol>
[[File:Aseprite_instruction2.webp|737px]]
===Полезные расширения для Aseprite===
<ul>
<li>[https://github.com/lufog/aseprite-language-russian Перевод для Aseprite] - расширение, что переводит интерфейс на русский язык.</li>
<li>[https://github.com/spacestation13/aseprite-dmi Поддержка DMI] - обязательный плагин, предоставляет возможность работать с DMI файлами.</li>
<li>[https://github.com/Seefaaa/aseprite-dmi Поддержка DMI №2] - резервный плагин, предоставляет возможность работать с DMI файлами. Не требует установки, если уже установлен плагин выше.</li>
</ul>
== Основы ==
В ''BYOND'' для спрайтов используются файлы формата '''.dmi''' - спрайт-лист (изображение, хранящее большое количество спрайтов). DMI файлы хранят в себе состояния (стейты), их направления, анимации и скорость её воспроизведения. 
Все спрайты в игре разбиты по разным файлам и разделены по файлам по категориям. Так намного проще ориентироваться в них и заниматься поиском нужного спрайта. 
'''Обычно спрайты отсортированы по своему назначению:'''
<ul>
<li>'''icons/obj''' - спрайты различных объектов</li>
<li>'''icons/mod''' - спрайты живых существ, одежды на куклах, спрайты предметов в руках и тд.</li>
<li>'''icons/turf''' - спрайты всех стен и полов.</li>
<li>'''icons/effects''' - спрайты для различных эффектов: от атак, щитов, крови на полу до оверлеев светa.</li>
</ul>

==== Создание DMI файла ====
<ol>
<li>Открываем DreamMaker (/BYOND/bin/dreammaker.exe)</li>
<li>В меню file выбираем “New Enviroment”</li>
<li>Если у вас уже есть Enviroment - переходите к 4 шагу</li>
<li>В открывшемся окне выбираем папку под работу с dmi и название файла .dme</li>
</ol>
 
[[File:sprite_settings3.png]]
 
В меню '''file -> New''' создаём новый файл (после создания .dme окошко сразу откроется), в поле Type выбираем Icon File, ниже укажите папку и название нового файла.
После создания .dmi файла, естественно, его надо заполнить. Сделать это можно несколькими способами:
Создайте новый стейт, зайдя в меню “'''Graphic -> New State'''” / нажав на синий плюс в верхнем левом углу / нажав ПКМ где угодно в открытом DMI файле.
 
[[File:sprite_settings4.png]]
 
Зайдя в меню Graphic -> import выберите ваш спрайт. Если выбранный файл не будет указаного в файле разрешении (обычно 32х32), то программа порежет ваш спрайт на куски.
 
Чтобы переименовать стейт нажмите дважды на его название (или no name, если он новый). Название стейта должно быть написано на латинице, маленькими буквами и разделением слов через нижнее подчёркивание.
 
'''Не забывайте часто сохранять ваш файл, ибо Dreammaker очень сильно любит вылетать в самый неподходящий момент.'''
==== Пример использования DMI файлов в коде ====
[[File:sprite_settings5.png|717px]]
 
Здесь, для спрайта предмета в игре, мы берём стейт под названием “'''gauze'''” из файла '''items.dmi''', в то время для спрайтов в левой и правой руке у персонажей мы указываем два разных файла '''items_lefthand''' и '''items_righthand''', откуда мы берём стейты с названием “'''gauze'''”, что мы указали в '''item_state'''.
== Работа с ДМИ, фишки приколы фейлы ==
DMI файлы состоят из '''стейтов''' - наборов спрайтов, аля спрайт-лист. В каждом файле спрайты сгруппированы в '''icon state''', по русски в стейты. В стейт можно добавить анимацию и до восьми направлений, то есть в него можно добавить до восьми отдельных спрайтов.
 
[[File:sprite_settings6.png|717px]]
 
На пике выше - два стейта: corgi и corgi_dead. Первый отвечает за спрайты корги, когда он жив, corgi_dead, соответственно, когда мёртв.
Посмотреть стейты в ДМИ файле можно просто открыв его в DreamMaker. В нём вы можете редактировать стейты внутри, количество их направлений и анимации.
=== Анимация ===
Стейты в DMI файлах можно анимировать, редактируя отдельные кадры в анимации. DreamMaker предоставляет несколько опций настройки анимации:
 
'''1. Количество кадров''' - чтобы изменить количество кадров в анимации нажимайте на стрелки на строке с '''frames''', или нажмите на пустой кадр после существующего.
 
[[File:sprite_settings7.gif|512px]]
 
'''2. Длительность кадра (Delay)''' - каждому кадру можно указать то, сколько миллисекунд (0.1 секунды) он будет длиться. Изменить это значение можно нажав на строку Delay под нужным кадром. На примере ниже на каждом кадре указано значение в 1 (0.1 секунды) и 10 (1 секунда).
 
[[File:sprite_settings8.gif|512px]]
 

== Документация ==
Также для удобства предоставляем список материалов, с которыми можно ознакомиться для повышения собственной квалификации.
<ul>
<li>[http://gas13.ru/v3/tutorials/ru_sywtbapa_almighty_grass_tile.php Gas13] - Базовый гайд на русском языке, рекомендуется ознакомиться для начинающих спрайтеров. </li>
<li>[https://gamin.me/posts/4849 Gamin.me ] - Pixel Art для начинающих, на русском.</li>
<li>[https://hackmd.io/@Partheo/spriting Hackmd.oi/@Partheo] - Очень хороший гайд на английском, в целом по сске.</li>
<li>[https://wiki.taucetistation.org/Guide_to_Spriting Гайд по спрайтингу с Tau Ceti Station Wiki]</li>
<li>[https://tgstation13.org/wiki/Guide_to_spriting Гайд по спрайтингу с TGStation13 Wiki]</li>
</ul>

== Хоткеи ==
Основные сочетания клавиш для работы.
{| class="wikitable" style="width:100%; text-align:left; border:3px solid rgba(80,80,80,0.4); border-radius:12px; overflow:hidden;"

! style="width:220px; background-color:#a5b4d1; color:#000000; text-align:center;" |Категория
! style="width:220px; background-color:#a5b4d1; color:#000000;" |Хоткей
! style="background-color:#a5b4d1; color:#000000;" |Описание

|-
! rowspan="6" style="background-color:#f2b3b3; color:#000; text-align:center;" |Навигация и холст
|Ctrl + колесо мыши
|Зум
|-
|1 / 2 / 3 / 4 / 5
|Быстрый масштаб
|-
|H
|Рука (перемещение холста)
|-
|Ctrl + 0
|Подогнать под экран
|-
|Tab
|Скрыть интерфейс
|-
|Shift + Tab
|Скрыть панели

|-
! rowspan="11" style="background-color:#f2d2b3; color:#000; text-align:center;" |Основные инструменты
|B
|Brush (Кисть)
|-
|E
|Eraser (Ластик)
|-
|G
|Paint Bucket (Заливка)
|-
|I
|Eyedropper (Пипетка)
|-
|M
|Marquee (Выделение прямоугольником)
|-
|L
|Lasso (Свободное выделение)
|-
|U
|Shape Tool (Фигуры)
|-
|P
|Pencil (Карандаш)
|-
|C
|Contour / Polygon
|-
|K
|Ink (режимы рисования)
|-
|S
|Spray

|-
! rowspan="4" style="background-color:#f2e7b3; color:#000; text-align:center;" |Работа с цветом
|X
|Поменять местами foreground/background
|-
|D
|Сброс цветов (черный/белый)
|-
|Alt + клик
|Пипетка
|-
|Shift + I
|Color Picker (альтернативный)

|-
! rowspan="6" style="background-color:#b3f2c2; color:#000; text-align:center;" |Выделение
|Ctrl + A
|Выделить всё
|-
|Ctrl + D
|Снять выделение
|-
|Ctrl + Shift + I
|Инвертировать выделение
|-
|Alt + drag
|Перемещение выделения
|-
|Shift
|Добавить к выделению
|-
|Alt
|Убрать из выделения

|-
! rowspan="7" style="background-color:#b3d2f2; color:#000; text-align:center;" |Слои и кадры
|N
|Новый слой
|-
|Shift + N
|Новый слой сверху
|-
|Ctrl + Shift + N
|Новый слой с настройками
|-
|Delete
|Удалить слой/содержимое
|-
|Page Up / Page Down
|Переключение кадров
|-
|Alt + N
|Новый кадр
|-
|Alt + Delete
|Очистить слой

|-
! rowspan="7" style="background-color:#d0b3f2; color:#000; text-align:center;" |Редактирование
|Ctrl + Z
|Отмена
|-
|Ctrl + Y
|Повтор
|-
|Ctrl + X
|Вырезать
|-
|Ctrl + C
|Копировать
|-
|Ctrl + V
|Вставить
|-
|Ctrl + B
|Вставить в место
|-
|Ctrl + T
|Трансформация

|-
! rowspan="3" style="background-color:#f2b3e1; color:#000; text-align:center;" |Трансформации
|Ctrl + T
|Свободная трансформация
|-
|Shift
|Сохранять пропорции
|-
|Alt
|Масштаб из центра

|-
! rowspan="5" style="background-color:#f2e0b3; color:#000; text-align:center;" |Дополнительно
|F
|Flip (отразить)
|-
|Shift + F
|Отразить по вертикали
|-
|Ctrl + Shift + F
|Отразить по горизонтали
|-
|Ctrl + U
|Hue/Saturation
|-
|Ctrl + L
|Levels

|-
! rowspan="2" style="background-color:#b3f2cf; color:#000; text-align:center;" |Тайлы и пиксель-арт
|Ctrl + Shift + T
|Tile Mode
|-
|Shift + B
|Pixel Perfect (идеальные линии)

|-
! rowspan="4" style="background-color:#d6d6d6; color:#000; text-align:center;" |Полезные скрытые фишки
|Пробел / СКМ (зажать)
|Временно инструмент "рука"
|-
|Ctrl (зажать)
|Временно пипетка
|-
|Shift (при рисовании)
|Рисование прямых линий
|-
|Ctrl + drag
|Перемещение содержимого

|}
== Основы ==
Спрайты в SS13 хранятся в файлах dmi. По сути, это атлас-спрайтов в определенном формате. Вы помещаете в него PNG и даете ему имя — это состояние значка. Большинство dmis имеют размер 32x32. У вас может быть растровое изображение, представляющее собой статический спрайт, а гифки можно анимировать. BYOND также работает с 8 направлениями движения, но обычно вам понадобится только 4 или 1.

== ПО ==
Aseprite используется очень часто. Вы можете получить его бесплатно, скомпилировав исходный код, или купить. Некоторые люди также используют Piskel. Вы также можете использовать другое программное обеспечение для обработки изображений, например Paint.net. От себя ещё могу порекомендовать бесплатный GIMP, или платный Adobe Photoshop, хотя ни в том ни в другом нет функции работы с DMI

== Обзор объекта ==
В игре 4 типа объектов:

* '''Область''' – нас это не будет интересовать, так как вы не увидите ее в игре и достаточно wip-графики,
* '''Моб''' – люди, обезьяны, киборги, инопланетяне и другая живность на станции / кораблях / планетах,
* '''Объекты''' – машины, двери, предметы и все остальное в игре,
* '''Турф''' – стены, полы и пространство

== Формат файла DMI ==
Спрайты в SS13 упакованы в файлы .dmi. Чтобы создать новый файл dmi, откройте Dream Maker, выберите «Файл» > «Новый» и выберите «Файл значка (dmi)» в раскрывающемся меню. Напишите для него путь к файлу и нажмите ОК.

Откроется новое окно с пустым файлом. в правом верхнем углу есть два места для размеров спрайта. Большинство спрайтов имеют размер 32x32 пикселя. К сожалению, один dmi-файл не может содержать спрайты разных размеров.

Теперь щелкните правой кнопкой мыши где-нибудь на белизне. Существует два типа спрайтов: растровое изображение и фильм. Растровое изображение статично, а фильм можно анимировать и смотреть в разных направлениях, вот и вся разница. Давайте создадим спрайт фильма. (Новый фильм)

Откроется окно с четырьмя стрелками направления и тремя рамками для каждой из них, все серого цвета. Байонд понимает 8 направлений. Вы можете выбрать, сколько кадров вы хотите использовать, под самими спрайтами: 1, 4 или 8. Вы также можете выбрать, сколько кадров вы хотите иметь в анимации. Если вы создаете разнонаправленный статический спрайт, создайте фильм с 1 кадром, без анимации, но с 4 или 8 направлениями, в зависимости от того, сколько вам нужно. Если вы хотите анимировать спрайт, вас также может заинтересовать возможность установить задержку в 1/10 секунды над конкретным кадром. Хорошо, надеюсь, отсюда вы поймете, что делать. Встроенный инструмент редактирования спрайтов очень примитивен и единственное, о чем в нем стоит упомянуть, это о том, как применять альфа-фильтр. Если вы дважды щелкните любое изображение, вы попадете в редактор спрайтов, а справа от него находится вертикальный ползунок, управляющий альфа-каналом. Также стоит отметить, что копирование из редактора может вести себя немного странно, поскольку фон создается полностью, несмотря на установленный альфа-фильтр. Просто «залейте» фон цветом со значением альфа 0 или используйте «импорт», который отлично работает.

Теперь предположим, что мы сделали ваши спрайты спрайтами, вернитесь к файлу dmi (экран, который появился, когда вы впервые создали файл). Предполагая, что вы создали спрайт, вы увидите его в списке. Дважды щелкните чуть ниже фактического спрайта, и откроется окно переименования. Альтернативно выберите спрайт и нажмите F2 на клавиатуре. Дайте имя вашему спрайту. Это имя часто называют icon_state, поскольку это имя переменной, которая определяет его в коде.

Также обратите внимание, что вы можете импортировать и экспортировать файлы изображений разных типов, выбрав файлы, которые вы хотите экспортировать, в редакторе (удерживайте Ctrl, чтобы выбрать несколько), щелкнув правой кнопкой мыши и выбрав экспорт, или щелкнув правой кнопкой мыши в любом месте и выбрав импорт, чтобы импортировать. DMI похож на PNG, поэтому, если вы переименуете расширение DMI в PNG, оно должно работать во всех программах графического редактирования. Обычно это работает и в обратную сторону. Это ускоряет перекрашивание.

Надеюсь, это вся информация, которая вам нужна для создания спрайтов и файлов dmi.

== Требуемые спрайты по категориям объектов ==
Теперь расскажу вам, какие спрайты нужны различным типам предметов:

=== Мобы ===

* Спрайты мобов по большей части требуют четырех направлений.
* Спрайты мобов требуют спрайтов мертвых мобов .
* Если вы захотите, вы можете создать спрайт моба, который лежит.
* Если вы создаете моба, который может носить одежду, вы можете использовать Pixel_y, Pixel_x для смены одежды при кодировании моба.

==== Мобы с конечностями ====

* Человек и человеческий вид состоят из конечностей – головы, груди, двух рук и двух ног.
* Файлы находятся в icon/mob/human_parts.dmi для конечностей, имеющих заданный цвет, и в icon/mob/human_parts_greyscale.dmi для конечностей, которые можно перекрасить и начать использовать оттенки серого.
* Конечности имеют 4 кадра, как и полноценные иконки.
* Конечности также используются в качестве иконок предметов на случай расчленения.
* Именование следующее:
** [race]_l/r_arm/leg для рук и ног.
** [race]_chest(_m/f) для торса (м/ж для мужских/женских вариантов, необязательно)
** [race]_head(_m/f) для головы (м/ж для мужского/женского вариантов, необязательно)
* Дополнительные части тела, такие как хвосты ящерицы, помещаются в mutant_bodyparts.dmi.

=== Турфы ===

* Полы находятся в файле icon/turf/floors.dmi.
* Стены находятся в файле icon/turf/walls.dmi.
* Стены и полы шаттла находятся в файле icon/turf/shuttle.dmi.
* Космические плитки находятся в файле icon/turf/space.dmi.

=== Объекты ===

* Спрайты объектов находятся в папке icon/obj.
* Спрайты предметов разбросаны по всей папке.
* Спрайты предметов по большей части требуют наличия собственных спрайтов. Их можно найти в разделах icon/mob/items_lefthand.dmi и icon/mob/items_righthand.dmi.
* Спрайты одежды находятся в папке icon/obj/clothing.
* Спрайты одежды на мобах можно найти в папке icon/mob.
* Спрайты одежды по большей части требуют спрайтов, находящихся в руках. Их можно найти в разделах icon/mob/items_lefthand.dmi и icon/mob/items_righthand.dmi.
* Спрайты техники находятся в папке images/obj/machines. Хотя значительная их часть находится в папке icon/obj.
* Спрайты дверей расположены в папке icon/obj/door.
* Обычный спрайт двери требует Door_closed, Door_locked, Door_opening, Door_deny, Door_Closing, Door_open, Door_spark, o_door_opening, o_door_Closing, Panel_open, Welded и Elights. Предлагаю осмотреть door.dmi
* Укреплённым дверям требуются только спрайты открытия и закрытия, а также спрайты, когда они открыты и закрыты.

== Маппинг ==
'''A.T.O.M. - Area - Turf - Object - Mob''' 
В маппинге, в основном мы рассматриваем 4 типа:

1. [https://www.byond.com/docs/ref/#/area '''Зоны''']. Покрывают область и карты и говорят коду что это за территория и её свойства. От зоны работает вся электроника, зону запитывает АЦП и т.д. Свойства у зон бывают самые различные. От звуков и сообщений в чате до запрета телепортации.

2. [https://www.byond.com/docs/ref/#/turf '''Турфы''']. Пол и стены. Полы определяют какой в тайле будет газ, температура, скорость, гравитация, а стены понятно, надеюсь, что делают. Нельзя в один тайл (условная игровая клетка) поставить и пол и стену. Под стеной при разборе всегда будет базовый пол, если в коде не прописано иного.

3. [https://www.byond.com/docs/ref/#/obj '''Предметы'''] . Всё, что не было указано ранее. В том числе, но не заканчивая ими: лендмарки (точки спавна), простые предметы (столы, стулья), декали (и прочий декор типо мелковых рисунков), рандом спавнеры, машинерия (от лампочки, до консолей и всех труб), провода, и прочее.

4. [https://www.byond.com/docs/ref/#/mob '''Мобы''']. Все НПС. С мобами можно по-разному играться задавая им <s>скорость</s>, здоровье, урон и <s>лутдпроп (для продвинутых).</s>

=== Список переменных ===
У каждого типа есть список переменных. Перечислять все переменные, которые меняются у объектов можно долго, но главные указаны здесь:

[https://www.byond.com/docs/ref/#/%7Bnotes%7D/pixel-movement '''pix_x''' | '''pix_y'''] - Задают смещение от центра тайла. Вся настенная машинерия ставится над/под/слева/справа от нужного расположения на стене и поднимается в нужную сторону на 28-32 пикселя. (1 тайл - 32х32 пикселя)

[[File: Directions.png|thumb|256px|Наглядный пример направлений]]
[https://www.byond.com/docs/ref/#/atom/var/dir '''dir'''] - Направление.
2 - на игрока 1 - от игрока 4 - вправо 8 - влево. Если направлений больше, то и другие значения до 16.

'''anchored''' - Закрепление. Объект нельзя потянуть или сдвинуть если TRUE

'''Id''' и '''id_tag''' - Кнопочная машинерия. Для кнопки задается ''id'', для объекта ''id tag'' определяет поведение для дверей(болты, открыть, доступ и т.д) 
Если вам нужно, чтобы кнопка(id) открывала дверь/поддур и тд с 1 ''id_tag'' - прописывайте в ''id'' так ''“ВАШ ID_TAG”'' 
Если Вам нужно, чтобы кнопка(id) открывала дверь/поддур и тд с множеством ''id_tag'' - прописывайте в id так ''list(“ID_TAG1”,”ID_TAG2”)''. Вписывать можно сколько вашей душе угодно, главное соблюдайте синтаксис.

'''req_access (list)''' - Проверка на доступ любая машинерия и двери. Таблица доступов есть в руководстве по маппингу. Несколько доступов пишутся через запятую без пробелов. Если вы хотите привязать мультидоступ, то прописывайте его через запятую, например: req_access = list(1,19,43)

[https://www.byond.com/docs/ref/#/atom/var/icon '''Icon'''] и [https://www.byond.com/docs/ref/#/atom/var/icon_state '''icon_state'''] - Первый указывает путь до дми файла с кучей иконок, второй указывает какая именно иконка из кучи в этом файле будет показываться.

=== Каждое новое помещение начинается с зоны ===
Зона это основной способ взаимодействия тайлов с кодом игры. Будет ли в зоне электричество от апц, либо же она будет запитана магией, будет ли в ней гравитация, какой в ней будет эмбиент(звук окружения), машинерия и как она будет работать в ней и т.д.

Зоны на станциях не должны повторяться. Дело в том, что зона не обязательно должна располагаться близко, чтобы передавать всю информацию внутри себя. Если разместить одну и ту же зону на разных концах карты, то пожарная сигнализация будет срабатывать в обоих, даже если вторая вообще не имеет атмосферы. Это работает даже на разных Z уровнях!

Помните, что настраивать и изменять свойства зоны необходимо исключительно в коде!
=== Подробнее про Variables ===
[[File:sdmm_variables.png|thumb|256px|Область управления переменными]]
Данная область позволит вам творить самые настоящие тёмные колдунства при наличии хотя бы минимальных знаний понимания работы кода/переменных.
Зона Variables состоит из двух вкладок: Instance и Prefab.
'''Instance''' - Позволяет смотреть и менять параметры у одного объекта на карте.
'''Prefab''' - Также позволяет проверять параметры, однако менять параметры будет у всех таких же объектов на карте.
У вас также имеется возможность использовать некоторые параметры, чтобы показать только изменённые переменные.
<ol>
<li>'''Ctrl+1''' - '''Show modified only''' - Покажет только те переменные, что уже были изменены.</li>
<li>'''Ctrl+2''' - '''Show types''' - Покажет переменные не только объекта, но и также его родителей.</li>
<li>'''Ctrl+3''' - '''Show pins''' - Позволит закрепить необходимую переменную, чтобы не потерять её из виду. Она будет показываться в самом верху.</li>
<li>'''Ctrl+4''' - '''Show tmp, const, and static''' - Наши тёмные маги ещё не познали такую сильную магию. Об этом параметре особо ничего не известно. </li>
</ol>
== Создание кораблей и руин ==
Все текущие корабли находятся в папке '''_maps/_mod_celadon/shuttles''' и имеют сортировку по фракциями, а также там имеется отдельная папка для субшаттлов - '''_maps/_mod_celadon/shuttles/subshuttles'''. В этих папках хранятся сами карты, однако инициализация кораблей происходит благодаря папке '''_maps/_mod_celadon/configs'''.

=== Конфиг корабля ===
[[File:example_ship_config.png|thumb]]
В папке с конфигами вы можете ознакомиться со структурой и перенести её в ваш новый файл. 
Вы также можете изучить саму [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/_maps/ship_config_schema.json '''структуру'''] и пример [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/_maps/example_ship_config.json '''конфигурационного файла'''].
Пройдёмся по переменным:
<ol>
<li>'''map_name''' - Полное название корабля. Именно с таким названием игроки увидят ваш корабль в общем списке в лобби.</li>
<li>'''map_short_name''' - Краткое название карты. Обозначает класс корабля. Будет отображаться в манифесте. Не может содержать пробелы. Кроме букв доступны только дефис и нижнее подчёркивание.</li>
<li>'''description''' - Описание корабля. Будет отображаться при выборе корабля в лобби. Содержит в себе лор корабля.</li>
<li>'''map_path''' - Путь к файлу карты корабля. Например: "_maps\shuttles\inteq\inteq_colossus.dmm"</li>
<li>'''enabled''' - Если "true" - доступно для покупки игроками. Если "false" - только для щитспавна.</li>
<li>'''limit''' - Допустимое количество для покупки корабля игроками.</li>
<li>'''space_spawn''' - По умолчанию корабль спавнится на аванпосту. Если "true", то корабль заспавнится в космосе.</li>
<li>'''prefix''' - Указывается префикс фракции. Доступные префиксы можно найти на [https://wiki.celadon.pro/index.php/Префиксы этой странице].</li>
<li>'''faction''' - Путь к датуму фракции. Доступные фракции находятся в этом файле: [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/mod_celadon/faction/code/faction.dm mod_celadon/faction/code/faction.dm], если нет необходимой - можно найти в другом файле: [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/code/modules/faction/faction_datum.dm code/modules/faction/faction_datum.dm].</li>
<li>'''tags''' - Указываются теги корабля. Их можно найти в этом файле: [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/_maps/ship_tags_descriptions_guide.txt _maps/ship_tags_descriptions_guide.txt]. На данный момент не используется. В будущем планируется использовать для сортировки кораблей.</li>
<li>'''namelists''' - Указываются кодовые названия списков, из которых корабль будет генерировать название корабля при его создании. Ознакомиться с доступными списками и названиями можно в этом файле:[https://github.com/CeladonSS13/Shiptest/blob/beta-dev/strings/ship_names.json strings/ship_names.json].</li>
<li>'''job_slots''' - Состоит из 3 частей. Название (название профессии при заходе на корабль), outfit (путь к снаряжению в коде), slots (количество доступных профессий). Доступный список снаряжений можно найти по пути [https://github.com/CeladonSS13/Shiptest/tree/beta-dev/mod_celadon/outfit/code mod_celadon/outfit/code], они имеют примерно такую структуру: ''/datum/outfit/job/фракция/профессия''.</li>
</ol>

=== Создание субшаттла ===
[[File:guide_subshuttle.png|thumb|256px|Пример датума субшаттла]]
Субшаттлы инициализируются не так, как обычные корабли, им не нужен конфиг. Они недоступны для покупки в общем списке лобби, но могут быть использованы в качестве дополнительного корабля внутри самого корабля или для отправки к примеру ЕРТ отряда с помощью администрации. Они создаются в отдельном файле: [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/mod_celadon/maps/code/subshuttles.dm mod_celadon/maps/code/subshuttles.dm].

Путь к картам субкораблей: '''_maps/_mod_celadon/shuttles/subshuttles'''.
=== Создание руины ===
Руинки - это дополнительные локации, которые спавнятся на планетах. На одной планете может быть максимум одна руина.
При создании руины старайтесь использовать флору и фауну, которые предназначены для выбранной вами планеты.
Чтобы инициализировать руину вам потребуется закинуть карту в папку с руинами для необходимой планеты по пути: '''_maps/_mod_celadon/RandomRuins/'''.
Затем перейдите к файлу '''mod_celadon/maps/code/ruins/ruin.dm''' и пропишите датум, по примеру других руин в файле. Датум может иметь такие параметры:
<ol>
<li>'''Datum''' - ''[Обязательно]'' /datum/map_template/ruin/Планета/Название</li>
<li>'''name''' - ''[Обязательно]'' Полное название вашей руины</li>
<li>'''id''' - ''[Обязательно]'' Уникальное и краткое название руины, без нижних подчёркиваний. Используется функционирования для чёрного листа.</li>
<li>'''suffix''' - ''[Обязательно]'' Название вашего файла. Пример: anima_heirophant.dmm</li>
<li>'''description''' - ''[Обязательно]'' Описание вашей руины, лёгкий лор. Используется для страницы с информацией о руинах (в разработке). </li>
<li>'''cost''' - Влияет на вероятность спавна вашей руины. Чем выше стоимость, тем реже она может встретиться.</li>
<li>'''allow_duplicates''' - Если значение "False", то на весь раунд сможет появится только одна руинка.</li>
<li>'''ruin_tags''' - Используется для краткого описания руины. Теги можно найти здесь: [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/code/__DEFINES/ruins.dm code/__DEFINES/ruins.dm].</li>
<li>'''never_spawn_with''' - Не заспавнит руинку, если уже имеется указанная руина из вашего списка.</li>
</ol>
После создания датума перейдите к текстовому файлу '''map_catalogue_key.txt''' по пути: '''_maps/_mod_celadon/map_catalogue.txt''' и оставьте запись о руинке с размерами, тегами и путями.

=== Важная дополнительная информация ===
Обязательное правило для создания корабля и субшатла, чтобы он не был квадратным иначе, как бы вы не старались при постановке док портов, вы не сможете задать нужное вам направление.
[Wideband] На корабля обязательно должно присутствовать средство связи с другими кораблями.
Если вы хотите, чтобы ваша карта была добавлена на [https://map.celadon.pro вебкарту], то нужно обращаться непосредственно к хосту Celadon`a - Voiko.
Максимальные размеры руин: '''121x75'''. Максимальный размер корабля равен максимальному размеру ангара '''56x40'''.
Список кодов доступа (access) к шлюзам и так далее находится в файле [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/code_DEFINES/access.dm code/_DEFINES/access.dm].
При создании атмосферы на шипе не используйте стационарные танки с газами.

= Проверка перед публикацией =
<ol>
<li>Полы с воздухом или без него, как и должно быть? (обычный или безвоздушный)</li>
<li>[APC] - Есть ли в этой зоне ЛКП?</li>
<li>[Air Alarm] - Есть ли в этой зоне воздушная сигнализация?</li>
<li>[Outpost Communications Console] - Есть ли в этой зоне консоль запросов?</li>
<li>[Light] - Есть ли на территории освещение?</li>
<li>[Light Switch] - Есть ли в этом помещении выключатель света?</li>
<li>[Intercom] - Достаточно ли в этом зоне интеркомов?</li>
<li>[Camera] - Достаточно ли в этом зоне камер видеонаблюдения?</li>
<li>[Vent Scrubber] - Подключена ли зона к вентиляционному очистителю?</li>
<li>[Vent Pump] - Подключена ли зона к вентиляционному насосу?</li>
<li>[Fire Alarm & Fire Doors] - Есть ли на территории пожарная сигнализация и противопожарные шлюзы?</li>
<li>[Holopad] - Имеется ли голопад на вашем судне?</li>
<li>Все ли подключено правильно?</li>
<li>Все ли двери работают правильно?</li>
<li>Правильно ли настроены доступы на дверях, кнопках и т. д.?</li>
<li>Все ли предметы размещены правильно? (не ниже вентиляционных отверстий, скрубберов, столов)?</li>
<li>Правильно ли работает система мусоропровода?</li>
<li>Проверьте наличие неуместных или наложенных частей труб (воздушных и отводящих).</li>
<li>Проверьте, нет ли неуместного или наложенного куска провода.</li>
<li>Определите, насколько сложно проникнуть в эту область и где находятся слабые места, и соответствующим образом сбалансируйте область (например, Хранилище должно быть сделано из усиленных конструкций и электрифицированных окон, Кухня не должна быть сделана из этих материалов, а из обычных стен)</li>
<li>Проверьте, не слишком ли много пустого пространства. Если да, уменьшите его и замените остальные туннелями для обслуживания.</li>
<li>Есть ли нерушимые турфы там, где их не должно быть?</li>
</ol>

Участник:Voiko

2026-04-21T14:47:22Z

Voiko: /* Анимация */

{{В процессе создания|worker=Voiko}}

= Руководство по созданию спрайтов =
'''Спрайтеры''' - люди, занимающиеся внешним видом игры, делают в основном текстурки для игры. Их главная цель - сделать хорошо, а плохо - не сделать, пиксель арт не стремится сделать достоверную репрезентацию чего-то в игре, его цель - показать объект так, чтобы было ясно что это он и красиво его нарисовать. Обычно спрайты рисуются в разрешении '''32x32''' пикселя, но бывают и исключения, например спрайты мегафауны имеют большее разрешение.

== Терминология ==
Перед процессом спрайтингом нам предстоит немного ознакомиться с основными терминами.
<ol>
<li>'''Билд''' - папка, которую вы скачали с нашего репозитория, хранит в себе кодовую структуру и конечно же DMI файлики с нашими спрайтами.</li>
<li>'''DMI (Атлас)''' - формат файла .dmi, также может называться как '''Атлас'''. Грубо говоря это файл, который имеет в себе спрайты от одного до целого множества. Обычно именно их вы встретите в билде.</li>
<li>'''Спрайт''' (стейт) - спрайтшит, в котором может быть анимация и несколько направлений спрайта. .</li>
<li>'''VSC (Visual Studio Code)''' - программа, в которой мы можем просматривать код и спрайты, а также делать изменения. (Для редактирования спрайтов программа не годится, только для просмотра).</li>
<li>'''Dream Maker''' - стандартная программа, появляется при установке BYOND, через которую вы можете открыть атлас, импортировать или экспортировать файлы, а также редактировать сам спрайт. Будьте осторожны. При открытии спрайтов могут сгенерироваться изменения в коде, которые могут помешать запуску билда. </li>
</ol>
== Выбор программы ==
Рисовать спрайты можно где вашей душе угодно. Можно конечно всё делать сразу в встроенном редакторе byond, но лучше использовать что-то другое, ибо он устаревший и достаточно неудобен, а ещё может сломать вам билд. Большинство спрайтеров пользуются '''Aseprite''' - удобной программой специально для пиксель арта.
Также стоит заметить, что если вы используете программу, не созданную специально для пиксель арта, вам необходимо будет выбрать режим интерполяции “По соседним пикселям” чтобы ваш спрайт не превратился в мыло. 
[[File:sprite_settings1.png|384px]] 
[[File:sprite_settings2.png|384px]]
[[File:Aseprite_Logo.png|thumb|128px]]
[[File:Aseprite.png|thumb|128px|'''"Aseprite"''' - стандартная программа для редактирования DMI файлов.]]
Прежде, чем начать спрайтить, нам потребуется взять на вооружение программу, с помощью которой ты сможешь создавать самые различные спрайты объектов, мобов, снаряжения и не только. 
На выбор у нас имеются программы:
<ol>
<li> '''[https://www.aseprite.org/ Aseprite]''' - отличный выбор, используется очень часто. Вы можете получить его бесплатно, скомпилировав [https://github.com/aseprite/aseprite исходный код], или купить. Отдельно можно установить [https://github.com/spacestation13/aseprite-dmi плагин] для поддержки DMI.</li>
<li> '''[https://www.piskelapp.com/ Piskel]''' - бесплатный сайт, который позволяет редактировать спрайты без необходимости скачивания. Простенький интерфейс, с отсутствием поддержки DMI файлов/атласов.</li>
<li> '''[https://www.gimp.org/ GIMP]''' - бесплатный вариант, не особо модный, требует скачивания. Имеет интерфейс немного лучше, чем обычный Paint. Поддержка DMI отсутствует.</li>
<li> '''[https://www.adobe.com/ua/products/photoshop.html Adobe Photoshop]''' - платный вариант, но возможно для кого-то покажется удобным инструментом для редактирования PNG картинок. Поддержка DMI отсутствует.</li>
</ol>
В данном гайде мы будем ориентироваться на функционал программы "Aseprite", однако перед этим нам потребуется загрузить сердце нашего проекта, определится с выбором билда и загрузить его. 
Подразумевается, что вы уже ознакомлены с [[Запуск локального сервера|руководством по установке локального сервера]] и имеете на компьютере загруженный билд. 
'''Важно! НЕЛЬЗЯ, ЧТОБЫ НА ПУТИ ПРОГРАММЫ БЫЛА КИРИЛИЦА.'''
===Инструкция по установке расширений для Aseprite===
<ol>
<li>Запускаем Aseprite - '''Edit (Menu)''' - '''Preferences'''</li>
<li>Выбираем раздел '''Extensions''' - '''Add Extension''' - Прикрепляем файл '''Asesprite-DMI-Windows'''.</li>
</ol>
Если вдруг не работает расширение - выбираем его в этой же менюшке и нажимаем Enable.
 [[File:Aseprite_instruction1.webp|737px]]
====Работа расширения====
При перетаскивании DMI файла в окно Aseprite (обычное открытие не работает из-за отсутствия поддержки), открывается окно со всеми иконками.
<ol>'''В расширении можно:'''
<li>Создавать/изменять спрайт в стейте</li>
<li>Менять данные</li>
<li>Сохранять (работает как обычное сохранение) </li>
<li>Экспортировать в формат .dmi.</li>
</ol>
[[File:Aseprite_instruction2.webp|737px]]
===Полезные расширения для Aseprite===
<ul>
<li>[https://github.com/lufog/aseprite-language-russian Перевод для Aseprite] - расширение, что переводит интерфейс на русский язык.</li>
<li>[https://github.com/spacestation13/aseprite-dmi Поддержка DMI] - обязательный плагин, предоставляет возможность работать с DMI файлами.</li>
<li>[https://github.com/Seefaaa/aseprite-dmi Поддержка DMI №2] - резервный плагин, предоставляет возможность работать с DMI файлами. Не требует установки, если уже установлен плагин выше.</li>
</ul>
== Основы ==
В ''BYOND'' для спрайтов используются файлы формата '''.dmi''' - спрайт-лист (изображение, хранящее большое количество спрайтов). DMI файлы хранят в себе состояния (стейты), их направления, анимации и скорость её воспроизведения. 
Все спрайты в игре разбиты по разным файлам и разделены по файлам по категориям. Так намного проще ориентироваться в них и заниматься поиском нужного спрайта. 
'''Обычно спрайты отсортированы по своему назначению:'''
<ul>
<li>'''icons/obj''' - спрайты различных объектов</li>
<li>'''icons/mod''' - спрайты живых существ, одежды на куклах, спрайты предметов в руках и тд.</li>
<li>'''icons/turf''' - спрайты всех стен и полов.</li>
<li>'''icons/effects''' - спрайты для различных эффектов: от атак, щитов, крови на полу до оверлеев светa.</li>
</ul>

==== Создание DMI файла ====
<ol>
<li>Открываем DreamMaker (/BYOND/bin/dreammaker.exe)</li>
<li>В меню file выбираем “New Enviroment”</li>
<li>Если у вас уже есть Enviroment - переходите к 4 шагу</li>
<li>В открывшемся окне выбираем папку под работу с dmi и название файла .dme</li>
</ol>
 
[[File:sprite_settings3.png]]
 
В меню '''file -> New''' создаём новый файл (после создания .dme окошко сразу откроется), в поле Type выбираем Icon File, ниже укажите папку и название нового файла.
После создания .dmi файла, естественно, его надо заполнить. Сделать это можно несколькими способами:
Создайте новый стейт, зайдя в меню “'''Graphic -> New State'''” / нажав на синий плюс в верхнем левом углу / нажав ПКМ где угодно в открытом DMI файле.
 
[[File:sprite_settings4.png]]
 
Зайдя в меню Graphic -> import выберите ваш спрайт. Если выбранный файл не будет указаного в файле разрешении (обычно 32х32), то программа порежет ваш спрайт на куски.
 
Чтобы переименовать стейт нажмите дважды на его название (или no name, если он новый). Название стейта должно быть написано на латинице, маленькими буквами и разделением слов через нижнее подчёркивание.
 
'''Не забывайте часто сохранять ваш файл, ибо Dreammaker очень сильно любит вылетать в самый неподходящий момент.'''
==== Пример использования DMI файлов в коде ====
[[File:sprite_settings5.png|717px]]
 
Здесь, для спрайта предмета в игре, мы берём стейт под названием “'''gauze'''” из файла '''items.dmi''', в то время для спрайтов в левой и правой руке у персонажей мы указываем два разных файла '''items_lefthand''' и '''items_righthand''', откуда мы берём стейты с названием “'''gauze'''”, что мы указали в '''item_state'''.
== Работа с ДМИ, фишки приколы фейлы ==
DMI файлы состоят из '''стейтов''' - наборов спрайтов, аля спрайт-лист. В каждом файле спрайты сгруппированы в '''icon state''', по русски в стейты. В стейт можно добавить анимацию и до восьми направлений, то есть в него можно добавить до восьми отдельных спрайтов.
[[File:sprite_settings6.png|717px]]
На пике выше - два стейта: corgi и corgi_dead. Первый отвечает за спрайты корги, когда он жив, corgi_dead, соответственно, когда мёртв.
Посмотреть стейты в ДМИ файле можно просто открыв его в DreamMaker. В нём вы можете редактировать стейты внутри, количество их направлений и анимации.
=== Анимация ===
Стейты в DMI файлах можно анимировать, редактируя отдельные кадры в анимации. DreamMaker предоставляет несколько опций настройки анимации:
 
'''1. Количество кадров''' - чтобы изменить количество кадров в анимации нажимайте на стрелки на строке с '''frames''', или нажмите на пустой кадр после существующего.
 
[[File:sprite_settings7.gif|512px]]
 
'''2. Длительность кадра (Delay)''' - каждому кадру можно указать то, сколько миллисекунд (0.1 секунды) он будет длиться. Изменить это значение можно нажав на строку Delay под нужным кадром. На примере ниже на каждом кадре указано значение в 1 (0.1 секунды) и 10 (1 секунда).
 
[[File:sprite_settings8.gif|512px]]
 

== Документация ==
Также для удобства предоставляем список материалов, с которыми можно ознакомиться для повышения собственной квалификации.
<ul>
<li>[http://gas13.ru/v3/tutorials/ru_sywtbapa_almighty_grass_tile.php Gas13] - Базовый гайд на русском языке, рекомендуется ознакомиться для начинающих спрайтеров. </li>
<li>[https://gamin.me/posts/4849 Gamin.me ] - Pixel Art для начинающих, на русском.</li>
<li>[https://hackmd.io/@Partheo/spriting Hackmd.oi/@Partheo] - Очень хороший гайд на английском, в целом по сске.</li>
<li>[https://wiki.taucetistation.org/Guide_to_Spriting Гайд по спрайтингу с Tau Ceti Station Wiki]</li>
<li>[https://tgstation13.org/wiki/Guide_to_spriting Гайд по спрайтингу с TGStation13 Wiki]</li>
</ul>

== Хоткеи ==
Основные сочетания клавиш для работы.
{| class="wikitable" style="width:100%; text-align:left; border:3px solid rgba(80,80,80,0.4); border-radius:12px; overflow:hidden;"

! style="width:220px; background-color:#a5b4d1; color:#000000; text-align:center;" |Категория
! style="width:220px; background-color:#a5b4d1; color:#000000;" |Хоткей
! style="background-color:#a5b4d1; color:#000000;" |Описание

|-
! rowspan="6" style="background-color:#f2b3b3; color:#000; text-align:center;" |Навигация и холст
|Ctrl + колесо мыши
|Зум
|-
|1 / 2 / 3 / 4 / 5
|Быстрый масштаб
|-
|H
|Рука (перемещение холста)
|-
|Ctrl + 0
|Подогнать под экран
|-
|Tab
|Скрыть интерфейс
|-
|Shift + Tab
|Скрыть панели

|-
! rowspan="11" style="background-color:#f2d2b3; color:#000; text-align:center;" |Основные инструменты
|B
|Brush (Кисть)
|-
|E
|Eraser (Ластик)
|-
|G
|Paint Bucket (Заливка)
|-
|I
|Eyedropper (Пипетка)
|-
|M
|Marquee (Выделение прямоугольником)
|-
|L
|Lasso (Свободное выделение)
|-
|U
|Shape Tool (Фигуры)
|-
|P
|Pencil (Карандаш)
|-
|C
|Contour / Polygon
|-
|K
|Ink (режимы рисования)
|-
|S
|Spray

|-
! rowspan="4" style="background-color:#f2e7b3; color:#000; text-align:center;" |Работа с цветом
|X
|Поменять местами foreground/background
|-
|D
|Сброс цветов (черный/белый)
|-
|Alt + клик
|Пипетка
|-
|Shift + I
|Color Picker (альтернативный)

|-
! rowspan="6" style="background-color:#b3f2c2; color:#000; text-align:center;" |Выделение
|Ctrl + A
|Выделить всё
|-
|Ctrl + D
|Снять выделение
|-
|Ctrl + Shift + I
|Инвертировать выделение
|-
|Alt + drag
|Перемещение выделения
|-
|Shift
|Добавить к выделению
|-
|Alt
|Убрать из выделения

|-
! rowspan="7" style="background-color:#b3d2f2; color:#000; text-align:center;" |Слои и кадры
|N
|Новый слой
|-
|Shift + N
|Новый слой сверху
|-
|Ctrl + Shift + N
|Новый слой с настройками
|-
|Delete
|Удалить слой/содержимое
|-
|Page Up / Page Down
|Переключение кадров
|-
|Alt + N
|Новый кадр
|-
|Alt + Delete
|Очистить слой

|-
! rowspan="7" style="background-color:#d0b3f2; color:#000; text-align:center;" |Редактирование
|Ctrl + Z
|Отмена
|-
|Ctrl + Y
|Повтор
|-
|Ctrl + X
|Вырезать
|-
|Ctrl + C
|Копировать
|-
|Ctrl + V
|Вставить
|-
|Ctrl + B
|Вставить в место
|-
|Ctrl + T
|Трансформация

|-
! rowspan="3" style="background-color:#f2b3e1; color:#000; text-align:center;" |Трансформации
|Ctrl + T
|Свободная трансформация
|-
|Shift
|Сохранять пропорции
|-
|Alt
|Масштаб из центра

|-
! rowspan="5" style="background-color:#f2e0b3; color:#000; text-align:center;" |Дополнительно
|F
|Flip (отразить)
|-
|Shift + F
|Отразить по вертикали
|-
|Ctrl + Shift + F
|Отразить по горизонтали
|-
|Ctrl + U
|Hue/Saturation
|-
|Ctrl + L
|Levels

|-
! rowspan="2" style="background-color:#b3f2cf; color:#000; text-align:center;" |Тайлы и пиксель-арт
|Ctrl + Shift + T
|Tile Mode
|-
|Shift + B
|Pixel Perfect (идеальные линии)

|-
! rowspan="4" style="background-color:#d6d6d6; color:#000; text-align:center;" |Полезные скрытые фишки
|Пробел / СКМ (зажать)
|Временно инструмент "рука"
|-
|Ctrl (зажать)
|Временно пипетка
|-
|Shift (при рисовании)
|Рисование прямых линий
|-
|Ctrl + drag
|Перемещение содержимого

|}
== Основы ==
Спрайты в SS13 хранятся в файлах dmi. По сути, это атлас-спрайтов в определенном формате. Вы помещаете в него PNG и даете ему имя — это состояние значка. Большинство dmis имеют размер 32x32. У вас может быть растровое изображение, представляющее собой статический спрайт, а гифки можно анимировать. BYOND также работает с 8 направлениями движения, но обычно вам понадобится только 4 или 1.

== ПО ==
Aseprite используется очень часто. Вы можете получить его бесплатно, скомпилировав исходный код, или купить. Некоторые люди также используют Piskel. Вы также можете использовать другое программное обеспечение для обработки изображений, например Paint.net. От себя ещё могу порекомендовать бесплатный GIMP, или платный Adobe Photoshop, хотя ни в том ни в другом нет функции работы с DMI

== Обзор объекта ==
В игре 4 типа объектов:

* '''Область''' – нас это не будет интересовать, так как вы не увидите ее в игре и достаточно wip-графики,
* '''Моб''' – люди, обезьяны, киборги, инопланетяне и другая живность на станции / кораблях / планетах,
* '''Объекты''' – машины, двери, предметы и все остальное в игре,
* '''Турф''' – стены, полы и пространство

== Формат файла DMI ==
Спрайты в SS13 упакованы в файлы .dmi. Чтобы создать новый файл dmi, откройте Dream Maker, выберите «Файл» > «Новый» и выберите «Файл значка (dmi)» в раскрывающемся меню. Напишите для него путь к файлу и нажмите ОК.

Откроется новое окно с пустым файлом. в правом верхнем углу есть два места для размеров спрайта. Большинство спрайтов имеют размер 32x32 пикселя. К сожалению, один dmi-файл не может содержать спрайты разных размеров.

Теперь щелкните правой кнопкой мыши где-нибудь на белизне. Существует два типа спрайтов: растровое изображение и фильм. Растровое изображение статично, а фильм можно анимировать и смотреть в разных направлениях, вот и вся разница. Давайте создадим спрайт фильма. (Новый фильм)

Откроется окно с четырьмя стрелками направления и тремя рамками для каждой из них, все серого цвета. Байонд понимает 8 направлений. Вы можете выбрать, сколько кадров вы хотите использовать, под самими спрайтами: 1, 4 или 8. Вы также можете выбрать, сколько кадров вы хотите иметь в анимации. Если вы создаете разнонаправленный статический спрайт, создайте фильм с 1 кадром, без анимации, но с 4 или 8 направлениями, в зависимости от того, сколько вам нужно. Если вы хотите анимировать спрайт, вас также может заинтересовать возможность установить задержку в 1/10 секунды над конкретным кадром. Хорошо, надеюсь, отсюда вы поймете, что делать. Встроенный инструмент редактирования спрайтов очень примитивен и единственное, о чем в нем стоит упомянуть, это о том, как применять альфа-фильтр. Если вы дважды щелкните любое изображение, вы попадете в редактор спрайтов, а справа от него находится вертикальный ползунок, управляющий альфа-каналом. Также стоит отметить, что копирование из редактора может вести себя немного странно, поскольку фон создается полностью, несмотря на установленный альфа-фильтр. Просто «залейте» фон цветом со значением альфа 0 или используйте «импорт», который отлично работает.

Теперь предположим, что мы сделали ваши спрайты спрайтами, вернитесь к файлу dmi (экран, который появился, когда вы впервые создали файл). Предполагая, что вы создали спрайт, вы увидите его в списке. Дважды щелкните чуть ниже фактического спрайта, и откроется окно переименования. Альтернативно выберите спрайт и нажмите F2 на клавиатуре. Дайте имя вашему спрайту. Это имя часто называют icon_state, поскольку это имя переменной, которая определяет его в коде.

Также обратите внимание, что вы можете импортировать и экспортировать файлы изображений разных типов, выбрав файлы, которые вы хотите экспортировать, в редакторе (удерживайте Ctrl, чтобы выбрать несколько), щелкнув правой кнопкой мыши и выбрав экспорт, или щелкнув правой кнопкой мыши в любом месте и выбрав импорт, чтобы импортировать. DMI похож на PNG, поэтому, если вы переименуете расширение DMI в PNG, оно должно работать во всех программах графического редактирования. Обычно это работает и в обратную сторону. Это ускоряет перекрашивание.

Надеюсь, это вся информация, которая вам нужна для создания спрайтов и файлов dmi.

== Требуемые спрайты по категориям объектов ==
Теперь расскажу вам, какие спрайты нужны различным типам предметов:

=== Мобы ===

* Спрайты мобов по большей части требуют четырех направлений.
* Спрайты мобов требуют спрайтов мертвых мобов .
* Если вы захотите, вы можете создать спрайт моба, который лежит.
* Если вы создаете моба, который может носить одежду, вы можете использовать Pixel_y, Pixel_x для смены одежды при кодировании моба.

==== Мобы с конечностями ====

* Человек и человеческий вид состоят из конечностей – головы, груди, двух рук и двух ног.
* Файлы находятся в icon/mob/human_parts.dmi для конечностей, имеющих заданный цвет, и в icon/mob/human_parts_greyscale.dmi для конечностей, которые можно перекрасить и начать использовать оттенки серого.
* Конечности имеют 4 кадра, как и полноценные иконки.
* Конечности также используются в качестве иконок предметов на случай расчленения.
* Именование следующее:
** [race]_l/r_arm/leg для рук и ног.
** [race]_chest(_m/f) для торса (м/ж для мужских/женских вариантов, необязательно)
** [race]_head(_m/f) для головы (м/ж для мужского/женского вариантов, необязательно)
* Дополнительные части тела, такие как хвосты ящерицы, помещаются в mutant_bodyparts.dmi.

=== Турфы ===

* Полы находятся в файле icon/turf/floors.dmi.
* Стены находятся в файле icon/turf/walls.dmi.
* Стены и полы шаттла находятся в файле icon/turf/shuttle.dmi.
* Космические плитки находятся в файле icon/turf/space.dmi.

=== Объекты ===

* Спрайты объектов находятся в папке icon/obj.
* Спрайты предметов разбросаны по всей папке.
* Спрайты предметов по большей части требуют наличия собственных спрайтов. Их можно найти в разделах icon/mob/items_lefthand.dmi и icon/mob/items_righthand.dmi.
* Спрайты одежды находятся в папке icon/obj/clothing.
* Спрайты одежды на мобах можно найти в папке icon/mob.
* Спрайты одежды по большей части требуют спрайтов, находящихся в руках. Их можно найти в разделах icon/mob/items_lefthand.dmi и icon/mob/items_righthand.dmi.
* Спрайты техники находятся в папке images/obj/machines. Хотя значительная их часть находится в папке icon/obj.
* Спрайты дверей расположены в папке icon/obj/door.
* Обычный спрайт двери требует Door_closed, Door_locked, Door_opening, Door_deny, Door_Closing, Door_open, Door_spark, o_door_opening, o_door_Closing, Panel_open, Welded и Elights. Предлагаю осмотреть door.dmi
* Укреплённым дверям требуются только спрайты открытия и закрытия, а также спрайты, когда они открыты и закрыты.

== Маппинг ==
'''A.T.O.M. - Area - Turf - Object - Mob''' 
В маппинге, в основном мы рассматриваем 4 типа:

1. [https://www.byond.com/docs/ref/#/area '''Зоны''']. Покрывают область и карты и говорят коду что это за территория и её свойства. От зоны работает вся электроника, зону запитывает АЦП и т.д. Свойства у зон бывают самые различные. От звуков и сообщений в чате до запрета телепортации.

2. [https://www.byond.com/docs/ref/#/turf '''Турфы''']. Пол и стены. Полы определяют какой в тайле будет газ, температура, скорость, гравитация, а стены понятно, надеюсь, что делают. Нельзя в один тайл (условная игровая клетка) поставить и пол и стену. Под стеной при разборе всегда будет базовый пол, если в коде не прописано иного.

3. [https://www.byond.com/docs/ref/#/obj '''Предметы'''] . Всё, что не было указано ранее. В том числе, но не заканчивая ими: лендмарки (точки спавна), простые предметы (столы, стулья), декали (и прочий декор типо мелковых рисунков), рандом спавнеры, машинерия (от лампочки, до консолей и всех труб), провода, и прочее.

4. [https://www.byond.com/docs/ref/#/mob '''Мобы''']. Все НПС. С мобами можно по-разному играться задавая им <s>скорость</s>, здоровье, урон и <s>лутдпроп (для продвинутых).</s>

=== Список переменных ===
У каждого типа есть список переменных. Перечислять все переменные, которые меняются у объектов можно долго, но главные указаны здесь:

[https://www.byond.com/docs/ref/#/%7Bnotes%7D/pixel-movement '''pix_x''' | '''pix_y'''] - Задают смещение от центра тайла. Вся настенная машинерия ставится над/под/слева/справа от нужного расположения на стене и поднимается в нужную сторону на 28-32 пикселя. (1 тайл - 32х32 пикселя)

[[File: Directions.png|thumb|256px|Наглядный пример направлений]]
[https://www.byond.com/docs/ref/#/atom/var/dir '''dir'''] - Направление.
2 - на игрока 1 - от игрока 4 - вправо 8 - влево. Если направлений больше, то и другие значения до 16.

'''anchored''' - Закрепление. Объект нельзя потянуть или сдвинуть если TRUE

'''Id''' и '''id_tag''' - Кнопочная машинерия. Для кнопки задается ''id'', для объекта ''id tag'' определяет поведение для дверей(болты, открыть, доступ и т.д) 
Если вам нужно, чтобы кнопка(id) открывала дверь/поддур и тд с 1 ''id_tag'' - прописывайте в ''id'' так ''“ВАШ ID_TAG”'' 
Если Вам нужно, чтобы кнопка(id) открывала дверь/поддур и тд с множеством ''id_tag'' - прописывайте в id так ''list(“ID_TAG1”,”ID_TAG2”)''. Вписывать можно сколько вашей душе угодно, главное соблюдайте синтаксис.

'''req_access (list)''' - Проверка на доступ любая машинерия и двери. Таблица доступов есть в руководстве по маппингу. Несколько доступов пишутся через запятую без пробелов. Если вы хотите привязать мультидоступ, то прописывайте его через запятую, например: req_access = list(1,19,43)

[https://www.byond.com/docs/ref/#/atom/var/icon '''Icon'''] и [https://www.byond.com/docs/ref/#/atom/var/icon_state '''icon_state'''] - Первый указывает путь до дми файла с кучей иконок, второй указывает какая именно иконка из кучи в этом файле будет показываться.

=== Каждое новое помещение начинается с зоны ===
Зона это основной способ взаимодействия тайлов с кодом игры. Будет ли в зоне электричество от апц, либо же она будет запитана магией, будет ли в ней гравитация, какой в ней будет эмбиент(звук окружения), машинерия и как она будет работать в ней и т.д.

Зоны на станциях не должны повторяться. Дело в том, что зона не обязательно должна располагаться близко, чтобы передавать всю информацию внутри себя. Если разместить одну и ту же зону на разных концах карты, то пожарная сигнализация будет срабатывать в обоих, даже если вторая вообще не имеет атмосферы. Это работает даже на разных Z уровнях!

Помните, что настраивать и изменять свойства зоны необходимо исключительно в коде!
=== Подробнее про Variables ===
[[File:sdmm_variables.png|thumb|256px|Область управления переменными]]
Данная область позволит вам творить самые настоящие тёмные колдунства при наличии хотя бы минимальных знаний понимания работы кода/переменных.
Зона Variables состоит из двух вкладок: Instance и Prefab.
'''Instance''' - Позволяет смотреть и менять параметры у одного объекта на карте.
'''Prefab''' - Также позволяет проверять параметры, однако менять параметры будет у всех таких же объектов на карте.
У вас также имеется возможность использовать некоторые параметры, чтобы показать только изменённые переменные.
<ol>
<li>'''Ctrl+1''' - '''Show modified only''' - Покажет только те переменные, что уже были изменены.</li>
<li>'''Ctrl+2''' - '''Show types''' - Покажет переменные не только объекта, но и также его родителей.</li>
<li>'''Ctrl+3''' - '''Show pins''' - Позволит закрепить необходимую переменную, чтобы не потерять её из виду. Она будет показываться в самом верху.</li>
<li>'''Ctrl+4''' - '''Show tmp, const, and static''' - Наши тёмные маги ещё не познали такую сильную магию. Об этом параметре особо ничего не известно. </li>
</ol>
== Создание кораблей и руин ==
Все текущие корабли находятся в папке '''_maps/_mod_celadon/shuttles''' и имеют сортировку по фракциями, а также там имеется отдельная папка для субшаттлов - '''_maps/_mod_celadon/shuttles/subshuttles'''. В этих папках хранятся сами карты, однако инициализация кораблей происходит благодаря папке '''_maps/_mod_celadon/configs'''.

=== Конфиг корабля ===
[[File:example_ship_config.png|thumb]]
В папке с конфигами вы можете ознакомиться со структурой и перенести её в ваш новый файл. 
Вы также можете изучить саму [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/_maps/ship_config_schema.json '''структуру'''] и пример [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/_maps/example_ship_config.json '''конфигурационного файла'''].
Пройдёмся по переменным:
<ol>
<li>'''map_name''' - Полное название корабля. Именно с таким названием игроки увидят ваш корабль в общем списке в лобби.</li>
<li>'''map_short_name''' - Краткое название карты. Обозначает класс корабля. Будет отображаться в манифесте. Не может содержать пробелы. Кроме букв доступны только дефис и нижнее подчёркивание.</li>
<li>'''description''' - Описание корабля. Будет отображаться при выборе корабля в лобби. Содержит в себе лор корабля.</li>
<li>'''map_path''' - Путь к файлу карты корабля. Например: "_maps\shuttles\inteq\inteq_colossus.dmm"</li>
<li>'''enabled''' - Если "true" - доступно для покупки игроками. Если "false" - только для щитспавна.</li>
<li>'''limit''' - Допустимое количество для покупки корабля игроками.</li>
<li>'''space_spawn''' - По умолчанию корабль спавнится на аванпосту. Если "true", то корабль заспавнится в космосе.</li>
<li>'''prefix''' - Указывается префикс фракции. Доступные префиксы можно найти на [https://wiki.celadon.pro/index.php/Префиксы этой странице].</li>
<li>'''faction''' - Путь к датуму фракции. Доступные фракции находятся в этом файле: [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/mod_celadon/faction/code/faction.dm mod_celadon/faction/code/faction.dm], если нет необходимой - можно найти в другом файле: [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/code/modules/faction/faction_datum.dm code/modules/faction/faction_datum.dm].</li>
<li>'''tags''' - Указываются теги корабля. Их можно найти в этом файле: [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/_maps/ship_tags_descriptions_guide.txt _maps/ship_tags_descriptions_guide.txt]. На данный момент не используется. В будущем планируется использовать для сортировки кораблей.</li>
<li>'''namelists''' - Указываются кодовые названия списков, из которых корабль будет генерировать название корабля при его создании. Ознакомиться с доступными списками и названиями можно в этом файле:[https://github.com/CeladonSS13/Shiptest/blob/beta-dev/strings/ship_names.json strings/ship_names.json].</li>
<li>'''job_slots''' - Состоит из 3 частей. Название (название профессии при заходе на корабль), outfit (путь к снаряжению в коде), slots (количество доступных профессий). Доступный список снаряжений можно найти по пути [https://github.com/CeladonSS13/Shiptest/tree/beta-dev/mod_celadon/outfit/code mod_celadon/outfit/code], они имеют примерно такую структуру: ''/datum/outfit/job/фракция/профессия''.</li>
</ol>

=== Создание субшаттла ===
[[File:guide_subshuttle.png|thumb|256px|Пример датума субшаттла]]
Субшаттлы инициализируются не так, как обычные корабли, им не нужен конфиг. Они недоступны для покупки в общем списке лобби, но могут быть использованы в качестве дополнительного корабля внутри самого корабля или для отправки к примеру ЕРТ отряда с помощью администрации. Они создаются в отдельном файле: [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/mod_celadon/maps/code/subshuttles.dm mod_celadon/maps/code/subshuttles.dm].

Путь к картам субкораблей: '''_maps/_mod_celadon/shuttles/subshuttles'''.
=== Создание руины ===
Руинки - это дополнительные локации, которые спавнятся на планетах. На одной планете может быть максимум одна руина.
При создании руины старайтесь использовать флору и фауну, которые предназначены для выбранной вами планеты.
Чтобы инициализировать руину вам потребуется закинуть карту в папку с руинами для необходимой планеты по пути: '''_maps/_mod_celadon/RandomRuins/'''.
Затем перейдите к файлу '''mod_celadon/maps/code/ruins/ruin.dm''' и пропишите датум, по примеру других руин в файле. Датум может иметь такие параметры:
<ol>
<li>'''Datum''' - ''[Обязательно]'' /datum/map_template/ruin/Планета/Название</li>
<li>'''name''' - ''[Обязательно]'' Полное название вашей руины</li>
<li>'''id''' - ''[Обязательно]'' Уникальное и краткое название руины, без нижних подчёркиваний. Используется функционирования для чёрного листа.</li>
<li>'''suffix''' - ''[Обязательно]'' Название вашего файла. Пример: anima_heirophant.dmm</li>
<li>'''description''' - ''[Обязательно]'' Описание вашей руины, лёгкий лор. Используется для страницы с информацией о руинах (в разработке). </li>
<li>'''cost''' - Влияет на вероятность спавна вашей руины. Чем выше стоимость, тем реже она может встретиться.</li>
<li>'''allow_duplicates''' - Если значение "False", то на весь раунд сможет появится только одна руинка.</li>
<li>'''ruin_tags''' - Используется для краткого описания руины. Теги можно найти здесь: [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/code/__DEFINES/ruins.dm code/__DEFINES/ruins.dm].</li>
<li>'''never_spawn_with''' - Не заспавнит руинку, если уже имеется указанная руина из вашего списка.</li>
</ol>
После создания датума перейдите к текстовому файлу '''map_catalogue_key.txt''' по пути: '''_maps/_mod_celadon/map_catalogue.txt''' и оставьте запись о руинке с размерами, тегами и путями.

=== Важная дополнительная информация ===
Обязательное правило для создания корабля и субшатла, чтобы он не был квадратным иначе, как бы вы не старались при постановке док портов, вы не сможете задать нужное вам направление.
[Wideband] На корабля обязательно должно присутствовать средство связи с другими кораблями.
Если вы хотите, чтобы ваша карта была добавлена на [https://map.celadon.pro вебкарту], то нужно обращаться непосредственно к хосту Celadon`a - Voiko.
Максимальные размеры руин: '''121x75'''. Максимальный размер корабля равен максимальному размеру ангара '''56x40'''.
Список кодов доступа (access) к шлюзам и так далее находится в файле [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/code_DEFINES/access.dm code/_DEFINES/access.dm].
При создании атмосферы на шипе не используйте стационарные танки с газами.

= Проверка перед публикацией =
<ol>
<li>Полы с воздухом или без него, как и должно быть? (обычный или безвоздушный)</li>
<li>[APC] - Есть ли в этой зоне ЛКП?</li>
<li>[Air Alarm] - Есть ли в этой зоне воздушная сигнализация?</li>
<li>[Outpost Communications Console] - Есть ли в этой зоне консоль запросов?</li>
<li>[Light] - Есть ли на территории освещение?</li>
<li>[Light Switch] - Есть ли в этом помещении выключатель света?</li>
<li>[Intercom] - Достаточно ли в этом зоне интеркомов?</li>
<li>[Camera] - Достаточно ли в этом зоне камер видеонаблюдения?</li>
<li>[Vent Scrubber] - Подключена ли зона к вентиляционному очистителю?</li>
<li>[Vent Pump] - Подключена ли зона к вентиляционному насосу?</li>
<li>[Fire Alarm & Fire Doors] - Есть ли на территории пожарная сигнализация и противопожарные шлюзы?</li>
<li>[Holopad] - Имеется ли голопад на вашем судне?</li>
<li>Все ли подключено правильно?</li>
<li>Все ли двери работают правильно?</li>
<li>Правильно ли настроены доступы на дверях, кнопках и т. д.?</li>
<li>Все ли предметы размещены правильно? (не ниже вентиляционных отверстий, скрубберов, столов)?</li>
<li>Правильно ли работает система мусоропровода?</li>
<li>Проверьте наличие неуместных или наложенных частей труб (воздушных и отводящих).</li>
<li>Проверьте, нет ли неуместного или наложенного куска провода.</li>
<li>Определите, насколько сложно проникнуть в эту область и где находятся слабые места, и соответствующим образом сбалансируйте область (например, Хранилище должно быть сделано из усиленных конструкций и электрифицированных окон, Кухня не должна быть сделана из этих материалов, а из обычных стен)</li>
<li>Проверьте, не слишком ли много пустого пространства. Если да, уменьшите его и замените остальные туннелями для обслуживания.</li>
<li>Есть ли нерушимые турфы там, где их не должно быть?</li>
</ol>

Участник:Voiko

2026-04-21T14:47:07Z

Файл:Sprite settings4.png

2026-04-21T14:29:45Z

Voiko:

Файл:Sprite settings3.png

2026-04-21T14:29:17Z

Voiko:

Участник:Voiko

2026-04-21T14:15:01Z

Voiko: /* Выбор программы */

{{В процессе создания|worker=Voiko}}

= Руководство по созданию спрайтов =
'''Спрайтеры''' - люди, занимающиеся внешним видом игры, делают в основном текстурки для игры. Их главная цель - сделать хорошо, а плохо - не сделать, пиксель арт не стремится сделать достоверную репрезентацию чего-то в игре, его цель - показать объект так, чтобы было ясно что это он и красиво его нарисовать. Обычно спрайты рисуются в разрешении '''32x32''' пикселя, но бывают и исключения, например спрайты мегафауны имеют большее разрешение.

== Терминология ==
Перед процессом спрайтингом нам предстоит немного ознакомиться с основными терминами.
<ol>
<li>'''Билд''' - папка, которую вы скачали с нашего репозитория, хранит в себе кодовую структуру и конечно же DMI файлики с нашими спрайтами.</li>
<li>'''DMI (Атлас)''' - формат файла .dmi, также может называться как '''Атлас'''. Грубо говоря это файл, который имеет в себе спрайты от одного до целого множества. Обычно именно их вы встретите в билде.</li>
<li>'''Спрайт''' (стейт) - спрайтшит, в котором может быть анимация и несколько направлений спрайта. .</li>
<li>'''VSC (Visual Studio Code)''' - программа, в которой мы можем просматривать код и спрайты, а также делать изменения. (Для редактирования спрайтов программа не годится, только для просмотра).</li>
<li>'''Dream Maker''' - стандартная программа, появляется при установке BYOND, через которую вы можете открыть атлас, импортировать или экспортировать файлы, а также редактировать сам спрайт. Будьте осторожны. При открытии спрайтов могут сгенерироваться изменения в коде, которые могут помешать запуску билда. </li>
</ol>
== Выбор программы ==
Рисовать спрайты можно где вашей душе угодно. Можно конечно всё делать сразу в встроенном редакторе byond, но лучше использовать что-то другое, ибо он устаревший и достаточно неудобен, а ещё может сломать вам билд. Большинство спрайтеров пользуются '''Aseprite''' - удобной программой специально для пиксель арта.
Также стоит заметить, что если вы используете программу, не созданную специально для пиксель арта, вам необходимо будет выбрать режим интерполяции “По соседним пикселям” чтобы ваш спрайт не превратился в мыло. 
[[File:sprite_settings1.png|384px]] 
[[File:sprite_settings2.png|384px]]
[[File:Aseprite_Logo.png|thumb|128px]]
[[File:Aseprite.png|thumb|128px|'''"Aseprite"''' - стандартная программа для редактирования DMI файлов.]]
Прежде, чем начать спрайтить, нам потребуется взять на вооружение программу, с помощью которой ты сможешь создавать самые различные спрайты объектов, мобов, снаряжения и не только. 
На выбор у нас имеются программы:
<ol>
<li> '''[https://www.aseprite.org/ Aseprite]''' - отличный выбор, используется очень часто. Вы можете получить его бесплатно, скомпилировав [https://github.com/aseprite/aseprite исходный код], или купить. Отдельно можно установить [https://github.com/spacestation13/aseprite-dmi плагин] для поддержки DMI.</li>
<li> '''[https://www.piskelapp.com/ Piskel]''' - бесплатный сайт, который позволяет редактировать спрайты без необходимости скачивания. Простенький интерфейс, с отсутствием поддержки DMI файлов/атласов.</li>
<li> '''[https://www.gimp.org/ GIMP]''' - бесплатный вариант, не особо модный, требует скачивания. Имеет интерфейс немного лучше, чем обычный Paint. Поддержка DMI отсутствует.</li>
<li> '''[https://www.adobe.com/ua/products/photoshop.html Adobe Photoshop]''' - платный вариант, но возможно для кого-то покажется удобным инструментом для редактирования PNG картинок. Поддержка DMI отсутствует.</li>
</ol>
В данном гайде мы будем ориентироваться на функционал программы "Aseprite", однако перед этим нам потребуется загрузить сердце нашего проекта, определится с выбором билда и загрузить его. 
Подразумевается, что вы уже ознакомлены с [[Запуск локального сервера|руководством по установке локального сервера]] и имеете на компьютере загруженный билд. 
'''Важно! НЕЛЬЗЯ, ЧТОБЫ НА ПУТИ ПРОГРАММЫ БЫЛА КИРИЛИЦА.'''
===Инструкция по установке расширений для Aseprite===
<ol>
<li>Запускаем Aseprite - '''Edit (Menu)''' - '''Preferences'''</li>
<li>Выбираем раздел '''Extensions''' - '''Add Extension''' - Прикрепляем файл '''Asesprite-DMI-Windows'''.</li>
</ol>
Если вдруг не работает расширение - выбираем его в этой же менюшке и нажимаем Enable.
 [[File:Aseprite_instruction1.webp|737px]]
====Работа расширения====
При перетаскивании DMI файла в окно Aseprite (обычное открытие не работает из-за отсутствия поддержки), открывается окно со всеми иконками.
<ol>'''В расширении можно:'''
<li>Создавать/изменять спрайт в стейте</li>
<li>Менять данные</li>
<li>Сохранять (работает как обычное сохранение) </li>
<li>Экспортировать в формат .dmi.</li>
</ol>
[[File:Aseprite_instruction2.webp|737px]]
===Полезные расширения для Aseprite===
<ul>
<li>[https://github.com/lufog/aseprite-language-russian Перевод для Aseprite] - расширение, что переводит интерфейс на русский язык.</li>
<li>[https://github.com/spacestation13/aseprite-dmi Поддержка DMI] - обязательный плагин, предоставляет возможность работать с DMI файлами.</li>
<li>[https://github.com/Seefaaa/aseprite-dmi Поддержка DMI №2] - резервный плагин, предоставляет возможность работать с DMI файлами. Не требует установки, если уже установлен плагин выше.</li>
</ul>

== Документация ==
Также для удобства предоставляем список материалов, с которыми можно ознакомиться для повышения собственной квалификации.
<ul>
<li>[http://gas13.ru/v3/tutorials/ru_sywtbapa_almighty_grass_tile.php Gas13] - Базовый гайд на русском языке, рекомендуется ознакомиться для начинающих спрайтеров. </li>
<li>[https://gamin.me/posts/4849 Gamin.me ] - Pixel Art для начинающих, на русском.</li>
<li>[https://hackmd.io/@Partheo/spriting Hackmd.oi/@Partheo] - Очень хороший гайд на английском, в целом по сске.</li>
<li>[https://wiki.taucetistation.org/Guide_to_Spriting Гайд по спрайтингу с Tau Ceti Station Wiki]</li>
<li>[https://tgstation13.org/wiki/Guide_to_spriting Гайд по спрайтингу с TGStation13 Wiki]</li>
</ul>

== Хоткеи ==
Основные сочетания клавиш для работы.
{| class="wikitable" style="width:100%; text-align:left; border:3px solid rgba(80,80,80,0.4); border-radius:12px; overflow:hidden;"

! style="width:220px; background-color:#a5b4d1; color:#000000; text-align:center;" |Категория
! style="width:220px; background-color:#a5b4d1; color:#000000;" |Хоткей
! style="background-color:#a5b4d1; color:#000000;" |Описание

|-
! rowspan="6" style="background-color:#f2b3b3; color:#000; text-align:center;" |Навигация и холст
|Ctrl + колесо мыши
|Зум
|-
|1 / 2 / 3 / 4 / 5
|Быстрый масштаб
|-
|H
|Рука (перемещение холста)
|-
|Ctrl + 0
|Подогнать под экран
|-
|Tab
|Скрыть интерфейс
|-
|Shift + Tab
|Скрыть панели

|-
! rowspan="11" style="background-color:#f2d2b3; color:#000; text-align:center;" |Основные инструменты
|B
|Brush (Кисть)
|-
|E
|Eraser (Ластик)
|-
|G
|Paint Bucket (Заливка)
|-
|I
|Eyedropper (Пипетка)
|-
|M
|Marquee (Выделение прямоугольником)
|-
|L
|Lasso (Свободное выделение)
|-
|U
|Shape Tool (Фигуры)
|-
|P
|Pencil (Карандаш)
|-
|C
|Contour / Polygon
|-
|K
|Ink (режимы рисования)
|-
|S
|Spray

|-
! rowspan="4" style="background-color:#f2e7b3; color:#000; text-align:center;" |Работа с цветом
|X
|Поменять местами foreground/background
|-
|D
|Сброс цветов (черный/белый)
|-
|Alt + клик
|Пипетка
|-
|Shift + I
|Color Picker (альтернативный)

|-
! rowspan="6" style="background-color:#b3f2c2; color:#000; text-align:center;" |Выделение
|Ctrl + A
|Выделить всё
|-
|Ctrl + D
|Снять выделение
|-
|Ctrl + Shift + I
|Инвертировать выделение
|-
|Alt + drag
|Перемещение выделения
|-
|Shift
|Добавить к выделению
|-
|Alt
|Убрать из выделения

|-
! rowspan="7" style="background-color:#b3d2f2; color:#000; text-align:center;" |Слои и кадры
|N
|Новый слой
|-
|Shift + N
|Новый слой сверху
|-
|Ctrl + Shift + N
|Новый слой с настройками
|-
|Delete
|Удалить слой/содержимое
|-
|Page Up / Page Down
|Переключение кадров
|-
|Alt + N
|Новый кадр
|-
|Alt + Delete
|Очистить слой

|-
! rowspan="7" style="background-color:#d0b3f2; color:#000; text-align:center;" |Редактирование
|Ctrl + Z
|Отмена
|-
|Ctrl + Y
|Повтор
|-
|Ctrl + X
|Вырезать
|-
|Ctrl + C
|Копировать
|-
|Ctrl + V
|Вставить
|-
|Ctrl + B
|Вставить в место
|-
|Ctrl + T
|Трансформация

|-
! rowspan="3" style="background-color:#f2b3e1; color:#000; text-align:center;" |Трансформации
|Ctrl + T
|Свободная трансформация
|-
|Shift
|Сохранять пропорции
|-
|Alt
|Масштаб из центра

|-
! rowspan="5" style="background-color:#f2e0b3; color:#000; text-align:center;" |Дополнительно
|F
|Flip (отразить)
|-
|Shift + F
|Отразить по вертикали
|-
|Ctrl + Shift + F
|Отразить по горизонтали
|-
|Ctrl + U
|Hue/Saturation
|-
|Ctrl + L
|Levels

|-
! rowspan="2" style="background-color:#b3f2cf; color:#000; text-align:center;" |Тайлы и пиксель-арт
|Ctrl + Shift + T
|Tile Mode
|-
|Shift + B
|Pixel Perfect (идеальные линии)

|-
! rowspan="4" style="background-color:#d6d6d6; color:#000; text-align:center;" |Полезные скрытые фишки
|Пробел / СКМ (зажать)
|Временно инструмент "рука"
|-
|Ctrl (зажать)
|Временно пипетка
|-
|Shift (при рисовании)
|Рисование прямых линий
|-
|Ctrl + drag
|Перемещение содержимого

|}
Спрайты важны, понимаешь? Если бы у нас не было спрайтов, мы бы сделали действительно дерьмовую текстовую ролевую игру Roblox 2010. Или, может быть, одна из тех DOS-игр, но многопользовательская. Вы вообще видели эти темы о ролевых играх на форумах? Вот это оно и есть. Очень старое и грустное. Таким образом, спрайтеры являются важными художниками в игре. Они заставляют мапперов ставить стены и полы, а кодеров использовать модульную организацию, а картинки мы бессовестно крадем и помещаем в вики, хехехе. У них великая цель, и они также могут хорошо развлечься — вы когда-нибудь видели спрайты, которые они кидают в дискорд? Это круто. Это действительно ахуенно. Искусство сложно, и люди выходят за рамки этого, чтобы создавать офигенные спрайты. Это работа со страстью. Я не могу выразить словами, насколько важно создание спрайтов (да, это пишет и переводит вики-редактор, который по совместительству спрайтер xdd). Упрощенные визуальные эффекты очень необходимы в игре, и работа спрайтеров, проделанная для того, чтобы это произошло, заслуживает высокой оценки.

О, вы искали настоящего гида. Извините. идите спрашивайте в #dev-спрайт [https://discord.gg/rxsggTJzY3 дискорда].

== Основы ==
Спрайты в SS13 хранятся в файлах dmi. По сути, это атлас-спрайтов в определенном формате. Вы помещаете в него PNG и даете ему имя — это состояние значка. Большинство dmis имеют размер 32x32. У вас может быть растровое изображение, представляющее собой статический спрайт, а гифки можно анимировать. BYOND также работает с 8 направлениями движения, но обычно вам понадобится только 4 или 1.

== ПО ==
Aseprite используется очень часто. Вы можете получить его бесплатно, скомпилировав исходный код, или купить. Некоторые люди также используют Piskel. Вы также можете использовать другое программное обеспечение для обработки изображений, например Paint.net. От себя ещё могу порекомендовать бесплатный GIMP, или платный Adobe Photoshop, хотя ни в том ни в другом нет функции работы с DMI

== Обзор объекта ==
В игре 4 типа объектов:

* '''Область''' – нас это не будет интересовать, так как вы не увидите ее в игре и достаточно wip-графики,
* '''Моб''' – люди, обезьяны, киборги, инопланетяне и другая живность на станции / кораблях / планетах,
* '''Объекты''' – машины, двери, предметы и все остальное в игре,
* '''Турф''' – стены, полы и пространство

== Формат файла DMI ==
Спрайты в SS13 упакованы в файлы .dmi. Чтобы создать новый файл dmi, откройте Dream Maker, выберите «Файл» > «Новый» и выберите «Файл значка (dmi)» в раскрывающемся меню. Напишите для него путь к файлу и нажмите ОК.

Откроется новое окно с пустым файлом. в правом верхнем углу есть два места для размеров спрайта. Большинство спрайтов имеют размер 32x32 пикселя. К сожалению, один dmi-файл не может содержать спрайты разных размеров.

Теперь щелкните правой кнопкой мыши где-нибудь на белизне. Существует два типа спрайтов: растровое изображение и фильм. Растровое изображение статично, а фильм можно анимировать и смотреть в разных направлениях, вот и вся разница. Давайте создадим спрайт фильма. (Новый фильм)

Откроется окно с четырьмя стрелками направления и тремя рамками для каждой из них, все серого цвета. Байонд понимает 8 направлений. Вы можете выбрать, сколько кадров вы хотите использовать, под самими спрайтами: 1, 4 или 8. Вы также можете выбрать, сколько кадров вы хотите иметь в анимации. Если вы создаете разнонаправленный статический спрайт, создайте фильм с 1 кадром, без анимации, но с 4 или 8 направлениями, в зависимости от того, сколько вам нужно. Если вы хотите анимировать спрайт, вас также может заинтересовать возможность установить задержку в 1/10 секунды над конкретным кадром. Хорошо, надеюсь, отсюда вы поймете, что делать. Встроенный инструмент редактирования спрайтов очень примитивен и единственное, о чем в нем стоит упомянуть, это о том, как применять альфа-фильтр. Если вы дважды щелкните любое изображение, вы попадете в редактор спрайтов, а справа от него находится вертикальный ползунок, управляющий альфа-каналом. Также стоит отметить, что копирование из редактора может вести себя немного странно, поскольку фон создается полностью, несмотря на установленный альфа-фильтр. Просто «залейте» фон цветом со значением альфа 0 или используйте «импорт», который отлично работает.

Теперь предположим, что мы сделали ваши спрайты спрайтами, вернитесь к файлу dmi (экран, который появился, когда вы впервые создали файл). Предполагая, что вы создали спрайт, вы увидите его в списке. Дважды щелкните чуть ниже фактического спрайта, и откроется окно переименования. Альтернативно выберите спрайт и нажмите F2 на клавиатуре. Дайте имя вашему спрайту. Это имя часто называют icon_state, поскольку это имя переменной, которая определяет его в коде.

Также обратите внимание, что вы можете импортировать и экспортировать файлы изображений разных типов, выбрав файлы, которые вы хотите экспортировать, в редакторе (удерживайте Ctrl, чтобы выбрать несколько), щелкнув правой кнопкой мыши и выбрав экспорт, или щелкнув правой кнопкой мыши в любом месте и выбрав импорт, чтобы импортировать. DMI похож на PNG, поэтому, если вы переименуете расширение DMI в PNG, оно должно работать во всех программах графического редактирования. Обычно это работает и в обратную сторону. Это ускоряет перекрашивание.

Надеюсь, это вся информация, которая вам нужна для создания спрайтов и файлов dmi.

== Требуемые спрайты по категориям объектов ==
Теперь расскажу вам, какие спрайты нужны различным типам предметов:

=== Мобы ===

* Спрайты мобов по большей части требуют четырех направлений.
* Спрайты мобов требуют спрайтов мертвых мобов .
* Если вы захотите, вы можете создать спрайт моба, который лежит.
* Если вы создаете моба, который может носить одежду, вы можете использовать Pixel_y, Pixel_x для смены одежды при кодировании моба.

==== Мобы с конечностями ====

* Человек и человеческий вид состоят из конечностей – головы, груди, двух рук и двух ног.
* Файлы находятся в icon/mob/human_parts.dmi для конечностей, имеющих заданный цвет, и в icon/mob/human_parts_greyscale.dmi для конечностей, которые можно перекрасить и начать использовать оттенки серого.
* Конечности имеют 4 кадра, как и полноценные иконки.
* Конечности также используются в качестве иконок предметов на случай расчленения.
* Именование следующее:
** [race]_l/r_arm/leg для рук и ног.
** [race]_chest(_m/f) для торса (м/ж для мужских/женских вариантов, необязательно)
** [race]_head(_m/f) для головы (м/ж для мужского/женского вариантов, необязательно)
* Дополнительные части тела, такие как хвосты ящерицы, помещаются в mutant_bodyparts.dmi.

=== Турфы ===

* Полы находятся в файле icon/turf/floors.dmi.
* Стены находятся в файле icon/turf/walls.dmi.
* Стены и полы шаттла находятся в файле icon/turf/shuttle.dmi.
* Космические плитки находятся в файле icon/turf/space.dmi.

=== Объекты ===

* Спрайты объектов находятся в папке icon/obj.
* Спрайты предметов разбросаны по всей папке.
* Спрайты предметов по большей части требуют наличия собственных спрайтов. Их можно найти в разделах icon/mob/items_lefthand.dmi и icon/mob/items_righthand.dmi.
* Спрайты одежды находятся в папке icon/obj/clothing.
* Спрайты одежды на мобах можно найти в папке icon/mob.
* Спрайты одежды по большей части требуют спрайтов, находящихся в руках. Их можно найти в разделах icon/mob/items_lefthand.dmi и icon/mob/items_righthand.dmi.
* Спрайты техники находятся в папке images/obj/machines. Хотя значительная их часть находится в папке icon/obj.
* Спрайты дверей расположены в папке icon/obj/door.
* Обычный спрайт двери требует Door_closed, Door_locked, Door_opening, Door_deny, Door_Closing, Door_open, Door_spark, o_door_opening, o_door_Closing, Panel_open, Welded и Elights. Предлагаю осмотреть door.dmi
* Укреплённым дверям требуются только спрайты открытия и закрытия, а также спрайты, когда они открыты и закрыты.

== Маппинг ==
'''A.T.O.M. - Area - Turf - Object - Mob''' 
В маппинге, в основном мы рассматриваем 4 типа:

1. [https://www.byond.com/docs/ref/#/area '''Зоны''']. Покрывают область и карты и говорят коду что это за территория и её свойства. От зоны работает вся электроника, зону запитывает АЦП и т.д. Свойства у зон бывают самые различные. От звуков и сообщений в чате до запрета телепортации.

2. [https://www.byond.com/docs/ref/#/turf '''Турфы''']. Пол и стены. Полы определяют какой в тайле будет газ, температура, скорость, гравитация, а стены понятно, надеюсь, что делают. Нельзя в один тайл (условная игровая клетка) поставить и пол и стену. Под стеной при разборе всегда будет базовый пол, если в коде не прописано иного.

3. [https://www.byond.com/docs/ref/#/obj '''Предметы'''] . Всё, что не было указано ранее. В том числе, но не заканчивая ими: лендмарки (точки спавна), простые предметы (столы, стулья), декали (и прочий декор типо мелковых рисунков), рандом спавнеры, машинерия (от лампочки, до консолей и всех труб), провода, и прочее.

4. [https://www.byond.com/docs/ref/#/mob '''Мобы''']. Все НПС. С мобами можно по-разному играться задавая им <s>скорость</s>, здоровье, урон и <s>лутдпроп (для продвинутых).</s>

=== Список переменных ===
У каждого типа есть список переменных. Перечислять все переменные, которые меняются у объектов можно долго, но главные указаны здесь:

[https://www.byond.com/docs/ref/#/%7Bnotes%7D/pixel-movement '''pix_x''' | '''pix_y'''] - Задают смещение от центра тайла. Вся настенная машинерия ставится над/под/слева/справа от нужного расположения на стене и поднимается в нужную сторону на 28-32 пикселя. (1 тайл - 32х32 пикселя)

[[File: Directions.png|thumb|256px|Наглядный пример направлений]]
[https://www.byond.com/docs/ref/#/atom/var/dir '''dir'''] - Направление.
2 - на игрока 1 - от игрока 4 - вправо 8 - влево. Если направлений больше, то и другие значения до 16.

'''anchored''' - Закрепление. Объект нельзя потянуть или сдвинуть если TRUE

'''Id''' и '''id_tag''' - Кнопочная машинерия. Для кнопки задается ''id'', для объекта ''id tag'' определяет поведение для дверей(болты, открыть, доступ и т.д) 
Если вам нужно, чтобы кнопка(id) открывала дверь/поддур и тд с 1 ''id_tag'' - прописывайте в ''id'' так ''“ВАШ ID_TAG”'' 
Если Вам нужно, чтобы кнопка(id) открывала дверь/поддур и тд с множеством ''id_tag'' - прописывайте в id так ''list(“ID_TAG1”,”ID_TAG2”)''. Вписывать можно сколько вашей душе угодно, главное соблюдайте синтаксис.

'''req_access (list)''' - Проверка на доступ любая машинерия и двери. Таблица доступов есть в руководстве по маппингу. Несколько доступов пишутся через запятую без пробелов. Если вы хотите привязать мультидоступ, то прописывайте его через запятую, например: req_access = list(1,19,43)

[https://www.byond.com/docs/ref/#/atom/var/icon '''Icon'''] и [https://www.byond.com/docs/ref/#/atom/var/icon_state '''icon_state'''] - Первый указывает путь до дми файла с кучей иконок, второй указывает какая именно иконка из кучи в этом файле будет показываться.

=== Каждое новое помещение начинается с зоны ===
Зона это основной способ взаимодействия тайлов с кодом игры. Будет ли в зоне электричество от апц, либо же она будет запитана магией, будет ли в ней гравитация, какой в ней будет эмбиент(звук окружения), машинерия и как она будет работать в ней и т.д.

Зоны на станциях не должны повторяться. Дело в том, что зона не обязательно должна располагаться близко, чтобы передавать всю информацию внутри себя. Если разместить одну и ту же зону на разных концах карты, то пожарная сигнализация будет срабатывать в обоих, даже если вторая вообще не имеет атмосферы. Это работает даже на разных Z уровнях!

Помните, что настраивать и изменять свойства зоны необходимо исключительно в коде!
=== Подробнее про Variables ===
[[File:sdmm_variables.png|thumb|256px|Область управления переменными]]
Данная область позволит вам творить самые настоящие тёмные колдунства при наличии хотя бы минимальных знаний понимания работы кода/переменных.
Зона Variables состоит из двух вкладок: Instance и Prefab.
'''Instance''' - Позволяет смотреть и менять параметры у одного объекта на карте.
'''Prefab''' - Также позволяет проверять параметры, однако менять параметры будет у всех таких же объектов на карте.
У вас также имеется возможность использовать некоторые параметры, чтобы показать только изменённые переменные.
<ol>
<li>'''Ctrl+1''' - '''Show modified only''' - Покажет только те переменные, что уже были изменены.</li>
<li>'''Ctrl+2''' - '''Show types''' - Покажет переменные не только объекта, но и также его родителей.</li>
<li>'''Ctrl+3''' - '''Show pins''' - Позволит закрепить необходимую переменную, чтобы не потерять её из виду. Она будет показываться в самом верху.</li>
<li>'''Ctrl+4''' - '''Show tmp, const, and static''' - Наши тёмные маги ещё не познали такую сильную магию. Об этом параметре особо ничего не известно. </li>
</ol>
== Создание кораблей и руин ==
Все текущие корабли находятся в папке '''_maps/_mod_celadon/shuttles''' и имеют сортировку по фракциями, а также там имеется отдельная папка для субшаттлов - '''_maps/_mod_celadon/shuttles/subshuttles'''. В этих папках хранятся сами карты, однако инициализация кораблей происходит благодаря папке '''_maps/_mod_celadon/configs'''.

=== Конфиг корабля ===
[[File:example_ship_config.png|thumb]]
В папке с конфигами вы можете ознакомиться со структурой и перенести её в ваш новый файл. 
Вы также можете изучить саму [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/_maps/ship_config_schema.json '''структуру'''] и пример [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/_maps/example_ship_config.json '''конфигурационного файла'''].
Пройдёмся по переменным:
<ol>
<li>'''map_name''' - Полное название корабля. Именно с таким названием игроки увидят ваш корабль в общем списке в лобби.</li>
<li>'''map_short_name''' - Краткое название карты. Обозначает класс корабля. Будет отображаться в манифесте. Не может содержать пробелы. Кроме букв доступны только дефис и нижнее подчёркивание.</li>
<li>'''description''' - Описание корабля. Будет отображаться при выборе корабля в лобби. Содержит в себе лор корабля.</li>
<li>'''map_path''' - Путь к файлу карты корабля. Например: "_maps\shuttles\inteq\inteq_colossus.dmm"</li>
<li>'''enabled''' - Если "true" - доступно для покупки игроками. Если "false" - только для щитспавна.</li>
<li>'''limit''' - Допустимое количество для покупки корабля игроками.</li>
<li>'''space_spawn''' - По умолчанию корабль спавнится на аванпосту. Если "true", то корабль заспавнится в космосе.</li>
<li>'''prefix''' - Указывается префикс фракции. Доступные префиксы можно найти на [https://wiki.celadon.pro/index.php/Префиксы этой странице].</li>
<li>'''faction''' - Путь к датуму фракции. Доступные фракции находятся в этом файле: [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/mod_celadon/faction/code/faction.dm mod_celadon/faction/code/faction.dm], если нет необходимой - можно найти в другом файле: [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/code/modules/faction/faction_datum.dm code/modules/faction/faction_datum.dm].</li>
<li>'''tags''' - Указываются теги корабля. Их можно найти в этом файле: [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/_maps/ship_tags_descriptions_guide.txt _maps/ship_tags_descriptions_guide.txt]. На данный момент не используется. В будущем планируется использовать для сортировки кораблей.</li>
<li>'''namelists''' - Указываются кодовые названия списков, из которых корабль будет генерировать название корабля при его создании. Ознакомиться с доступными списками и названиями можно в этом файле:[https://github.com/CeladonSS13/Shiptest/blob/beta-dev/strings/ship_names.json strings/ship_names.json].</li>
<li>'''job_slots''' - Состоит из 3 частей. Название (название профессии при заходе на корабль), outfit (путь к снаряжению в коде), slots (количество доступных профессий). Доступный список снаряжений можно найти по пути [https://github.com/CeladonSS13/Shiptest/tree/beta-dev/mod_celadon/outfit/code mod_celadon/outfit/code], они имеют примерно такую структуру: ''/datum/outfit/job/фракция/профессия''.</li>
</ol>

=== Создание субшаттла ===
[[File:guide_subshuttle.png|thumb|256px|Пример датума субшаттла]]
Субшаттлы инициализируются не так, как обычные корабли, им не нужен конфиг. Они недоступны для покупки в общем списке лобби, но могут быть использованы в качестве дополнительного корабля внутри самого корабля или для отправки к примеру ЕРТ отряда с помощью администрации. Они создаются в отдельном файле: [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/mod_celadon/maps/code/subshuttles.dm mod_celadon/maps/code/subshuttles.dm].

Путь к картам субкораблей: '''_maps/_mod_celadon/shuttles/subshuttles'''.
=== Создание руины ===
Руинки - это дополнительные локации, которые спавнятся на планетах. На одной планете может быть максимум одна руина.
При создании руины старайтесь использовать флору и фауну, которые предназначены для выбранной вами планеты.
Чтобы инициализировать руину вам потребуется закинуть карту в папку с руинами для необходимой планеты по пути: '''_maps/_mod_celadon/RandomRuins/'''.
Затем перейдите к файлу '''mod_celadon/maps/code/ruins/ruin.dm''' и пропишите датум, по примеру других руин в файле. Датум может иметь такие параметры:
<ol>
<li>'''Datum''' - ''[Обязательно]'' /datum/map_template/ruin/Планета/Название</li>
<li>'''name''' - ''[Обязательно]'' Полное название вашей руины</li>
<li>'''id''' - ''[Обязательно]'' Уникальное и краткое название руины, без нижних подчёркиваний. Используется функционирования для чёрного листа.</li>
<li>'''suffix''' - ''[Обязательно]'' Название вашего файла. Пример: anima_heirophant.dmm</li>
<li>'''description''' - ''[Обязательно]'' Описание вашей руины, лёгкий лор. Используется для страницы с информацией о руинах (в разработке). </li>
<li>'''cost''' - Влияет на вероятность спавна вашей руины. Чем выше стоимость, тем реже она может встретиться.</li>
<li>'''allow_duplicates''' - Если значение "False", то на весь раунд сможет появится только одна руинка.</li>
<li>'''ruin_tags''' - Используется для краткого описания руины. Теги можно найти здесь: [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/code/__DEFINES/ruins.dm code/__DEFINES/ruins.dm].</li>
<li>'''never_spawn_with''' - Не заспавнит руинку, если уже имеется указанная руина из вашего списка.</li>
</ol>
После создания датума перейдите к текстовому файлу '''map_catalogue_key.txt''' по пути: '''_maps/_mod_celadon/map_catalogue.txt''' и оставьте запись о руинке с размерами, тегами и путями.

=== Важная дополнительная информация ===
Обязательное правило для создания корабля и субшатла, чтобы он не был квадратным иначе, как бы вы не старались при постановке док портов, вы не сможете задать нужное вам направление.
[Wideband] На корабля обязательно должно присутствовать средство связи с другими кораблями.
Если вы хотите, чтобы ваша карта была добавлена на [https://map.celadon.pro вебкарту], то нужно обращаться непосредственно к хосту Celadon`a - Voiko.
Максимальные размеры руин: '''121x75'''. Максимальный размер корабля равен максимальному размеру ангара '''56x40'''.
Список кодов доступа (access) к шлюзам и так далее находится в файле [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/code_DEFINES/access.dm code/_DEFINES/access.dm].
При создании атмосферы на шипе не используйте стационарные танки с газами.

= Проверка перед публикацией =
<ol>
<li>Полы с воздухом или без него, как и должно быть? (обычный или безвоздушный)</li>
<li>[APC] - Есть ли в этой зоне ЛКП?</li>
<li>[Air Alarm] - Есть ли в этой зоне воздушная сигнализация?</li>
<li>[Outpost Communications Console] - Есть ли в этой зоне консоль запросов?</li>
<li>[Light] - Есть ли на территории освещение?</li>
<li>[Light Switch] - Есть ли в этом помещении выключатель света?</li>
<li>[Intercom] - Достаточно ли в этом зоне интеркомов?</li>
<li>[Camera] - Достаточно ли в этом зоне камер видеонаблюдения?</li>
<li>[Vent Scrubber] - Подключена ли зона к вентиляционному очистителю?</li>
<li>[Vent Pump] - Подключена ли зона к вентиляционному насосу?</li>
<li>[Fire Alarm & Fire Doors] - Есть ли на территории пожарная сигнализация и противопожарные шлюзы?</li>
<li>[Holopad] - Имеется ли голопад на вашем судне?</li>
<li>Все ли подключено правильно?</li>
<li>Все ли двери работают правильно?</li>
<li>Правильно ли настроены доступы на дверях, кнопках и т. д.?</li>
<li>Все ли предметы размещены правильно? (не ниже вентиляционных отверстий, скрубберов, столов)?</li>
<li>Правильно ли работает система мусоропровода?</li>
<li>Проверьте наличие неуместных или наложенных частей труб (воздушных и отводящих).</li>
<li>Проверьте, нет ли неуместного или наложенного куска провода.</li>
<li>Определите, насколько сложно проникнуть в эту область и где находятся слабые места, и соответствующим образом сбалансируйте область (например, Хранилище должно быть сделано из усиленных конструкций и электрифицированных окон, Кухня не должна быть сделана из этих материалов, а из обычных стен)</li>
<li>Проверьте, не слишком ли много пустого пространства. Если да, уменьшите его и замените остальные туннелями для обслуживания.</li>
<li>Есть ли нерушимые турфы там, где их не должно быть?</li>
</ol>

Участник:Voiko

2026-04-21T14:13:46Z

Voiko: /* Выбор программы */

{{В процессе создания|worker=Voiko}}

= Руководство по созданию спрайтов =
'''Спрайтеры''' - люди, занимающиеся внешним видом игры, делают в основном текстурки для игры. Их главная цель - сделать хорошо, а плохо - не сделать, пиксель арт не стремится сделать достоверную репрезентацию чего-то в игре, его цель - показать объект так, чтобы было ясно что это он и красиво его нарисовать. Обычно спрайты рисуются в разрешении '''32x32''' пикселя, но бывают и исключения, например спрайты мегафауны имеют большее разрешение.

== Терминология ==
Перед процессом спрайтингом нам предстоит немного ознакомиться с основными терминами.
<ol>
<li>'''Билд''' - папка, которую вы скачали с нашего репозитория, хранит в себе кодовую структуру и конечно же DMI файлики с нашими спрайтами.</li>
<li>'''DMI (Атлас)''' - формат файла .dmi, также может называться как '''Атлас'''. Грубо говоря это файл, который имеет в себе спрайты от одного до целого множества. Обычно именно их вы встретите в билде.</li>
<li>'''Спрайт''' (стейт) - спрайтшит, в котором может быть анимация и несколько направлений спрайта. .</li>
<li>'''VSC (Visual Studio Code)''' - программа, в которой мы можем просматривать код и спрайты, а также делать изменения. (Для редактирования спрайтов программа не годится, только для просмотра).</li>
<li>'''Dream Maker''' - стандартная программа, появляется при установке BYOND, через которую вы можете открыть атлас, импортировать или экспортировать файлы, а также редактировать сам спрайт. Будьте осторожны. При открытии спрайтов могут сгенерироваться изменения в коде, которые могут помешать запуску билда. </li>
</ol>
== Выбор программы ==
Рисовать спрайты можно где вашей душе угодно. Можно конечно всё делать сразу в встроенном редакторе byond, но лучше использовать что-то другое, ибо он устаревший и достаточно неудобен. Большинство спрайтеров пользуются Aseprite - удобной программой специально для пиксель арта. Платная, но в закрепах канала можно и БЕСПЛАТНО.
Также стоит заметить, что если вы используете программу, не созданную специально для пиксель арта, вам необходимо будет выбрать режим интерполяции “По соседним пикселям” чтобы ваш спрайт не превратился в мыло. 
[[File:sprite_settings1.png|384px]]
[[File:sprite_settings2.png|384px]]
[[File:Aseprite_Logo.png|thumb|128px]]
[[File:Aseprite.png|thumb|128px|'''"Aseprite"''' - стандартная программа для редактирования DMI файлов.]]
Прежде, чем начать спрайтить, нам потребуется взять на вооружение программу, с помощью которой ты сможешь создавать самые различные спрайты объектов, мобов, снаряжения и не только. 
На выбор у нас имеются программы:
<ol>
<li> '''[https://www.aseprite.org/ Aseprite]''' - отличный выбор, используется очень часто. Вы можете получить его бесплатно, скомпилировав [https://github.com/aseprite/aseprite исходный код], или купить. Отдельно можно установить [https://github.com/spacestation13/aseprite-dmi плагин] для поддержки DMI.</li>
<li> '''[https://www.piskelapp.com/ Piskel]''' - бесплатный сайт, который позволяет редактировать спрайты без необходимости скачивания. Простенький интерфейс, с отсутствием поддержки DMI файлов/атласов.</li>
<li> '''[https://www.gimp.org/ GIMP]''' - бесплатный вариант, не особо модный, требует скачивания. Имеет интерфейс немного лучше, чем обычный Paint. Поддержка DMI отсутствует.</li>
<li> '''[https://www.adobe.com/ua/products/photoshop.html Adobe Photoshop]''' - платный вариант, но возможно для кого-то покажется удобным инструментом для редактирования PNG картинок. Поддержка DMI отсутствует.</li>
</ol>
В данном гайде мы будем ориентироваться на функционал программы "Aseprite", однако перед этим нам потребуется загрузить сердце нашего проекта, определится с выбором билда и загрузить его. 
Подразумевается, что вы уже ознакомлены с [[Запуск локального сервера|руководством по установке локального сервера]] и имеете на компьютере загруженный билд. 
'''Важно! НЕЛЬЗЯ, ЧТОБЫ НА ПУТИ ПРОГРАММЫ БЫЛА КИРИЛИЦА.'''
===Инструкция по установке расширений для Aseprite===
<ol>
<li>Запускаем Aseprite - '''Edit (Menu)''' - '''Preferences'''</li>
<li>Выбираем раздел '''Extensions''' - '''Add Extension''' - Прикрепляем файл '''Asesprite-DMI-Windows'''.</li>
</ol>
Если вдруг не работает расширение - выбираем его в этой же менюшке и нажимаем Enable.
 [[File:Aseprite_instruction1.webp|737px]]
====Работа расширения====
При перетаскивании DMI файла в окно Aseprite (обычное открытие не работает из-за отсутствия поддержки), открывается окно со всеми иконками.
<ol>'''В расширении можно:'''
<li>Создавать/изменять спрайт в стейте</li>
<li>Менять данные</li>
<li>Сохранять (работает как обычное сохранение) </li>
<li>Экспортировать в формат .dmi.</li>
</ol>
[[File:Aseprite_instruction2.webp|737px]]
===Полезные расширения для Aseprite===
<ul>
<li>[https://github.com/lufog/aseprite-language-russian Перевод для Aseprite] - расширение, что переводит интерфейс на русский язык.</li>
<li>[https://github.com/spacestation13/aseprite-dmi Поддержка DMI] - обязательный плагин, предоставляет возможность работать с DMI файлами.</li>
<li>[https://github.com/Seefaaa/aseprite-dmi Поддержка DMI №2] - резервный плагин, предоставляет возможность работать с DMI файлами. Не требует установки, если уже установлен плагин выше.</li>
</ul>

== Документация ==
Также для удобства предоставляем список материалов, с которыми можно ознакомиться для повышения собственной квалификации.
<ul>
<li>[http://gas13.ru/v3/tutorials/ru_sywtbapa_almighty_grass_tile.php Gas13] - Базовый гайд на русском языке, рекомендуется ознакомиться для начинающих спрайтеров. </li>
<li>[https://gamin.me/posts/4849 Gamin.me ] - Pixel Art для начинающих, на русском.</li>
<li>[https://hackmd.io/@Partheo/spriting Hackmd.oi/@Partheo] - Очень хороший гайд на английском, в целом по сске.</li>
<li>[https://wiki.taucetistation.org/Guide_to_Spriting Гайд по спрайтингу с Tau Ceti Station Wiki]</li>
<li>[https://tgstation13.org/wiki/Guide_to_spriting Гайд по спрайтингу с TGStation13 Wiki]</li>
</ul>

== Хоткеи ==
Основные сочетания клавиш для работы.
{| class="wikitable" style="width:100%; text-align:left; border:3px solid rgba(80,80,80,0.4); border-radius:12px; overflow:hidden;"

! style="width:220px; background-color:#a5b4d1; color:#000000; text-align:center;" |Категория
! style="width:220px; background-color:#a5b4d1; color:#000000;" |Хоткей
! style="background-color:#a5b4d1; color:#000000;" |Описание

|-
! rowspan="6" style="background-color:#f2b3b3; color:#000; text-align:center;" |Навигация и холст
|Ctrl + колесо мыши
|Зум
|-
|1 / 2 / 3 / 4 / 5
|Быстрый масштаб
|-
|H
|Рука (перемещение холста)
|-
|Ctrl + 0
|Подогнать под экран
|-
|Tab
|Скрыть интерфейс
|-
|Shift + Tab
|Скрыть панели

|-
! rowspan="11" style="background-color:#f2d2b3; color:#000; text-align:center;" |Основные инструменты
|B
|Brush (Кисть)
|-
|E
|Eraser (Ластик)
|-
|G
|Paint Bucket (Заливка)
|-
|I
|Eyedropper (Пипетка)
|-
|M
|Marquee (Выделение прямоугольником)
|-
|L
|Lasso (Свободное выделение)
|-
|U
|Shape Tool (Фигуры)
|-
|P
|Pencil (Карандаш)
|-
|C
|Contour / Polygon
|-
|K
|Ink (режимы рисования)
|-
|S
|Spray

|-
! rowspan="4" style="background-color:#f2e7b3; color:#000; text-align:center;" |Работа с цветом
|X
|Поменять местами foreground/background
|-
|D
|Сброс цветов (черный/белый)
|-
|Alt + клик
|Пипетка
|-
|Shift + I
|Color Picker (альтернативный)

|-
! rowspan="6" style="background-color:#b3f2c2; color:#000; text-align:center;" |Выделение
|Ctrl + A
|Выделить всё
|-
|Ctrl + D
|Снять выделение
|-
|Ctrl + Shift + I
|Инвертировать выделение
|-
|Alt + drag
|Перемещение выделения
|-
|Shift
|Добавить к выделению
|-
|Alt
|Убрать из выделения

|-
! rowspan="7" style="background-color:#b3d2f2; color:#000; text-align:center;" |Слои и кадры
|N
|Новый слой
|-
|Shift + N
|Новый слой сверху
|-
|Ctrl + Shift + N
|Новый слой с настройками
|-
|Delete
|Удалить слой/содержимое
|-
|Page Up / Page Down
|Переключение кадров
|-
|Alt + N
|Новый кадр
|-
|Alt + Delete
|Очистить слой

|-
! rowspan="7" style="background-color:#d0b3f2; color:#000; text-align:center;" |Редактирование
|Ctrl + Z
|Отмена
|-
|Ctrl + Y
|Повтор
|-
|Ctrl + X
|Вырезать
|-
|Ctrl + C
|Копировать
|-
|Ctrl + V
|Вставить
|-
|Ctrl + B
|Вставить в место
|-
|Ctrl + T
|Трансформация

|-
! rowspan="3" style="background-color:#f2b3e1; color:#000; text-align:center;" |Трансформации
|Ctrl + T
|Свободная трансформация
|-
|Shift
|Сохранять пропорции
|-
|Alt
|Масштаб из центра

|-
! rowspan="5" style="background-color:#f2e0b3; color:#000; text-align:center;" |Дополнительно
|F
|Flip (отразить)
|-
|Shift + F
|Отразить по вертикали
|-
|Ctrl + Shift + F
|Отразить по горизонтали
|-
|Ctrl + U
|Hue/Saturation
|-
|Ctrl + L
|Levels

|-
! rowspan="2" style="background-color:#b3f2cf; color:#000; text-align:center;" |Тайлы и пиксель-арт
|Ctrl + Shift + T
|Tile Mode
|-
|Shift + B
|Pixel Perfect (идеальные линии)

|-
! rowspan="4" style="background-color:#d6d6d6; color:#000; text-align:center;" |Полезные скрытые фишки
|Пробел / СКМ (зажать)
|Временно инструмент "рука"
|-
|Ctrl (зажать)
|Временно пипетка
|-
|Shift (при рисовании)
|Рисование прямых линий
|-
|Ctrl + drag
|Перемещение содержимого

|}
Спрайты важны, понимаешь? Если бы у нас не было спрайтов, мы бы сделали действительно дерьмовую текстовую ролевую игру Roblox 2010. Или, может быть, одна из тех DOS-игр, но многопользовательская. Вы вообще видели эти темы о ролевых играх на форумах? Вот это оно и есть. Очень старое и грустное. Таким образом, спрайтеры являются важными художниками в игре. Они заставляют мапперов ставить стены и полы, а кодеров использовать модульную организацию, а картинки мы бессовестно крадем и помещаем в вики, хехехе. У них великая цель, и они также могут хорошо развлечься — вы когда-нибудь видели спрайты, которые они кидают в дискорд? Это круто. Это действительно ахуенно. Искусство сложно, и люди выходят за рамки этого, чтобы создавать офигенные спрайты. Это работа со страстью. Я не могу выразить словами, насколько важно создание спрайтов (да, это пишет и переводит вики-редактор, который по совместительству спрайтер xdd). Упрощенные визуальные эффекты очень необходимы в игре, и работа спрайтеров, проделанная для того, чтобы это произошло, заслуживает высокой оценки.

О, вы искали настоящего гида. Извините. идите спрашивайте в #dev-спрайт [https://discord.gg/rxsggTJzY3 дискорда].

== Основы ==
Спрайты в SS13 хранятся в файлах dmi. По сути, это атлас-спрайтов в определенном формате. Вы помещаете в него PNG и даете ему имя — это состояние значка. Большинство dmis имеют размер 32x32. У вас может быть растровое изображение, представляющее собой статический спрайт, а гифки можно анимировать. BYOND также работает с 8 направлениями движения, но обычно вам понадобится только 4 или 1.

== ПО ==
Aseprite используется очень часто. Вы можете получить его бесплатно, скомпилировав исходный код, или купить. Некоторые люди также используют Piskel. Вы также можете использовать другое программное обеспечение для обработки изображений, например Paint.net. От себя ещё могу порекомендовать бесплатный GIMP, или платный Adobe Photoshop, хотя ни в том ни в другом нет функции работы с DMI

== Обзор объекта ==
В игре 4 типа объектов:

* '''Область''' – нас это не будет интересовать, так как вы не увидите ее в игре и достаточно wip-графики,
* '''Моб''' – люди, обезьяны, киборги, инопланетяне и другая живность на станции / кораблях / планетах,
* '''Объекты''' – машины, двери, предметы и все остальное в игре,
* '''Турф''' – стены, полы и пространство

== Формат файла DMI ==
Спрайты в SS13 упакованы в файлы .dmi. Чтобы создать новый файл dmi, откройте Dream Maker, выберите «Файл» > «Новый» и выберите «Файл значка (dmi)» в раскрывающемся меню. Напишите для него путь к файлу и нажмите ОК.

Откроется новое окно с пустым файлом. в правом верхнем углу есть два места для размеров спрайта. Большинство спрайтов имеют размер 32x32 пикселя. К сожалению, один dmi-файл не может содержать спрайты разных размеров.

Теперь щелкните правой кнопкой мыши где-нибудь на белизне. Существует два типа спрайтов: растровое изображение и фильм. Растровое изображение статично, а фильм можно анимировать и смотреть в разных направлениях, вот и вся разница. Давайте создадим спрайт фильма. (Новый фильм)

Откроется окно с четырьмя стрелками направления и тремя рамками для каждой из них, все серого цвета. Байонд понимает 8 направлений. Вы можете выбрать, сколько кадров вы хотите использовать, под самими спрайтами: 1, 4 или 8. Вы также можете выбрать, сколько кадров вы хотите иметь в анимации. Если вы создаете разнонаправленный статический спрайт, создайте фильм с 1 кадром, без анимации, но с 4 или 8 направлениями, в зависимости от того, сколько вам нужно. Если вы хотите анимировать спрайт, вас также может заинтересовать возможность установить задержку в 1/10 секунды над конкретным кадром. Хорошо, надеюсь, отсюда вы поймете, что делать. Встроенный инструмент редактирования спрайтов очень примитивен и единственное, о чем в нем стоит упомянуть, это о том, как применять альфа-фильтр. Если вы дважды щелкните любое изображение, вы попадете в редактор спрайтов, а справа от него находится вертикальный ползунок, управляющий альфа-каналом. Также стоит отметить, что копирование из редактора может вести себя немного странно, поскольку фон создается полностью, несмотря на установленный альфа-фильтр. Просто «залейте» фон цветом со значением альфа 0 или используйте «импорт», который отлично работает.

Теперь предположим, что мы сделали ваши спрайты спрайтами, вернитесь к файлу dmi (экран, который появился, когда вы впервые создали файл). Предполагая, что вы создали спрайт, вы увидите его в списке. Дважды щелкните чуть ниже фактического спрайта, и откроется окно переименования. Альтернативно выберите спрайт и нажмите F2 на клавиатуре. Дайте имя вашему спрайту. Это имя часто называют icon_state, поскольку это имя переменной, которая определяет его в коде.

Также обратите внимание, что вы можете импортировать и экспортировать файлы изображений разных типов, выбрав файлы, которые вы хотите экспортировать, в редакторе (удерживайте Ctrl, чтобы выбрать несколько), щелкнув правой кнопкой мыши и выбрав экспорт, или щелкнув правой кнопкой мыши в любом месте и выбрав импорт, чтобы импортировать. DMI похож на PNG, поэтому, если вы переименуете расширение DMI в PNG, оно должно работать во всех программах графического редактирования. Обычно это работает и в обратную сторону. Это ускоряет перекрашивание.

Надеюсь, это вся информация, которая вам нужна для создания спрайтов и файлов dmi.

== Требуемые спрайты по категориям объектов ==
Теперь расскажу вам, какие спрайты нужны различным типам предметов:

=== Мобы ===

* Спрайты мобов по большей части требуют четырех направлений.
* Спрайты мобов требуют спрайтов мертвых мобов .
* Если вы захотите, вы можете создать спрайт моба, который лежит.
* Если вы создаете моба, который может носить одежду, вы можете использовать Pixel_y, Pixel_x для смены одежды при кодировании моба.

==== Мобы с конечностями ====

* Человек и человеческий вид состоят из конечностей – головы, груди, двух рук и двух ног.
* Файлы находятся в icon/mob/human_parts.dmi для конечностей, имеющих заданный цвет, и в icon/mob/human_parts_greyscale.dmi для конечностей, которые можно перекрасить и начать использовать оттенки серого.
* Конечности имеют 4 кадра, как и полноценные иконки.
* Конечности также используются в качестве иконок предметов на случай расчленения.
* Именование следующее:
** [race]_l/r_arm/leg для рук и ног.
** [race]_chest(_m/f) для торса (м/ж для мужских/женских вариантов, необязательно)
** [race]_head(_m/f) для головы (м/ж для мужского/женского вариантов, необязательно)
* Дополнительные части тела, такие как хвосты ящерицы, помещаются в mutant_bodyparts.dmi.

=== Турфы ===

* Полы находятся в файле icon/turf/floors.dmi.
* Стены находятся в файле icon/turf/walls.dmi.
* Стены и полы шаттла находятся в файле icon/turf/shuttle.dmi.
* Космические плитки находятся в файле icon/turf/space.dmi.

=== Объекты ===

* Спрайты объектов находятся в папке icon/obj.
* Спрайты предметов разбросаны по всей папке.
* Спрайты предметов по большей части требуют наличия собственных спрайтов. Их можно найти в разделах icon/mob/items_lefthand.dmi и icon/mob/items_righthand.dmi.
* Спрайты одежды находятся в папке icon/obj/clothing.
* Спрайты одежды на мобах можно найти в папке icon/mob.
* Спрайты одежды по большей части требуют спрайтов, находящихся в руках. Их можно найти в разделах icon/mob/items_lefthand.dmi и icon/mob/items_righthand.dmi.
* Спрайты техники находятся в папке images/obj/machines. Хотя значительная их часть находится в папке icon/obj.
* Спрайты дверей расположены в папке icon/obj/door.
* Обычный спрайт двери требует Door_closed, Door_locked, Door_opening, Door_deny, Door_Closing, Door_open, Door_spark, o_door_opening, o_door_Closing, Panel_open, Welded и Elights. Предлагаю осмотреть door.dmi
* Укреплённым дверям требуются только спрайты открытия и закрытия, а также спрайты, когда они открыты и закрыты.

== Маппинг ==
'''A.T.O.M. - Area - Turf - Object - Mob''' 
В маппинге, в основном мы рассматриваем 4 типа:

1. [https://www.byond.com/docs/ref/#/area '''Зоны''']. Покрывают область и карты и говорят коду что это за территория и её свойства. От зоны работает вся электроника, зону запитывает АЦП и т.д. Свойства у зон бывают самые различные. От звуков и сообщений в чате до запрета телепортации.

2. [https://www.byond.com/docs/ref/#/turf '''Турфы''']. Пол и стены. Полы определяют какой в тайле будет газ, температура, скорость, гравитация, а стены понятно, надеюсь, что делают. Нельзя в один тайл (условная игровая клетка) поставить и пол и стену. Под стеной при разборе всегда будет базовый пол, если в коде не прописано иного.

3. [https://www.byond.com/docs/ref/#/obj '''Предметы'''] . Всё, что не было указано ранее. В том числе, но не заканчивая ими: лендмарки (точки спавна), простые предметы (столы, стулья), декали (и прочий декор типо мелковых рисунков), рандом спавнеры, машинерия (от лампочки, до консолей и всех труб), провода, и прочее.

4. [https://www.byond.com/docs/ref/#/mob '''Мобы''']. Все НПС. С мобами можно по-разному играться задавая им <s>скорость</s>, здоровье, урон и <s>лутдпроп (для продвинутых).</s>

=== Список переменных ===
У каждого типа есть список переменных. Перечислять все переменные, которые меняются у объектов можно долго, но главные указаны здесь:

[https://www.byond.com/docs/ref/#/%7Bnotes%7D/pixel-movement '''pix_x''' | '''pix_y'''] - Задают смещение от центра тайла. Вся настенная машинерия ставится над/под/слева/справа от нужного расположения на стене и поднимается в нужную сторону на 28-32 пикселя. (1 тайл - 32х32 пикселя)

[[File: Directions.png|thumb|256px|Наглядный пример направлений]]
[https://www.byond.com/docs/ref/#/atom/var/dir '''dir'''] - Направление.
2 - на игрока 1 - от игрока 4 - вправо 8 - влево. Если направлений больше, то и другие значения до 16.

'''anchored''' - Закрепление. Объект нельзя потянуть или сдвинуть если TRUE

'''Id''' и '''id_tag''' - Кнопочная машинерия. Для кнопки задается ''id'', для объекта ''id tag'' определяет поведение для дверей(болты, открыть, доступ и т.д) 
Если вам нужно, чтобы кнопка(id) открывала дверь/поддур и тд с 1 ''id_tag'' - прописывайте в ''id'' так ''“ВАШ ID_TAG”'' 
Если Вам нужно, чтобы кнопка(id) открывала дверь/поддур и тд с множеством ''id_tag'' - прописывайте в id так ''list(“ID_TAG1”,”ID_TAG2”)''. Вписывать можно сколько вашей душе угодно, главное соблюдайте синтаксис.

'''req_access (list)''' - Проверка на доступ любая машинерия и двери. Таблица доступов есть в руководстве по маппингу. Несколько доступов пишутся через запятую без пробелов. Если вы хотите привязать мультидоступ, то прописывайте его через запятую, например: req_access = list(1,19,43)

[https://www.byond.com/docs/ref/#/atom/var/icon '''Icon'''] и [https://www.byond.com/docs/ref/#/atom/var/icon_state '''icon_state'''] - Первый указывает путь до дми файла с кучей иконок, второй указывает какая именно иконка из кучи в этом файле будет показываться.

=== Каждое новое помещение начинается с зоны ===
Зона это основной способ взаимодействия тайлов с кодом игры. Будет ли в зоне электричество от апц, либо же она будет запитана магией, будет ли в ней гравитация, какой в ней будет эмбиент(звук окружения), машинерия и как она будет работать в ней и т.д.

Зоны на станциях не должны повторяться. Дело в том, что зона не обязательно должна располагаться близко, чтобы передавать всю информацию внутри себя. Если разместить одну и ту же зону на разных концах карты, то пожарная сигнализация будет срабатывать в обоих, даже если вторая вообще не имеет атмосферы. Это работает даже на разных Z уровнях!

Помните, что настраивать и изменять свойства зоны необходимо исключительно в коде!
=== Подробнее про Variables ===
[[File:sdmm_variables.png|thumb|256px|Область управления переменными]]
Данная область позволит вам творить самые настоящие тёмные колдунства при наличии хотя бы минимальных знаний понимания работы кода/переменных.
Зона Variables состоит из двух вкладок: Instance и Prefab.
'''Instance''' - Позволяет смотреть и менять параметры у одного объекта на карте.
'''Prefab''' - Также позволяет проверять параметры, однако менять параметры будет у всех таких же объектов на карте.
У вас также имеется возможность использовать некоторые параметры, чтобы показать только изменённые переменные.
<ol>
<li>'''Ctrl+1''' - '''Show modified only''' - Покажет только те переменные, что уже были изменены.</li>
<li>'''Ctrl+2''' - '''Show types''' - Покажет переменные не только объекта, но и также его родителей.</li>
<li>'''Ctrl+3''' - '''Show pins''' - Позволит закрепить необходимую переменную, чтобы не потерять её из виду. Она будет показываться в самом верху.</li>
<li>'''Ctrl+4''' - '''Show tmp, const, and static''' - Наши тёмные маги ещё не познали такую сильную магию. Об этом параметре особо ничего не известно. </li>
</ol>
== Создание кораблей и руин ==
Все текущие корабли находятся в папке '''_maps/_mod_celadon/shuttles''' и имеют сортировку по фракциями, а также там имеется отдельная папка для субшаттлов - '''_maps/_mod_celadon/shuttles/subshuttles'''. В этих папках хранятся сами карты, однако инициализация кораблей происходит благодаря папке '''_maps/_mod_celadon/configs'''.

=== Конфиг корабля ===
[[File:example_ship_config.png|thumb]]
В папке с конфигами вы можете ознакомиться со структурой и перенести её в ваш новый файл. 
Вы также можете изучить саму [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/_maps/ship_config_schema.json '''структуру'''] и пример [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/_maps/example_ship_config.json '''конфигурационного файла'''].
Пройдёмся по переменным:
<ol>
<li>'''map_name''' - Полное название корабля. Именно с таким названием игроки увидят ваш корабль в общем списке в лобби.</li>
<li>'''map_short_name''' - Краткое название карты. Обозначает класс корабля. Будет отображаться в манифесте. Не может содержать пробелы. Кроме букв доступны только дефис и нижнее подчёркивание.</li>
<li>'''description''' - Описание корабля. Будет отображаться при выборе корабля в лобби. Содержит в себе лор корабля.</li>
<li>'''map_path''' - Путь к файлу карты корабля. Например: "_maps\shuttles\inteq\inteq_colossus.dmm"</li>
<li>'''enabled''' - Если "true" - доступно для покупки игроками. Если "false" - только для щитспавна.</li>
<li>'''limit''' - Допустимое количество для покупки корабля игроками.</li>
<li>'''space_spawn''' - По умолчанию корабль спавнится на аванпосту. Если "true", то корабль заспавнится в космосе.</li>
<li>'''prefix''' - Указывается префикс фракции. Доступные префиксы можно найти на [https://wiki.celadon.pro/index.php/Префиксы этой странице].</li>
<li>'''faction''' - Путь к датуму фракции. Доступные фракции находятся в этом файле: [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/mod_celadon/faction/code/faction.dm mod_celadon/faction/code/faction.dm], если нет необходимой - можно найти в другом файле: [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/code/modules/faction/faction_datum.dm code/modules/faction/faction_datum.dm].</li>
<li>'''tags''' - Указываются теги корабля. Их можно найти в этом файле: [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/_maps/ship_tags_descriptions_guide.txt _maps/ship_tags_descriptions_guide.txt]. На данный момент не используется. В будущем планируется использовать для сортировки кораблей.</li>
<li>'''namelists''' - Указываются кодовые названия списков, из которых корабль будет генерировать название корабля при его создании. Ознакомиться с доступными списками и названиями можно в этом файле:[https://github.com/CeladonSS13/Shiptest/blob/beta-dev/strings/ship_names.json strings/ship_names.json].</li>
<li>'''job_slots''' - Состоит из 3 частей. Название (название профессии при заходе на корабль), outfit (путь к снаряжению в коде), slots (количество доступных профессий). Доступный список снаряжений можно найти по пути [https://github.com/CeladonSS13/Shiptest/tree/beta-dev/mod_celadon/outfit/code mod_celadon/outfit/code], они имеют примерно такую структуру: ''/datum/outfit/job/фракция/профессия''.</li>
</ol>

=== Создание субшаттла ===
[[File:guide_subshuttle.png|thumb|256px|Пример датума субшаттла]]
Субшаттлы инициализируются не так, как обычные корабли, им не нужен конфиг. Они недоступны для покупки в общем списке лобби, но могут быть использованы в качестве дополнительного корабля внутри самого корабля или для отправки к примеру ЕРТ отряда с помощью администрации. Они создаются в отдельном файле: [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/mod_celadon/maps/code/subshuttles.dm mod_celadon/maps/code/subshuttles.dm].

Путь к картам субкораблей: '''_maps/_mod_celadon/shuttles/subshuttles'''.
=== Создание руины ===
Руинки - это дополнительные локации, которые спавнятся на планетах. На одной планете может быть максимум одна руина.
При создании руины старайтесь использовать флору и фауну, которые предназначены для выбранной вами планеты.
Чтобы инициализировать руину вам потребуется закинуть карту в папку с руинами для необходимой планеты по пути: '''_maps/_mod_celadon/RandomRuins/'''.
Затем перейдите к файлу '''mod_celadon/maps/code/ruins/ruin.dm''' и пропишите датум, по примеру других руин в файле. Датум может иметь такие параметры:
<ol>
<li>'''Datum''' - ''[Обязательно]'' /datum/map_template/ruin/Планета/Название</li>
<li>'''name''' - ''[Обязательно]'' Полное название вашей руины</li>
<li>'''id''' - ''[Обязательно]'' Уникальное и краткое название руины, без нижних подчёркиваний. Используется функционирования для чёрного листа.</li>
<li>'''suffix''' - ''[Обязательно]'' Название вашего файла. Пример: anima_heirophant.dmm</li>
<li>'''description''' - ''[Обязательно]'' Описание вашей руины, лёгкий лор. Используется для страницы с информацией о руинах (в разработке). </li>
<li>'''cost''' - Влияет на вероятность спавна вашей руины. Чем выше стоимость, тем реже она может встретиться.</li>
<li>'''allow_duplicates''' - Если значение "False", то на весь раунд сможет появится только одна руинка.</li>
<li>'''ruin_tags''' - Используется для краткого описания руины. Теги можно найти здесь: [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/code/__DEFINES/ruins.dm code/__DEFINES/ruins.dm].</li>
<li>'''never_spawn_with''' - Не заспавнит руинку, если уже имеется указанная руина из вашего списка.</li>
</ol>
После создания датума перейдите к текстовому файлу '''map_catalogue_key.txt''' по пути: '''_maps/_mod_celadon/map_catalogue.txt''' и оставьте запись о руинке с размерами, тегами и путями.

=== Важная дополнительная информация ===
Обязательное правило для создания корабля и субшатла, чтобы он не был квадратным иначе, как бы вы не старались при постановке док портов, вы не сможете задать нужное вам направление.
[Wideband] На корабля обязательно должно присутствовать средство связи с другими кораблями.
Если вы хотите, чтобы ваша карта была добавлена на [https://map.celadon.pro вебкарту], то нужно обращаться непосредственно к хосту Celadon`a - Voiko.
Максимальные размеры руин: '''121x75'''. Максимальный размер корабля равен максимальному размеру ангара '''56x40'''.
Список кодов доступа (access) к шлюзам и так далее находится в файле [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/code_DEFINES/access.dm code/_DEFINES/access.dm].
При создании атмосферы на шипе не используйте стационарные танки с газами.

= Проверка перед публикацией =
<ol>
<li>Полы с воздухом или без него, как и должно быть? (обычный или безвоздушный)</li>
<li>[APC] - Есть ли в этой зоне ЛКП?</li>
<li>[Air Alarm] - Есть ли в этой зоне воздушная сигнализация?</li>
<li>[Outpost Communications Console] - Есть ли в этой зоне консоль запросов?</li>
<li>[Light] - Есть ли на территории освещение?</li>
<li>[Light Switch] - Есть ли в этом помещении выключатель света?</li>
<li>[Intercom] - Достаточно ли в этом зоне интеркомов?</li>
<li>[Camera] - Достаточно ли в этом зоне камер видеонаблюдения?</li>
<li>[Vent Scrubber] - Подключена ли зона к вентиляционному очистителю?</li>
<li>[Vent Pump] - Подключена ли зона к вентиляционному насосу?</li>
<li>[Fire Alarm & Fire Doors] - Есть ли на территории пожарная сигнализация и противопожарные шлюзы?</li>
<li>[Holopad] - Имеется ли голопад на вашем судне?</li>
<li>Все ли подключено правильно?</li>
<li>Все ли двери работают правильно?</li>
<li>Правильно ли настроены доступы на дверях, кнопках и т. д.?</li>
<li>Все ли предметы размещены правильно? (не ниже вентиляционных отверстий, скрубберов, столов)?</li>
<li>Правильно ли работает система мусоропровода?</li>
<li>Проверьте наличие неуместных или наложенных частей труб (воздушных и отводящих).</li>
<li>Проверьте, нет ли неуместного или наложенного куска провода.</li>
<li>Определите, насколько сложно проникнуть в эту область и где находятся слабые места, и соответствующим образом сбалансируйте область (например, Хранилище должно быть сделано из усиленных конструкций и электрифицированных окон, Кухня не должна быть сделана из этих материалов, а из обычных стен)</li>
<li>Проверьте, не слишком ли много пустого пространства. Если да, уменьшите его и замените остальные туннелями для обслуживания.</li>
<li>Есть ли нерушимые турфы там, где их не должно быть?</li>
</ol>

Участник:Voiko

2026-04-21T14:13:17Z

Voiko: /* Выбор программы */

{{В процессе создания|worker=Voiko}}

= Руководство по созданию спрайтов =
'''Спрайтеры''' - люди, занимающиеся внешним видом игры, делают в основном текстурки для игры. Их главная цель - сделать хорошо, а плохо - не сделать, пиксель арт не стремится сделать достоверную репрезентацию чего-то в игре, его цель - показать объект так, чтобы было ясно что это он и красиво его нарисовать. Обычно спрайты рисуются в разрешении '''32x32''' пикселя, но бывают и исключения, например спрайты мегафауны имеют большее разрешение.

== Терминология ==
Перед процессом спрайтингом нам предстоит немного ознакомиться с основными терминами.
<ol>
<li>'''Билд''' - папка, которую вы скачали с нашего репозитория, хранит в себе кодовую структуру и конечно же DMI файлики с нашими спрайтами.</li>
<li>'''DMI (Атлас)''' - формат файла .dmi, также может называться как '''Атлас'''. Грубо говоря это файл, который имеет в себе спрайты от одного до целого множества. Обычно именно их вы встретите в билде.</li>
<li>'''Спрайт''' (стейт) - спрайтшит, в котором может быть анимация и несколько направлений спрайта. .</li>
<li>'''VSC (Visual Studio Code)''' - программа, в которой мы можем просматривать код и спрайты, а также делать изменения. (Для редактирования спрайтов программа не годится, только для просмотра).</li>
<li>'''Dream Maker''' - стандартная программа, появляется при установке BYOND, через которую вы можете открыть атлас, импортировать или экспортировать файлы, а также редактировать сам спрайт. Будьте осторожны. При открытии спрайтов могут сгенерироваться изменения в коде, которые могут помешать запуску билда. </li>
</ol>
== Выбор программы ==
[[File:Aseprite_Logo.png|thumb|128px]]
[[File:Aseprite.png|thumb|128px|'''"Aseprite"''' - стандартная программа для редактирования DMI файлов.]]
Рисовать спрайты можно где вашей душе угодно. Можно конечно всё делать сразу в встроенном редакторе byond, но лучше использовать что-то другое, ибо он устаревший и достаточно неудобен. Большинство спрайтеров пользуются Aseprite - удобной программой специально для пиксель арта. Платная, но в закрепах канала можно и БЕСПЛАТНО.
Также стоит заметить, что если вы используете программу, не созданную специально для пиксель арта, вам необходимо будет выбрать режим интерполяции “По соседним пикселям” чтобы ваш спрайт не превратился в мыло.
[[File:sprite_settings1.png|384px]]
[[File:sprite_settings2.png|384px]]

Прежде, чем начать спрайтить, нам потребуется взять на вооружение программу, с помощью которой ты сможешь создавать самые различные спрайты объектов, мобов, снаряжения и не только. 
На выбор у нас имеются программы:
<ol>
<li> '''[https://www.aseprite.org/ Aseprite]''' - отличный выбор, используется очень часто. Вы можете получить его бесплатно, скомпилировав [https://github.com/aseprite/aseprite исходный код], или купить. Отдельно можно установить [https://github.com/spacestation13/aseprite-dmi плагин] для поддержки DMI.</li>
<li> '''[https://www.piskelapp.com/ Piskel]''' - бесплатный сайт, который позволяет редактировать спрайты без необходимости скачивания. Простенький интерфейс, с отсутствием поддержки DMI файлов/атласов.</li>
<li> '''[https://www.gimp.org/ GIMP]''' - бесплатный вариант, не особо модный, требует скачивания. Имеет интерфейс немного лучше, чем обычный Paint. Поддержка DMI отсутствует.</li>
<li> '''[https://www.adobe.com/ua/products/photoshop.html Adobe Photoshop]''' - платный вариант, но возможно для кого-то покажется удобным инструментом для редактирования PNG картинок. Поддержка DMI отсутствует.</li>
</ol>
В данном гайде мы будем ориентироваться на функционал программы "Aseprite", однако перед этим нам потребуется загрузить сердце нашего проекта, определится с выбором билда и загрузить его. 
Подразумевается, что вы уже ознакомлены с [[Запуск локального сервера|руководством по установке локального сервера]] и имеете на компьютере загруженный билд. 
'''Важно! НЕЛЬЗЯ, ЧТОБЫ НА ПУТИ ПРОГРАММЫ БЫЛА КИРИЛИЦА.'''
===Инструкция по установке расширений для Aseprite===
<ol>
<li>Запускаем Aseprite - '''Edit (Menu)''' - '''Preferences'''</li>
<li>Выбираем раздел '''Extensions''' - '''Add Extension''' - Прикрепляем файл '''Asesprite-DMI-Windows'''.</li>
</ol>
Если вдруг не работает расширение - выбираем его в этой же менюшке и нажимаем Enable.
 [[File:Aseprite_instruction1.webp|737px]]
====Работа расширения====
При перетаскивании DMI файла в окно Aseprite (обычное открытие не работает из-за отсутствия поддержки), открывается окно со всеми иконками.
<ol>'''В расширении можно:'''
<li>Создавать/изменять спрайт в стейте</li>
<li>Менять данные</li>
<li>Сохранять (работает как обычное сохранение) </li>
<li>Экспортировать в формат .dmi.</li>
</ol>
[[File:Aseprite_instruction2.webp|737px]]
===Полезные расширения для Aseprite===
<ul>
<li>[https://github.com/lufog/aseprite-language-russian Перевод для Aseprite] - расширение, что переводит интерфейс на русский язык.</li>
<li>[https://github.com/spacestation13/aseprite-dmi Поддержка DMI] - обязательный плагин, предоставляет возможность работать с DMI файлами.</li>
<li>[https://github.com/Seefaaa/aseprite-dmi Поддержка DMI №2] - резервный плагин, предоставляет возможность работать с DMI файлами. Не требует установки, если уже установлен плагин выше.</li>
</ul>

== Документация ==
Также для удобства предоставляем список материалов, с которыми можно ознакомиться для повышения собственной квалификации.
<ul>
<li>[http://gas13.ru/v3/tutorials/ru_sywtbapa_almighty_grass_tile.php Gas13] - Базовый гайд на русском языке, рекомендуется ознакомиться для начинающих спрайтеров. </li>
<li>[https://gamin.me/posts/4849 Gamin.me ] - Pixel Art для начинающих, на русском.</li>
<li>[https://hackmd.io/@Partheo/spriting Hackmd.oi/@Partheo] - Очень хороший гайд на английском, в целом по сске.</li>
<li>[https://wiki.taucetistation.org/Guide_to_Spriting Гайд по спрайтингу с Tau Ceti Station Wiki]</li>
<li>[https://tgstation13.org/wiki/Guide_to_spriting Гайд по спрайтингу с TGStation13 Wiki]</li>
</ul>

== Хоткеи ==
Основные сочетания клавиш для работы.
{| class="wikitable" style="width:100%; text-align:left; border:3px solid rgba(80,80,80,0.4); border-radius:12px; overflow:hidden;"

! style="width:220px; background-color:#a5b4d1; color:#000000; text-align:center;" |Категория
! style="width:220px; background-color:#a5b4d1; color:#000000;" |Хоткей
! style="background-color:#a5b4d1; color:#000000;" |Описание

|-
! rowspan="6" style="background-color:#f2b3b3; color:#000; text-align:center;" |Навигация и холст
|Ctrl + колесо мыши
|Зум
|-
|1 / 2 / 3 / 4 / 5
|Быстрый масштаб
|-
|H
|Рука (перемещение холста)
|-
|Ctrl + 0
|Подогнать под экран
|-
|Tab
|Скрыть интерфейс
|-
|Shift + Tab
|Скрыть панели

|-
! rowspan="11" style="background-color:#f2d2b3; color:#000; text-align:center;" |Основные инструменты
|B
|Brush (Кисть)
|-
|E
|Eraser (Ластик)
|-
|G
|Paint Bucket (Заливка)
|-
|I
|Eyedropper (Пипетка)
|-
|M
|Marquee (Выделение прямоугольником)
|-
|L
|Lasso (Свободное выделение)
|-
|U
|Shape Tool (Фигуры)
|-
|P
|Pencil (Карандаш)
|-
|C
|Contour / Polygon
|-
|K
|Ink (режимы рисования)
|-
|S
|Spray

|-
! rowspan="4" style="background-color:#f2e7b3; color:#000; text-align:center;" |Работа с цветом
|X
|Поменять местами foreground/background
|-
|D
|Сброс цветов (черный/белый)
|-
|Alt + клик
|Пипетка
|-
|Shift + I
|Color Picker (альтернативный)

|-
! rowspan="6" style="background-color:#b3f2c2; color:#000; text-align:center;" |Выделение
|Ctrl + A
|Выделить всё
|-
|Ctrl + D
|Снять выделение
|-
|Ctrl + Shift + I
|Инвертировать выделение
|-
|Alt + drag
|Перемещение выделения
|-
|Shift
|Добавить к выделению
|-
|Alt
|Убрать из выделения

|-
! rowspan="7" style="background-color:#b3d2f2; color:#000; text-align:center;" |Слои и кадры
|N
|Новый слой
|-
|Shift + N
|Новый слой сверху
|-
|Ctrl + Shift + N
|Новый слой с настройками
|-
|Delete
|Удалить слой/содержимое
|-
|Page Up / Page Down
|Переключение кадров
|-
|Alt + N
|Новый кадр
|-
|Alt + Delete
|Очистить слой

|-
! rowspan="7" style="background-color:#d0b3f2; color:#000; text-align:center;" |Редактирование
|Ctrl + Z
|Отмена
|-
|Ctrl + Y
|Повтор
|-
|Ctrl + X
|Вырезать
|-
|Ctrl + C
|Копировать
|-
|Ctrl + V
|Вставить
|-
|Ctrl + B
|Вставить в место
|-
|Ctrl + T
|Трансформация

|-
! rowspan="3" style="background-color:#f2b3e1; color:#000; text-align:center;" |Трансформации
|Ctrl + T
|Свободная трансформация
|-
|Shift
|Сохранять пропорции
|-
|Alt
|Масштаб из центра

|-
! rowspan="5" style="background-color:#f2e0b3; color:#000; text-align:center;" |Дополнительно
|F
|Flip (отразить)
|-
|Shift + F
|Отразить по вертикали
|-
|Ctrl + Shift + F
|Отразить по горизонтали
|-
|Ctrl + U
|Hue/Saturation
|-
|Ctrl + L
|Levels

|-
! rowspan="2" style="background-color:#b3f2cf; color:#000; text-align:center;" |Тайлы и пиксель-арт
|Ctrl + Shift + T
|Tile Mode
|-
|Shift + B
|Pixel Perfect (идеальные линии)

|-
! rowspan="4" style="background-color:#d6d6d6; color:#000; text-align:center;" |Полезные скрытые фишки
|Пробел / СКМ (зажать)
|Временно инструмент "рука"
|-
|Ctrl (зажать)
|Временно пипетка
|-
|Shift (при рисовании)
|Рисование прямых линий
|-
|Ctrl + drag
|Перемещение содержимого

|}
Спрайты важны, понимаешь? Если бы у нас не было спрайтов, мы бы сделали действительно дерьмовую текстовую ролевую игру Roblox 2010. Или, может быть, одна из тех DOS-игр, но многопользовательская. Вы вообще видели эти темы о ролевых играх на форумах? Вот это оно и есть. Очень старое и грустное. Таким образом, спрайтеры являются важными художниками в игре. Они заставляют мапперов ставить стены и полы, а кодеров использовать модульную организацию, а картинки мы бессовестно крадем и помещаем в вики, хехехе. У них великая цель, и они также могут хорошо развлечься — вы когда-нибудь видели спрайты, которые они кидают в дискорд? Это круто. Это действительно ахуенно. Искусство сложно, и люди выходят за рамки этого, чтобы создавать офигенные спрайты. Это работа со страстью. Я не могу выразить словами, насколько важно создание спрайтов (да, это пишет и переводит вики-редактор, который по совместительству спрайтер xdd). Упрощенные визуальные эффекты очень необходимы в игре, и работа спрайтеров, проделанная для того, чтобы это произошло, заслуживает высокой оценки.

О, вы искали настоящего гида. Извините. идите спрашивайте в #dev-спрайт [https://discord.gg/rxsggTJzY3 дискорда].

== Основы ==
Спрайты в SS13 хранятся в файлах dmi. По сути, это атлас-спрайтов в определенном формате. Вы помещаете в него PNG и даете ему имя — это состояние значка. Большинство dmis имеют размер 32x32. У вас может быть растровое изображение, представляющее собой статический спрайт, а гифки можно анимировать. BYOND также работает с 8 направлениями движения, но обычно вам понадобится только 4 или 1.

== ПО ==
Aseprite используется очень часто. Вы можете получить его бесплатно, скомпилировав исходный код, или купить. Некоторые люди также используют Piskel. Вы также можете использовать другое программное обеспечение для обработки изображений, например Paint.net. От себя ещё могу порекомендовать бесплатный GIMP, или платный Adobe Photoshop, хотя ни в том ни в другом нет функции работы с DMI

== Обзор объекта ==
В игре 4 типа объектов:

* '''Область''' – нас это не будет интересовать, так как вы не увидите ее в игре и достаточно wip-графики,
* '''Моб''' – люди, обезьяны, киборги, инопланетяне и другая живность на станции / кораблях / планетах,
* '''Объекты''' – машины, двери, предметы и все остальное в игре,
* '''Турф''' – стены, полы и пространство

== Формат файла DMI ==
Спрайты в SS13 упакованы в файлы .dmi. Чтобы создать новый файл dmi, откройте Dream Maker, выберите «Файл» > «Новый» и выберите «Файл значка (dmi)» в раскрывающемся меню. Напишите для него путь к файлу и нажмите ОК.

Откроется новое окно с пустым файлом. в правом верхнем углу есть два места для размеров спрайта. Большинство спрайтов имеют размер 32x32 пикселя. К сожалению, один dmi-файл не может содержать спрайты разных размеров.

Теперь щелкните правой кнопкой мыши где-нибудь на белизне. Существует два типа спрайтов: растровое изображение и фильм. Растровое изображение статично, а фильм можно анимировать и смотреть в разных направлениях, вот и вся разница. Давайте создадим спрайт фильма. (Новый фильм)

Откроется окно с четырьмя стрелками направления и тремя рамками для каждой из них, все серого цвета. Байонд понимает 8 направлений. Вы можете выбрать, сколько кадров вы хотите использовать, под самими спрайтами: 1, 4 или 8. Вы также можете выбрать, сколько кадров вы хотите иметь в анимации. Если вы создаете разнонаправленный статический спрайт, создайте фильм с 1 кадром, без анимации, но с 4 или 8 направлениями, в зависимости от того, сколько вам нужно. Если вы хотите анимировать спрайт, вас также может заинтересовать возможность установить задержку в 1/10 секунды над конкретным кадром. Хорошо, надеюсь, отсюда вы поймете, что делать. Встроенный инструмент редактирования спрайтов очень примитивен и единственное, о чем в нем стоит упомянуть, это о том, как применять альфа-фильтр. Если вы дважды щелкните любое изображение, вы попадете в редактор спрайтов, а справа от него находится вертикальный ползунок, управляющий альфа-каналом. Также стоит отметить, что копирование из редактора может вести себя немного странно, поскольку фон создается полностью, несмотря на установленный альфа-фильтр. Просто «залейте» фон цветом со значением альфа 0 или используйте «импорт», который отлично работает.

Теперь предположим, что мы сделали ваши спрайты спрайтами, вернитесь к файлу dmi (экран, который появился, когда вы впервые создали файл). Предполагая, что вы создали спрайт, вы увидите его в списке. Дважды щелкните чуть ниже фактического спрайта, и откроется окно переименования. Альтернативно выберите спрайт и нажмите F2 на клавиатуре. Дайте имя вашему спрайту. Это имя часто называют icon_state, поскольку это имя переменной, которая определяет его в коде.

Также обратите внимание, что вы можете импортировать и экспортировать файлы изображений разных типов, выбрав файлы, которые вы хотите экспортировать, в редакторе (удерживайте Ctrl, чтобы выбрать несколько), щелкнув правой кнопкой мыши и выбрав экспорт, или щелкнув правой кнопкой мыши в любом месте и выбрав импорт, чтобы импортировать. DMI похож на PNG, поэтому, если вы переименуете расширение DMI в PNG, оно должно работать во всех программах графического редактирования. Обычно это работает и в обратную сторону. Это ускоряет перекрашивание.

Надеюсь, это вся информация, которая вам нужна для создания спрайтов и файлов dmi.

== Требуемые спрайты по категориям объектов ==
Теперь расскажу вам, какие спрайты нужны различным типам предметов:

=== Мобы ===

* Спрайты мобов по большей части требуют четырех направлений.
* Спрайты мобов требуют спрайтов мертвых мобов .
* Если вы захотите, вы можете создать спрайт моба, который лежит.
* Если вы создаете моба, который может носить одежду, вы можете использовать Pixel_y, Pixel_x для смены одежды при кодировании моба.

==== Мобы с конечностями ====

* Человек и человеческий вид состоят из конечностей – головы, груди, двух рук и двух ног.
* Файлы находятся в icon/mob/human_parts.dmi для конечностей, имеющих заданный цвет, и в icon/mob/human_parts_greyscale.dmi для конечностей, которые можно перекрасить и начать использовать оттенки серого.
* Конечности имеют 4 кадра, как и полноценные иконки.
* Конечности также используются в качестве иконок предметов на случай расчленения.
* Именование следующее:
** [race]_l/r_arm/leg для рук и ног.
** [race]_chest(_m/f) для торса (м/ж для мужских/женских вариантов, необязательно)
** [race]_head(_m/f) для головы (м/ж для мужского/женского вариантов, необязательно)
* Дополнительные части тела, такие как хвосты ящерицы, помещаются в mutant_bodyparts.dmi.

=== Турфы ===

* Полы находятся в файле icon/turf/floors.dmi.
* Стены находятся в файле icon/turf/walls.dmi.
* Стены и полы шаттла находятся в файле icon/turf/shuttle.dmi.
* Космические плитки находятся в файле icon/turf/space.dmi.

=== Объекты ===

* Спрайты объектов находятся в папке icon/obj.
* Спрайты предметов разбросаны по всей папке.
* Спрайты предметов по большей части требуют наличия собственных спрайтов. Их можно найти в разделах icon/mob/items_lefthand.dmi и icon/mob/items_righthand.dmi.
* Спрайты одежды находятся в папке icon/obj/clothing.
* Спрайты одежды на мобах можно найти в папке icon/mob.
* Спрайты одежды по большей части требуют спрайтов, находящихся в руках. Их можно найти в разделах icon/mob/items_lefthand.dmi и icon/mob/items_righthand.dmi.
* Спрайты техники находятся в папке images/obj/machines. Хотя значительная их часть находится в папке icon/obj.
* Спрайты дверей расположены в папке icon/obj/door.
* Обычный спрайт двери требует Door_closed, Door_locked, Door_opening, Door_deny, Door_Closing, Door_open, Door_spark, o_door_opening, o_door_Closing, Panel_open, Welded и Elights. Предлагаю осмотреть door.dmi
* Укреплённым дверям требуются только спрайты открытия и закрытия, а также спрайты, когда они открыты и закрыты.

== Маппинг ==
'''A.T.O.M. - Area - Turf - Object - Mob''' 
В маппинге, в основном мы рассматриваем 4 типа:

1. [https://www.byond.com/docs/ref/#/area '''Зоны''']. Покрывают область и карты и говорят коду что это за территория и её свойства. От зоны работает вся электроника, зону запитывает АЦП и т.д. Свойства у зон бывают самые различные. От звуков и сообщений в чате до запрета телепортации.

2. [https://www.byond.com/docs/ref/#/turf '''Турфы''']. Пол и стены. Полы определяют какой в тайле будет газ, температура, скорость, гравитация, а стены понятно, надеюсь, что делают. Нельзя в один тайл (условная игровая клетка) поставить и пол и стену. Под стеной при разборе всегда будет базовый пол, если в коде не прописано иного.

3. [https://www.byond.com/docs/ref/#/obj '''Предметы'''] . Всё, что не было указано ранее. В том числе, но не заканчивая ими: лендмарки (точки спавна), простые предметы (столы, стулья), декали (и прочий декор типо мелковых рисунков), рандом спавнеры, машинерия (от лампочки, до консолей и всех труб), провода, и прочее.

4. [https://www.byond.com/docs/ref/#/mob '''Мобы''']. Все НПС. С мобами можно по-разному играться задавая им <s>скорость</s>, здоровье, урон и <s>лутдпроп (для продвинутых).</s>

=== Список переменных ===
У каждого типа есть список переменных. Перечислять все переменные, которые меняются у объектов можно долго, но главные указаны здесь:

[https://www.byond.com/docs/ref/#/%7Bnotes%7D/pixel-movement '''pix_x''' | '''pix_y'''] - Задают смещение от центра тайла. Вся настенная машинерия ставится над/под/слева/справа от нужного расположения на стене и поднимается в нужную сторону на 28-32 пикселя. (1 тайл - 32х32 пикселя)

[[File: Directions.png|thumb|256px|Наглядный пример направлений]]
[https://www.byond.com/docs/ref/#/atom/var/dir '''dir'''] - Направление.
2 - на игрока 1 - от игрока 4 - вправо 8 - влево. Если направлений больше, то и другие значения до 16.

'''anchored''' - Закрепление. Объект нельзя потянуть или сдвинуть если TRUE

'''Id''' и '''id_tag''' - Кнопочная машинерия. Для кнопки задается ''id'', для объекта ''id tag'' определяет поведение для дверей(болты, открыть, доступ и т.д) 
Если вам нужно, чтобы кнопка(id) открывала дверь/поддур и тд с 1 ''id_tag'' - прописывайте в ''id'' так ''“ВАШ ID_TAG”'' 
Если Вам нужно, чтобы кнопка(id) открывала дверь/поддур и тд с множеством ''id_tag'' - прописывайте в id так ''list(“ID_TAG1”,”ID_TAG2”)''. Вписывать можно сколько вашей душе угодно, главное соблюдайте синтаксис.

'''req_access (list)''' - Проверка на доступ любая машинерия и двери. Таблица доступов есть в руководстве по маппингу. Несколько доступов пишутся через запятую без пробелов. Если вы хотите привязать мультидоступ, то прописывайте его через запятую, например: req_access = list(1,19,43)

[https://www.byond.com/docs/ref/#/atom/var/icon '''Icon'''] и [https://www.byond.com/docs/ref/#/atom/var/icon_state '''icon_state'''] - Первый указывает путь до дми файла с кучей иконок, второй указывает какая именно иконка из кучи в этом файле будет показываться.

=== Каждое новое помещение начинается с зоны ===
Зона это основной способ взаимодействия тайлов с кодом игры. Будет ли в зоне электричество от апц, либо же она будет запитана магией, будет ли в ней гравитация, какой в ней будет эмбиент(звук окружения), машинерия и как она будет работать в ней и т.д.

Зоны на станциях не должны повторяться. Дело в том, что зона не обязательно должна располагаться близко, чтобы передавать всю информацию внутри себя. Если разместить одну и ту же зону на разных концах карты, то пожарная сигнализация будет срабатывать в обоих, даже если вторая вообще не имеет атмосферы. Это работает даже на разных Z уровнях!

Помните, что настраивать и изменять свойства зоны необходимо исключительно в коде!
=== Подробнее про Variables ===
[[File:sdmm_variables.png|thumb|256px|Область управления переменными]]
Данная область позволит вам творить самые настоящие тёмные колдунства при наличии хотя бы минимальных знаний понимания работы кода/переменных.
Зона Variables состоит из двух вкладок: Instance и Prefab.
'''Instance''' - Позволяет смотреть и менять параметры у одного объекта на карте.
'''Prefab''' - Также позволяет проверять параметры, однако менять параметры будет у всех таких же объектов на карте.
У вас также имеется возможность использовать некоторые параметры, чтобы показать только изменённые переменные.
<ol>
<li>'''Ctrl+1''' - '''Show modified only''' - Покажет только те переменные, что уже были изменены.</li>
<li>'''Ctrl+2''' - '''Show types''' - Покажет переменные не только объекта, но и также его родителей.</li>
<li>'''Ctrl+3''' - '''Show pins''' - Позволит закрепить необходимую переменную, чтобы не потерять её из виду. Она будет показываться в самом верху.</li>
<li>'''Ctrl+4''' - '''Show tmp, const, and static''' - Наши тёмные маги ещё не познали такую сильную магию. Об этом параметре особо ничего не известно. </li>
</ol>
== Создание кораблей и руин ==
Все текущие корабли находятся в папке '''_maps/_mod_celadon/shuttles''' и имеют сортировку по фракциями, а также там имеется отдельная папка для субшаттлов - '''_maps/_mod_celadon/shuttles/subshuttles'''. В этих папках хранятся сами карты, однако инициализация кораблей происходит благодаря папке '''_maps/_mod_celadon/configs'''.

=== Конфиг корабля ===
[[File:example_ship_config.png|thumb]]
В папке с конфигами вы можете ознакомиться со структурой и перенести её в ваш новый файл. 
Вы также можете изучить саму [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/_maps/ship_config_schema.json '''структуру'''] и пример [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/_maps/example_ship_config.json '''конфигурационного файла'''].
Пройдёмся по переменным:
<ol>
<li>'''map_name''' - Полное название корабля. Именно с таким названием игроки увидят ваш корабль в общем списке в лобби.</li>
<li>'''map_short_name''' - Краткое название карты. Обозначает класс корабля. Будет отображаться в манифесте. Не может содержать пробелы. Кроме букв доступны только дефис и нижнее подчёркивание.</li>
<li>'''description''' - Описание корабля. Будет отображаться при выборе корабля в лобби. Содержит в себе лор корабля.</li>
<li>'''map_path''' - Путь к файлу карты корабля. Например: "_maps\shuttles\inteq\inteq_colossus.dmm"</li>
<li>'''enabled''' - Если "true" - доступно для покупки игроками. Если "false" - только для щитспавна.</li>
<li>'''limit''' - Допустимое количество для покупки корабля игроками.</li>
<li>'''space_spawn''' - По умолчанию корабль спавнится на аванпосту. Если "true", то корабль заспавнится в космосе.</li>
<li>'''prefix''' - Указывается префикс фракции. Доступные префиксы можно найти на [https://wiki.celadon.pro/index.php/Префиксы этой странице].</li>
<li>'''faction''' - Путь к датуму фракции. Доступные фракции находятся в этом файле: [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/mod_celadon/faction/code/faction.dm mod_celadon/faction/code/faction.dm], если нет необходимой - можно найти в другом файле: [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/code/modules/faction/faction_datum.dm code/modules/faction/faction_datum.dm].</li>
<li>'''tags''' - Указываются теги корабля. Их можно найти в этом файле: [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/_maps/ship_tags_descriptions_guide.txt _maps/ship_tags_descriptions_guide.txt]. На данный момент не используется. В будущем планируется использовать для сортировки кораблей.</li>
<li>'''namelists''' - Указываются кодовые названия списков, из которых корабль будет генерировать название корабля при его создании. Ознакомиться с доступными списками и названиями можно в этом файле:[https://github.com/CeladonSS13/Shiptest/blob/beta-dev/strings/ship_names.json strings/ship_names.json].</li>
<li>'''job_slots''' - Состоит из 3 частей. Название (название профессии при заходе на корабль), outfit (путь к снаряжению в коде), slots (количество доступных профессий). Доступный список снаряжений можно найти по пути [https://github.com/CeladonSS13/Shiptest/tree/beta-dev/mod_celadon/outfit/code mod_celadon/outfit/code], они имеют примерно такую структуру: ''/datum/outfit/job/фракция/профессия''.</li>
</ol>

=== Создание субшаттла ===
[[File:guide_subshuttle.png|thumb|256px|Пример датума субшаттла]]
Субшаттлы инициализируются не так, как обычные корабли, им не нужен конфиг. Они недоступны для покупки в общем списке лобби, но могут быть использованы в качестве дополнительного корабля внутри самого корабля или для отправки к примеру ЕРТ отряда с помощью администрации. Они создаются в отдельном файле: [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/mod_celadon/maps/code/subshuttles.dm mod_celadon/maps/code/subshuttles.dm].

Путь к картам субкораблей: '''_maps/_mod_celadon/shuttles/subshuttles'''.
=== Создание руины ===
Руинки - это дополнительные локации, которые спавнятся на планетах. На одной планете может быть максимум одна руина.
При создании руины старайтесь использовать флору и фауну, которые предназначены для выбранной вами планеты.
Чтобы инициализировать руину вам потребуется закинуть карту в папку с руинами для необходимой планеты по пути: '''_maps/_mod_celadon/RandomRuins/'''.
Затем перейдите к файлу '''mod_celadon/maps/code/ruins/ruin.dm''' и пропишите датум, по примеру других руин в файле. Датум может иметь такие параметры:
<ol>
<li>'''Datum''' - ''[Обязательно]'' /datum/map_template/ruin/Планета/Название</li>
<li>'''name''' - ''[Обязательно]'' Полное название вашей руины</li>
<li>'''id''' - ''[Обязательно]'' Уникальное и краткое название руины, без нижних подчёркиваний. Используется функционирования для чёрного листа.</li>
<li>'''suffix''' - ''[Обязательно]'' Название вашего файла. Пример: anima_heirophant.dmm</li>
<li>'''description''' - ''[Обязательно]'' Описание вашей руины, лёгкий лор. Используется для страницы с информацией о руинах (в разработке). </li>
<li>'''cost''' - Влияет на вероятность спавна вашей руины. Чем выше стоимость, тем реже она может встретиться.</li>
<li>'''allow_duplicates''' - Если значение "False", то на весь раунд сможет появится только одна руинка.</li>
<li>'''ruin_tags''' - Используется для краткого описания руины. Теги можно найти здесь: [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/code/__DEFINES/ruins.dm code/__DEFINES/ruins.dm].</li>
<li>'''never_spawn_with''' - Не заспавнит руинку, если уже имеется указанная руина из вашего списка.</li>
</ol>
После создания датума перейдите к текстовому файлу '''map_catalogue_key.txt''' по пути: '''_maps/_mod_celadon/map_catalogue.txt''' и оставьте запись о руинке с размерами, тегами и путями.

=== Важная дополнительная информация ===
Обязательное правило для создания корабля и субшатла, чтобы он не был квадратным иначе, как бы вы не старались при постановке док портов, вы не сможете задать нужное вам направление.
[Wideband] На корабля обязательно должно присутствовать средство связи с другими кораблями.
Если вы хотите, чтобы ваша карта была добавлена на [https://map.celadon.pro вебкарту], то нужно обращаться непосредственно к хосту Celadon`a - Voiko.
Максимальные размеры руин: '''121x75'''. Максимальный размер корабля равен максимальному размеру ангара '''56x40'''.
Список кодов доступа (access) к шлюзам и так далее находится в файле [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/code_DEFINES/access.dm code/_DEFINES/access.dm].
При создании атмосферы на шипе не используйте стационарные танки с газами.

= Проверка перед публикацией =
<ol>
<li>Полы с воздухом или без него, как и должно быть? (обычный или безвоздушный)</li>
<li>[APC] - Есть ли в этой зоне ЛКП?</li>
<li>[Air Alarm] - Есть ли в этой зоне воздушная сигнализация?</li>
<li>[Outpost Communications Console] - Есть ли в этой зоне консоль запросов?</li>
<li>[Light] - Есть ли на территории освещение?</li>
<li>[Light Switch] - Есть ли в этом помещении выключатель света?</li>
<li>[Intercom] - Достаточно ли в этом зоне интеркомов?</li>
<li>[Camera] - Достаточно ли в этом зоне камер видеонаблюдения?</li>
<li>[Vent Scrubber] - Подключена ли зона к вентиляционному очистителю?</li>
<li>[Vent Pump] - Подключена ли зона к вентиляционному насосу?</li>
<li>[Fire Alarm & Fire Doors] - Есть ли на территории пожарная сигнализация и противопожарные шлюзы?</li>
<li>[Holopad] - Имеется ли голопад на вашем судне?</li>
<li>Все ли подключено правильно?</li>
<li>Все ли двери работают правильно?</li>
<li>Правильно ли настроены доступы на дверях, кнопках и т. д.?</li>
<li>Все ли предметы размещены правильно? (не ниже вентиляционных отверстий, скрубберов, столов)?</li>
<li>Правильно ли работает система мусоропровода?</li>
<li>Проверьте наличие неуместных или наложенных частей труб (воздушных и отводящих).</li>
<li>Проверьте, нет ли неуместного или наложенного куска провода.</li>
<li>Определите, насколько сложно проникнуть в эту область и где находятся слабые места, и соответствующим образом сбалансируйте область (например, Хранилище должно быть сделано из усиленных конструкций и электрифицированных окон, Кухня не должна быть сделана из этих материалов, а из обычных стен)</li>
<li>Проверьте, не слишком ли много пустого пространства. Если да, уменьшите его и замените остальные туннелями для обслуживания.</li>
<li>Есть ли нерушимые турфы там, где их не должно быть?</li>
</ol>

Файл:Sprite settings2.png

2026-04-21T14:11:30Z

Voiko:

2026-04-21T13:03:29Z

Voiko: /* Полезные расширения для Aseprite */

{{В процессе создания|worker=Voiko}}

= Руководство по созданию спрайтов =
'''В рядах Империи Celadon новое пополнение? Отлично!''' Представляю к вашему вниманию универсальный гайд для повышения квалификации!

== Терминология ==
Перед процессом спрайтингом нам предстоит немного ознакомиться с основными терминами.
<ol>
<li>'''Билд''' - папка, которую вы скачали с нашего репозитория, хранит в себе кодовую структуру и конечно же DMI файлики с нашими спрайтами.</li>
<li>'''DMI (Атлас)''' - формат файла .dmi, также может называться как '''Атлас'''. Грубо говоря это файл, который имеет в себе спрайты от одного до целого множества. Обычно именно их вы встретите в билде.</li>
<li>'''Спрайт''' - картинка, что находится в атласе.</li>
<li>'''VSC (Visual Studio Code)''' - программа, в которой мы можем просматривать код и спрайты, а также делать изменения. (Для редактирования спрайтов программа не годится, только для просмотра).</li>
<li>'''Dream Maker''' - стандартная программа, появляется при установке BYOND, через которую вы можете открыть атлас, импортировать или экспортировать файлы, а также редактировать сам спрайт. Будьте осторожны. При открытии спрайтов могут сгенерироваться изменения в коде, которые могут помешать запуску билда. </li>
</ol>
== Выбор программы ==
[[File:Aseprite_Logo.png|thumb|128px]]
[[File:Aseprite.png|thumb|128px|'''"Aseprite"''' - стандартная программа для редактирования DMI файлов.]]
Прежде, чем начать спрайтить, нам потребуется взять на вооружение программу, с помощью которой ты сможешь создавать самые различные спрайты объектов, мобов, снаряжения и не только. 
На выбор у нас имеются программы:
<ol>
<li> '''[https://www.aseprite.org/ Aseprite]''' - отличный выбор, используется очень часто. Вы можете получить его бесплатно, скомпилировав [https://github.com/aseprite/aseprite исходный код], или купить. Отдельно можно установить [https://github.com/spacestation13/aseprite-dmi плагин] для поддержки DMI.</li>
<li> '''[https://www.piskelapp.com/ Piskel]''' - бесплатный сайт, который позволяет редактировать спрайты без необходимости скачивания. Простенький интерфейс, с отсутствием поддержки DMI файлов/атласов.</li>
<li> '''[https://www.gimp.org/ GIMP]''' - бесплатный вариант, не особо модный, требует скачивания. Имеет интерфейс немного лучше, чем обычный Paint. Поддержка DMI отсутствует.</li>
<li> '''[https://www.adobe.com/ua/products/photoshop.html Adobe Photoshop]''' - платный вариант, но возможно для кого-то покажется удобным инструментом для редактирования PNG картинок. Поддержка DMI отсутствует.</li>
</ol>
В данном гайде мы будем ориентироваться на функционал программы "Aseprite", однако перед этим нам потребуется загрузить сердце нашего проекта, определится с выбором билда и загрузить его. 
Подразумевается, что вы уже ознакомлены с [[Запуск локального сервера|руководством по установке локального сервера]] и имеете на компьютере загруженный билд. 
'''Важно! НЕЛЬЗЯ, ЧТОБЫ НА ПУТИ ПРОГРАММЫ БЫЛА КИРИЛИЦА.'''
===Инструкция по установке расширений для Aseprite===
<ol>
<li>Запускаем Aseprite - '''Edit (Menu)''' - '''Preferences'''</li>
<li>Выбираем раздел '''Extensions''' - '''Add Extension''' - Прикрепляем файл '''Asesprite-DMI-Windows'''.</li>
</ol>
Если вдруг не работает расширение - выбираем его в этой же менюшке и нажимаем Enable.
 [[File:Aseprite_instruction1.webp|737px]]
====Работа расширения====
При перетаскивании DMI файла в окно Aseprite (обычное открытие не работает из-за отсутствия поддержки), открывается окно со всеми иконками.
<ol>'''В расширении можно:'''
<li>Создавать/изменять спрайт в стейте</li>
<li>Менять данные</li>
<li>Сохранять (работает как обычное сохранение) </li>
<li>Экспортировать в формат .dmi.</li>
</ol>
[[File:Aseprite_instruction2.webp|737px]]
===Полезные расширения для Aseprite===
<ul>
<li>[https://github.com/lufog/aseprite-language-russian Перевод для Aseprite] - расширение, что переводит интерфейс на русский язык.
<li>[https://github.com/spacestation13/aseprite-dmi Поддержка DMI] - обязательный плагин, предоставляет возможность работать с DMI файлами.
<li>[https://github.com/Seefaaa/aseprite-dmi Поддержка DMI №2] - резервный плагин, предоставляет возможность работать с DMI файлами. Не требует установки, если уже установлен плагин выше.
<ul>

== Документация ==
Также для удобства предоставляем список материалов, с которыми можно ознакомиться для повышения собственной квалификации.
<ul>
<li>[http://gas13.ru/v3/tutorials/ru_sywtbapa_almighty_grass_tile.php Gas13] - Базовый гайд на русском языке, рекомендуется ознакомиться для начинающих спрайтеров. </li>
<li>[https://gamin.me/posts/4849 Gamin.me ] - Pixel Art для начинающих, на русском.</li>
<li>[https://hackmd.io/@Partheo/spriting Hackmd.oi/@Partheo] - Очень хороший гайд на английском, в целом по сске.</li>
<li>[https://wiki.taucetistation.org/Guide_to_Spriting Гайд по спрайтингу с Tau Ceti Station Wiki]</li>
<li>[https://tgstation13.org/wiki/Guide_to_spriting Гайд по спрайтингу с TGStation13 Wiki]</li>
<ul>

== Хоткеи ==
<ol>
• ⁠В каждом цветовом поле, например, в основном, фоновом, а также в полях замены цвета (ctrl+r), можно щелкнуть и перетащить нужный цвет в любое место окна - интерфейс, изображение, изменяемое поле выбора цвета.

• ⁠Основные сочетания клавиш, чтобы рука рисовала: b (карандаш), m (выделение), g (заливка), n (пипетка), e (ластик),… Не стесняйтесь пробовать новые клавиши. Ctrl+z работает очень хорошо.

• ⁠Сочетания клавиш с CTRL+что-то, которые я использую чаще всего: c+v (копировать/вставить), r (заменить цвет), u (оттенок/насыщенность), a (выделить все), а еще есть одна для отображения/скрытия сетки. Очень удобно, но я переназначил ее, не знаю по умолчанию.

• ⁠Сочетания клавиш с Shift+что-то: h (отразить по горизонтали), v (отразить по вертикали).
<li>Передвигать карту на '''СКМ (нажатие колёсика)''', зум на колёсико.</li>
<li>'''CTRL+1''' - переключает слой зон.</li>
<li>'''CTRL+2''' - переключает слой покрытий (turf).</li>
<li>'''CTRL+3''' - переключает слой объектов.</li>
<li>'''CTRL+4''' - переключает слой мобов.</li>
<li>Удерживание '''S + ЛКМ''' – пипетка.</li>
<li>Удерживание '''D + ЛКМ''' - удалить подсвеченный красным объект.</li>
<li>Удерживание '''R + ЛКМ''' - замена тайла выбранным объектом.</li>
<li>'''CTRL + N''' - новое рабочее пространство(environment).</li>
<li>'''CTRL + O''' - открыть карту.</li>
<li>'''CTRL + Q''' - выход из программы.</li>
<li>'''CTRL + Z''' - отменить последнее действие.</li>
<li>'''CTRL + SHIFT + Z''' - вернуть последнее отмененное действие.</li>
<li>'''CTRL + C''' - копирование; '''CTRL + V''' - вставить; '''CTRL + X''' - вырезать; '''DEL''' - очистить (как правило, речь идет о выбранной области через 3 режим, при этом, очищается области по периметру выделенной зеленым).</li>
<li>'''CTRL + D''' - отменить выделение.</li>
<li>'''CTRL + S''' - сохраняет карту.</li>
<li>'''CTRL + F''' - открыть строку поиска объекта.</li>
<li>'''F5''' - обновить слой</li>
<li>'''+''' - приблизить масштаб</li>
<li>'''-''' - отдалить масштаб</li>
</ol>

Спрайты важны, понимаешь? Если бы у нас не было спрайтов, мы бы сделали действительно дерьмовую текстовую ролевую игру Roblox 2010. Или, может быть, одна из тех DOS-игр, но многопользовательская. Вы вообще видели эти темы о ролевых играх на форумах? Вот это оно и есть. Очень старое и грустное. Таким образом, спрайтеры являются важными художниками в игре. Они заставляют мапперов ставить стены и полы, а кодеров использовать модульную организацию, а картинки мы бессовестно крадем и помещаем в вики, хехехе. У них великая цель, и они также могут хорошо развлечься — вы когда-нибудь видели спрайты, которые они кидают в дискорд? Это круто. Это действительно ахуенно. Искусство сложно, и люди выходят за рамки этого, чтобы создавать офигенные спрайты. Это работа со страстью. Я не могу выразить словами, насколько важно создание спрайтов (да, это пишет и переводит вики-редактор, который по совместительству спрайтер xdd). Упрощенные визуальные эффекты очень необходимы в игре, и работа спрайтеров, проделанная для того, чтобы это произошло, заслуживает высокой оценки.

О, вы искали настоящего гида. Извините. идите спрашивайте в #dev-спрайт [https://discord.gg/rxsggTJzY3 дискорда].

== Основы ==
Спрайты в SS13 хранятся в файлах dmi. По сути, это атлас-спрайтов в определенном формате. Вы помещаете в него PNG и даете ему имя — это состояние значка. Большинство dmis имеют размер 32x32. У вас может быть растровое изображение, представляющее собой статический спрайт, а гифки можно анимировать. BYOND также работает с 8 направлениями движения, но обычно вам понадобится только 4 или 1.

== ПО ==
Aseprite используется очень часто. Вы можете получить его бесплатно, скомпилировав исходный код, или купить. Некоторые люди также используют Piskel. Вы также можете использовать другое программное обеспечение для обработки изображений, например Paint.net. От себя ещё могу порекомендовать бесплатный GIMP, или платный Adobe Photoshop, хотя ни в том ни в другом нет функции работы с DMI

== Обзор объекта ==
В игре 4 типа объектов:

* '''Область''' – нас это не будет интересовать, так как вы не увидите ее в игре и достаточно wip-графики,
* '''Моб''' – люди, обезьяны, киборги, инопланетяне и другая живность на станции / кораблях / планетах,
* '''Объекты''' – машины, двери, предметы и все остальное в игре,
* '''Турф''' – стены, полы и пространство

== Формат файла DMI ==
Спрайты в SS13 упакованы в файлы .dmi. Чтобы создать новый файл dmi, откройте Dream Maker, выберите «Файл» > «Новый» и выберите «Файл значка (dmi)» в раскрывающемся меню. Напишите для него путь к файлу и нажмите ОК.

Откроется новое окно с пустым файлом. в правом верхнем углу есть два места для размеров спрайта. Большинство спрайтов имеют размер 32x32 пикселя. К сожалению, один dmi-файл не может содержать спрайты разных размеров.

Теперь щелкните правой кнопкой мыши где-нибудь на белизне. Существует два типа спрайтов: растровое изображение и фильм. Растровое изображение статично, а фильм можно анимировать и смотреть в разных направлениях, вот и вся разница. Давайте создадим спрайт фильма. (Новый фильм)

Откроется окно с четырьмя стрелками направления и тремя рамками для каждой из них, все серого цвета. Байонд понимает 8 направлений. Вы можете выбрать, сколько кадров вы хотите использовать, под самими спрайтами: 1, 4 или 8. Вы также можете выбрать, сколько кадров вы хотите иметь в анимации. Если вы создаете разнонаправленный статический спрайт, создайте фильм с 1 кадром, без анимации, но с 4 или 8 направлениями, в зависимости от того, сколько вам нужно. Если вы хотите анимировать спрайт, вас также может заинтересовать возможность установить задержку в 1/10 секунды над конкретным кадром. Хорошо, надеюсь, отсюда вы поймете, что делать. Встроенный инструмент редактирования спрайтов очень примитивен и единственное, о чем в нем стоит упомянуть, это о том, как применять альфа-фильтр. Если вы дважды щелкните любое изображение, вы попадете в редактор спрайтов, а справа от него находится вертикальный ползунок, управляющий альфа-каналом. Также стоит отметить, что копирование из редактора может вести себя немного странно, поскольку фон создается полностью, несмотря на установленный альфа-фильтр. Просто «залейте» фон цветом со значением альфа 0 или используйте «импорт», который отлично работает.

Теперь предположим, что мы сделали ваши спрайты спрайтами, вернитесь к файлу dmi (экран, который появился, когда вы впервые создали файл). Предполагая, что вы создали спрайт, вы увидите его в списке. Дважды щелкните чуть ниже фактического спрайта, и откроется окно переименования. Альтернативно выберите спрайт и нажмите F2 на клавиатуре. Дайте имя вашему спрайту. Это имя часто называют icon_state, поскольку это имя переменной, которая определяет его в коде.

Также обратите внимание, что вы можете импортировать и экспортировать файлы изображений разных типов, выбрав файлы, которые вы хотите экспортировать, в редакторе (удерживайте Ctrl, чтобы выбрать несколько), щелкнув правой кнопкой мыши и выбрав экспорт, или щелкнув правой кнопкой мыши в любом месте и выбрав импорт, чтобы импортировать. DMI похож на PNG, поэтому, если вы переименуете расширение DMI в PNG, оно должно работать во всех программах графического редактирования. Обычно это работает и в обратную сторону. Это ускоряет перекрашивание.

Надеюсь, это вся информация, которая вам нужна для создания спрайтов и файлов dmi.

== Требуемые спрайты по категориям объектов ==
Теперь расскажу вам, какие спрайты нужны различным типам предметов:

=== Мобы ===

* Спрайты мобов по большей части требуют четырех направлений.
* Спрайты мобов требуют спрайтов мертвых мобов .
* Если вы захотите, вы можете создать спрайт моба, который лежит.
* Если вы создаете моба, который может носить одежду, вы можете использовать Pixel_y, Pixel_x для смены одежды при кодировании моба.

==== Мобы с конечностями ====

* Человек и человеческий вид состоят из конечностей – головы, груди, двух рук и двух ног.
* Файлы находятся в icon/mob/human_parts.dmi для конечностей, имеющих заданный цвет, и в icon/mob/human_parts_greyscale.dmi для конечностей, которые можно перекрасить и начать использовать оттенки серого.
* Конечности имеют 4 кадра, как и полноценные иконки.
* Конечности также используются в качестве иконок предметов на случай расчленения.
* Именование следующее:
** [race]_l/r_arm/leg для рук и ног.
** [race]_chest(_m/f) для торса (м/ж для мужских/женских вариантов, необязательно)
** [race]_head(_m/f) для головы (м/ж для мужского/женского вариантов, необязательно)
* Дополнительные части тела, такие как хвосты ящерицы, помещаются в mutant_bodyparts.dmi.

=== Турфы ===

* Полы находятся в файле icon/turf/floors.dmi.
* Стены находятся в файле icon/turf/walls.dmi.
* Стены и полы шаттла находятся в файле icon/turf/shuttle.dmi.
* Космические плитки находятся в файле icon/turf/space.dmi.

=== Объекты ===

* Спрайты объектов находятся в папке icon/obj.
* Спрайты предметов разбросаны по всей папке.
* Спрайты предметов по большей части требуют наличия собственных спрайтов. Их можно найти в разделах icon/mob/items_lefthand.dmi и icon/mob/items_righthand.dmi.
* Спрайты одежды находятся в папке icon/obj/clothing.
* Спрайты одежды на мобах можно найти в папке icon/mob.
* Спрайты одежды по большей части требуют спрайтов, находящихся в руках. Их можно найти в разделах icon/mob/items_lefthand.dmi и icon/mob/items_righthand.dmi.
* Спрайты техники находятся в папке images/obj/machines. Хотя значительная их часть находится в папке icon/obj.
* Спрайты дверей расположены в папке icon/obj/door.
* Обычный спрайт двери требует Door_closed, Door_locked, Door_opening, Door_deny, Door_Closing, Door_open, Door_spark, o_door_opening, o_door_Closing, Panel_open, Welded и Elights. Предлагаю осмотреть door.dmi
* Укреплённым дверям требуются только спрайты открытия и закрытия, а также спрайты, когда они открыты и закрыты.

== Маппинг ==
'''A.T.O.M. - Area - Turf - Object - Mob''' 
В маппинге, в основном мы рассматриваем 4 типа:

1. [https://www.byond.com/docs/ref/#/area '''Зоны''']. Покрывают область и карты и говорят коду что это за территория и её свойства. От зоны работает вся электроника, зону запитывает АЦП и т.д. Свойства у зон бывают самые различные. От звуков и сообщений в чате до запрета телепортации.

2. [https://www.byond.com/docs/ref/#/turf '''Турфы''']. Пол и стены. Полы определяют какой в тайле будет газ, температура, скорость, гравитация, а стены понятно, надеюсь, что делают. Нельзя в один тайл (условная игровая клетка) поставить и пол и стену. Под стеной при разборе всегда будет базовый пол, если в коде не прописано иного.

3. [https://www.byond.com/docs/ref/#/obj '''Предметы'''] . Всё, что не было указано ранее. В том числе, но не заканчивая ими: лендмарки (точки спавна), простые предметы (столы, стулья), декали (и прочий декор типо мелковых рисунков), рандом спавнеры, машинерия (от лампочки, до консолей и всех труб), провода, и прочее.

4. [https://www.byond.com/docs/ref/#/mob '''Мобы''']. Все НПС. С мобами можно по-разному играться задавая им <s>скорость</s>, здоровье, урон и <s>лутдпроп (для продвинутых).</s>

=== Список переменных ===
У каждого типа есть список переменных. Перечислять все переменные, которые меняются у объектов можно долго, но главные указаны здесь:

[https://www.byond.com/docs/ref/#/%7Bnotes%7D/pixel-movement '''pix_x''' | '''pix_y'''] - Задают смещение от центра тайла. Вся настенная машинерия ставится над/под/слева/справа от нужного расположения на стене и поднимается в нужную сторону на 28-32 пикселя. (1 тайл - 32х32 пикселя)

[[File: Directions.png|thumb|256px|Наглядный пример направлений]]
[https://www.byond.com/docs/ref/#/atom/var/dir '''dir'''] - Направление.
2 - на игрока 1 - от игрока 4 - вправо 8 - влево. Если направлений больше, то и другие значения до 16.

'''anchored''' - Закрепление. Объект нельзя потянуть или сдвинуть если TRUE

'''Id''' и '''id_tag''' - Кнопочная машинерия. Для кнопки задается ''id'', для объекта ''id tag'' определяет поведение для дверей(болты, открыть, доступ и т.д) 
Если вам нужно, чтобы кнопка(id) открывала дверь/поддур и тд с 1 ''id_tag'' - прописывайте в ''id'' так ''“ВАШ ID_TAG”'' 
Если Вам нужно, чтобы кнопка(id) открывала дверь/поддур и тд с множеством ''id_tag'' - прописывайте в id так ''list(“ID_TAG1”,”ID_TAG2”)''. Вписывать можно сколько вашей душе угодно, главное соблюдайте синтаксис.

'''req_access (list)''' - Проверка на доступ любая машинерия и двери. Таблица доступов есть в руководстве по маппингу. Несколько доступов пишутся через запятую без пробелов. Если вы хотите привязать мультидоступ, то прописывайте его через запятую, например: req_access = list(1,19,43)

[https://www.byond.com/docs/ref/#/atom/var/icon '''Icon'''] и [https://www.byond.com/docs/ref/#/atom/var/icon_state '''icon_state'''] - Первый указывает путь до дми файла с кучей иконок, второй указывает какая именно иконка из кучи в этом файле будет показываться.

=== Каждое новое помещение начинается с зоны ===
Зона это основной способ взаимодействия тайлов с кодом игры. Будет ли в зоне электричество от апц, либо же она будет запитана магией, будет ли в ней гравитация, какой в ней будет эмбиент(звук окружения), машинерия и как она будет работать в ней и т.д.

Зоны на станциях не должны повторяться. Дело в том, что зона не обязательно должна располагаться близко, чтобы передавать всю информацию внутри себя. Если разместить одну и ту же зону на разных концах карты, то пожарная сигнализация будет срабатывать в обоих, даже если вторая вообще не имеет атмосферы. Это работает даже на разных Z уровнях!

Помните, что настраивать и изменять свойства зоны необходимо исключительно в коде!
=== Подробнее про Variables ===
[[File:sdmm_variables.png|thumb|256px|Область управления переменными]]
Данная область позволит вам творить самые настоящие тёмные колдунства при наличии хотя бы минимальных знаний понимания работы кода/переменных.
Зона Variables состоит из двух вкладок: Instance и Prefab.
'''Instance''' - Позволяет смотреть и менять параметры у одного объекта на карте.
'''Prefab''' - Также позволяет проверять параметры, однако менять параметры будет у всех таких же объектов на карте.
У вас также имеется возможность использовать некоторые параметры, чтобы показать только изменённые переменные.
<ol>
<li>'''Ctrl+1''' - '''Show modified only''' - Покажет только те переменные, что уже были изменены.</li>
<li>'''Ctrl+2''' - '''Show types''' - Покажет переменные не только объекта, но и также его родителей.</li>
<li>'''Ctrl+3''' - '''Show pins''' - Позволит закрепить необходимую переменную, чтобы не потерять её из виду. Она будет показываться в самом верху.</li>
<li>'''Ctrl+4''' - '''Show tmp, const, and static''' - Наши тёмные маги ещё не познали такую сильную магию. Об этом параметре особо ничего не известно. </li>
</ol>
== Создание кораблей и руин ==
Все текущие корабли находятся в папке '''_maps/_mod_celadon/shuttles''' и имеют сортировку по фракциями, а также там имеется отдельная папка для субшаттлов - '''_maps/_mod_celadon/shuttles/subshuttles'''. В этих папках хранятся сами карты, однако инициализация кораблей происходит благодаря папке '''_maps/_mod_celadon/configs'''.

=== Конфиг корабля ===
[[File:example_ship_config.png|thumb]]
В папке с конфигами вы можете ознакомиться со структурой и перенести её в ваш новый файл. 
Вы также можете изучить саму [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/_maps/ship_config_schema.json '''структуру'''] и пример [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/_maps/example_ship_config.json '''конфигурационного файла'''].
Пройдёмся по переменным:
<ol>
<li>'''map_name''' - Полное название корабля. Именно с таким названием игроки увидят ваш корабль в общем списке в лобби.</li>
<li>'''map_short_name''' - Краткое название карты. Обозначает класс корабля. Будет отображаться в манифесте. Не может содержать пробелы. Кроме букв доступны только дефис и нижнее подчёркивание.</li>
<li>'''description''' - Описание корабля. Будет отображаться при выборе корабля в лобби. Содержит в себе лор корабля.</li>
<li>'''map_path''' - Путь к файлу карты корабля. Например: "_maps\shuttles\inteq\inteq_colossus.dmm"</li>
<li>'''enabled''' - Если "true" - доступно для покупки игроками. Если "false" - только для щитспавна.</li>
<li>'''limit''' - Допустимое количество для покупки корабля игроками.</li>
<li>'''space_spawn''' - По умолчанию корабль спавнится на аванпосту. Если "true", то корабль заспавнится в космосе.</li>
<li>'''prefix''' - Указывается префикс фракции. Доступные префиксы можно найти на [https://wiki.celadon.pro/index.php/Префиксы этой странице].</li>
<li>'''faction''' - Путь к датуму фракции. Доступные фракции находятся в этом файле: [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/mod_celadon/faction/code/faction.dm mod_celadon/faction/code/faction.dm], если нет необходимой - можно найти в другом файле: [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/code/modules/faction/faction_datum.dm code/modules/faction/faction_datum.dm].</li>
<li>'''tags''' - Указываются теги корабля. Их можно найти в этом файле: [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/_maps/ship_tags_descriptions_guide.txt _maps/ship_tags_descriptions_guide.txt]. На данный момент не используется. В будущем планируется использовать для сортировки кораблей.</li>
<li>'''namelists''' - Указываются кодовые названия списков, из которых корабль будет генерировать название корабля при его создании. Ознакомиться с доступными списками и названиями можно в этом файле:[https://github.com/CeladonSS13/Shiptest/blob/beta-dev/strings/ship_names.json strings/ship_names.json].</li>
<li>'''job_slots''' - Состоит из 3 частей. Название (название профессии при заходе на корабль), outfit (путь к снаряжению в коде), slots (количество доступных профессий). Доступный список снаряжений можно найти по пути [https://github.com/CeladonSS13/Shiptest/tree/beta-dev/mod_celadon/outfit/code mod_celadon/outfit/code], они имеют примерно такую структуру: ''/datum/outfit/job/фракция/профессия''.</li>
</ol>

=== Создание субшаттла ===
[[File:guide_subshuttle.png|thumb|256px|Пример датума субшаттла]]
Субшаттлы инициализируются не так, как обычные корабли, им не нужен конфиг. Они недоступны для покупки в общем списке лобби, но могут быть использованы в качестве дополнительного корабля внутри самого корабля или для отправки к примеру ЕРТ отряда с помощью администрации. Они создаются в отдельном файле: [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/mod_celadon/maps/code/subshuttles.dm mod_celadon/maps/code/subshuttles.dm].

Путь к картам субкораблей: '''_maps/_mod_celadon/shuttles/subshuttles'''.
=== Создание руины ===
Руинки - это дополнительные локации, которые спавнятся на планетах. На одной планете может быть максимум одна руина.
При создании руины старайтесь использовать флору и фауну, которые предназначены для выбранной вами планеты.
Чтобы инициализировать руину вам потребуется закинуть карту в папку с руинами для необходимой планеты по пути: '''_maps/_mod_celadon/RandomRuins/'''.
Затем перейдите к файлу '''mod_celadon/maps/code/ruins/ruin.dm''' и пропишите датум, по примеру других руин в файле. Датум может иметь такие параметры:
<ol>
<li>'''Datum''' - ''[Обязательно]'' /datum/map_template/ruin/Планета/Название</li>
<li>'''name''' - ''[Обязательно]'' Полное название вашей руины</li>
<li>'''id''' - ''[Обязательно]'' Уникальное и краткое название руины, без нижних подчёркиваний. Используется функционирования для чёрного листа.</li>
<li>'''suffix''' - ''[Обязательно]'' Название вашего файла. Пример: anima_heirophant.dmm</li>
<li>'''description''' - ''[Обязательно]'' Описание вашей руины, лёгкий лор. Используется для страницы с информацией о руинах (в разработке). </li>
<li>'''cost''' - Влияет на вероятность спавна вашей руины. Чем выше стоимость, тем реже она может встретиться.</li>
<li>'''allow_duplicates''' - Если значение "False", то на весь раунд сможет появится только одна руинка.</li>
<li>'''ruin_tags''' - Используется для краткого описания руины. Теги можно найти здесь: [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/code/__DEFINES/ruins.dm code/__DEFINES/ruins.dm].</li>
<li>'''never_spawn_with''' - Не заспавнит руинку, если уже имеется указанная руина из вашего списка.</li>
</ol>
После создания датума перейдите к текстовому файлу '''map_catalogue_key.txt''' по пути: '''_maps/_mod_celadon/map_catalogue.txt''' и оставьте запись о руинке с размерами, тегами и путями.

=== Важная дополнительная информация ===
Обязательное правило для создания корабля и субшатла, чтобы он не был квадратным иначе, как бы вы не старались при постановке док портов, вы не сможете задать нужное вам направление.
[Wideband] На корабля обязательно должно присутствовать средство связи с другими кораблями.
Если вы хотите, чтобы ваша карта была добавлена на [https://map.celadon.pro вебкарту], то нужно обращаться непосредственно к хосту Celadon`a - Voiko.
Максимальные размеры руин: '''121x75'''. Максимальный размер корабля равен максимальному размеру ангара '''56x40'''.
Список кодов доступа (access) к шлюзам и так далее находится в файле [https://github.com/CeladonSS13/Shiptest/blob/beta-dev/code_DEFINES/access.dm code/_DEFINES/access.dm].
При создании атмосферы на шипе не используйте стационарные танки с газами.

= Проверка перед публикацией =
<ol>
<li>Полы с воздухом или без него, как и должно быть? (обычный или безвоздушный)</li>
<li>[APC] - Есть ли в этой зоне ЛКП?</li>
<li>[Air Alarm] - Есть ли в этой зоне воздушная сигнализация?</li>
<li>[Outpost Communications Console] - Есть ли в этой зоне консоль запросов?</li>
<li>[Light] - Есть ли на территории освещение?</li>
<li>[Light Switch] - Есть ли в этом помещении выключатель света?</li>
<li>[Intercom] - Достаточно ли в этом зоне интеркомов?</li>
<li>[Camera] - Достаточно ли в этом зоне камер видеонаблюдения?</li>
<li>[Vent Scrubber] - Подключена ли зона к вентиляционному очистителю?</li>
<li>[Vent Pump] - Подключена ли зона к вентиляционному насосу?</li>
<li>[Fire Alarm & Fire Doors] - Есть ли на территории пожарная сигнализация и противопожарные шлюзы?</li>
<li>[Holopad] - Имеется ли голопад на вашем судне?</li>
<li>Все ли подключено правильно?</li>
<li>Все ли двери работают правильно?</li>
<li>Правильно ли настроены доступы на дверях, кнопках и т. д.?</li>
<li>Все ли предметы размещены правильно? (не ниже вентиляционных отверстий, скрубберов, столов)?</li>
<li>Правильно ли работает система мусоропровода?</li>
<li>Проверьте наличие неуместных или наложенных частей труб (воздушных и отводящих).</li>
<li>Проверьте, нет ли неуместного или наложенного куска провода.</li>
<li>Определите, насколько сложно проникнуть в эту область и где находятся слабые места, и соответствующим образом сбалансируйте область (например, Хранилище должно быть сделано из усиленных конструкций и электрифицированных окон, Кухня не должна быть сделана из этих материалов, а из обычных стен)</li>
<li>Проверьте, не слишком ли много пустого пространства. Если да, уменьшите его и замените остальные туннелями для обслуживания.</li>
<li>Есть ли нерушимые турфы там, где их не должно быть?</li>
</ol>

Файл:Aseprite instruction2.webp

2026-04-21T12:59:33Z

Voiko:

Файл:Aseprite instruction1.webp

2026-04-21T12:57:16Z

Voiko: