{
"spell": {
"firebolt": "Огонь",
"heal": "Тело",
"icebolt": "Вода",
"lightbolt": "Воздух",
"lightbolt_blue": "Воздух",
"thunderbolt2": "Воздух"
},
"element": {
"Огонь": "#FF732E",
"Вода": "#4D99FF",
"Воздух": "#80E0FF",
"Тело": "#73E67A"
}
}
$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;