Whitelista FiveM przez Discorda z txAdmin: pełny poradnik
Z txAdmin twoja whitelista FiveM może opierać się na jednej roli na Discordzie: gracze z rolą @Whitelist wchodzą, wszyscy inni odbijają się od drzwi. Dodaj bota do podań, który nadaje tę rolę, gdy administracja przyjmie podanie, a samo przyjęcie podania wystarczy, żeby gracz był na WL. Bez kopiowania licencji, bez komend w konsoli.
Toscio działa z whitelistą txAdmin po roli Discord: rola nadana po przyjęciu wpuszcza gracza na serwer. Ten poradnik zajmie ci około 15 minut, od zera do pierwszego przyjętego podania.
Jak to działa
Trzy elementy, każdy ma jedno zadanie:
| Element | Co robi |
|---|---|
| Rola @Whitelist | Klucz do twojego serwera FiveM |
| Toscio | Zbiera podania na Discordzie i nadaje rolę, gdy administracja przyjmie |
| txAdmin | Sprawdza rolę przy każdym połączeniu i odrzuca graczy bez niej |
Po stronie gracza: dołącza do twojego Discorda, klika Złóż podanie, wypełnia formularz na WL, dostaje DM „podanie przyjęte”, odpala FiveM i wchodzi. Nikt z ekipy nie musiał otwierać txAdmina.
Ten poradnik opiera się na menu txAdmin 8, dostarczanym z nowszymi buildami FXServera. Nazwy opcji mogą się trochę przesuwać między wersjami.
Zanim zaczniesz
Potrzebujesz:
- serwera FiveM z txAdmin i konta txAdmin z prawem do zmiany ustawień;
- uprawnienia Zarządzanie serwerem na swoim Discordzie;
- trybu dewelopera w Discordzie, żeby kopiować ID: Ustawienia użytkownika → Zaawansowane → Tryb dewelopera.
1. Utwórz rolę @Whitelist
- Na swoim Discordzie otwórz Ustawienia serwera → Role → Utwórz rolę.
- Nazwij ją Whitelist (albo WL, Obywatel… nazwa nie ma znaczenia).
- Kliknij rolę prawym przyciskiem i wybierz Kopiuj ID roli. Zachowaj ten numer pod ręką.
Robisz rozmowę na WL albo etap dla gości? Utwórz też rolę @Gość: Toscio może ją zabrać po przyjęciu podania.
2. Utwórz bota Discord dla txAdmin
txAdmin potrzebuje własnego bota, żeby czytać role twoich graczy. To nie jest Toscio: to twój własny bot, używany tylko przez txAdmin.
- Wejdź na Discord Developer Portal i kliknij New Application. Nazwij ją jak swój serwer.
- W zakładce Bot kliknij Reset Token i skopiuj token. Nigdy go nie udostępniaj: daje pełną kontrolę nad botem.
- Dalej w Bot włącz Server Members Intent i zapisz. Bez tego txAdmin nie widzi ról.
- W OAuth2 → URL Generator zaznacz zakres bot, otwórz wygenerowany link i dodaj bota na swój serwer Discord.
Jeśli zapisywanie ustawień Discorda w txAdmin się nie udaje albo wisi, powodem prawie zawsze jest brak Server Members Intent.
3. Podłącz bota w txAdmin
- W txAdmin otwórz Settings, a potem zakładkę Discord.
- Włącz Discord Bot.
- Wklej token w polu Token.
- W Guild/Server ID wklej ID swojego serwera Discord (prawy przycisk na nazwie serwera, Kopiuj ID serwera).
- Zapisz.
4. Przełącz txAdmin na whitelistę po roli Discord
- Dalej w Settings otwórz zakładkę Whitelist.
- W Allowlist Mode wybierz Discord Server Roles.
- W Allowlisted Discord Roles wklej ID roli @Whitelist. Możesz dodać kilka, oddzielonych przecinkami (np. @Whitelist i @Administracja).
- W Allowlist Instructions napisz odrzuconym graczom, jak złożyć podanie, np.: „Wbij na discord.gg/twojserwer i złóż podanie na #podanie-wl.”
- Zapisz.
Od teraz txAdmin odrzuca każdego gracza bez tej roli. Przed testem nadaj ją sobie i swojej ekipie.
5. Zbieraj podania przez Toscio
Zostało tylko automatyczne nadawanie roli.
- Dodaj Toscio na swojego Discorda.
- W Ustawieniach serwera → Role przeciągnij rolę Toscio nad @Whitelist. Discord pozwala botowi nadawać tylko role niższe niż jego własna.
- Wpisz
/toscio setupz:template: Whitelista RP (FiveM, GTA RP…);channel: gdzie gracze składają podania, np.#podanie-wl;staff-channel: prywatny kanał dla ekipy od WL, np.#podania-wl;role: @Whitelist;staff-role: rola twojej ekipy od WL, jeśli taką masz.
Toscio publikuje panel z przyciskiem Złóż podanie i potwierdza, gdzie będą trafiać podania. Pierwszy formularz daje 14 dni Premium za darmo, bez karty: pełna whitelista ze wszystkimi pytaniami.
Żeby dobrać pytania, przejrzyj 53 pytania na WL FiveM, a potem edytuj formularz w edytorze formularza. W ustawieniach formularza możesz też ustawić zabieranie @Gość po przyjęciu.
6. Przetestuj cały proces
Z drugiego konta Discord albo z pomocą znajomego:
- Kliknij Złóż podanie, wypełnij formularz na WL i wyślij.
- Na
#podania-wlkliknij Przyjmij na karcie podania. - Sprawdź, czy konto dostało @Whitelist i DM z potwierdzeniem.
- Otwórz aplikację Discord na komputerze, odpal FiveM i połącz się: wchodzisz.
- Zabierz rolę i spróbuj jeszcze raz: txAdmin odrzuca cię z twoją wiadomością z instrukcją.
Co widzi administracja
Każde podanie trafia na kanał administracji z odpowiedziami, wiekiem konta Discord i datą dołączenia gracza do serwera, plus trzy przyciski:
- Przyjmij: Toscio nadaje @Whitelist i pisze do gracza DM w jego języku. Może od razu wchodzić.
- Odrzuć: z powodem, żeby gracz wiedział, co poprawić. Czas oczekiwania 24 godziny (do zmiany) zatrzymuje spam podaniami.
- Rozmowa: otwiera się prywatny wątek z graczem. Wygodne, żeby dopytać na piśmie.
Robisz rozmowę na WL na kanale głosowym, zanim wpuścisz graczy? Włącz etap przed ostatecznym przyjęciem w edytorze formularza i nazwij go „Rozmowa na WL”. Zielony przycisk karty zmienia się w Zatwierdź → Rozmowa na WL: gracz dostaje rolę @Rozmowa WL i DM z terminem, a administracja dostaje przypomnienie, jeśli rozmowa się przeciąga. Po niej Przyjmij nadaje @Whitelist i zdejmuje @Rozmowa WL. Etap jest za darmo.
Częste błędy
| Komunikat albo objaw | Przyczyna | Rozwiązanie |
|---|---|---|
| „You do not have the discord identifier” | FiveM nie znajduje konta Discord gracza | Otwórz aplikację Discord na komputerze (nie w przeglądarce) przed uruchomieniem FiveM |
| „You are required to join our Discord server” | Gracza nie ma na Discordzie ustawionym w txAdmin | Sprawdź Guild/Server ID i czy gracz dołączył do właściwego serwera |
| „You do not have a allowlisted role” | Gracz nie ma roli albo wklejone ID jest błędne | Sprawdź ID roli w zakładce Whitelist |
| Przyjęcie nie działa w Toscio | Rola Toscio jest pod @Whitelist | Przesuń rolę Toscio wyżej w Ustawieniach serwera → Role |
| txAdmin nie zapisuje ustawień Discorda | Brak intentu | Włącz Server Members Intent w Developer Portal |
Gracz musi używać tego samego konta Discord, z którego złożył podanie: txAdmin sprawdza rolę konta Discord otwartego na jego komputerze.
A whitelista po licencji?
txAdmin ma też tryb Approved License: każdego gracza trzeba zatwierdzić ręcznie na stronie Allowlist w txAdmin, po ID prośby. Działa, ale ktoś z ekipy musi to zrobić dla każdego gracza, oprócz przeczytania jego podania.
Przy roli Discord decyzja i dostęp to jedno i to samo. Zabranie roli zabiera dostęp, administrację wpuścisz drugą rolą, a cała historia whitelisty zostaje na Discordzie.
Co dalej
- Odwołania od bana: gracz zbanowany na twoim Discordzie nie może już złożyć podania. Dzięki formularzowi www i odwołaniom od bana odwołuje się ze strony www, a Toscio zdejmuje mu bana, jeśli administracja przyjmie odwołanie.
- Głosowanie administracji (Premium): kilka osób z ekipy od WL głosuje nad każdym podaniem, a Toscio decyduje, gdy zbierze się dość głosów.
- Quiz z regulaminu: 3 albo 4 oceniane pytania wyboru (RDM, NLR, MG…) z progiem zaliczenia. Gracz, który nie zda, jest odrzucany automatycznie i dostaje swój wynik, nigdy poprawnych odpowiedzi. Za darmo.
- Webhooki do CAD/MDT (Premium): każde otrzymane, przeniesione do etapu, przyjęte albo odrzucone podanie jest wysyłane jako podpisany JSON na wybrany adres https (CAD/MDT, arkusz, skrypt). Toscio nie ma zasobu FiveM w grze: to twoje narzędzie odbiera zdarzenie i robi z nim, co chcesz.
- Podanie przed dołączeniem do Discorda (Premium): txAdmin wymaga, żeby gracz był na twoim Discordzie. Z formularzem na stronie otwartym dla osób, których jeszcze nie ma na serwerze, gracz składa podanie z twojej strony www; po przyjęciu dołącza do Discorda jednym kliknięciem z @Whitelist i może wejść na FiveM.
- Kilka formularzy: whitelista cywilna, policja, EMS, administracja… każdy z własną rolą i kanałem. Zobacz stronę whitelisty FiveM.
Wahasz się między Toscio a FiveApply? Zobacz Toscio vs FiveApply.
Pytania
Jak zrobić whitelistę FiveM przez Discorda?
W txAdmin włącz bota Discord (zakładka Discord), potem w zakładce Whitelist wybierz tryb „Discord Server Roles” i wklej ID roli @Whitelist. Na serwer wejdą tylko gracze z tą rolą na twoim Discordzie. Bot do podań, np. Toscio, nadaje tę rolę, gdy administracja przyjmie podanie.
Dlaczego gracz dostaje „You do not have the discord identifier”?
FiveM nie znalazł jego konta Discord. Gracz musi otworzyć aplikację Discord na komputerze (nie wersję w przeglądarce) przed uruchomieniem FiveM, a potem połączyć się ponownie.
Czy txAdmin potrzebuje własnego bota Discord obok Toscio?
Tak. txAdmin używa własnego bota, utworzonego w Discord Developer Portal, żeby czytać role graczy. Toscio obsługuje podania i nadaje rolę. Oba działają obok siebie i sobie nie przeszkadzają.
Jak usunąć kogoś z whitelisty?
Zabierz mu rolę @Whitelist na Discordzie. txAdmin sprawdza rolę przy każdym połączeniu, więc przy następnej próbie gracz zostanie odrzucony.
Czy whitelista po roli Discord działa z ESX i QBCore?
Tak. txAdmin sprawdza gracza przy łączeniu, zanim framework w ogóle wejdzie do gry. Działa tak samo na ESX, QBCore, Qbox czy własnym frameworku.


