$object — сущность, уходящая со сцены$new_map — карта, на которую сущность переходит; null — уходит совсем: выход игрока либо снятие с карты$spawn — точка появления сущности — x, y, z: её получают загруженные при старте карты и возвращённые миром после снятия с карты, созданные по ходу игры приходят сюда с nullКод выхода ничего не возвращает. Снятие с карты отложено до конца кадра, поэтому состояние сущности здесь ещё целое: по $spawn код решает, заказывать ли её возвращение.
Кроме них коду доступны классы фреймворка игры и подключённых к ней библиотек — их зовут по имени класса; что именно они умеют, сказано на их страницах.
<?php
switch ($object->kind)
{
case 'player':
// если уходим с картой и есть какая то точка к которой идем возможно мы как раз идем на другую карту и надо пересчитать координаты
if($new_map)
{
// если в момент выхода из игры мы куда то шли и мы переходим на нову карту в этот момент и эта карта соседняя - пересчитаем относительно нее координат
if($object->events->get('move/walk')->action=='to' && !empty(Map2D::sides()[$new_map]))
{
$data = $object->events->get('move/walk')->data;
Map2D::encode2dCoord($data['x'], $data['y'], MAP_ID, $new_map);
// перезпишет
$object->events->add('move/walk', 'to', $data);
}
// Забор, укладывание и выбор квеста, присланные до перехода границей, ждали своего хода и уехали бы с игроком:
// на новой карте их сущность — соседняя, и исполненная там команда отключила бы игрока как присланная неверным
// клиентом, хотя слал он её, стоя рядом на её карте. Это гонка: команда снимается с записью в журнал предупреждений.
// Группы названы строкой у каждого вызова, не ключом перечня: так проверка занятости параметров видит, что
// данных этих команд здесь не читают, и параметр команды можно убрать.
// Вычитано: автор проекта в журнале предупреждений, без вычитчика: правка текста до 400 знаков без нового понятия (CLAUDE.md).
if($object->events->isset('ui/inventory') && in_array($action = $object->events->get('ui/inventory')->action, ['take', 'put']))
{
$object->warning('команда ui/inventory/'.$action.' снята: игрок перешёл на карту '.$new_map.' до её исполнения');
$object->events->remove('ui/inventory');
}
if($object->events->isset('ui/dialog') && $object->events->get('ui/dialog')->action == 'quest')
{
$object->warning('команда ui/dialog/quest снята: игрок перешёл на карту '.$new_map.' до её исполнения');
$object->events->remove('ui/dialog');
}
}
break;
default:
// Возврат существа на точку появления: точка приходит третьим параметром и есть только у сущностей,
// загруженных при старте карты, и у них же, уже вернувшихся (точка уходит в addLater и едет дальше):
// рождённые по ходу игры (призыв, снаряд, брошенный игроком предмет) уходят без возврата. Пауза —
// компонент respawn_delay: сущность вида, к которому он не привязан, тоже уходит без возврата. Переход
// на другую карту возвратом НЕ является — там существо продолжает жить, и состояние едет вместе с ним.
if($spawn && !$new_map && $object->components->isset('respawn_delay'))
{
// В заказ уходит ВСЁ состояние, а не отобранные поля: перечень переносимого молча терял бы и собственные
// события сущности (их задаёт её запись, а не префаб), и каждое поле, заведённое потом. Приведение
// к живому идёт одним местом ниже.
$components = [];
foreach ($object->components->keys() as $name)
$components[$name] = $object->components->get($name);
$prefab = World::prefabGet($object->prefab);
$groups = EventCollection::list();
$events = [];
foreach ($object->events->keys() as $name)
{
$group = $object->events->get($name);
if (!$group->action)
{
// Пустая группа, в которую новое воплощение само поставило бы постоянную команду (стартовую префаба
// либо вида), выключена записью сущности: без отметки «выключено» возврат включил бы её заново —
// существо с выключенным поиском целей вернулось бы нападающим. Прочая пустая группа — отработавшая
// разовая команда, переносить нечего.
$start = isset($prefab['event'][$name]) ? (((array)$prefab['event'][$name])['action'] ?? null) : null;
if ($start === null && isset($groups[$name]->entity[$object->kind]))
foreach ($groups[$name]->event as $action => $event)
if ($event->isAutoStart)
{
$start = $action;
break;
}
if ($start !== null && !empty($groups[$name]->event[$start]->isPersist))
$events[$name] = ['action' => ''];
continue;
}
// Право на добычу лежит параметрами своего отсчёта и в новое воплощение не едет — иначе
// существо вернулось бы с добычей, закреплённой за игроками прошлой смерти. Бой прошлой жизни —
// атака по цели, ждущий урон и оглушение от удара — тоже: вернувшееся существо било бы своего
// убийцу; в бой оно входит своим поиском целей.
if (in_array($name, ['status/lootfree', 'fight/melee', 'fight/bolt', 'status/hurt', 'status/stagger']))
continue;
// Форма пакета создания — ровно действие и его параметры: столько же разворачивает стартовая
// декларация префаба. Прочие поля группы (время) описывают прожитый такт, а не новое воплощение.
$events[$name] = ['action' => $group->action, 'data' => $group->data];
}
// Приведение к живому. Запас и его потолок — пара: перенесёшь один без второго — получишь запас
// выше своего потолка, и код потолка отобьёт создание ошибкой. Потолок переносим только когда он
// отличается от префабного — это персональная настройка ЗАПИСИ существа, и снять её значит молча
// потерять; совпал с префабом — снимаем оба, иначе вморозим в заказ значение префаба на момент
// смерти, и правка префаба до возврата не доедет.
$prefabComponents = $prefab['component'] ?? [];
foreach (['hp' => 'hp_max', 'mp' => 'mp_max'] as $pool => $cap)
{
if (isset($components[$cap]) && ($prefabComponents[$cap] ?? null) != $components[$cap])
$components[$pool] = $components[$cap];
else
unset($components[$pool], $components[$cap]);
}
// Добыча не переносится — иначе существо вернётся с уже обысканным трупом.
unset($components['loot']);
World::addLater($object->prefab, [
'map' => $object->map,
'x' => $spawn['x'],
'y' => $spawn['y'],
'z' => $spawn['z'],
'slug' => $object->slug,
'components' => $components,
'events' => $events,
], $object->components->get('respawn_delay'), $spawn);
}
break;
}