WardenCoredocs
Discord-бот

Магазин наборов

Настройка магазина предметов за монеты в Discord

Магазин наборов (Pack Shop) позволяет игрокам тратить монеты на покупку наборов предметов через Discord. При покупке предметы доставляются игроку прямо в игру. Магазин работает как через интерактивные кнопки, так и через текстовые команды.

Обзор

Процесс покупки работает следующим образом:

  1. Администраторы создают наборы в панели (каждый набор содержит предметы и имеет цену в монетах)
  2. Embed-карточки наборов публикуются в канале Discord (с кнопками покупки)
  3. Игроки просматривают карточки и нажимают Buy Now или используют команду !buy
  4. Монеты списываются, предметы доставляются в игру

Игроки должны иметь привязанный аккаунт и быть онлайн в игре для совершения покупок.

Настройка магазина

Создайте наборы в панели

Перейдите в раздел управления наборами в панели WardenCore. Создайте наборы, указав:

  • Name -- короткий идентификатор для команд (например, AK47, Medkit)
  • Display Name -- название, отображаемое в embed магазина
  • Description -- описание содержимого набора
  • Price -- стоимость набора в монетах
  • Items -- игровые предметы, включённые в набор
  • Image -- изображение для embed магазина (необязательно)
  • Category -- группировка наборов по категориям для удобства

Настройте параметры магазина

В Settings > Discord > Bot-Shop настройте глобальные параметры магазина:

  • Shop Cooldown -- минимальное время (в секундах) между покупками для каждого игрока. По умолчанию 15 секунд. Предотвращает слишком частые покупки.
  • Max Packs Per Order -- максимальное количество наборов, которое игрок может купить одной командой !buy или !cart. По умолчанию 5.

Опубликуйте наборы в Discord

Используйте админ-команды для публикации embed-карточек в канале Discord:

  • !listpack AK47 -- публикует embed одного набора
  • !listcat Weapons -- публикует все включённые наборы в категории

Каждый embed содержит кнопку Buy Now и отображает название набора, цену и изображение.

Как игроки покупают наборы

Через кнопку покупки

  1. Игрок находит embed набора в канале магазина
  2. Нажимает кнопку Buy Now
  3. Бот проверяет баланс, списывает монеты и доставляет предметы в игру
  4. Появляется сообщение с подтверждением

Через текстовые команды

Игроки также могут покупать наборы командами:

!buy AK47

Чтобы купить несколько одинаковых наборов:

!buy AK47 3

Чтобы купить несколько разных наборов одним заказом:

!cart AK47 Medkit Ammo

Команда !cart проверяет общую стоимость заранее, списывает все монеты сразу и доставляет каждый набор. Если доставка какого-либо набора не удалась, монеты за него возвращаются.

Расширенные возможности наборов

Наборы поддерживают несколько расширенных функций, настраиваемых через панель:

Лимиты покупок

Ограничение количества покупок конкретного набора за определённый период. Например, 3 покупки за 60 минут.

Требуемые роли

Ограничение набора для игроков с определённой ролью Discord. Игроки без этой роли не смогут его купить.

Скидки по ролям

Процентные скидки для игроков с определёнными ролями Discord. Например, VIP-участники получают скидку 20%.

Видимость в магазине

У каждого набора есть переключатель Shop Enabled. Когда он отключён, набор скрыт из магазина и недоступен для покупки — но его по-прежнему можно использовать для наград, ежедневных наборов и кодов активации.

Ежедневный набор

Ежедневный набор (Daily Pack) -- бесплатная награда, которую игроки могут получить раз в 24 часа. Настраивается в панели в разделе Settings > Discord > Bot-Shop > Daily Pack.

Включите Daily Pack

Переключите Daily Pack в состояние Enabled.

Установите награду в монетах

Укажите количество монет, которое игрок получает при активации. Установите 0, чтобы не выдавать монеты.

Выберите набор (необязательно)

Выберите набор, который будет выдаваться вместе с монетами. Оставьте пустым, чтобы выдавать только монеты.

Сохраните

Нажмите Save. Теперь игроки могут ввести !daily, чтобы получить награду.

Игроки должны быть онлайн в игре, когда вводят !daily. 24-часовой откат начинается с момента получения награды.

Управление ежедневным набором (админ)

Администраторы могут сбрасывать откат ежедневного набора:

  • !cleardaily 76561198012345678 -- сбросить откат для одного игрока
  • !cleardaily all -- сбросить откат для всех игроков

Коды активации

Администраторы могут создавать коды, дающие игрокам определённые наборы. Это полезно для розыгрышей, наград и акций.

Создание кода:

!createcode AK47 true 5 7

Эта команда создаёт код для набора AK47, отправляет его в личные сообщения (true), разрешает 5 использований и истекает через 7 дней.

Игроки активируют коды командой:

!claim ak47-ABCDEF123456

Embed кода содержит кнопку Claim для удобной активации.

Частые проблемы

Недостаточно монет

Игроку нужно больше монет для покупки. Администраторы могут выдать монеты командой !addcoins 500 76561198012345678. Игроки зарабатывают монеты через ежедневный набор, приветственный набор и другие серверные активности.

Откат активен

Игроки должны ждать между покупками. Стандартный откат -- 15 секунд. Его можно изменить в Settings > Discord > Bot-Shop. Для лимитов покупок администраторы могут сбросить их командой !clearbuylimit.

Аккаунт не привязан

Игрок должен привязать свои аккаунты Discord и Steam перед покупкой. Направьте его к приветственному embed или попросите администратора использовать !link. Смотрите Привязка аккаунтов.

Предметы не появляются в игре

Игрок должен быть онлайн в игре во время покупки. Если предметы всё равно не появляются, пусть попробует перезайти. Проверьте логи WardenCore на наличие ошибок выполнения наборов.

Необходимо быть онлайн для покупки

Команды !buy и !daily требуют, чтобы игрок был подключён к игровому серверу. Бот проверяет статус онлайн перед обработкой любой покупки.

Содержание