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

Открыто всем Участник гильдии Участник — про себя Офицер / лидер

Регистрация

Привязка своего Discord-аккаунта к коду союзника SWGOH — без этого команды вида «мой персонаж» не знают, кого имеют в виду.

• /регистрация ally_code: Открыто всем Привязать себя к коду союзника. Работает даже для тех, кого бот вообще не знает — сам проверит через игру, что этот аккаунт состоит в обслуживаемой гильдии. После этого команды без указания игрока (например /статы) по умолчанию берут этот аккаунт.
• /регистрация ally_code: альт:True Участник гильдии Привязать второй (альт) аккаунт, не заменяя основной.
• /регистрация ally_code: участник:@X Офицер / лидер Зарегистрировать другого участника вместо себя. Если этот код союзника уже был по ошибке привязан к чужому Discord — офицерский вызов переносит его на указанного участника.
• /регистрация_отмена [ally_code] Участник гильдии Отвязать код союзника от себя. Если у вас несколько аккаунтов (основной + альт) — параметр ally_code обязателен, чтобы уточнить, какой из них отвязать. Если отвязывается основной, а альт остаётся — альт автоматически становится новым основным.
• /регистрация_отмена ally_code: участник:@X Офицер / лидер Отвязать аккаунт другого участника вместо своего.
• /регистрация_отчёт Офицер / лидер Список по всей гильдии: кто ещё не привязан, у кого основной аккаунт, у кого — альт.

Статы и плейты

Нормы по статам персонажей (плейты) и проверка реального игрока против них.

• /статы [игрок] Участник — про себя Проверка статов персонажа(ей) игрока по его реальным модам/шмоту против норм плейта. Параметр «сценарий»: как сейчас / релик поднят только тем, кто ниже цели / полный подгон релика. У персонажей с двумя вариантами мод-билда («схема 1»/«схема 2», см. схема_переименовать) активная схема определяется автоматически по фактическим основам модов игрока — либо форсируется параметром «схема». Без игрока — берётся ваш зарегистрированный аккаунт. Участник может проверить только себя; чужого игрока и «гильдия» — только офицеры.
• /статы_релик Участник гильдии Пересчитать уже заданную в плейте норму персонажа на другой уровень реликвии — без привязки к игроку, просто «а что если норма была бы для релика N». У персонажа с двумя схемами показывает схему 1, если не задан параметр «схема».
• /ресурсы [игрок] [период] Участник — про себя Сколько деталей снаряжения и «сигналов» (материалов реликвии) реально потрачено на прокачку за неделю/месяц/3 месяца — точный подсчёт по официальным игровым рецептам тиров, не оценка. Месяц/3 месяца — по календарю, с 1 числа. Без игрока — берётся ваш зарегистрированный аккаунт; чужого игрока смотрят только офицеры.
• /статы_требования плейты Участник гильдии Список всех существующих плейтов: сколько в каждом персонажей и требований.
• /статы_требования список Участник гильдии Показать все требования плейта целиком, либо только по одному персонажу.
• /статы_требования создать [модульный] Офицер / лидер Создать новый плейт — название + необязательное описание. С модульный:True плейт не содержит персонажей напрямую, а вместо этого ссылается на другие плейты (целиком или по персонажу) — см. /статы_требования модуль_добавить. Признак «модульный» задаётся только при создании и не переключается позже (аналог в вебе: чекбокс на /plates).
• /статы_требования добавить Офицер / лидер Добавить в плейт требование к конкретному стату персонажа (например «Health ≥ 50000»), с приоритетом (Обязательно / По желанию) и комментарием. Недоступно для модульных плейтов — там состав задаётся через модуль_добавить.
• /статы_требования добавить_омикрон Офицер / лидер Добавить в плейт требование на разблокированный омикрон конкретного персонажа/корабля — способность выбирается автодополнением из тех, что реально есть у юнита. Недоступно для модульных плейтов.
• /статы_требования добавить_основу Офицер / лидер Добавить в плейт требование на основу (primary-стат) конкретного слота мода персонажа (например «на Стреле — Скорость»). Список допустимых основ зависит от выбранного слота (square/diamond имеют всего один вариант). Проверяется по реальным экипированным модам игрока, независимо от релика/сценария. Недоступно для модульных плейтов.
• /статы_требования добавить_сет Офицер / лидер Добавить в плейт требование на надетый сет модов (тот же справочник сетов, что в Калькуляторе). Параметр «комплектов» — сколько раз сет нужен (например Health ×2 = 4 модуля + ещё 2 модуля под другой сет); 4-модульные сеты (Speed, Offense, Critical Damage) — только 1, всего не больше 6 модулей. Проверяется по числу полных комплектов среди реально надетых модов, независимо от релика/сценария. При авто-детекте активной схемы мод-билда сеты сравниваются ПЕРВЫМИ и приоритетнее основ — если сеты по схемам различаются, схема выбирается по ним, даже если основы совпадают. Недоступно для модульных плейтов.
• /статы_требования добавить_сравнение Офицер / лидер Добавить требование на сравнение стата персонажа с тем же стата другого персонажа ТОГО ЖЕ игрока (например «офицер быстрее Хакса»). Операторы >, >=, <, <=, = и необязательный отрыв «на_сколько»: «Скорость > Хакс + 51» — офицер быстрее Хакса больше чем на 51, для </<= отрыв вычитается. Считается всегда по сырым живым значениям, независимо от сценария релика, и на равных с обычными требованиями по статам/сетам/основам. Недоступно для модульных плейтов.
• /статы_требования редактировать Офицер / лидер Изменить или удалить ранее добавленное требование (по id из автодополнения).
• /статы_требования переименовать Офицер / лидер Переименовать плейт — все требования внутри переносятся автоматически, включая ссылки на этот плейт из/в модульных плейтах.
• /статы_требования описание Офицер / лидер Изменить заметку/описание уже существующего плейта (при создании оно задаётся один раз, до сих пор не было способа поменять его позже).
• /статы_требования схема_переименовать Офицер / лидер Задать название одной из двух «схем» мод-билда персонажа (например «Скорость»/«КД»), вместо стандартных «Схема 1»/«Схема 2». Сама привязка требования к схеме — параметр «схема» у добавить/добавить_омикрон/добавить_основу/добавить_сравнение/редактировать.
• /статы_требования удалить Офицер / лидер Удалить плейт целиком (или одного персонажа из него). Сначала команда покажет, сколько требований (или, для модульного плейта, компонентов состава) будет удалено, и предупредит, если плейт подключён к другим модульным плейтам — реальное удаление только повторным вызовом с подтвердить:True.
• /статы_требования модуль_добавить плейт: источник: [персонаж] Офицер / лидер Подключить к модульному плейту другой плейт — целиком (персонаж не указан) либо только одного персонажа из него. Требования подтягиваются «на лету»: правка исходного плейта сразу отражается во всех модульных плейтах, где он подключён. Циклические ссылки (A подключает B, B подключает A, в том числе транзитивно) отклоняются. В вебе — тот же выбор чекбоксами на странице модульного плейта (/plates/<name>), с раскрывающимся деревом «весь плейт / отдельные персонажи».
• /статы_требования модуль_убрать плейт: источник: [персонаж] Офицер / лидер Отключить ранее подключённый плейт (или персонажа из него) от модульного плейта.
• /статы_требования модуль_список плейт: Офицер / лидер Показать текущий состав модульного плейта: какие плейты/персонажи подключены и сколько персонажей это даёт в развёрнутом виде.

Моды

Поиск надетых модов по всей гильдии — например «у кого есть сет здоровья на круге со скоростью от 15».

• /моды_поиск [игрок] [гильдия] сет: слот: primary: стат_1: оператор_1: значение_1: ... Участник — про себя Поиск надетых модов по гибкому фильтру: сет / слот / primary-стат / до 3 условий по вторичкам (все указанные условия — через И). Условие по вторичке — это три параметра сразу: стат + оператор (>=, <= и т.д.) + значение; если заполнили один из трёх — нужно заполнить и остальные два. Без «игрок» и без «гильдия:True» — по вашему зарегистрированному аккаунту (участникам доступно только это); чужой игрок и «гильдия:True» (таблица по всей гильдии) — только офицерам. Пример: «сет здоровья с primary-статом Defense и вторичкой Speed ≥ 15» — `/моды_поиск гильдия:True сет:Здоровье primary:Defense стат_1:Speed оператор_1:>= значение_1:15`. У более гибкого конструктора условий (произвольное число строк вместо фиксированных трёх) — веб-версия /mod-search.

Датакроны

Требования к датакронам по сезонам ТБ и автосверка с тем, что реально есть у игроков.

• /дк_требования список [сезон] Участник гильдии Список требуемых датакронов с приоритетами. С «сезон» — только этот сезон, без него — все сезоны, где есть требования.
• /дк_требования проверить сезон: [игрок] [гильдия] Участник — про себя Без игрока и без гильдия:True — проверка по вашему зарегистрированному аккаунту (участникам доступно только это). С игроком — проверка конкретного человека, с гильдия:True — сводный отчёт по всей гильдии (кто не закрыл «Обязательно»): оба варианта только для офицеров. Под сводкой есть кнопка «Тегнуть должников» — бот одним сообщением в этот же канал тегает всех, кто не закрыл «Обязательно», и пишет, чего именно не хватает.
• /дк_требования добавить сезон: [количество] Офицер / лидер Добавить обычное требование: уровни 3/6/9 + приоритет (Обязательно / По желанию / Полезно) + комментарий. количество: — сколько разных ДК с такими бонусами нужно (например, 5 ДК с одним бонусом 3 ур.). Один датакрон игрока засчитывается только в одно требование, поэтому «5 ДК с бонусом X» проверяется отдельно от требования «X на 3 ур. + Y на 6 ур.».
• /дк_требования добавить_спец сезон: персонаж: уровень: Офицер / лидер Добавить требование к фокусному (спец.) датакрону конкретного персонажа.
• /дк_требования добавить_альтернативу id: уровень: вариант: Офицер / лидер Требование по умолчанию задаёт на каждый уровень (3/6/9) ровно один нужный бонус — эта команда добавляет к уже существующему уровню ещё один допустимый вариант, чтобы требование засчиталось при любом из них. Пример: в требовании #12 на 6 уровне указан бонус «Health +10%» — `/дк_требования добавить_альтернативу id:#12 уровень:6 вариант:«Protection +10%»` сделает так, что подойдёт и Health, и Protection. Только для обычных требований (не фокусных/спец.) и только если на уровне уже не стоит «Любой».
• /дк_требования редактировать id: Офицер / лидер Изменить любое поле требования (обычного или спец.), либо удалить его (параметр удалить:True).
• /дк_требования очистить_сезон сезон: Офицер / лидер Удалить все требования сезона целиком. Сначала покажет количество — реальное удаление только с подтвердить:True.

Задачи

Персональные задания на прокачку конкретного юнита с дедлайном и отслеживанием прогресса.

• /задачи отчёт [игрок] Участник — про себя Прогресс по задачам. Свой отчёт открыт всем; отчёт по чужому игроку или по всей гильдии — только офицерам.
• /задачи добавить Офицер / лидер Поставить задачу игроку на прокачку юнита (гир / релик / звёзды / зета / омикрон) с дедлайном. Для омикрона конкретная способность выбирается автодополнением из способностей юнита.
• /задачи синхронизировать_юниты Офицер / лидер Принудительно обновить справочник персонажей/кораблей, которым бот пользуется для автодополнения юнитов в задачах (обычно обновляется само раз в час).

Территориальная битва (ТБ)

Отчёты по итогам ТБ, сравнение по игрокам/этапам, план планет по фазам и автоматический ордер по картинке стратегии.

• /тб_отчет последняя Офицер / лидер Таблица по всей гильдии за последнюю ТБ: очки территории, юниты во взвод, ОЗ попыток, БЗ волн/попыток.
• /тб_отчет игрок [name] Офицер / лидер Расшифровка одного игрока по фазам и планетам. Без имени — по вашему зарегистрированному аккаунту.
• /тб_отчет сравнение_по_тб Офицер / лидер Та же таблица, что «последняя», но сразу за 3 последние ТБ по каждому игроку — с пометкой, кто просел.
• /тб_отчет сравнение_по_игроку [name] Офицер / лидер Детальное сравнение одного игрока по фазам/планетам за 3 последние ТБ. Без имени — по вашему зарегистрированному аккаунту.
• /тб_отчет синхронизация Офицер / лидер Привязать Discord-пользователей к игровым аккаунтам по совпадению ника — разовая массовая альтернатива ручной /регистрация каждого.
• /тб_отчет план Офицер / лидер Вручную задать/поправить планету для фазы и ветки — фолбэк на случай, если бот не смог сам разобрать анонс офицера с названием планеты.
• /тб_ордер_из_картинки Офицер / лидер Собрать ордер на 6 этапов ТБ из картинки Strategy Summary и сохранить как план для /тб_план выбрать. Картинка — скриншот вкладки «Strategy Summary» планировщика ТБ в ХотЮтилс (HotUtils), не из самой игры: наверху вкладки Round 1-6 и Strategy Summary, нужна именно последняя — таблица Dark/Mixed/Light/Bonus по раундам, с рейтингом ★ снизу справа в каждой заполненной ячейке (пример ниже). Порядок: 1) создать в Discord отдельный тред и первым сообщением в нём отправить этот скриншот; 2) вызвать команду со ссылкой на этот тред. Пример: `/тб_ордер_из_картинки ссылка:<ссылка на тред> название:«44 неделя» звёзды:120` — бот распознает картинку и опубликует в тот же тред 6 сообщений (по одному на этап). Параметр принудительно:True — опубликовать заново, даже если ордер для этих этапов в треде уже есть (например, план поменялся).
• /тб_план список Офицер / лидер Список сохранённых планов ордера ТБ и какой из них сейчас активен.
• /тб_план предпросмотр [название] Офицер / лидер Проверка «на сухую»: что бот сейчас видит по всем 6 этапам в ветке плана, без публикации в канал — удобно свериться после правки ветки вручную. Без названия — берётся активный план. Пометит этапы, которые не нашёл, если ветку меняли и разметка «N этап» съехала.
• /тб_план выбрать Офицер / лидер Выбрать план, из которого бот будет постить ежедневный автоордер ТБ.
• /тб_план сохранить ссылка: название: звёзды: Офицер / лидер Сохранить как план уже готовую ветку с ордером на все 6 этапов — например, вручную дописанную или собранную не через /тб_ордер_из_картинки. Бот проверяет, что в ветке реально нашлись заголовки всех 6 этапов (по тексту вида «1 этап» / «этап 1» в сообщениях) — если каких-то не хватает, план не сохранится, а команда скажет, каких именно. Пример: `/тб_план сохранить ссылка:<ссылка на тред> название:«44 неделя» звёзды:120`.
• /тб_план разослать_взводы этап: Офицер / лидер Разослать в личку Discord всем, кому назначен слот взвода на этом этапе, список их слотов (планета/взвод/юнит). Показывает окно с выпадающими списками, где можно исключить конкретных игроков перед отправкой (например тех, кто уже задонатил) — исключение полностью ручное, бот не проверяет донат в игре. Игроков без привязки Discord (/регистрация) пропускает всегда. То же самое доступно и на сайте — кнопка «Разослать взводы в личку» на /tb/platoons.
• /тб_план удалить Офицер / лидер Удалить сохранённый план ордера ТБ.

Территориальная война (ВГ)

Быстрый копипаст-ордер по контрам на ВГ.

• /вг_ордер пак1: контра1: локация1: [пак2: контра2: локация2: ... до 5] Офицер / лидер Собрать готовый копипаст-ордер по ВГ. Команда одна, но параметров у неё много: до 5 троек «пак / наша контра / локация» — все заполняются за один вызов, Discord откроет их по очереди при наборе команды (сначала пак1, контра1, локация1, затем можно продолжить пак2 и т.д.). Каждое поле — через автодополнение (пак и локация — по фиксированному списку, контра — по базе контр гильдии), вручную печатать не нужно и не сработает. Если под пак не выбрана контра — ордер выйдет с пометкой «контра не выбрана», это не ошибка, просто впишите её в готовый текст вручную. Заполнять нужно только реально нужное число паков (1-5), остальные слоты можно оставить пустыми. Ордер сначала виден только вам; кнопка «Показать всем» публикует его в текущий канал.
• /вг_гайды_синхронизация Офицер / лидер Форс-синхронизация базы контр из форум-канала гайдов ВГ (обычно синхронизируется сама).

Фарм гира

Куда фармить конкретную недостающую деталь гира.

• /фарм ссылка: Офицер / лидер Распознать картинку C3PO (inventory unit) с недостающими деталями по ссылке на сообщение и подсказать, где их фармить. Может быть не видна в списке команд сервера, пока владелец сервера вручную не откроет её роли офицеров (Настройки сервера → Интеграции → бот).

Нарушения

Учёт пропусков/нарушений участников по ТБ, ВГ, рейдам.

• /нарушения добавить Офицер / лидер Зафиксировать нарушение игроку (ТБ / ВГ / Рейд). Игрока можно указать именем или Discord-тегом — у тегнутого должна быть своя /регистрация.
• /нарушения список [игрок] Офицер / лидер Без параметра — сводная таблица по гильдии за 90 дней (у превысивших лимит), с игроком (именем или тегом) — личное досье.
• /нарушения снять Офицер / лидер Интерактивно выбрать и удалить конкретное нарушение у игрока (по имени или тегом).

Дни рождения

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

• /др добавить Офицер / лидер Задать день рождения участника.
• /др удалить Офицер / лидер Убрать день рождения участника.
• /др список Офицер / лидер Список дней рождения гильдии по ближайшей дате.

Омикроны (фан)

Автообъявления в канале о том, кто получил омикрон, с шуточной подписью под конкретного персонажа.

• /омикрон_текст канал Офицер / лидер Канал, куда бот пишет автообъявления о выдаче омикронов.
• /омикрон_текст фраза Офицер / лидер Задать/обновить фразу-приписку для омикрона персонажа.
• /омикрон_текст удалить_фразу Офицер / лидер Убрать фразу-приписку у персонажа.
• /омикрон_текст список Офицер / лидер Показать все настроенные фразы.
• /омикроны отчёт [игрок] Участник — про себя Какие приоритетные для ВГ омикроны игрок уже готов поставить (владеет всеми юнитами-требованиями на нужном релике), но ещё не поставил. Свой отчёт — без параметра, через /регистрация; чужого игрока смотрят только офицеры.

Настройки гильдии

Каналы и роли, которые бот использует для авто-уведомлений — дублируется страницей /settings на сайте.

• /канал Офицер / лидер Запомнить текущий канал/ветку в списке гильдии — станет доступен для выбора в настройках оповещений (Discord и сайт).
• /настройки список Офицер / лидер Показать все текущие настройки каналов и ролей гильдии.
• /настройки тб_ротация_канал / тб_ротация_роль Офицер / лидер Канал и роль для тега на ротацию/взводы перед ТБ.
• /настройки др_канал / др_роль Офицер / лидер Канал и роль для поздравлений с днём рождения.
• /настройки тб_отчет_канал Офицер / лидер Канал для автоотчёта по итогам ТБ и уведомлений офицерам.
• /настройки тб_план_канал Офицер / лидер Канал анонсов плана ТБ.
• /настройки тб_ордер_источник Офицер / лидер Канал или ветка-источник со стратегией на этапы ТБ.
• /настройки тб_ордер_роль Офицер / лидер Роль, тегаемая в автоматическом ордере ТБ.
• /настройки тб_модуль Офицер / лидер Вкл/выкл тег-напоминания и/или автопубликацию плана/ордера ТБ, без потери настроек канала/роли.
• /настройки вг_гайды_канал Офицер / лидер Форум-канал с гайдами по контрам ВГ, откуда бот берёт данные для /вг_ордер.
• /настройки задачи_канал Офицер / лидер Канал для уведомлений о выполнении/провале задач и напоминаний о дедлайне.
• /настройки задачи_модуль Офицер / лидер Вкл/выкл тег игрока в сообщении о постановке новой задачи (по умолчанию выключено).

Прочее

• /пригласить Открыто всем Получить ссылку, чтобы добавить бота на свой Discord-сервер.
• /гильдия_заявка Открыто всем Подключить вашу гильдию к боту платно — выполняется на сервере самой гильдии.

Ручной доступ (офицеры своей гильдии)

Для участников, которых бот не резолвит по игровому рангу (например Discord другого аккаунта). Действует только в рамках вашей гильдии — веб-аналог: страница /access.

• /грант добавить юзер: аллай_код: уровень: Офицер / лидер Выдать участнику ручной доступ (Игрок или Офицер) в вашей гильдии.
• /грант удалить юзер: Офицер / лидер Снять ранее выданный доступ. Можно снять только грант, выданный в вашей же гильдии.
• /грант список Офицер / лидер Список ручных грантов доступа в вашей гильдии.