Shop

Shop — клиентский API магазина. В Reflex server глобальный объект равен nil.

Командные методы BuyItem(), BuyAndDropItem() и SellItem() возвращают nil. Проверяйте результат операции по инвентарю и query-методам, а не по возвращаемому значению.

Как обрабатывается операция

Клиентский вызов формирует запрос операции магазина. Сервер проверяет актуальные правила матча — доступность buy, деньги, лимиты, сторону, слот и возможность продажи — и только после этого изменяет экономику, инвентарь или создаёт drop. Поэтому nil означает лишь завершение отправки вызова, а не успешную покупку.

Методы CanSellItem(), HasBoughtItem() и IsBuyLimitReachedForItem() читают текущее состояние магазина для локального агента. Они ничего не резервируют и не гарантируют, что условия не изменятся до обработки следующего запроса.

Где виден результат

BuyItem() при принятом сервером запросе меняет инвентарь и состояние покупки предмета.
SellItem() удаляет доступный для возврата предмет и меняет связанное состояние магазина.
BuyAndDropItem() запрашивает покупку с появлением предмета в мире, но сам вызов не возвращает созданный Drop.

Эти методы не показывают отдельное подтверждение от имени модуля. Проверяйте инвентарь, HasBoughtItem(), CanSellItem() и списки Drops; при необходимости выводите собственное сообщение через NotificationController или ChatManager.

Пример покупки и продажи

local itemName = "FragGrenade"

if not Shop:IsBuyLimitReachedForItem(itemName) then
    Shop:BuyItem(itemName)
end

if Shop:CanSellItem(itemName) then
    Shop:SellItem(itemName)
end

Успешная покупка добавляет предмет в Agents:GetLocalAgent().Inventory. После покупки HasBoughtItem() становится true, а CanSellItem() показывает, можно ли вернуть предмет прямо сейчас.

BuyItem

Shop:BuyItem(itemName: string)

Покупает предмет по внутреннему имени. Операция зависит от стадии раунда, buy zone, денег, доступности предмета и лимита покупок.

SellItem

Shop:SellItem(itemName: string)

Продаёт ранее купленный предмет, когда CanSellItem(itemName) возвращает true.

BuyAndDropItem

Shop:BuyAndDropItem(itemName: string)

Отправляет запрос на покупку предмета с выбросом в мир.

Проверки состояния

CanSellItem

Shop:CanSellItem(itemName: string): bool

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

HasBoughtItem

Shop:HasBoughtItem(itemName: string): bool

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

IsBuyLimitReachedForItem

Shop:IsBuyLimitReachedForItem(itemName: string): bool

Возвращает true, если достигнут лимит покупок этого предмета.