actionbars

словарь со своим кодом
Панель быстрых действий игрока: словарь «номер кнопки → что на ней». Кнопок столько, сколько ключей в умолчании компонента (поле «По умолчанию»). Кнопка — {kind, id} либо null (пуста). kind — что стоит на кнопке: spell — заклинание, item — вещь. id у заклинания — идентификатор префаба заклинания, тот же ключ, что в книге заклинаний; у вещи — номер ячейки инвентаря, где вещь лежит. Присланное изменение дописывается в раскладку: кнопка, которой в нём нет, остаётся как была, пустое значение её очищает. Одно заклинание либо одна ячейка инвентаря стоит лишь на одной кнопке: поставленное на новую кнопку снимается с прежней, а присланное одной записью на несколько кнопок остаётся на кнопке с большим номером. Кнопку с вещью правит инвентарь, когда вещь переезжает в другую ячейку либо уходит из своей: он ставит раскладке свою правку. Что при этом становится с кнопкой, сказано в описании компонента inventory. Все проверки кнопок делает компонент, и исход для негодной кнопки — номер, которого на панели нет, заклинание не из книги заклинаний, пустая ячейка инвентаря, kind не spell и не item — зависит от того, откуда пришло значение. Сохранённая раскладка при появлении игрока на карте и правка от инвентаря законно расходятся с нынешним составом: кнопка с номером вне панели молча отбрасывается, прочая негодная кнопка молча очищается, недостающие в сохранённой раскладке кнопки достраиваются пустыми. Так же разбирается раскладка, которую игрок прислал в том же кадре: правка от инвентаря вбирает её в себя. В раскладке из команды игрока любая негодная кнопка — нарушение, номер вне панели тоже, даже с пустым значением: игрок отключается от игры. Клиент игры заводит ровно те кнопки, что есть в умолчании компонента, и ставит на кнопку то, что игрок видит, поэтому нарушение приходит лишь от программы, которая шлёт команды игрока мимо клиента игры. Пустую ячейку на кнопку не ставит и человек: следующее действие он делает, уже увидев ответ игры на прежнее. Уровень вложенности значения (maxCompareLevel) у компонента не меняют: при другом значении код компонента отбивает каждое значение ошибкой — с тем же исходом, что неверная скорость (описание компонента speed).
Стартовое значение
{
    "1": {
        "kind": "",
        "id": ""
    },
    "2": {
        "kind": "",
        "id": ""
    },
    "3": {
        "kind": "",
        "id": ""
    },
    "4": {
        "kind": "",
        "id": ""
    },
    "5": {
        "kind": "",
        "id": ""
    },
    "6": {
        "kind": "",
        "id": ""
    },
    "7": {
        "kind": "",
        "id": ""
    }
}
Кому выдаётся
player
Каждая сущность этих видов получает компонент при создании.
Код компонента — срабатывает, когда значение меняется, и когда сущность появляется на карте
Что платформа подаёт в код
Код исполняется телом функции, и платформа подаёт в него эти переменные:
  • $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;
К игре