buy

из группы item/give
Торговец скупает вещь, которую ему продал игрок его карты. Исполняется на самом торговце: лавку — его добычу, где лежат и товар, и касса (монеты, которыми он платит и куда кладёт выручку), — пишет лишь он. Продавец уже снял вещь у себя и прислал её торговцу, а сделку решает торговец — по своему нынешнему ценнику (множителям компонента trade) и своей лавке. Сошлось — вещь ложится в лавку: та же вещь (того же префаба и с теми же своими значениями компонентов) прибавляет количество к своей записи, новая ложится новой записью; выручка ложится продавцу в инвентарь, а без места падает ему под ноги. Скупка вещи закрыта (ценник не задан — значение компонента trade пусто, множитель скупки (sell) нулевой либо у вещи нет базовой цены — компонент price), в кассе не хватает монет либо в лавке нет места под вещь (такой вещи в ней нет, а разных вещей уже предел — столько, сколько ячеек в умолчании компонента inventory, подпись поля — «По умолчанию») — вещь возвращается продавцу так же: в инвентарь, а без места под ноги. Продавца к исполнению скупки больше не видно (ушёл с карты, вышел из игры) — ответить некому, вещь пропадает, и это пишется в журнал предупреждений. Событие этой команды ставит торговцу команда ui/inventory/put, когда игрок продаёт ему вещь.
Параметры 2
Параметр По умолчанию Что задаёт
item обязателен
Проданная вещь с количеством — та, что продавец назвал и снял у себя, в виде {prefab, count, components}, как вещь хранит компонент inventory: префаб, количество и, у вещи со своими значениями компонентов, они.
key обязателен Ключ продавца — игрока на запущенной карте (вида players_1).
Кому доступна
bot item armor enemy animal object player trader weapon trader_silent
Что делает команда — код, который выполняется при её срабатывании
Что платформа подаёт в код
Код исполняется телом функции, и платформа подаёт в него эти переменные:
  • $object — сущность, выполняющая команду
  • $data — параметры команды: ключ — slug параметра; непереданные приходят со своим значением по умолчанию
  • $from_client — команду прислал игрок пакетом, а не поставил код механик
  • $client_origin — цепочку начал игрок: признак наследуют и события, которые код поставит по ходу неё

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

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

<?php
/** @var EntityAbstract $object @var array $data @var bool $from_client */

# Лавку и кассу пишу лишь я: продажа приходит сюда заявкой с уже снятой у продавца вещью, решаю сделку у себя
# целиком и отвечаю зачислением — выручкой либо возвратом вещи.
# Никаких throw: событие на НЕ-игроке, исключение уронило бы карту.

// продавца больше не видно (ушёл со своей карты, вышел из игры) — ответить некому, вещь пропадает
if(!World::isset($data['key']))
{
	$object->warning('скупка у '.$data['key'].' не состоялась: продавца больше не видно, вещь '.$data['item']['prefab'].' пропала');
	return;
}

$seller = World::get($data['key']);
$item = $data['item'];
$loot = $object->components->get('loot');
$price = Trade::price($object, $item, false);
$coins = $price ? Inventory::take($loot, Trade::COIN, $price) : null;

// место под вещь ищется по составу после выплаты: опустевшая запись кассы годится
$next = $coins === null ? null : Inventory::lootPut(Inventory::lootAfter($loot, $coins), $item);

// вещь не торгуется, касса пуста либо разных вещей в лавке предел — сделки нет, вещь возвращается продавцу
if($next === null)
{
	$seller->events->push('status/changes', 'index', ['data' => ['components' => ['inventory' => ['__add' => [['item' => $item]]]]]]);
	return;
}

$object->components->add('loot', $next);

$seller->events->push('status/changes', 'index', ['data' => ['components' => ['inventory' => ['__add' => [['item' => ['prefab' => Trade::COIN, 'count' => $price]]]]]]]);
К игре