HELPER SETUP АВТО-ЗАСТРОЙКА СЕРВЕРА /SETUP / FULL AUTO BUILD / MANUAL MODULE WIZARD / MODULE_STATES SYNC
Setup — это стартовый установщик HELPER для покупателя. Администратор сервера вводит /setup, выбирает полную авто-застройку или ручную настройку, а бот создаёт/находит роли, категории, каналы, публикует основные панели и включает клиентские модули. Всё работает строго по guild_id и не смешивает настройки разных серверов.
Что делает Setup
Setup — это быстрый запуск всего HELPER на новом сервере. Он не заменяет тонкую настройку каждого модуля, а создаёт правильный фундамент: системные логи, каналы проверки, публичные панели, роли staff/member, роли реакций, статистику и включённые client-модули в module_states.json.
Открыть установщик
Администратор вызывает /setup. Меню приходит ephemeral и привязано к автору.
Выбрать режим
Полная авто-застройка или ручные мастеры каналов/ролей.
Развернуть панели
Бот публикует welcome, tickets, shop, reports, events и другие интерфейсы.
Донастроить сайт
Владелец привязывает форум-каналы и редактирует тексты/баннеры в Dashboard.
Больше информации картинками
Ниже весь путь установки: команда, меню выбора, авто-застройка, создаваемая структура, ручной мастер, итоговый embed, ручной шаг с форумами и disabled-state.
Команда Discord
В Setup всё начинается с одной команды. Дальше пользователь работает с кнопками и select-меню, чтобы не запоминать десятки setup-команд.
/setupОткрывает интерактивный установщик HELPER. Команда работает только на сервере и требует Administrator.
🚀 Полная авто-застройка
⚙️ Ручная настройкаДве главные кнопки: полный автоматический запуск или ручная привязка уже существующих каналов/ролей.
if inter.user.id != author_id:
"Это меню настройки открыто другим администратором."Меню защищено от чужих кликов: управляет только тот админ, который вызвал /setup.
module_states.json → setup/settings/installerЕсли модуль выключен на сайте, /setup отдаёт короткое сообщение и не запускает установщик.
Путь авто-застройки за один клик
menu
channels/roles
categories
deploy
modules on
forums
Administratorкоманду может открыть только администратор.Manage Channelsнужно для создания категорий и каналов.Manage Rolesнужно для ролей [H] и ролей реакций.bot_memberбот должен быть найден как участник сервера.⚙️ СИСТЕМА HELPERлоги, проверки отчётов/покупок/заявок, архивы.👋 ДОБРО ПОЖАЛОВАТЬверификация новых участников.📞 ЦЕНТР ПОДДЕРЖКИсоздание тикетов.🎮 ПРИВАТНЫЕ КОМНАТЫпанель приваток.🎁 МЕРОПРИЯТИЯсборы, розыгрыши и итоги.💼 ИГРОВОЙ ПРОЦЕССмагазин, отчёты, заявки, роли, статистика.deploy_eventsпубликует станцию сборов.deploy_ticketsцентр поддержки и категория тикетов.deploy_temp_roomsпанель создания приватных комнат.deploy_giveawaysпанель розыгрышей и канал итогов.deploy_shop / reportsмагазин и рабочие отчёты.deploy_reaction_roles / statsроли за реакции и live-статистика.Ручная настройка существующего сервера
Ручной режим нужен, если владелец уже сделал структуру сервера и не хочет, чтобы бот создавал категории. Администратор выбирает модуль в dropdown и привязывает каналы/роли через Discord select-меню.
📜 Логиглобальный канал системных логов.👋 Верификацияканал welcome и роли участника.🎫 Тикетыканал панели, категория, support-роли.🎮 Приваткиканал панели и категория комнат.🎁 Розыгрыши / 🗺️ Сборыканалы публикации и итогов.📝 Заявкивитрина, проверка, архивы и staff-роли.🛒 Магазинвитрина, проверка, форум личных дел, роли проверяющих.💼 Отчётытерминал, проверка, форум архива, кураторы.🎭 Роли за реакцииканал плашки, выдаваемые роли, роли админов.📊 Статистикаканал публичной live-статистики.Что создаёт полная авто-застройка
📜・логи-ботаобщий канал системных логов.📥・проверка-отчетовпроверка рабочих отчётов.🛒・проверка-покупокмодерация покупок магазина.📝・рассмотрение-заявокstaff-канал заявок.✅・одобренные-заявкиархив одобрений.❌・отклоненные-заявкиархив отказов.📊・отчеты-сборовлоги мероприятий.✅・верификацияwelcome / verification.🎫・создать-тикетцентр поддержки.➕・управление-комнатойприватные комнаты.📅・сборы-составаevents / сборы.🎉・розыгрышиактивные giveaways.🏆・итоги-розыгрышейрезультаты giveaways.🛒・магазинвитрина Shop.📋・отчетытерминал Reports.📝・кабинет-наборапанель Applications.🎭・роли-за-реакциипанель Reaction Roles.📊・статистикаlive stats.[H] Руководствоstaff/admin[H] Участникmember[H] Новостиreaction[H] Розыгрышиreaction[H] Клиентыreactionoverwritesstaff-onlyКакие модули поднимает Setup
👋 Верификация
Сохраняет welcome_channel и member_role, затем пытается отправить welcome-панель.
🎫 Тикеты
Канал панели, категория тикетов, лог-канал и support_role_ids.
🎮 Приватки
Канал управления и категория персональных комнат.
🗺️ Сборы
Панель станции сборов и канал отчётов мероприятий.
🎁 Розыгрыши
Канал активных розыгрышей, итоги, announcement_channel и deploy.
📝 Заявки
Витрина набора, проверка, approved/rejected архивы и staff roles.
🛒 Магазин
Витрина, канал проверки покупок, лог-канал, роли проверяющих и опциональный форум.
💼 Отчёты
Терминал, проверка, лог, роли кураторов, DEFAULT_REPORT_TYPES и ForumChannel.
🎭 Reaction Roles
Канал ролевой плашки, набор ролей для выдачи и admin_roles панели.
📊 Статистика
Канал публичной статистики и попытка вызвать deploy у StatsCog.
🧩 Пассивные
Banners, constructor, embed_builder, leaderboard, profiles, reputation, help и setup включаются без отдельного канала.
🔌 Disabled
Если setup выключен, команда не стартует, но уже созданные настройки других модулей не удаляются.
Ручной шаг ForumChannel
Важная часть, которую нужно прямо показать покупателю: Setup специально не создаёт Discord ForumChannel автоматически. Это нужно, чтобы владелец сам выбрал права, категорию и структуру. Обычные текстовые каналы бот создаёт сам.
Что писать в Wiki покупателю
Основные панели работают сразу после авто-застройки. Полный архив личных дел, форумный магазин и часть продвинутых функций станут полноценными после ручной привязки ForumChannel на сайте.
Настройка на сайте
Setup сам по себе в основном хранит состояние включения, а результаты установки раскладывает по JSON-файлам других модулей. Все записи идут через data/<module>_settings.json и data/module_states.json.
update_module_stateвключает модуль для конкретного guild_id.STATE_COMPAT_ALIASESпишет совместимые alias ключи.setup/settings/installerключи, которые могут отключить сам установщик.CLIENT_MODULESсписок клиентских модулей, которые Setup включает.tickets_settings.jsoncategory_id, log_channel_id, support_role_ids, panel_message_id.shop_settings.jsonSHOP_CHANNEL_ID, CHECK_CHANNEL_ID, LOG_CHANNEL_ID, FORUM_CHANNEL_ID.reports_settings.jsonREPORT_TERMINAL_CHANNEL, REPORT_TYPES, REPORT_MESSAGE_ID.reaction_roles_settings.jsonsystems, channel_id, message_id, items.Права и безопасность
Administrator
/setup и меню доступны только администраторам сервера.
Manage Channels
Нужно для создания категорий и текстовых каналов при авто-застройке.
Manage Roles
Нужно для ролей [H] и последующей работы reaction roles / welcome / staff-доступов.
Author lock
Другой админ не может нажимать чужое меню установки.
@everyoneне видит системную категорию.bot_memberвидит, пишет и управляет каналами.[H] Руководствовидит и пишет в системных каналах.public_read_onlyпубличные панели видны, но пользователи не пишут туда текст.Forbiddenне хватает прав Discord.роль бота нижесоздание/выдача ролей может быть заблокирована.cog missingпанель конкретного модуля не публикуется, но настройки могут сохраниться.forum missingличные дела и форумный магазин требуют ручной привязки.Если Setup выключен
Отключение Setup не удаляет созданные каналы, роли и настройки других модулей. Оно просто запрещает снова открыть установщик через /setup.
setupосновной ключ.settingsalias для страницы настроек.installeralias установщика.after enable/setup снова открывает MainSetupView.Карта технической логики
SetupCog, deploy_* методы, enable_passive_modules и slash-команда /setup.
MainSetupView, FullSetupView, ManualSetupDropdownView и ручные мастеры.
CLIENT_MODULES, MODULE_ALIASES, STATE_COMPAT_ALIASES и DEFAULT_REPORT_TYPES.
JSON helpers, module states, channel/role helpers, send_panel_message и disabled embeds.
Используется для общего log_channel через config key guild_id_log_channel.
/setupadmin onlyFULL CD15 секундAUTHORmenu lockCLIENT18 modulesFORUMmanualJSONatomic writeget_loaded_view_classпытается найти View в загруженном cog/module.call_view_factoryподбирает совместимую сигнатуру View.ensure_viewfallback для уже созданной view.build_*_payloadShop/Reports могут отдать готовый embed+view.send_panel_messageредактирует старое сообщение или создаёт новое.update_module_stateвключает модули и compat aliases.update_json_settingsпишет data/<module>_settings.json.save_server_configсохраняет global log_channel в SQLite config.deploy_requested=Falseпосле прямого deploy с Discord.last_*_channel_idпомогает переносить/редактировать панели.Ошибки и решения
/setup не открывается
Проверьте, что пользователь администратор, команда вызвана на сервере, а setup не выключен в module_states.json.
Авто-застройка пишет, что нет прав
Боту нужны Manage Channels и Manage Roles. Также роль бота должна быть достаточно высоко в иерархии.
Форумы не создались
Это правильное поведение. Форум-каналы создаются вручную: 📂・личные-дела и, при необходимости, 🛒・магазин-каталог.
Некоторые панели не появились
Проверьте, загружен ли соответствующий cog. Setup сохраняет настройки, но deploy конкретной панели зависит от модуля.
Ручной магазин/отчёты требуют логи
Сначала настройте 📜 канал системных логов, потому что Shop и Reports используют общий log_channel.
Каналы уже существовали
Setup старается найти существующие по имени и использовать их, а не создавать дубль, но старые message_id всё равно лучше проверить на сайте.