Просмотр кода страницы SS13 для опытных программистов

{{Needsrevision|reason=Гайд давно не трогали, что-то может не соответствовать реальности. Нужен реальный опыт работы с Paracode}}
Похожие руководства: [[Структура кода SS13]] и [[Руководство по маппингу]]

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

== Синтаксис ==

*Точка с запятой в конце строки не является обязательной,
*Циклы, процедуры, объекты, переменные и т.п. блоки определяются отступами (сходство с Python). Примеры:
  /obj
    var
      i1
      i2
      i3
идентично коду: (Крайне рекомендуется использовать подобный вариант разметки, для упрощения поиска объявлений переменных и процедур в дальнейшем)
  /obj
    var/i1
    var/i2
    var/i3
что в свою очередь эквивалентно: 
  /obj/var/i1
  /obj/var/i2
  /obj/var/i3
*Руководство использует термин '''объект''' для любых определенных типов (см. [[#Variable types|Типы переменных]]), и '''obj''' для производных <code>atom/obj</code>, все из которых являются объектами, которые могут быть размещены на игровой карте.
*Руководство использует термин 'подконтрольный ИИ' для описания поведения, связанного с игроком в роли [[ИИ]], контролирующего предмет. Термин 'подконтрольный игре' используется, отсылаясь к поведению, которое определяет сам скрипт. (Существ с подобным поведением обычно называют существами, подконтрольными ИИ, или NPC) <!--Что тут имелось в виду в оригинале?-->
*Все унаследовано от родительских объектов. Если переменная определена в <code>/obj/item</code>, её не нужно будет (на самом деле, нельзя) определять в <code>/obj/item/weapon</code>.

=== [http://www.byond.com/members/?command=reference&path=var Переменные (Источник)] ===
Переменные - это база. В BYOND переменные общие, не существует большой разницы при определении строковых, числовых, булевых и т.д. (Как в PHP)

==== [http://www.byond.com/members/?command=reference&path=var Предопределенные переменные (Источник)] ====
В BYOND существует большое количество предопределенных переменных, самые основные из них:
*'''[http://www.byond.com/members/?command=reference&path=proc%2Fvar%2Fsrc src]''' - эквивалентна объекту, содержащему процедуру или переменную. При определении принимает тот же тип, что и этот объект. (Аналогично <code>this</code> из Java или C++)
*'''[http://www.byond.com/members/?command=reference&path=proc%2Fvar%2Fusr usr]''' - переменная сущности (моба) (<code>var/mob/usr</code>), содержит сущность игрока, исполнившего текущий оператор или чье действие в конечном счете вызвало текущую процедуру. '''Хорошее правило из практики: никогда не помещать <code>usr</code> в процедуру.''' Если <code>src</code> не будет верным выбором, лучше отправить другой аргумент в процедуру с необходимой информацией. <!--Мы, конечно, программисты, но тут автор невнятно пишет -->
*'''[http://www.byond.com/members/?command=reference&path=proc%2Fvar%2Fargs args]''' - список аргументов, принятых в процедуре или операторе.
*'''[http://www.byond.com/members/?command=reference&path=datum%2Fvar%2Fvars vars]''' - список переменных-объектов. Если использовать имя переменной в качестве индекса списка, возвращает значение этой переменной.

Больше переменных описано здесь: [[#SS13 common variable meanings|Предназначение основных переменных в коде SS13]]

==== Определение переменных ====

=====Базовое определение=====
  var/j
  var/i = 4
  var/a, b, c

=====Комплексное определение=====
Основной синтаксис: <code>var/type/variable_name = value</code> [http://www.byond.com/members/?command=reference&path=var (из источника)]

Примеры:
  var/obj/item/I = new/obj/item
  [http://www.byond.com/members/?command=reference&path=operator%2F%40dt%3B I.name] = "Some item"

Определение блока данных (datum) и объявление переменной этого типа данных (test_datum):
  datum/test_datum
    var/test_variable = 0 //объявляем переменную test_variable
    
    proc/set_as(var/i) //объявление процедуры в рамках test_datum
      test_variable = i //присваиваем test_variable значение из аргумента
  
  var/datum/test_datum/TD = new/datum/test_datum //TD будет указателем на блок данных типа test_datum
  TD.test_variable = 4  //Byond не знает о приватных переменных, так что можно присваивать им значение таким образом
  [http://www.byond.com/members/?command=reference&path=world world] [http://www.byond.com/members/?command=reference&path=operator%2F%26lt%3B%26lt%3B <<] TD.test_variable //вернет 4 всем подключенным пользователям
  TD.set_as(10) //Вызовет процедуру set_as в блоке данных TD с аргументом 10
  TD.test_variable //вернет 10 всем подключенным пользователям

==== Битовый флаг ====

Битовые флаги (Bitflags) - это переменные, использующие биты вместо чисел для определения условий. Битовые операторы: [http://www.byond.com/members/?command=reference&path=operator%2F%26 & (поразрядное И)] и [http://www.byond.com/members/?command=reference&path=operator%2F%7C | (Поразрядное ИЛИ)]. Данные операторы используют двоичную систему счисления для определения результата. Таким образом, [http://www.byond.com/members/?command=reference&path=operator%2F%26 13 & 3] вернет 1. ([http://www.byond.com/members/?command=reference&path=operator%2F%26 1101 & 0011 = 0001]) и [http://www.byond.com/members/?command=reference&path=operator%2F%7C 13 | 3 = 15] ([http://www.byond.com/members/?command=reference&path=operator%2F%7C 1101 | 0011 = 1111]) (см. [[#IF (ЕСЛИ)]])

==== Типы переменных ====
[http://www.byond.com/members/?command=reference&path=var Источник]

*[http://www.byond.com/members/?command=reference&path=datum datum] - обычный тип объекта (классы из Java)
*[http://www.byond.com/members/?command=reference&path=atom atom] - атомарные переменные, превращаются в obj, turf, mob и area
*[http://www.byond.com/members/?command=reference&path=turf turf] - плитки, составляющие полов, стен и космоса в SS13
*[http://www.byond.com/members/?command=reference&path=area area] - зоны, сгруппированные локации. Объединяют множество turf с похожими свойствами. Определяют электроснабжение, атмосферу и т.п.
*[http://www.byond.com/members/?command=reference&path=mob mob] - живое существо, контролируемое игрой или игроком.
*[http://www.byond.com/members/?command=reference&path=obj obj] - объекты, которые могут быть размещены на карте.
*[http://www.byond.com/members/?command=reference&path=client client] - объект клиента, создаваемый при подключении игрока
*[http://www.byond.com/members/?command=reference&path=list list] - список элементов. Первый элемент списка '''L''' определяется как '''L[1]'''
*[http://www.byond.com/members/?command=reference&path=world world] - переменная, в которой могут быть определены глобальные переменные игрового мира. Переменные в world содержат все атомарные переменные, присутствующие в игровом мире.

==== [http://www.byond.com/members/?command=reference&path=operator%2F%26lt%3B%26lt%3B%2Foutput Вывод сообщений] ====
Самым простым способом вывода сообщений является использование оператора [http://www.byond.com/members/?command=reference&path=operator%2F%26lt%3B%26lt%3B%2Foutput '''<<'''].

  [http://www.byond.com/members/?command=reference&path=world world] [http://www.byond.com/members/?command=reference&path=operator%2F%26lt%3B%26lt%3B <<] "Hello World!" //Выводит сообщение всем клиентам, подключенным к миру.
  [http://www.byond.com/members/?command=reference&path=proc%2Fvar%2Fusr usr] [http://www.byond.com/members/?command=reference&path=operator%2F%26lt%3B%26lt%3B <<] "Hello usr" //Выводит сообщение только для пользователя, который вызвал процедуру с данным оператором.

===== Вывод значений переменных =====
  var/s1 = "Привет"
  var/s2 = "Мир"
  var/i = 2011
  var/j = 2022
  [http://www.byond.com/members/?command=reference&path=world world] [http://www.byond.com/members/?command=reference&path=operator%2F%26lt%3B%26lt%3B <<] "[s1] [s2], руководство написано в [i], переведено в [j]" //Возвращает "Привет Мир, руководство написано в 2011, переведено в 2022"

==== Определение типов переменных в коде ====
Процедура [http://www.byond.com/members/?command=reference&path=proc%2Fistype istype()] вам пригодится.

Пример:
  var/obj/item/weapon/W = new/obj/item/weapon/baton
  if([http://www.byond.com/members/?command=reference&path=proc%2Fistype istype](W,/obj/item/weapon/baton))
    [http://www.byond.com/members/?command=reference&path=world world] << "Это - baton!"

Второй аргумент необязателен, если опущен, переменная будет проверена на соответствие объявленному типу:
  var/obj/item/weapon/W = new/obj/item/weapon/baton
  if([http://www.byond.com/members/?command=reference&path=proc%2Fistype istype](W))
    [http://www.byond.com/members/?command=reference&path=world world] << "Это - weapon!"

Стандартный код для получения аргументов из переменных, которые имеют тип, являющийся подклассом типа, с которым их обрабатывает текущая процедура (см. пример любой процедуры Attackby()). Обратите внимание, что приведенный ниже пример относится к процедуре, которая определена глобально и не привязана к объекту. Не имеет смысла делать это так, но это работает в рамках примера. Объекты /obj не имеют переменной 'amount', она определена в /obj/item/stack (как показано в упрощенном определении классов ниже. Также обратите внимание, где var/ используется, а где нет).
  /obj
    var/name = "Object"
  
  /obj/item
    name = "Item"
  
  /obj/item/stack
    name = "Stack"
    var/amount = 50
  
  proc/get_amount(var/obj/O)
    if([http://www.byond.com/members/?command=reference&path=proc%2Fistype istype](O,/obj/item/stack))
      var/obj/item/stack/S = O
      return [http://www.byond.com/members/?command=reference&path=operator%2F%40dt%3B S.amount]

Другой способ проделать такое. Он существует исключительно для демонстрации.
  proc/get_aount(var/obj/S)
    if([http://www.byond.com/members/?command=reference&path=proc%2Fistype istype](O,/obj/item/stack))
      return [http://www.byond.com/members/?command=reference&path=operator%2F%3A O:amount]
Оператор двоеточия ([http://www.byond.com/members/?command=reference&path=operator%2F%3A :]) в примере выше сообщает компилятору: "Я знаю, что делаю, не обращай внимание на тот факт, что объект не имеет этой переменной. Я сам проверю, что оно работает." Проблема в том, что люди будут использовать ваш код так, как вы никогда не планировали. Это значит, что что-то может заставить 0:amount выдать исключение в виде ошибки Runtime Error. Некоторые переменные, возможно, в конечном итоге потребуется удалить или заменить, и это будет невозможно, когда они используются с object:variable, поскольку компилятор не выдаст ошибку при удалении переменной. Ошибка станет очевидной только после того, как игра будет запущена на реальном сервере, что может привести к ее сбою. Так что '''никогда''' не используйте этот метод.

Вот вам еще несколько источников:

[http://www.byond.com/members/?command=reference&path=proc%2Fistype istype()] proc:<br>
[http://www.byond.com/members/?command=reference&path=proc%2Fisarea isarea(variable)] = istype(variable, /area)<br>
[http://www.byond.com/members/?command=reference&path=proc%2Fisicon isicon(variable)] = istype(variable, /icon)<br>
[http://www.byond.com/members/?command=reference&path=proc%2Fismob ismob(variable)]  = istype(variable, /mob)<br>
[http://www.byond.com/members/?command=reference&path=proc%2Fisobj isobj(variable)]  = istype(variable, /obj)<br>
[http://www.byond.com/members/?command=reference&path=proc%2Fisturf isturf(variable)] = istype(variable, /turf)<br>
[http://www.byond.com/members/?command=reference&path=proc%2Fisloc isloc(variable)]  = ismob(variable) || isobj(variable) || isturf(variable) || isarea(variable)

==== Переключение между типами переменных ====

Предопределены BYOND:<br>
[http://www.byond.com/members/?command=reference&path=proc%2Fascii2text ascii2text]<br>
[http://www.byond.com/members/?command=reference&path=proc%2Ffile2text file2text]<br>
[http://www.byond.com/members/?command=reference&path=proc%2Flist2params list2params]<br>
[http://www.byond.com/members/?command=reference&path=proc%2Fnum2text num2text]<br>
[http://www.byond.com/members/?command=reference&path=proc%2Fparams2list params2list]<br>
[http://www.byond.com/members/?command=reference&path=proc%2Ftext2ascii text2ascii]<br>
[http://www.byond.com/members/?command=reference&path=proc%2Ftext2file text2file]<br>
[http://www.byond.com/members/?command=reference&path=proc%2Ftext2num text2num]<br>
[http://www.byond.com/members/?command=reference&path=proc%2Ftext2path text2path]<br>
[http://www.byond.com/members/?command=reference&path=proc%2Ftime2text time2text]<br>

Определены в SS13:<br>
text2dir(direction)<br>
dir2text(direction)<br>
dd_file2list(file_path, separator)<br>
dd_text2list(text, separator, var/list/withinList)<br>
dd_text2List(text, separator, var/list/withinList)<br>
dd_list2text(var/list/the_list, separator)<br>
angle2dir(var/degree)<br>
angle2text(var/degree)<br>

Больше полезных процедур:<br>
[http://code.google.com/p/tgstation13/source/browse/trunk/code/defines/procs/helpers.dm code/defines/procs/helpers.dm]<br>
[http://code.google.com/p/tgstation13/source/browse/trunk/code/game/objects/items/helper_procs.dm code/game/objects/items/helper_procs.dm]

=== [http://www.byond.com/members/?command=reference&path=proc%2Fif IF (ЕСЛИ)] ===

If обычно проверяет на истинность условия, если не указано иное. За ложность в других типах переменных принимаются такие значения, как <code>empty</code>, <code>0</code> или отсутствие значения (<code>null</code>).
  if(condition)
    action_true()
  else
    action_false()

==== Поведение переменных в операторе If ====
{|
!Тип переменной
!Ложно когда
!Истина когда
|-
!String (Text/ASCII)
|"" или null
|Все остальное
|-
!Int, Real
|0 или null
|Все остальное
|-
!datum, atom
|null
|Все остальное
|}

==== [http://www.byond.com/members/?command=reference&path=operator Логические операторы] ====
Стандарт:
  [http://www.byond.com/members/?command=reference&path=operator%2F%21 ! (НЕ)] //НЕ выражение1
  [http://www.byond.com/members/?command=reference&path=operator%2F%26%26 && (И)] //выражение1 И выражение2
  [http://www.byond.com/members/?command=reference&path=operator%2F%7C%7C || (ИЛИ)] //выражение1 ИЛИ выражение2
  [http://www.byond.com/members/?command=reference&path=operator%2F%3D%3D == (РАВНО)] //выражение1 РАВНО выражению2
  [http://www.byond.com/members/?command=reference&path=operator%2F%21%3D != (НЕ РАВНО)] //выражение1 НЕ РАВНО выражению2
  [http://www.byond.com/members/?command=reference&path=operator%2F%26lt%3B < (МЕНЬШЕ)] ([http://www.byond.com/members/?command=reference&path=operator%2F%26lt%3B%3D <= (НЕ БОЛЬШЕ)]) //1 меньше или равно 2
  [http://www.byond.com/members/?command=reference&path=operator%2F%26gt%3B > (БОЛЬШЕ)] ([http://www.byond.com/members/?command=reference&path=operator%2F%26gt%3B%3D >= (НЕ МЕНЬШЕ)]) //1 больше или равно 2
  [http://www.byond.com/members/?command=reference&path=operator%2F%26 & (Поразрядное И)] //13 & 3 = 1 (1101 & 0011 = 0001)
  [http://www.byond.com/members/?command=reference&path=operator%2F%7C | (Поразрядное ИЛИ)] //13 | 3 = 15 (1101 | 0011 = 1111)

BYOND не распознает оператор === (эквивалентность). 

Больше операторов: [http://www.byond.com/members/?command=reference&path=operator Источник (левое меню)]

=== [http://www.byond.com/members/?command=reference&path=proc%2Fwhile While] ===
BYOND совершит выход из цикла, как только он достигнет определенного числа повторов (итераций) и выдаст runtime ошибку из опасений попасть в бесконечный цикл. То же относится к рекурсиям.
Также, как и везде:
  while(condition)
    action1()

Все циклы понимают команды <code>[http://www.byond.com/members/?command=reference&path=proc%2Fcontinue continue]</code> и <code>[http://www.byond.com/members/?command=reference&path=proc%2Fbreak break]</code>

=== For ===

For объединяет for-циклы и foreach-циклы:
====  [http://www.byond.com/members/?command=reference&path=proc%2Ffor%2Floop For цикл] ====
  for(var/i = 1; i <= 10; i++)
    [http://www.byond.com/members/?command=reference&path=world world] << i //Выведет в каждой строке числа 1 2 3 4 5 6 7 8 9 10

==== [http://www.byond.com/members/?command=reference&path=proc%2Ffor%2Flist For each цикл] ====
  for(var/obj/item/weapon/baton/B [http://www.byond.com/members/?command=reference&path=operator%2Fin in] world)  //итерации над каждым объектом из world.contents (все атомы игрового мира) и берет для обработки только объекты типа <code>/obj/item/weapon/baton</code>
    B.name = "Smelly baton" //Присвоит новое имя предмету "baton" в текущей итерации

=== [http://www.byond.com/members/?command=reference&path=proc%2Fdo Do..While] ===

Оператор Do..while обычно не используется в коде SS13, хотя BYOND его поддерживает.

  var/i = 3
  do
    world << i--
  while(i)

=== [http://www.byond.com/members/?command=reference&path=datum Определение объектов] ===
Неважно, хотите ли вы создать [http://www.byond.com/members/?command=reference&path=datum datum] или [http://www.byond.com/members/?command=reference&path=atom atom]-объект, определение объектов этих двух типов одинаково просто:
  /obj/item/weapon/item1 //создаст новый объект типа obj.
    var/item_property = 5 //определяет новый тип переменных для всех объектов item1
    name = "Testing Item" //переменная name уже определена в родительских объектах, поэтому в этой строке только присваивается новое значение
  
  /obj/item/weapon/item1/[http://www.byond.com/members/?command=reference&path=datum%2Fproc%2FNew New()] //Конструктор процедуры New()
    [[#..()|..()]] //всегда присутствует в процедуре New(), см. <code>[[#..()|..()]]</code>
    item_property = 3 //выполняемое действие в конструкторе объекта.

=== [http://www.byond.com/members/?command=reference&path=proc Procs] (Методы, функции, процедуры) ===
Вы привыкли к стандартным функциям и методам, верно? Ну, procs опускают несколько аспектов. Их можно сравнивать с методами Java, поскольку связаны с конкретными объектами. Они не могут быть определены как static-, private-, public-методы. Статичные методы можно написать, однако компилятор не будет наказывать за вызов функции нестатическим способом или в нестатической среде. То же применимо к нестатичным методам

  proc/proc_name(var/argument1, var/argument2)
    [http://www.byond.com/members/?command=reference&path=world world] << "[argument1] [argument2]"

Код выше определяет глобальнукю процедуру. Если вы хотите привязать его на конкретный уровень

==== ..() ====
То же самое, что и <code>super()</code> из Java. Вызывает процедуру родительского класса с тем же именем и параметрами.

Пример:
  /obj/item
    name = "Item"
  
  /obj/item/New() //New() вызывается при создании объекта данного типа. Конструктор, если угодно.
    src.name = "It's an item!"
  
  /obj/item/stack
    name = "Stack"
  
  /obj/item/stack/New() 
    src.name = "It's a stack!"
    ..()

При наличии кода, похожего на пример выше и создании нового объекта типа <code>/obj/item/stack</code>, сначала в мире появится объект с именем "Stack", поскольку это определено по умолчанию. Следом сразу будет вызвана процедура New(). Это изменит имя объекта на "It's a Stack!" но вызов New() родительского типа командой ..() назначит имя "It's an item!". В конце концов, объект получит имя "It's an item!". Команда ..() важна во многих ситуациях, когда что-то определено только в процедуре New() родителя. В Del(), процедуре, которая вызывается преимущественно при удалении объекта, от кода потребуется перейти к корневому Del(), даже чтобы удалить его. Примеры Del() можно найти в коде.

== Важные процедуры ==

=== [http://www.byond.com/members/?command=reference&path=atom%2Fproc%2FNew New()] ===
Процедура вызывается каждый раз, когда создается экземпляр объекта. При необходимости можно присвоить аргументы. Должна вызвать ..() где это применимо, чтобы сработали родительские конструкторы.

Если у вас возникла необходимость в процедуре New() для [[#Variable types|atoms]] с отдельым набором аргументов, убедитесь, что первый аргумент определяет локацию объекта. Пример:
  obj/item/weapon/my_item/New(var/location, var/i)
    ..()
    //Код и все, что он делает

Для создания основного объекта
  [http://www.byond.com/members/?command=reference&path=proc%2Fnew new] /datum/test_datum
Для создания atom (обычно имеет локацию)
  [http://www.byond.com/members/?command=reference&path=proc%2Fnew new] /obj/item/weapon(src.loc)
Для создания своего объекта из примера выше, код будет выглядеть так: цифра 5 - пример значения, примененного к var/i в конструкторе.
  [http://www.byond.com/members/?command=reference&path=proc%2Fnew new] /obj/item/weapon/my_item(src.loc, 5)
где src - владелец процедуры, содержит строку выше. src.loc - локация объекта src.

=== [http://www.byond.com/members/?command=reference&path=datum%2Fproc%2FDel Del()] ===
Процедура, вызываемая перед удалением объекта. Она ДОЛЖНА вызвать ..() в конце, поскольку само удаление происходит в корневой процедуре Del().

Объект удаляется при вызове del(O), где O - объект, подлежащий удалению.

=== attack_hand(mob/M as mob) ===
Вызывается, когда user (M) нажимает на объект пустой активной рукой

=== attack_paw(mob/M as mob) ===
Вызывается, когда monkey (M) нажимает на объект пустой активной рукой

Если своей вариации attack_paw(mob/user) для atom не было расписано, по умолчанию вызовется attack_hand(user)

=== attack_ai(mob/user) ===
Вызывается, когда ИИ/киборг нажимает на объект пустой активной рукой

Если своей вариации attack_ai(mob/user) для atom не было расписано, по умолчанию вызовется attack_hand(user)

=== attack(mob/M as mob, mob/user as mob) ===
Вызывается, когда объект использовался для атаки моба M со стороны user

=== attackby(obj/item/W, mob/user) ===
Вызывается, когда объект атакован user при помощи W (Пример: клик по проводам кусачками)

=== ex_act(severity) ===
Определяет реакцию объекта на взрыв (severity=1-3, 1 - наиболее разрушительный).

=== blob_act() ===
Определяет реакцию предмета на атаку блоба (магмы)

=== emp_act(severity) ===
Определяет реакцию предмета на ЭМИ (severity=1-2, 1 - более серьезные последствия).

=== [http://www.byond.com/members/?command=reference&path=datum%2Fproc%2FTopic Topic(href, href_list)] ===
Вызывается при нажатии на ссылку во всплывающем окне. Пример: увеличение выходной мощности на ячейках SMES. Переменная href_list важна, поскольку является
проанализированной версией аргументов, которые вы добавляете в ссылку. Для создания ссылки во всплывающем окне, добавьте в отображаемый текст следующее:
  <nowiki>dat += </nowiki>[http://www.byond.com/members/?command=reference&path=proc%2Ftext text](<nowiki>"<A href='?src=\ref[src];select=[i]'>[src.name]</a><br>")</nowiki>
Примеры использования ищите в коде.

=== process() ===
Вызывается для всех объектов в каждом тике. Избегайте использования данной процедуры, если возможно, поскольку сильно грузит процессор. Учитывайте, что для некоторых механик избежать её использования нельзя.

== Значение основных переменных SS13 ==

=== Datum ===

Datum-объекты располагают минимальным числом предопределенных переменных. Они присутствуют во всех объектах в игре:
  type //Тип объекта. Если объект имеет тип /obj/item/weapon/shovel (лопата), то выражение: new src.type(src.loc) создаст еще одну лопату в том же тайле.
  parent_type //Родительский тип для /obj/item/weapon/shovel - это /obj/item/weapon.
  tag //Тег используется для помощи в идентификации при использовании нескольких экземплров одного объекта. Он должен быть настроен вручную для каждого экземпляра. Ленивые кодеры и мапперы в результате не используют слишком много тегов. Экземпляры в редакторе карт сортируются по тегам.
  vars //List of object vars the datum has defined

=== Atom ===

Эти переменные делятся между всеми area, mob, obj, turf.

  contents //Список содержимого. Пример: шкафчики хранят содержимое в этой переменной, как и все предметы-контейнеры. All the items on a turf are in the turf's contents var.
  density //Плотность, при значении 0, игрок сможет пройти через объект, при значении 1 - не сможет.
  desc //Описание. Отображает текст под именем объекта при его подробном изучении (Shift+ЛКМ или ПКМ->Examine).
  dir //Направление объекта. Спрайты обладают перменной направления, которая может принимать до 8 действительных состояний.
  gender //Не используется(?)
  icon //Файл формата .dmi, в котором сохранены спрайты. Выделить одиночными кавычками. (Пример: 'items.dmi')
  icon_state //Наименование спрайта в файле .dmi. Если имя не задано или не подходит по требованиям, то будет использоваться безымянный спрайт из этого файла. Если же имя не соответствует какому-либо спрайту, то по умолчанию будет использоваться пустой.
  invisibility //Невидимость, определяет, что можно будет увидеть, а что - нельзя. 
  infra_luminosity //Инфракрасное освещение. Используется только мехами.
  underlays //Список изображений (см. процедуру image()), находящихся НИЖЕ текущего спрайта.
  overlays //Список изображений (см. процедуру image()), находящихся ВЫШЕ текущего спрайта.
  loc //Содержит ссылку на turf-файл, в котором находится объект в данный момент.
  layer //Слой. Численная переменная, определяющая распределение объектов по слоям. Столы со значением слоя 2.8 всегда расположены под большинством объектов, которые имеют значение слоя 3.0. Можно назначать до 20, который зарезервирован для отображения HUD.
  luminosity //Освещение. Определяет, с какой силой объект излучает свет. Заметьте, что подбор и сброс излучающих свет объектов нужно обрабатывать особым образом. За примером можно обратиться к коду фонарика.
  mouse_over_pointer // не используется
  mouse_drag_pointer //(почти) не используется
  mouse_drop_pointer //не используется
  mouse_drop_zone //не используется
  mouse_opacity //редко используется, см. на странице источника.
  name //Наименование объекта, отображается в строке состояния в левом-нижнем углу экрана или при осмотре предмета (Shift+ПКМ или ПКМ->Examine)
  opacity //Прозрачность. Определяет, можно ли видеть что-либо за этим объектом. Значение 0 для объектов, просматриваемых насквозь (окна, пол, решетки), 1 для непрозрачных объектов (стены, мехи, закрытые шлюзы без окон).
  pixel_x //Смещение по оси Х относительно исходной позиции в пикселях. pixel_x = -5 сдвинет объект на 5 пикс влево, pixel_x = 5 сдвинет на 5 пикс вправо. Пример: Метод New() для ЛКП (APC), также можно понаблюдать, как пульт управления пожарной сигнализацией определен на карте. 
  pixel_y //Смещение по оси Y относительно исходной позиции в пикселях. pixel_y = -5 сдвинет объект на 5 пикс вниз (южнее), pixel_y = 5 сдвинет на 5 пикс вверх (севернее).
  pixel_z //Применяется в изометрических картах, в SS13 не используется.
  suffix //Редко используется. См. в источнике.
  text //Представление объекта в текстовых клиентах. Не используется.
  type //Тип объекта
  vars //См. [[#Datum|Datum]]
  verbs //Действия контекстного меню, которые можно совершить над объектом (появляются при нажатии ПКМ на объекте).
  x //Координата по X, только чтение. Измените значение переменной loc, чтобы сдвинуть объект, или используйте встроенные функции.
  y //Координата по Y, только чтение. 
  z //Координата по Z, только чтение (cектор, Z-level).

=== Зоны (Area) ===

  var/requires_power = 1 //Необходимость в питании. Установлено на 0 для зон, которым не нужны ЛКП (APC) для работы оборудования (такие, как Центральное Командование). Всем остальным установлено значение 1.
  var/music = null //Музыкальная композиция, которая проигрывается при входе в зону.
  [http://www.byond.com/members/?command=reference&path=atom%2Fvar%2Fluminosity luminosity] = 0 //Освещенность. Установлено на 1 для зон, которые должны быть освещены все время (космос, Центральное Командование). Динамическое освещение при этом выключено (sd_lightning = 0).
  var/sd_lighting = 0 //Динамическое освещение. Необходимость рассчитывать освещенность тайлов этой зоны. Выключите, если освещенность для зоны включена (luminosity = 1).

Большинство остальных переменных существуют только в технических целях и не должны затрагиваться, кроме как в существующих процедурах, в которых были определены:
  [https://github.com/tgstation/-tg-station/blob/master/code/game/area/Space%20Station%2013%20areas.dm code/game/area/Space Station 13 areas.dm] 

=== Мобы (Mob) ===

Для мобов определено огромное количество переменных. Взгляните на следующие файлы:
  [http://code.google.com/p/tgstation13/source/browse/trunk/code/defines/mob/mob.dm code/defines/mob/mob.dm]
  [http://code.google.com/p/tgstation13/source/browse/trunk/code/defines/mob/dead/observer.dm code/defines/mob/dead/observer.dm]
  [http://code.google.com/p/tgstation13/source/browse/trunk/code/defines/mob/living/living.dm code/defines/mob/living/living.dm]
  [http://code.google.com/p/tgstation13/source/browse/trunk/code/defines/mob/living/carbon/carbon.dm code/defines/mob/living/carbon/carbon.dm]
  [http://code.google.com/p/tgstation13/source/browse/trunk/code/defines/mob/living/carbon/human.dm code/defines/mob/living/carbon/human.dm]
  [http://code.google.com/p/tgstation13/source/browse/trunk/code/defines/mob/living/carbon/monkey.dm code/defines/mob/living/carbon/monkey.dm]
  [http://code.google.com/p/tgstation13/source/browse/trunk/code/defines/mob/living/silicon/silicon.dm code/defines/mob/living/silicon/silicon.dm]
  [http://code.google.com/p/tgstation13/source/browse/trunk/code/defines/mob/living/silicon/ai.dm code/defines/mob/living/silicon/ai.dm]
  [http://code.google.com/p/tgstation13/source/browse/trunk/code/defines/mob/living/silicon/robot.dm code/defines/mob/living/silicon/robot.dm]
Также существуют дополнительные файлы для чужих, лярв, лицехватов и т.п. существ, но файлы выше содержат большинство переменных, которые вам понадобятся.

=== Объекты (Obj) ===

  var/m_amt = 0	// Содержание металла в объекте. Используется для определения количества металла (Metal), которое будет получено после переработки предмета в автолате (или же потребуется для его производства).
  var/g_amt = 0	// Содержание стекла в объекте. Используется для определения количества стекла (Glass), которое будет получено после переработки предмета в автолате (или же потребуется для его производства).
  var/w_amt = 0	// Содержание отходов. Не используется
  var/origin_tech = null //Используется для определения размера бонусов исследования, которые получит Отдел Исследований (РнД). Примеры смотрите в коде объектов.
  var/reliability = 100	//Используется некоторыми устройствами для определения их надежности - величины шанса в процентах, что предмет сработает, как надо.
  var/unacidable = 0 //Невосприимчивость к кислотам. При значении 1 объект нельзя уничтожить кислотой.
  var/throwforce = 0 //Количество урона, который пройдет по целевому объекту при броске в него другим предметом.

Больше переменных здесь:
  [http://code.google.com/p/tgstation13/source/browse/trunk/code/defines/obj.dm code/defines/obj.dm]

==== Предметы (Item) ====

Предметы (Items) - объекты, которые игрок может поднять. В зависимости от их функционала они делятся на несколько категорий.

/obj/item определен в файле:
  [http://code.google.com/p/tgstation13/source/browse/trunk/code/defines/obj.dm code/defines/obj.dm]

Он добавляет следующие переменные (Далее идут только самые основные, см. файл для полного списка):
  var/force = null //Сила удара. Определяет размер урона, который получит цель при ударе предметом в руке. Малые предметы обычно не наносят урона, средние наносят 5-10 единиц урона, редкие и мощные предметы могут нанести 10-15 единиц урона, двуручные - от 15 единиц, и т.д. Предметы синдиката могут наносить от 40 единиц урона и выше.
  var/item_state = null //Определяет, какой спрайт будет использоваться для предмета в руке из файлов icons/mob/items_lefthand.dmi и items_righthand.dmi.
  var/damtype = "brute" //Тип урона, наносимый предметом.
  var/health = null //Прочность предмета. Используется в некоторых случаях для того, чтобы определить, может ли предмет сломаться при использовании или получении урона.
  var/hitsound = null //Звук, который будет воспроизводиться при ударе этим предметом. Используется нечасто.
  var/w_class = 3.0 //Вес (а точнее, габариты) предмета.
    // w_class = 1 - предмет маленький и может поместиться в карманах (дискета, ручка, пачка сигарет)
    // w_class = 2 - предмет небольшой, не лезет в карман, но легко помещается в коробку (папка для бумаг, анализатор, распылитель)
    // w_class = 3 - предмет средних размеров, не помещается в коробке, но можно переносить в рюкзаке (коробки, листы металла, металлические прутья)
    // w_class = 4 - предмет крупный и не лезет даже в рюкзак (рюкзак, кирка, пожарный топор)
    // w_class = 5 - предмет имеет неопределенные габариты.
  var/wielded = 0 //Используется для двуручных предметов, которые можно переносить в одной руке, но требуют хват двумя руками для их использования. Условия, при которых происходит переход между хватом двумя руками (wielding) и переносом в оной руке (unwielding) описываются в коде. Все предметы вначале имеют значение этой переменной на 0.
  var/twohanded = 0 // Установите на 1, если предмет двуручный.
  flags = FPRINT | TABLEPASS //Флаги

==== Машины (Machinery) ====

Определены в:
  [http://code.google.com/p/tgstation13/source/browse/trunk/code/defines/obj/machinery.dm code/defines/obj/machinery.dm]

Машины (Machinery) - объекты, которые не могут быть подняты и как правило требуют питание для работы. Для них определены следующие переменные:
  var/use_power = 0 //определяет, будет ли машина потреблять энергию, а также её количество.
    //use_power = 0 - энергия не используется
    //use_power = 1 - пассивное электропотребление
    //use_power = 2 - активное электропотребление
  var/idle_power_usage = 0 //Количество энергии в ваттах (Вт, W), расходуемое машиной в пассивном режиме (use_power = 1) в один игровой тик
  var/active_power_usage = 0 //Количество энергии в ваттах (Вт, W), расходуемое машиной в активном режиме (use_power = 2) в один игровой тик
  var/power_channel = EQUIP //Определяет категорию устройства на ЛКП (APC). EQUIP (цепь для оборудования), ENVIRON (цепь для систем жизнеобеспечения) или LIGHT (цепь освещения).
  var/list/component_parts = null //Список частей, которые потребуются помимо платы для сборки машины в корпусе (machine frame).

=== Покрытие (Turf) ===

  var/intact = 1 //Определяет, будет ли покрытие скрывать под собой коммуникации (трубы, проводку и т.п.). Значение 1 будет скрывать коммуникации, 0 - не будет. Скрыты будут только трубы и провода с установленным level=1. Установите level=2, чтобы не скрывать коммуникации.
  var/blocks_air = 0 //Определяет воздухопроницаемость. Не пропускает воздух при значении 1.
Существуют и другие переменные, но которые тесно связаны с атмосферикой, код которой крайне не рекомендуется трогать, чтобы не сломать вообще все.
  [http://code.google.com/p/tgstation13/source/browse/trunk/code/defines/turf.dm code/defines/turf.dm]

==== Симулируемые (Simulated) ====

Симулируемые полы (simulated floors) - это тайлы, которые симулируют движение воздушных масс и температуру. Станция практически полностью состоит из таких, тогда как Центральное Командование использует несимулируемые полы, чтобы не допустить массивных и ненужных лагов.

  var/wet = 0 //Мокрый пол. При значении 1 игрок поскользнется при пробеге по нему.
  var/thermite = 0 //Термитный слой. Принимает значение 1, когда на тайл вылит термит.

===== Симулируемые полы (Simulated floors) =====

  var/icon_regular_floor = "floor" //Определяет, какую иконку должна иметь стальная разновидность пола. Определяется при создании пола (процедура New()). Если icon_state (спрайт состояния) пола в этой точке является одним из тех, что определены в глобальной переменной icons_to_ignore_at_floor_init , то этой переменной присвоится значение "floor". Список icons_to_ignore_at_floor_init list содержит следующие icon_states (спрайты состояния) из файла icons/turf/floors.dmi: broken (сломанный), plating (обшивка), burnt (обоженный) and non-steel (не стальной).
  heat_capacity = 10000 //Когда очаг возгорания на тайле превышает это число, пол с некоторым шансом может расплавиться. Чем выше число, там выше шанс расплавления.
  var/broken = 0 //В основном только определяет, получите ли вы плитку обратно, если подцепите её ломом. Сломанные плитки пропадают при снятии с пола.
  var/burnt = 0 //TВ основном только определяет, получите ли вы плитку обратно, если подцепите её ломом. Обоженные плитки пропадают при снятии с пола.
  var/obj/item/stack/tile/floor_tile = new/obj/item/stack/tile/steel //определяет, какая плитка лежит на полу

Симулируемые полы определены в файле:
  [http://code.google.com/p/tgstation13/source/browse/trunk/code/game/turf.dm code/game/turf.dm]

===== Симулируемые стены (Simulated walls) =====

Особо отличающихся переменных не содержат.

Определены в:
  [http://code.google.com/p/tgstation13/source/browse/trunk/code/defines/turf.dm code/defines/turf.dm]


[[Category:Guides]] [[Category:Game Resources]]
{{Contribution Guides}}