trade

словарь видно другим игрокам со своим кодом
Множители торговца к базовой цене вещи: цена штуки у торговца — базовая цена вещи, умноженная на множитель продажи (buy) либо множитель скупки (sell). Множитель продажи берётся, когда торговец продаёт игроку, множитель скупки — когда скупает у него, и работают оба одинаково: с buy=2 покупатель платит вдвое больше базовой цены, с sell=0.5 продавцу достаётся половина базовой цены. Поэтому «скупать вдвое дешевле» задаётся половиной, а не двойкой: с sell=2 торговец заплатит за вещь вдвое больше её базовой цены — то есть станет раздавать деньги. Дробная цена штуки округляется в пользу торговца — при продаже вверх, при скупке вниз, — но не падает ниже монеты, если базовая цена вещи больше нуля: за дешёвую вещь с мелким множителем скупки продавец получит за штуку монету, а не ноль, ведь иначе мелочью нельзя было бы торговать. Сделка за несколько штук стоит округлённую цену штуки, умноженную на число штук, — итог сделки отдельно не округляется. Базовой цены здесь нет: она живёт у вещи (компонент price). Наличие этого компонента, а не его заполненность, делает сущность торговцем. Сущность без компонента — сундук, тело погибшей сущности и прочие контейнеры — не торгует: брать из неё бесплатно. Пустое значение значит, что ценник торговцу ещё не задан: он не продаёт и не скупает, хотя разговор с вариантом «Торговать» и сама лавка у него открываются. Нулевой множитель так же закрывает свою сторону: с sell=0 торговец ничего не скупает. Покупка либо продажа на закрытой стороне — нарушение, и игрок отключается от игры: клиент игры такой сделки не шлёт. У торговца перенос вещей между ним и игроком платный. Счёт идёт в монетах, а монеты — обычная вещь из состава обеих сторон, поэтому торговец скупает ровно пока есть чем платить. Значение рассылается всем видящим торговца, но клиент цен из него не считает: множители он показывает лишь строкой «Торгует» окна сведений о цели, а цену штуки у торговца считает только сервер. Игроку, открывшему лавку, сервер в ответ присылает цены штуки по buy и по sell для каждого префаба вещей игры, чьему виду объявлен компонент price, а для каждой вещи со своей ценой, если вещь лежит в товаре лавки либо в инвентаре этого игрока, — отдельную пару цен. В другое время цены не приходят, в том числе при смене товара лавки, инвентаря игрока либо ценника. Клиент лишь умножает цену штуки на число штук. Списание и начисление тоже считает сервер.
Стартовое значение
пусто
Сущность получает компонент пустым: ноль у числа, пустая строка у текста, пустой набор у списка.
Кому выдаётся
trader trader_silent
Каждая сущность этих видов получает компонент при создании.
Код компонента — срабатывает, когда значение меняется, и когда сущность появляется на карте
Что платформа подаёт в код
Код исполняется телом функции, и платформа подаёт в него эти переменные:
  • $object — сущность, которой присваивают значение компонента
  • $value — присваиваемое значение; в самом компоненте на этот момент ещё лежит прежнее

Записано будет то, что лежит в $value после кода: платформа возвращает его сама, свой return тоже годится — так значение правят перед записью либо отказывают в смене. Пустое значение выражается пустой строкой либо пустым набором, null запрещён. Код срабатывает на смену значения и на появление сущности на карте; повторная запись прежнего значения его не запускает. В коде компонента менять компоненты нельзя, ставить события можно.

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

<?php
/** @var array $value входящее значение, прокинуто closure-обёрткой ComponentCollection::trigger */

# Компонент несёт ТОЛЬКО множители торговца. Базовые цены вещей лежат у самих вещей
# (компонент price) и едут к клиенту своим каналом — вместе с префабами: цена нужна и там, где
# торговца нет вовсе (свой инвентарь, добыча трупа, вещь на земле), а справочник внутри
# торговца возил бы её копию в каждой лавке и только туда, где лавка рядом.

if(!is_array($value))
	throw new Error('Компонент trade задаётся парой множителей buy и sell');

# Пустое значение — ценник торговца ещё не задан, и это НОРМА, а не ошибка заполнения: торговец тогда
# не продаёт и не скупает. Проверять множители есть смысл только у заполненного: там автор заявил цены,
# и половинчатая запись — его ошибка.
if($value)
{
	foreach(['buy', 'sell'] as $rate)
	{
		if(!isset($value[$rate]) || !is_numeric($value[$rate]) || $value[$rate] < 0)
			throw new Error('Множитель "'.$rate.'" компонента trade обязателен и не может быть отрицательным');
	}

	# пересобираем состав: лишние ключи в значении не хранятся и не уезжают клиенту
	$value = ['buy' => (float)$value['buy'], 'sell' => (float)$value['sell']];
}
К игре