Вайтлист FiveM через Discord и txAdmin: полная настройка
С txAdmin вайтлист FiveM через Discord может держаться на одной роли: игроки с ролью @Вайтлист заходят, всех остальных не пускают уже на входе. Добавь бота для заявок, который выдаёт эту роль, когда администрация одобряет заявку, и одобрение заявки — это и есть вайтлист. Никаких лицензий для копирования и консольных команд.
Toscio работает с вайтлистом txAdmin по роли Discord: роль, выданная при одобрении, пускает игрока на сервер. Гайд займёт около 15 минут — от нуля до первой одобренной анкеты.
Как это работает
Три элемента, у каждого одна задача:
| Элемент | Что делает |
|---|---|
| Роль @Вайтлист | Ключ к твоему серверу FiveM |
| Toscio | Принимает анкеты в Discord и выдаёт роль, когда администрация одобряет |
| txAdmin | Проверяет роль при каждом подключении и не пускает игроков без неё |
Для игрока: он заходит в твой Discord, нажимает Подать заявку, заполняет анкету на вайтлист, получает в ЛС «заявка одобрена», запускает FiveM и подключается. Никому из команды не пришлось открывать txAdmin.
Гайд описывает меню txAdmin 8, которое идёт в свежих сборках FXServer. Названия опций могут немного меняться от версии к версии.
Перед началом
Понадобится:
- сервер FiveM с txAdmin и аккаунт txAdmin с правом менять настройки;
- право Управлять сервером в твоём Discord;
- Режим разработчика в Discord, чтобы копировать ID: Настройки пользователя → Расширенные → Режим разработчика.
1. Создай роль @Вайтлист
- В своём Discord открой Настройки сервера → Роли → Создать роль.
- Назови её Вайтлист (или WL, Житель… название не важно).
- Нажми на роль правой кнопкой и выбери Копировать ID роли. Сохрани это число.
Проводишь обзвон или держишь роль для гостей? Создай ещё роль @Гость: Toscio может снимать её при одобрении анкеты.
2. Создай бота Discord для txAdmin
txAdmin нужен собственный бот, чтобы читать роли игроков. Это не Toscio: это твой бот, которым пользуется только txAdmin.
- Зайди на Discord Developer Portal и нажми New Application. Назови его как свой сервер.
- Во вкладке Bot нажми Reset Token и скопируй токен. Никому его не показывай: он даёт полный контроль над ботом.
- Там же, в Bot, включи Server Members Intent и сохрани. Без этого txAdmin не видит роли.
- В OAuth2 → URL Generator отметь scope bot, открой сгенерированную ссылку и добавь бота на свой сервер Discord.
Если настройки Discord в txAdmin не сохраняются или зависают, почти всегда дело в Server Members Intent.
3. Подключи бота в txAdmin
- В txAdmin открой Settings, затем вкладку Discord.
- Включи Discord Bot.
- Вставь токен в поле Token.
- В Guild/Server ID вставь ID своего сервера Discord (правый клик по названию сервера, Копировать ID сервера).
- Сохрани.
4. Переключи txAdmin на вайтлист по роли Discord
- Там же, в Settings, открой вкладку Whitelist.
- В Allowlist Mode выбери Discord Server Roles.
- В Allowlisted Discord Roles вставь ID роли @Вайтлист. Можно добавить несколько через запятую (например, @Вайтлист и @Стафф).
- В Allowlist Instructions объясни тем, кого не пустило, как подать анкету, например: «Заходи на discord.gg/tvoyserver и подай заявку в #вайтлист».
- Сохрани.
С этого момента txAdmin не пускает игроков без роли. Перед проверкой выдай её себе и своей администрации.
5. Принимай анкеты через Toscio
Осталось выдавать роль автоматически.
- Добавь Toscio в свой Discord.
- В Настройках сервера → Роли перетащи роль Toscio выше @Вайтлист. Discord разрешает боту выдавать только роли ниже его собственной.
- Запусти
/toscio setupс параметрами:template: «RP вайтлист»;channel: где игроки подают анкеты, например#вайтлист;staff-channel: приватный канал для команды вайтлиста, например#заявки-вл;role: @Вайтлист;staff-role: роль команды вайтлиста, если она есть.
Toscio публикует панель с кнопкой Подать заявку и подтверждает, куда будут приходить анкеты. Первая форма даёт 14 дней Premium бесплатно, без банковской карты: полный вайтлист со всеми вопросами.
Вопросы выбирай из 53 вопросов для анкеты на вайтлист GTA RP, затем измени форму в редакторе формы. В настройках формы можно также снимать @Гость при одобрении.
6. Проверь весь путь
Со второго аккаунта Discord или с помощью друга:
- Нажми Подать заявку, заполни анкету и отправь.
- В
#заявки-влнажми Одобрить на карточке заявки. - Проверь, что аккаунт получил @Вайтлист и ЛС с подтверждением.
- Открой приложение Discord для компьютера, запусти FiveM и подключись: тебя пустит.
- Сними роль и попробуй снова: txAdmin не пустит и покажет твоё сообщение с инструкцией.
Что видит администрация
Каждая анкета приходит в канал администрации с ответами, возрастом аккаунта Discord и датой входа игрока на сервер, плюс три кнопки:
- Одобрить: Toscio выдаёт @Вайтлист и пишет игроку в ЛС на его языке. Он может подключаться сразу.
- Отклонить: с причиной, чтобы игрок знал, что исправить. Пауза 24 часа (настраивается) не даёт заваливать вас повторными анкетами.
- Собеседование: открывается приватная ветка с игроком. Удобно, чтобы задать письменные уточняющие вопросы.
Проводишь обзвон перед тем, как пустить игрока? Включи этап перед окончательным одобрением в редакторе формы и назови его «Обзвон». Зелёная кнопка карточки превращается в Подтвердить → Обзвон: игрок получает роль @Обзвон и ЛС со временем, а администрация — напоминание, если обзвон затянулся. После него Одобрить выдаёт @Вайтлист и снимает @Обзвон. Этап бесплатный.
Частые ошибки
| Сообщение или симптом | Причина | Решение |
|---|---|---|
| «You do not have the discord identifier» | FiveM не находит аккаунт Discord игрока | Открыть приложение Discord для компьютера (не в браузере) до запуска FiveM |
| «You are required to join our Discord server» | Игрока нет в Discord, указанном в txAdmin | Проверить Guild/Server ID и что игрок зашёл на нужный сервер |
| «You do not have a allowlisted role» | У игрока нет роли или вставлен неверный ID | Проверить ID роли во вкладке Whitelist |
| Одобрение в Toscio не срабатывает | Роль Toscio ниже @Вайтлист | Поднять роль Toscio в Настройках сервера → Роли |
| txAdmin не сохраняет настройки Discord | Не включён intent | Включить Server Members Intent на Developer Portal |
Игрок должен использовать тот же аккаунт Discord, с которого подавал анкету: txAdmin проверяет роль аккаунта Discord, открытого на его ПК.
А как же вайтлист по лицензии?
В txAdmin есть и режим Approved License: каждого игрока нужно одобрить вручную на странице Allowlist в txAdmin по ID запроса. Это работает, но кому-то из команды придётся делать это для каждого игрока, вдобавок к чтению его анкеты.
С ролью Discord решение и доступ — одно и то же. Снял роль — убрал доступ, свою администрацию можно пустить второй ролью, а вся история вайтлиста остаётся в Discord.
Что ещё можно сделать
- Обжалование бана: игрок, забаненный в твоём Discord, больше не может подать анкету. С веб-формой и обжалованием бана он подаёт апелляцию на веб-странице, а Toscio его разбанит, если администрация одобрит.
- Голосование администрации (Premium): несколько человек из команды вайтлиста голосуют по каждой анкете, и Toscio решает, когда голосов достаточно.
- Тест по правилам: 3–4 вопроса с выбором с оценкой (ДМ, NLR, МГ…) и порог прохождения. Игрок, который не сдал, получает автоматический отказ и свой результат, но не правильные ответы. Это бесплатно.
- Вебхуки в твой CAD/MDT (Premium): каждая полученная, переведённая на этап, одобренная или отклонённая анкета уходит в виде подписанного JSON на выбранный тобой адрес https (CAD/MDT, таблица, скрипт). Внутриигрового ресурса FiveM у Toscio нет: событие принимает твой инструмент и делает с ним что нужно.
- Анкета до входа в Discord (Premium): txAdmin требует, чтобы игрок был в твоём Discord. С веб-формой, открытой для тех, кого ещё нет на сервере, он подаёт анкету с твоего сайта; после одобрения он заходит в твой Discord в один клик с @Вайтлист и может подключаться к FiveM.
- Несколько форм: гражданский вайтлист, полиция, EMS, стафф… у каждой своя роль и канал. См. страницу вайтлист FiveM.
Выбираешь между Toscio и FiveApply? Смотри Toscio или FiveApply.
Вопросы
Как сделать вайтлист FiveM через Discord?
В txAdmin включи бота Discord (вкладка Discord), затем во вкладке Whitelist выбери режим «Discord Server Roles» и вставь ID роли @Вайтлист. Подключиться смогут только игроки с этой ролью в твоём Discord. Бот для заявок вроде Toscio выдаёт роль, когда администрация одобряет анкету.
Почему игрок видит «You do not have the discord identifier»?
FiveM не нашёл его аккаунт Discord. Игроку нужно открыть приложение Discord для компьютера (не версию в браузере) до запуска FiveM, а потом подключиться снова.
Нужен ли txAdmin свой бот Discord рядом с Toscio?
Да. txAdmin использует собственного бота, созданного на Discord Developer Portal, чтобы читать роли игроков. Toscio принимает анкеты и выдаёт роль. Они работают параллельно и не мешают друг другу.
Как убрать человека из вайтлиста?
Сними с него роль @Вайтлист в Discord. txAdmin проверяет роль при каждом подключении, так что при следующей попытке игрока не пустит.
Вайтлист по роли Discord работает с ESX и QBCore?
Да. txAdmin проверяет игрока при подключении, ещё до фреймворка. Всё работает одинаково на ESX, QBCore, Qbox или своём фреймворке.


