Витрина (предметы и валюта)

Зачем это владельцу. Игрок может купить ваш предмет за баланс, который заработал активностью на TopGam — без обязательного вложения личных денег. Вы получаете обычный баланс на продвижение сервера на площадке, продавая игровые предметы / валюту / VIP: вам 50% от покупки, 50% — комиссия площадки. Реальные деньги на продвижение вкладывать не нужно — достаточно выставить товар с сервера.

Выдача в игру: плагин по API или кнопка «Выдано» в кабинете. Работает для всех игр: Minecraft, Rust, CS, SA-MP, FiveM, Lineage, WoW, MU и др.

Где в кабинете 1) Сервер → Витрина — добавить товар (картинка, тип, цена, выдача).
2) Сервер → Ключ и API — тот же ключ, что у наград.
3) Товары видны в публичном Магазине и на странице сервера.

Пошаговая настройка

Откройте кабинет → ваш сервер → Витрина.
Добавьте товар:
- Тип — игровой предмет / валюта · донат / привилегия · VIP / другое.
- Картинка, название, описание, характеристики («что получит игрок»).
- Цена в ₽ — покупатель платит обычным балансом, затем бонусом.
- Склад — число или пусто (безлимит).
Выберите способ выдачи (см. таблицу ниже) и сохраните.
Поставьте плагин TopGam (тот же, что для наград) или PHP cron из примеров — плагин опрашивает и /rewards/*, и /shop/*.
Проверка: купите тестовым аккаунтом с другого профиля → заказ «pending» → после команды/«Выдано» статус delivered. Себе и связанным аккаунтам купить нельзя.

Типы товаров (поле kind)

item — игровой предмет (меч, кит, ресурс).
currency — валюта / донат-баланс на сервере.
privilege — привилегия / VIP / группа прав.
other — всё остальное.

В API поле kind приходит в каждом заказе — можно ветвить логику плагина (например, валюта в одну команду, VIP — в другую).

Способы выдачи по играм

Команда на сервере delivery=command Minecraft, Rust, CS/TF2, SA-MP, FiveM — плагин выполняет команду с уже подставленным ником. В поле укажите шаблон с %nick% или %player%.

Код / промо delivery=code Lineage, WoW, MU, веб-аккаунты — один код или инструкция в code; игрок/вы активируете в игре или на сайте сервера. Плагин обычно не выполняет команду.

Вручную delivery=manual Любая игра без плагина: заказ в Витрине → выдайте предмет/валюту в игре → «Выдано» (или claim после своей выдачи).

Примеры команд

# Minecraft (LuckPerms / give)
lp user %nick% parent add vip
give %nick% diamond 64

# Rust (Oxide)
oxide.usergroup add %nick% vip
inventory.giveto %nick% scrap 1000

# SourceMod (CS и т.п.)
sm_give %nick% weapon_ak47

# SA-MP / open.mp — ваша RCON-команда
# FiveM — команда фреймворка, как в txAdmin

GEThttps://topgam.ru/api/v1/shop/pending

Параметры: опционально nick, limit (1–200). Ключ — Authorization: Bearer … или X-Api-Key (не в URL).

{
  "success": true,
  "count": 1,
  "retry_after": 60,
  "orders": [{
    "id": 42,
    "nick": "steve",
    "title": "VIP 7 дней",
    "kind": "privilege",
    "description": "Доступ к VIP",
    "specs": "7 дней · /fly · цветной ник",
    "image_url": "https://…/storage/shop/….avif",
    "delivery": "command",
    "command": "lp user steve parent add vip",
    "code": null,
    "price": 100,
    "ordered_at": "2026-09-14T12:00:00+00:00"
  }]
}

В command ник уже подставлен — выполняйте как есть. Для delivery=code смотрите code; для manual команда пустая — закрывайте заказ кнопкой «Выдано» в кабинете. Пустая очередь: retry_after ≈ 300 с — не долбите API чаще.

POSThttps://topgam.ru/api/v1/shop/claim

Параметры: ids=12,13 и/или nick=steve. Ключ — Bearer. Повторный вызов безопасен (уже выданные не дублируются).

{
  "success": true,
  "claimed": 2
}

curl

# Очередь
curl -s -H "Authorization: Bearer KEY" "https://topgam.ru/api/v1/shop/pending?limit=50"

# Подтвердить выдачу
curl -s -X POST -H "Authorization: Bearer KEY" \
  -d "ids=42,43" "https://topgam.ru/api/v1/shop/claim"

Ошибки API

401 — нет или неверный ключ (Bearer / X-Api-Key).
403 — сервер не активен в рейтинге.
422 на claim — не указаны ни ids, ни nick.

Экономика и правила

Игрок может платить балансом, заработанным на TopGam — без обязательного пополнения своими деньгами.
Покупка 100 ₽ → вам 50 ₽ на обычный баланс (на продвижение сервера), 50 ₽ — комиссия TopGam. Реальные деньги на продвижение не обязательны: достаточно продавать игровые товары.
Нельзя купить у своего сервера и у связанного аккаунта (антифрод).
Возврат в кабинете: откат вашей доли с обычного баланса, покупателю — возврат средств.
Сайт не кладёт предмет в инвентарь сам — только ставит заказ в очередь; выдаёт игра или вы вручную.
Ник покупателя: только буквы, цифры, _ . - (без пробелов и спецсимволов) — защита консоли сервера.
Тот же API-ключ, что для наград и Status — отдельный ключ для витрины не нужен.

Плагины и PHP cron: Примеры и плагины (раздел про витрину). Настройки в кабинете: Мои серверы → Витрина.

Документация API