item/give| Параметр | По умолчанию | Что задаёт |
|---|---|---|
item |
обязателен | Проданная вещь с количеством — та, что продавец назвал и снял у себя, в виде {prefab, count, components}, как вещь хранит компонент inventory: префаб, количество и, у вещи со своими значениями компонентов, они. |
key |
обязателен | Ключ продавца — игрока на запущенной карте (вида players_1). |
$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]]]]]]]);