$object — сущность, которой присваивают значение компонента$value — присваиваемое значение; в самом компоненте на этот момент ещё лежит прежнееЗаписано будет то, что лежит в $value после кода: платформа возвращает его сама, свой return тоже годится — так значение правят перед записью либо отказывают в смене. Пустое значение выражается пустой строкой либо пустым набором, null запрещён. Код срабатывает на смену значения и на появление сущности на карте; повторная запись прежнего значения его не запускает. В коде компонента менять компоненты нельзя, ставить события можно.
Кроме них коду доступны классы фреймворка игры и подключённых к ней библиотек — их зовут по имени класса; что именно они умеют, сказано на их страницах.
<?php
/** @var array $value входящее значение, прокинуто closure-обёрткой ComponentCollection::trigger */
# Компонент несёт ТОЛЬКО множители торговца. Базовые цены вещей лежат у самих вещей
# (компонент price) и едут к клиенту своим каналом — вместе с префабами: цена нужна и там, где
# торговца нет вовсе (свой инвентарь, добыча трупа, вещь на земле), а справочник внутри
# торговца возил бы её копию в каждой лавке и только туда, где лавка рядом.
if(!is_array($value))
throw new Error('Компонент trade задаётся парой множителей buy и sell');
# Пустое значение — ценник торговца ещё не задан, и это НОРМА, а не ошибка заполнения: торговец тогда
# не продаёт и не скупает. Проверять множители есть смысл только у заполненного: там автор заявил цены,
# и половинчатая запись — его ошибка.
if($value)
{
foreach(['buy', 'sell'] as $rate)
{
if(!isset($value[$rate]) || !is_numeric($value[$rate]) || $value[$rate] < 0)
throw new Error('Множитель "'.$rate.'" компонента trade обязателен и не может быть отрицательным');
}
# пересобираем состав: лишние ключи в значении не хранятся и не уезжают клиенту
$value = ['buy' => (float)$value['buy'], 'sell' => (float)$value['sell']];
}