DM Guide 18: различия между версиями

''Это 18 глава перевода оригинального руководства по Dream Maker от разработчиков.''

[http://wiki.ss13.ru/index.php?title=All_about_the_code Остальные главы руководства и статьи о программировании на коде BYOND от любителей на русском.]

[http://www.byond.com/docs/guide/chap18.html Оригинальная 18 глава руководства на английском языке]

''Он тронул рыб, говоря страшным голосом: "Рыбы, рыбы, вы выполняете свой долг?" — на что рыбы, подняв головы, ответили: "Да, да. Если вы рассчитываетесь, мы рассчитываемся. Если вы платите по своим долгам, мы платим по своим. Если вы летаете, мы завоевываем и довольствуемся этим."'' — Визирь, который был наказан, Арабские Ночи

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

== Определение типа данных ==

Чтобы определить новый тип данных проще выделить из корня программы, чем из существующего типа объектов. Следующий код демонстрирует пример кода, который определяет новый тип данных - ''Quest''.

Quest

var

mob/sponsor

quest_obj_type

reward_obj_type

desc

proc

Check()

var/mob/M

var/obj/O

for(M in view(sponsor,1))

O = locate(quest_obj_type) in M

if(O)

Reward(M,O)

return 1

Reward(mob/M,obj/O)

var/obj/R = new reward_obj_type(M)

O.Move(sponsor)

M << "You have completed the quest!"

M << "[sponsor] takes [O] and rewards you with \an [R]."

Как вы видите, переменные объекта и процессы обозначаются так же, как и в любых других объектах. Наследование работает точно так же, так что вы можете извлекать новые типы из уже существующих.

== Переменные объекта ==

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

• '''type''' - содержит путь к объекту.

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

• '''vars''' – список переменных, относящихся к объекту. Элементы списка – названия переменных. Каждое ассоциируется с собственным значением переменной. Смотрите раздел 12.7 для примера.

== Операции объекта ==

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

''New'' - [[DM Guide 7#Создание и удаление объектов|7.2]]<br/>

''Del'' - [[DM Guide 7#Создание и удаление объектов|7.2]]<br/>

''Topic'' - [[DM Guide 7#Topic|7.6]]<br/>

''Read'' - 12.4<br/>

''Write'' - 12.4<br/>

== Создание объекта ==

Команда ''new'' используется для создания объектов, а ''del'', соответственно, для их уничтожения. Следующий пример показывает, как можно использовать описанный до этого объект ''quest''.

mob/king

var/quests[0]

verb/beg() //get a new quest

set src in view()

var/Quest/q = RandQuest()

usr << q.desc

quests += q

verb/bow() //finish quest

set src in view()

var/Quest/q

for(q in quests)

if(q.Check())

quests -= q

return

proc/RandQuest()

var/qtype = pick(typesof(/Quest) - /Quest)

var/Quest/q = new qtype()

q.sponsor = src

return q

Quest/Goblin

quest_obj_type = /obj/corpse/goblin

reward_obj_type = /obj/potion/newlife

desc = "Bring us the head of a goblin and ye shall have new life!"

Quest/Ring

quest_obj_type = /obj/magic_ring

reward_obj_type = /obj/wand/lightning

desc = "Bring us a golden ring and thy reward shall be great!"

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

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

Заметьте, что мы никогда не удаляли квест, когда он заканчивался, а просто убирали его из списка. С того момента, как на этот объект больше никто нигде не ссылается, он будет автоматически удален.