spell_book

словарь со своим кодом
Книга заклинаний: какими заклинаниями владеет сущность, игрок в том числе. Ключ — идентификатор префаба вида spell, значение — true. Присланное изменение дописывается в книгу: непереданное заклинание остаётся как было, пустое значение его снимает. Умолчание компонента (поле «По умолчанию») книгой не является — это справочник на всю игру, и разделов в нём два, у каждого свой смысл и своя форма ключа. Раздел «spell» раскладывает заклинания по стихиям: ключ — идентификатор префаба заклинания, значение — название его стихии. Название свободное: одинаковое у разных заклинаний означает одну стихию, разное — разные. Заклинание, которого в разделе нет, из книги не выпадает, но стихии за ним не закреплено, поэтому новое заклинание сюда вписывают. Раздел «element» задаёт цвет стихии: ключ — название стихии, дословно такое же, как в первом разделе; значение — цвет вида #RRGGBB. Цвет принадлежит стихии, а не заклинанию: у стихии он записан один раз, сколько бы заклинаний в неё ни входило. Стихия, которой в этом разделе нет, из игры не выпадает — цвет ей подбирается автоматически, поэтому вписывают сюда только те стихии, чей цвет выбран осознанно. Сущности без заданной книги — игроку в том числе — умолчание достаётся при создании как значение компонента, но книгой не становится: значение, целиком совпадающее со справочником, за состав книги не принимается — такая сущность остаётся с пустой книгой. Уровень вложенности значения (maxCompareLevel) у этого компонента оставляют пустым. При выставленном уровне код компонента отбивает каждое значение ошибкой — с тем же исходом, что неверная скорость (описание компонента speed).
Стартовое значение
{
    "spell": {
        "firebolt": "Огонь",
        "heal": "Тело",
        "icebolt": "Вода",
        "lightbolt": "Воздух",
        "lightbolt_blue": "Воздух",
        "thunderbolt2": "Воздух"
    },
    "element": {
        "Огонь": "#FF732E",
        "Вода": "#4D99FF",
        "Воздух": "#80E0FF",
        "Тело": "#73E67A"
    }
}
Кому выдаётся
bot enemy player
Каждая сущность этих видов получает компонент при создании.
Код компонента — срабатывает, когда значение меняется, и когда сущность появляется на карте
Что платформа подаёт в код
Код исполняется телом функции, и платформа подаёт в него эти переменные:
  • $object — сущность, которой присваивают значение компонента
  • $value — присваиваемое значение; в самом компоненте на этот момент ещё лежит прежнее

Записано будет то, что лежит в $value после кода: платформа возвращает его сама, свой return тоже годится — так значение правят перед записью либо отказывают в смене. Пустое значение выражается пустой строкой либо пустым набором, null запрещён. Код срабатывает на смену значения и на появление сущности на карте; повторная запись прежнего значения его не запускает. В коде компонента менять компоненты нельзя, ставить события можно.

Кроме них коду доступны классы фреймворка игры и подключённых к ней библиотек — их зовут по имени класса; что именно они умеют, сказано на их страницах.

<?php
# Код срабатывает и при создании существа, и при каждой смене состава книги из события

$component = ComponentCollection::list()['spell_book'];

// на случай если кто то захочет изменить в админке (это не то что плохо - просто не надо)
// сравниваем с «не задано»: ноль тоже уровень, и на проверке истинности он проходил бы молча
if($component->maxCompareLevel !== null)
	throw new Error('Компонент spell_book не должен иметь в настройках предела уровня анализа уникальных данных для Рассылки');

// Умолчание компонента книгой НЕ является — это справочник на всю игру: состав стихий и их цвета
// разделами. Существу, которому книга не задана, справочник достаётся ЦЕЛИКОМ как значение при создании —
// по совпадению с умолчанием его и отличаем, отдавая такому существу пустую книгу. Разбирать значения по
// типу (строка — значит стихия) нельзя: форма справочника меняется независимо от этого кода, и на
// структурном значении такая проверка молча раздала бы все заклинания каждому существу разрешённого вида.
// При создании существа без своей книги справочник уже лежит и прежним значением — его тоже за книгу не принимаем.
$current_value = $object->components->isset('spell_book') ? $object->components->get('spell_book') : array();
if($current_value == $component->default)
	$current_value = array();
$incoming = (is_array($value) && $value != $component->default) ? $value : array();

$spells = array();

foreach(array_keys($current_value + $incoming) as $key)
{
	// присланное перекрывает прежнее: пустое значение снимает заклинание, отсутствие ключа оставляет как было
	$own = array_key_exists($key, $incoming) ? $incoming[$key] : ($current_value[$key] ?? null);

	if(empty($own))
		continue;

	$spells[$key] = true;
}

// Отдельного справочника заклинаний клиенту не шлём: заклинание — обычный префаб, и его имя,
// описание, стоимость и группа команды едут каталогом префабов наравне с прочим контентом.
// Компонент несёт только флаги обладания, из них клиент и собирает книгу.
$value = $spells;
К игре