код выхода

Свой код на уход сущности с карты — переход на другую карту либо выход игрока: например, заказывает возвращение сущности
Код игры — он выполняется в этот момент поверх готового фреймворка
Что платформа подаёт в код
Код исполняется телом функции, и платформа подаёт в него эти переменные:
  • $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;
}
К игре