База знаний & FAQ

Централизованный инженерный реестр ответов на частые вопросы, решений нештатных ситуаций и технических регламентов для всей линейки сервисов ASTERION Ecosystem (ConCord Partners, Asterion Monitor, Asterion Economy, Asterion Events).

Release | KB-2.6.4-LTS AST-Core 1.6.4 DISCORD API v10 VALIDATED
[+] б̲о̲ʍб̲о̲з̲а̲в̲р 𝕾𝖔 𝕾1𝖈𝖐 • 19.09.2026

Обновление базы знаний включает стандартизированную диагностику прав доступа, актуализированные параметры Voice XP compositing, таблицы регенерации выносливости для боевой системы Hunt 2.0 и ускоренный протокол разрешения инцидентов (Fast-Resolution Pipeline).

Ключевые регламенты
  • Auto-Diagnostic Suite: Внедрена команда автоматического аудита сервера /diagnose.
  • Role Hierarchy Guard: Описаны правила взаимного позиционирования системных ролей бота и ролей участников.
  • Anti-AFK Voice Criteria: Закреплены строгие условия начисления Voice XP в голосовых каналах.
Инженерные протоколы
  • Webhook Recovery: Автоматический перевыпуск вебхуков при коде 404 без потери PTS-рейтинга.
  • Stamina Fatigue Math: Опубликована точная математика штрафов к урону при истощении зарядов.
  • Fast-Resolution SLA: Гарантированное время первичного реагирования дежурных инженеров < 15 минут.

Диагностические команды

Перед обращением в техническую поддержку выполните экспресс-диагностику узла. Команды возвращают статус шлюзов Discord, задержку REST API, корректность разрешений гильдии и состояние очередей сообщений.

Команда Параметры Права доступа Назначение & Диагностический вывод
/ping None @everyone Замеряет задержку REST API и WebSocket Heartbeat шлюза. Номинальное значение < 85ms.
/botinfo None @everyone Выводит идентификатор шарда, аптайм ноды, потребление ОЗУ и версию активного кластера.
/diagnose [module: optional] Administrator Автоматическое сканирование прав гильдии, Discord Privileged Intents и иерархии ролей.
/sync-check [scope: cache|db] Administrator Принудительная проверка консистентности локального кэша вебхуков и записей базы данных.
/report <category> <text> @everyone Генерация шифрованного дампа инцидента с системными метаданными для дежурных инженеров.
/help [command: optional] @everyone Интерактивный справочник по слэш-командам, типам аргументов и правам доступа.

Права доступа и Discord API

Базовые архитектурные требования Discord API v10 к шлюзам, привилегированным интентам и иерархии ролей гильдии.

Какие Privileged Gateway Intents требуются для работы платформы?

Для корректного функционирования ботов экосистемы в Discord Developer Portal должны быть активированы три привилегированных интента:

  • Message Content Intent: Необходим для парсинга текстовых сообщений, начисления текстового XP в Asterion Monitor и обработки настраиваемых префиксов.
  • Server Members Intent: Требуется для отслеживания входа/выхода участников, синхронизации ролей за уровни и валидации прав доступа.
  • Presence Intent: Используется монитором голосовых каналов для детектирования активности и анти-твинковых механизмов.
Почему бот выдает ошибку «Missing Permissions» или не назначает роль за уровень?

В 95% случаев это связано с нарушением правила Иерархии ролей Discord (Role Hierarchy):

  1. Перейдите в Настройки сервера → Роли.
  2. Найдите системную роль бота (например, ASTERION Monitor).
  3. Перетащите роль бота выше всех ролей, которые он должен выдавать (роли рангов Onyx, Nemesis, Diamond, мут-роли, роли участников).
  4. Убедитесь, что у роли бота включено право Управлять ролями (Manage Roles).
Почему слэш-команды бота не отображаются сразу после добавления на сервер?

В Discord API существует два типа слэш-команд:

  • Guild Commands (Команды гильдии): Регистрируются мгновенно (0–3 секунды). Используются для локального тестирования.
  • Global Commands (Глобальные команды): Распространяются на инфраструктуру Discord по всему миру с задержкой кэширования до 60 минут.

Если команды не появились, перезапустите клиент Discord клавишами Ctrl + R для очистки локального кэша схем взаимодействия.

ConCord Partners FAQ

Вопросы партнерской автоматизации, настройки внешних медиа-фидов и начисления партнерского рейтинга PTS.

Почему не приходят оповещения о прямых эфирах Twitch и YouTube?

Типичные причины задержки или отсутствия оповещений:

  • Права вебхука: Убедитесь, что у роли бота в целевом канале есть права Manage Webhooks и Send Messages.
  • Задержка PubSubHubbub (YouTube): Протокол Google оповещает шлюз о начале трансляции в течение 2–5 минут после старта.
  • Фильтрация категорий: Если в настройках стрима включен фильтр игр, стримы без категории игнорируются.
  • Проверка канала: Выполните команду /partner test_stream <channel> для отправки тестового вебхука.
Как рассчитываются очки PTS и за что налагаются штрафы?

Очки PTS начисляются по детерминированной формуле:

PTS = Base_PTS + (Active_Members * 1.5) + (Active_Feeds * 2.0) + Mutual_Bonus

Штрафы и списания:

  • Удаление партнерского канала без предупреждения: -150 PTS.
  • Удаление взаимного баннера или откат прав вебхука: -300 PTS и понижение тира.
  • Попытка накрутки фейковыми аккаунтами: блокировка в партнерской сети ConCord.
Что делать, если партнерский вебхук был случайно удален?

При ручном удалении вебхука выполните команду /partner reset_webhook в желаемом текстовом канале. Бот сгенерирует новый токен вебхука, обновит привязку в распределенной базе данных и восстановит очередь публикации без потери накопленного партнерского тира.

Asterion Monitor FAQ

Вопросы голосового опыта (Voice XP), работы движка Dual-Layer Compositor 2.0 и каскадных множителей каналов.

Почему не начисляется Voice XP во время нахождения в голосовом канале?

Для предотвращения накрутки бот начисляет опыт только при соблюдении Anti-AFK протокола:

  • В канале должно находиться минимум 2 реальных участника (боты не учитываются).
  • Микрофон пользователя не должен быть заглушен (Self-Mute или Server-Mute).
  • Звук пользователя не должен быть отключен (Self-Deaf или Server-Deaf).
  • Канал не должен находиться в черном списке /monitor ignore_channel.
  • Канал не должен иметь статус AFK Channel в настройках сервера Discord.
Как правильно настроить множители опыта (Cascade Multipliers)?

Множители вычисляются по правилу каскадного приоритета (более узкий скоуп переопределяет широкий):

  1. Категория: Устанавливает базовый коэффициент (например, 0.8x для флудилок).
  2. Канал: Переопределяет категорию (например, 1.5x для тематического хаба).
  3. Ролевой множитель: Применяется мультипликативно к финальному результату канала (например, 2.0x для Server Booster).
Сбросятся ли ранги участников, если изменить структуру ролей?

Нет. Asterion Monitor хранит первичные значения очков опыта (Raw XP) в базе данных независимо от Discord Snowflake ID ролей. После реорганизации ролей администратору достаточно выполнить команду /monitor sync_roles, и бот автоматически перевыдаст актуальные роли всем пользователям в соответствии с их текущим опытом.

Asterion Economy FAQ

Механика энергии (Stamina), правила безопасного хранения кредитов в банке, оружие Hunter Arsenal и рыбная ловля.

Как восполняется выносливость (Stamina) и что такое штраф усталости?

Выносливость охотника ограничена пулом из 18 сегментов:

  • Регенерация: 1 заряд восстанавливается каждые 10 минут пассивного отдыха (полный цикл восстановления — 3 часа).
  • Fatigue Penalty: Если остаток выносливости опускается ниже 3 делений, охотник получает штраф: урон снижается на 35%, а вероятность успешного ограбления /crime падает до 12%.
  • Мгновенное восстановление: Энергетические напитки и пайки в магазине /shop buy energy_drink восстанавливают +6 зарядов.
Как защитить баланс от краж и ограблений других игроков (/crime)?

Игроки могут грабить только наличные средства (Wallet Cash), находящиеся на руках. Средства, положенные в банковский сейф командой /bank deposit <amount>, имеют абсолютную защиту от команды /crime и не могут быть похищены ни при каких обстоятельствах.

Какое оружие наиболее эффективно против мировых боссов Bestiary 2.0?

Арсенал охотника разделен на 4 тира:

  • Tier 1 — Белый стрик: Базовый карабин для начальных мобов (Короналесс, Охотник с колоколом).
  • Tier 2 — Прототип баррель: Оптимизирован для бронированных целей средней полосы.
  • Tier 3 — Клэр 12G: Тяжелый тактический дробовик с высоким критическим множителем.
  • Tier 4 — Вулкан (Minigun): Максимальный DPS в рейдах на легендарных боссов (Thundering Mephis, Фантилия).

Asterion Events FAQ

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

Как работает 4-этапный пайплайн напоминаний о турнирах?

Планировщик автоматически отсылает уведомления зарегистрированным участникам по временной сетке:

  • T-48h: Анонс турнирной сетки и верификация регистрации капитанов.
  • T-24h: Подтверждение готовности и публикация регламента матчей.
  • T-1h: Открытие предстартового голосового лобби и чекин команд.
  • T-15m: Финальный пинг участников с прямой ссылкой на игровую комнату.
Что такое «Happy Hours» и как включить удвоение Очков Чести?

Режим Happy Hours активирует глобальный множитель 2.0x к начислению Очков Чести (Honor Sync) за победы в турнирах и викторинах. Режим включается автоматически каждые выходные с 18:00 до 23:00 МСК либо принудительно администратором командой /event happy_hours start <duration_hours>.

Как получить сезонные жетоны Purple Heart Coin и открывать фестивальные сундуки?

В период сезонных фестивалей (Valentine Season) жетоны Purple Heart Coin начисляются за отправку валентинок командой /love send <user>, победы в тематических викторинах и парных мини-играх. Накопленные жетоны обмениваются на эксклюзивные роли и сундуки через /love open_chest.

Матрица ошибок и сбоев

Справочная таблица стандартных кодов исключений Discord API и внутренних сбоев микросервисов ASTERION с готовыми инструкциями по их устранению.

Код / Симптом Модуль Первопричина (Root Cause) Решение & Инструкция
HTTP 403 Forbidden API Core Отсутствие необходимых прав (Manage Roles, Manage Webhooks, Send Messages) у бота в канале. Проверьте права роли бота в категории канала. Убедитесь, что бот не ограничен оверрайдами.
HTTP 429 RateLimit Gateway Превышен лимит запросов к Discord REST API (массовый спам командами или реакциями). Бот автоматически ставит запросы в экспоненциальную очередь ожидания (Retry-After). Ожидайте 5–30 сек.
VoiceXP_MuteLock Monitor Участник находится в муте, глушении звука или один в комнате (Anti-AFK блокировка). Разглушите микрофон и звук. В канале должно находиться минимум 2 живых участника.
Webhook_InvalidUrl Partners Вебхук партнерского канала был удален вручную модератором сервера. Выполните команду /partner reset_webhook для автоматической перепривязки канала.
Stamina_Exhausted Economy Запас выносливости охотника равен 0. Блокировка действий охоты и грабежей. Подождите естественного восстановления (1 заряд / 10 мин) или используйте предмет /shop buy energy_drink.
Interaction_Timeout Discord Ответ бота занял более 3 секунд без предварительного вызова deferReply(). Следствие высокой сетевой нагрузки на ноду Discord. Повторите вызов слэш-команды через 5 секунд.
Role_Hierarchy_Fail Monitor Роль, выдаваемая за ранг, находится в списке ролей Discord выше системной роли бота. В настройках сервера перетащите роль бота выше ролей рангов (Onyx, Nemesis, Diamond).
Event_Channel_NoPing Events У роли бота отсутствует право Mention @everyone, @here and All Roles. Выдайте роли бота право упоминания ролей участников в канале проведения турнира.

Регламент эскалации инцидентов

Если стандартные диагностические шаги не помогли устранить сбой, следуйте официальному алгоритму передачи инцидента в службу дежурной инженерной поддержки ASTERION Core Team:

SLA Protocol FAST-RESOLUTION < 15 MIN
Engineering Incident Management
  1. Снятие диагностического слепка: Запустите в приватном канале команду /diagnose и сохраните вывод идентификаторов шарда, версии кластера и списка недостающих разрешений.
  2. Локальная ревизия прав: Проверьте соответствие иерархии ролей (роль бота выше целевых ролей) и наличие активных оверрайдов прав в целевой категории каналов.
  3. Генерация защищенного репорта: Выполните команду /report category:bug description:"Краткое описание сбоя". Система сформирует защищенный хэш инцидента и отправит его в инженерный лог.
  4. Обращение в инженерный хаб: Присоединитесь к официальному серверу поддержки discord.gg/3pRjpqH454 в канал #incident-tickets и укажите сгенерированный хэш репорта. Время первичного отклика инженера составляет менее 15 минут.