код перемещения

Свой код перемещения сущностей: им игра меняет правила движения по карте
Код игры — он выполняется в этот момент поверх готового фреймворка
Что платформа подаёт в код
Код исполняется телом функции, и платформа подаёт в него эти переменные:
  • $object — сущность, сменившая положение
  • $old — прежнее положение; при появлении сущности на карте — null

Код перемещения ничего не возвращает. В нём нельзя менять координаты и создавать сущности.

Кроме них коду доступны классы фреймворка игры и подключённых к ней библиотек — их зовут по имени класса; что именно они умеют, сказано на их страницах.

<?php
/** @var EntityAbstract $object @var ?Position $old */

// Самоподбор вещей (компонент autopickup) идёт ШАГОМ ИГРОКА, вводящим вещь в пределы его дальности, а не опросом у каждой лежащей вещи:
// код смены положения и так зовётся на каждом перемещении, а опрос стоил бы кадру тем больше, чем больше вещей
// на земле. Шагом считается только переход в другую клетку: появление на карте и сдвиг внутри своей клетки
// вещь под ногами не берут — выброшенное игроком остаётся лежать, пока он не уйдёт за пределы своей дальности и не вернётся.
if(!$object instanceof Player || $old === null)
	return;

$position = $object->position;
if($old->tile() === $position->tile())
	return;

// Мёртвому команду не ставим: подбор погасил бы её первой строкой, а постановка и снятие ушли бы клиентам парой пакетов.
if($object->components->isset('hp') && $object->components->get('hp') <= 0)
	return;

// Дальность — своя у игрока (компонент pickup_radius): 0 — только новая клетка, дальше — клетки вокруг неё.
$radius = $object->components->get('pickup_radius');

// Берётся лишь то, до чего дальность дотянулась именно этим шагом: вещь в пределах дальности от прежней клетки
// игрок уже миновал — выброшенная им лежит, пока он не уйдёт за пределы дальности и не вернётся (решение автора 2026-10-13).
[$oldX, $oldY, $oldZ] = explode(Position::DELIMETR, $old->tile());

$found = World::filter($position->x, $position->y, $position->z, static function(EntityAbstract $near) use ($oldX, $oldY, $oldZ, $radius):bool
{
	// Вещь соседней карты сама не подбирается: действие над ней идёт лишь на её карте, после перехода.
	if($near->map != MAP_ID || !$near->components->isset('autopickup') || !$near->components->get('autopickup'))
		return false;

	[$x, $y, $z] = explode(Position::DELIMETR, $near->position->tile());

	return (int)$z != (int)$oldZ || abs((int)$x - (int)$oldX) > $radius || abs((int)$y - (int)$oldY) > $radius;
}, distance: $radius, count: null);

if(!$found)
	return;

// Ждущий подбор не стирается заменой: клик игрока по вещи (с подходом) ждёт своего хода и, стёртый, пропал бы.
// Ждущий самоподбор вбирает новые вещи, и время его исполнения не сдвигается: несколько вещей берутся одной командой.
$pickup = $object->events->get('item/pickup');

if($pickup->action)
{
	if($pickup->from_client || $pickup->data['walk'])
		return;

	$targets = (array)($pickup->data['target'] ?: []);
	foreach(array_keys($found) as $key)
		if(!in_array($key, $targets))
			$targets[] = $key;

	$object->events->add('item/pickup', 'index', ['target' => $targets, 'radius' => max($radius, (int)$pickup->data['radius'])]);
	return;
}

$object->events->add('item/pickup', 'index', ['target' => array_keys($found), 'radius' => $radius]);

// Исполнение сдвигается на срок самой группы: без сдвига команда отработала бы тем же кадром, её постановка и снятие
// легли бы в один пакет, и клиент увидел бы лишь пустую команду — ни взявшего, ни взятого.
$object->events->get('item/pickup')->resetTimeout();
К игре