Испытания и карточки

Описание

Руководство пользователя

Оживите своё сообщество еженедельными испытаниями с проверкой персоналом, коллекционными карточками, лутбоксами, сейфом с секретным кодом и внезапными появлениями награды в чате. Для администраторов, которые хотят придать смысл валюте своего сервера.

Что это делает

• Публикует еженедельные испытания, которые участники выбирают, а затем подтверждает их доказательства в отдельном канале.
• Даёт собирать карточки (6 степеней редкости), объединённые в коллекции и выпадающие из платных бустеров.
• Продаёт лутбоксы, содержимое которых определяется случайно по заданным вероятностям.
• Открывает сейф, который участники пытаются отпереть секретным кодом.
• Запускает реактивные события: награда случайно появляется в чате и достаётся тем, кто нажмёт первым.
• Ведёт престиж, значки и редкие предметы, которые видны в профиле.

Быстрый старт (админ)

1. Сначала создайте валюту в модуле «Мультивалюты»: весь этот модуль опирается на неё (см. Валюта сервера).
2. Откройте модуль Испытания и карточки в панели управления.
3. Вкладка Испытания: создайте испытание (название, критерий, награда, валюта), затем укажите канал проверки для этой валюты — именно туда будут поступать доказательства.
4. Вкладка Карточки: создайте коллекцию, затем несколько карточек; вкладка Бустеры: создайте бустер и настройте его вероятности по редкости.
5. Вкладка Сейфы: создайте сейф (секретный код, попытки в день, приз).
6. Вкладка События: задайте вероятность появления, длительность и награду — а затем добавьте хотя бы один разрешённый канал, иначе ничего никогда не появится.
7. Расскажите участникам про /challengesystem defi liste и /challengesystem profil voir.

Команды

Все команды находятся внутри /challengesystem, за которой следует группа, а затем действие.

Для участников

Команда	Описание
/challengesystem defi liste	Показывает доступные испытания, сгруппированные по валютам.
/challengesystem defi choisir	Выбрать еженедельное испытание.
/challengesystem defi soumettre_preuve	Отправить файл как доказательство выполнения.
/challengesystem profil voir	Полный профиль (валюты, значки, предметы, карточки, престиж).
/challengesystem profil recompenses	Посмотреть награды, настроенные на сервере.
/challengesystem carte moi	Посмотреть свою коллекцию карточек.
/challengesystem collection lister	Посмотреть коллекции сервера.
/challengesystem booster ouvrir	Открыть бустер с карточками (платно).
/challengesystem lootbox ouvrir	Открыть лутбокс и узнать свою награду.
/challengesystem lootbox voir	Посмотреть заявленное содержимое лутбокса.
/challengesystem coffre tenter	Попытаться открыть сейф, введя код.
/challengesystem coffre actif	Посмотреть текущий сейф.
/challengesystem coffre stats	Посмотреть оставшиеся попытки на сегодня.
/challengesystem prestige voir	Посмотреть свой уровень престижа.
/challengesystem badge voir	Посмотреть свои значки.
/challengesystem objet voir	Посмотреть свои редкие предметы.

Для персонала

Команда	Описание
/challengesystem defi ajouter	Создать еженедельное испытание.
/challengesystem defi config_validation	Задать канал проверки доказательств для валюты.
/challengesystem carte creer · carte modifier · carte supprimer	Управлять карточками (с предпросмотром перед публикацией).
/challengesystem collection creer	Создать коллекцию карточек.
/challengesystem booster creer · booster config_proba	Создать бустер и настроить его вероятности по редкости.
/challengesystem lootbox ajouter · lootbox ajouter_item	Создать лутбокс и положить в него призы.
/challengesystem coffre creer · coffre fermer	Открыть или закрыть сейф.
/challengesystem prestige configurer	Задать порог престижа и выдаваемую роль.
/challengesystem badge ajouter	Создать доступный значок.
/challengesystem objet ajouter	Создать редкий предмет.
/challengesystem event configurer · event onoff	Настроить и включить реактивные события.
/challengesystem event channels_add · channels_remove · channels_list	Управлять каналами, где могут появляться события.
/challengesystem event forcer	Немедленно запустить событие (для проверки).
/challengesystem chaos ajouter · chaos ajouter_effet · chaos liste · chaos ouvrir	Управлять Сундуками Хаоса и их эффектами.

Настройки в панели управления

Модуль представлен десятью вкладками и охватывает всё, что делают команды персонала — как правило, удобнее (таблицы, формы, выбор ролей и каналов):

• Испытания — список испытаний (название, тип, критерий, тип и размер награды, связанная валюта, требуется ли доказательство) и таблица каналов проверки по валютам.
• Карточки — карточки (название, описание, изображение по URL, редкость, коллекция) и коллекции.
• Бустеры — цена, валюта, число выпадающих карточек (мин./макс.) и таблица выпадения по типу и редкости с весами.
• Лутбоксы — коробки (цена, валюта, запас) и их призы с весом выпадения.
• Сейфы — секретный код, подсказка, попытки в день, приз и опция «отключить остальные активные сейфы».
• Престиж — порог (сумма всех валют), выдаваемая роль, множитель, отображаемый в карточке престижа.
• Значки — название, эмодзи, изображение и роль Discord, выдаваемая вместе со значком (необязательно).
• Редкие предметы — название, описание, эмодзи, изображение.
• События — вероятность на сообщение (от 0 до 1), задержка, число победителей, длительность, награда.
• Хаос — Сундуки Хаоса и их эффекты: общая потеря, буст казино, общий бонус, закрытие магазина, обращение начислений.

Полезно знать

• Панель управления показывает предупреждение «Модуль нестабилен — в разработке». Он молодой и может меняться без предупреждения: проверяйте всё в неприметном канале, прежде чем объявлять событие всему серверу.
• Без валюты ничего не работает. Испытания, бустеры, лутбоксы, сейфы и события — всё привязано к валюте из модуля «Мультивалюты». Без созданной валюты формы останутся пустыми.
• Испытания не проверяются сами. «Тип» и «критерий» — это свободный текст: бот не измеряет никакого прогресса. Участник выбирает испытание, отправляет файл в качестве доказательства, а сотрудник персонала одобряет или отклоняет его кнопками в сообщении, размещённом в канале проверки. Если канал проверки для валюты испытания не настроен, доказательство никуда не поступит.
• Каждое испытание участник может выбрать только один раз: «пройти заново» нельзя.
• Престиж обнуляет счётчики. Когда сумма валют участника достигает порога, все его балансы обнуляются, уровень престижа увеличивается на 1, а настроенная роль выдаётся ему. Объявите об этом ясно, иначе участники воспримут это как потерю.
• Сейф: код хранится в зашифрованном виде (никто не сможет прочитать его в базе), число попыток ограничено в сутки (от 1 до 100, по умолчанию 5) и обнуляется каждый день. Создание сейфа по умолчанию отключает предыдущие.
• Реактивные события появляются только в тех каналах, которые вы перечислили. Пока ни один канал не добавлен, вероятность появления ни на что не влияет. Боту также нужно право писать в этих каналах.
• Оплата списывается до розыгрыша: при открытии лутбокса или бустера проверяется баланс, резервируется запас, а затем определяется приз. Исчерпанный запас блокирует открытие.
• Не все команды персонала защищены одинаково. Большинство требуют права «Управлять сервером» или «Администратор», но некоторые команды создания (в частности, испытаний и лутбоксов) на стороне бота ничего не проверяют. Ограничьте /challengesystem доверенными ролями через Настройки сервера → Интеграции.
• В модуле более сорока подкоманд: для настройки лучше пользоваться панелью управления, а участникам оставить только команды просмотра и игры.