$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();