{
"1": {
"kind": "",
"id": ""
},
"2": {
"kind": "",
"id": ""
},
"3": {
"kind": "",
"id": ""
},
"4": {
"kind": "",
"id": ""
},
"5": {
"kind": "",
"id": ""
},
"6": {
"kind": "",
"id": ""
},
"7": {
"kind": "",
"id": ""
}
}
$object — сущность, которой присваивают значение компонента$value — присваиваемое значение; в самом компоненте на этот момент ещё лежит прежнееЗаписано будет то, что лежит в $value после кода: платформа возвращает его сама, свой return тоже годится — так значение правят перед записью либо отказывают в смене. Пустое значение выражается пустой строкой либо пустым набором, null запрещён. Код срабатывает на смену значения и на появление сущности на карте; повторная запись прежнего значения его не запускает. В коде компонента менять компоненты нельзя, ставить события можно.
Кроме них коду доступны классы фреймворка игры и подключённых к ней библиотек — их зовут по имени класса; что именно они умеют, сказано на их страницах.
<?php
# Этот код и при создании существ проверит значение компонента и далее из события что будет меняться
$component = ComponentCollection::list()['actionbars'];
// на случай если кто то захочет изменить в админке (это не то что плохо - просто не надо)
if($component->maxCompareLevel!=2)
throw new Error('Компонент actionbars не должен иметь в настройках предела уровня анализа уникальных данных для Рассылки кроме как 2');
$current_value = $object->components->get('actionbars');
$spells = $object->components->get('spell_book');
$inventory = $object->components->get('inventory');
// Проверки кнопок, присланных клиентом прямо (Block::$from_client), — единственные: команда ui/actionbars/index их не
// повторяет. Сохранённая раскладка и каскад инвентаря, переставивший кнопки от имени сервера, законно расходятся с
// нынешним составом — их негодную кнопку цикл ниже очищает. От клиента kind не spell и не item — нарушение
// (снятие с карты). Заклинание не из книги — тоже: книгу во время игры не меняет ни один код игры (решение автора
// 2026-10-14). Пустой слот инвентаря — нарушение: между своими действиями человек дожидается ответа сервера.
// Номер вне панели — тоже: клиент заводит кнопки по ключам того же умолчания компонента.
if(Block::$from_client)
foreach($value as $num => $bar)
{
if(!array_key_exists($num, $component->default))
throw new Error('Кнопка '.$num.' панели: такой кнопки нет — у панели кнопок '.count($component->default));
if(empty($bar))
continue;
$present = match($bar['kind'] ?? null) {
'spell' => !empty($spells[$bar['id']]),
'item' => !empty($inventory[$bar['id']]),
default => throw new Error('Кнопка '.$num.' панели: kind '.json_encode($bar['kind'] ?? null).' — допустимы spell и item'),
};
if(!$present)
throw new Error('Кнопка '.$num.' панели: '.($bar['kind'] == 'spell' ? 'заклинания '.$bar['id'].' нет в книге заклинаний' : 'слот инвентаря '.$bar['id'].' пуст'));
}
// эти танц с бубнами от 1 нужны для c# что бы передавать не как массив данные а как объект (тк если от 0 будет отсчет c# воспримит как массив , несмотря на то что там принудительно стоит Dictionary)
$actionbars = array();
for($i=1;$i<=count($component->default);$i++)
{
if(!empty($value[$i]))
{
switch($value[$i]['kind'])
{
case 'spell':
if(empty($spells[$value[$i]['id']]))
{
$value[$i] = null;
}
break;
case 'item':
// номер слота в инвентаре
if(empty($inventory[$value[$i]['id']]))
{
$value[$i] = null;
}
break;
default:
$value[$i] = null;
break;
}
// так раписываю что бы точно никакие лишние поля не попали
if(!empty($value[$i]))
$current_value[$i] = ['kind'=>$value[$i]['kind'], 'id'=>$value[$i]['id']];
else
$current_value[$i] = null;
}
elseif(array_key_exists($i, $value))
$current_value[$i] = null;
// Сохранённый набор может держать не все слоты (правка мимо игры — админка либо MCP): недостающий
// достраивается пустым — иначе цикл рвётся на первом же отсутствующем ключе, а вместе с ним и вход игрока в игру.
// Полный набор отсюда уходит в сохранение, так что дырявый чинится сам при ближайшем входе.
$actionbars[$i] = $current_value[$i] ?? null;
}
// Дедупликация: при перемещении на новый слот старый очищается
$seen = [];
for ($i = 1; $i <= count($actionbars); $i++) {
if (!empty($actionbars[$i])) {
$key = $actionbars[$i]['kind'] . ':' . $actionbars[$i]['id'];
if (isset($seen[$key])) {
$prev = $seen[$key];
if (array_key_exists($i, $value) && !empty($value[$i])) {
$actionbars[$prev] = null;
$seen[$key] = $i;
} else {
$actionbars[$i] = null;
}
} else {
$seen[$key] = $i;
}
}
}
$value = $actionbars;