Aby połączyć txAdmin z Discord, utwórz dedykowaną aplikację i bota Discord, dodaj go na właściwy serwer z tylko niezbędnymi uprawnieniami, skopiuj token bota do ustawień Discord w txAdmin i skonfiguruj wiadomości statusu oraz dostęp oparty na rolach jako oddzielne funkcje. Zachowaj poufność tokena: uwierzytelnia on bota i nigdy nie powinien pojawiać się na zrzutach ekranu, w plikach klienta ani w publicznym repozytorium.
Przegląd 12 sierpnia 2026 r. zgodnie z oficjalną dokumentacją Cfx.re txAdmin, Discord konfiguracja aplikacji I dokumentacja OAuth2. Etykiety mogą się zmieniać między wydaniami txAdmin, dlatego używaj ustawień pokazanych przez zainstalowaną wersję.
Rozdziel cztery ruchome części
| Część | Cel | Typowa awaria |
|---|---|---|
| Aplikacja i bot Discord | Tożsamość używana przez txAdmin | Nieprawidłowa aplikacja, wyłączony bot lub wygenerowany ponownie token |
| Status serwera | Publikuje lub aktualizuje status na wybranym kanale | Nieprawidłowy kanał lub brak uprawnień do wyświetlania/wysyłania/osadzania |
| Role lub biała lista | Mapuje członkostwo/role Discord do skonfigurowanej reguły dostępu | Nieprawidłowy identyfikator serwera/roli, hierarchia ról lub wymóg intencji członka |
| Uprawnienia txAdmin | Kontroluje, kto może zarządzać serwerem FiveM | Rola Discord została przyjęta, aby automatycznie przyznać prawa txAdmin |
Nie debuguj ich jako jednej funkcji. Najpierw udowodnij, że bot jest online, następnie udowodnij, że może uzyskać dostęp do jednego kanału, dodaj zachowanie statusu, a dopiero potem przetestuj opcjonalną logikę ról lub białej listy.
Krok 1: utwórz dedykowaną aplikację Discord
- Otwórz portal deweloperski Discord i utwórz nową aplikację dla tego serwera.
- Dodaj bota do aplikacji.
- Nadaj mu jasną nazwę, aby personel mógł odróżnić wersję produkcyjną od stagingowej.
- Wygeneruj lub zresetuj token tylko wtedy, gdy jesteś gotów bezpiecznie go przechowywać.
Token bota to sekret, a nie identyfikator aplikacji ani klucz publiczny. Jeśli zostanie ujawniony, zresetuj go w Discord i natychmiast zaktualizuj txAdmin. Przechowuj zamiennik tylko w ustawieniu po stronie serwera przeznaczonym dla tokenu.
Krok 2: zaproś bota z minimalnymi uprawnieniami
Użyj przepływu instalacji OAuth2 Discord dla aplikacji i wybierz zakres bota wymagany przez bieżącą konfigurację. Zacznij od najmniejszych uprawnień do kanału, które spełniają funkcję: przeglądanie wybranego kanału, wysyłanie wiadomości, osadzanie linków i odczytywanie historii wiadomości, gdy jest to potrzebne do aktualizacji statusu. Unikaj uprawnień Administratora, chyba że oficjalna integracja wyraźnie tego wymaga i przejrzałeś powody.
Ogranicz bota do dedykowanego kanału statusu lub administracyjnego, jeśli to praktyczne. Po zaproszeniu potwierdź, że pojawił się na docelowym serwerze Discord. To, że jest widoczny jako offline, jest oczekiwane, dopóki txAdmin pomyślnie się nie zaloguje za pomocą tokenu.
Krok 3: skonfiguruj bota w txAdmin
Otwórz txAdmin jako autoryzowany administrator i zlokalizuj ustawienia integracji Discord w swojej zainstalowanej wersji. Wklej token do pola token bez cudzysłowów i dodatkowych białych znaków. Wybierz docelowy serwer i kanał Discord, używając pól wprowadzania udostępnionych przez txAdmin. Zapisz, a następnie zrestartuj tylko komponent lub serwer, jeśli interfejs tego wymaga.
Jeśli tworzysz stronę FiveM od zera, użyj Ścieżka konfiguracji serwera FiveM najpierw. Discord nie może naprawić niezdrowego FXServer ani niedostępnej instancji txAdmin.
Konfiguruj wiadomości statusu osobno
Włącz funkcję statusu i wybierz kanał, na którym bot może publikować. Zacznij od zwykłej aktualizacji testowej, zanim dodasz niestandardowe słownictwo lub osadzenia. Potwierdź, że wiadomość zmienia się, gdy serwer FiveM uruchamia się, zatrzymuje lub zmienia liczbę graczy, zgodnie z zachowaniem udokumentowanym przez Twoją wersję txAdmin.
Jeśli bot zaloguje się, ale nie pojawi się żaden status, sprawdź wybrane ID kanału i specyficzne dla kanału nadpisywania. Rola obejmująca cały serwer może zezwalać na wysyłanie, podczas gdy nadpisanie kanału tego odmawia. Sprawdź również wyjście konsoli/logu txAdmin dla odpowiedzi API Discord zamiast wielokrotnie generować token.
Konfiguruj role lub zasady białej listy osobno
Dostęp oparty na rolach wymaga dokładnych identyfikatorów serwera i ról Discord, których oczekuje integracja. Włącz tryb deweloperski Discord, aby skopiować identyfikatory, gdy bieżąca konfiguracja ich wymaga. Nazwy ról nie są stabilnymi identyfikatorami i dwie role mogą mieć podobne nazwy.
Przetestuj z jednym kontem posiadającym wymaganą rolę i jednym, które jej nie posiada. Usuń i dodaj ponownie rolę, rozłącz się i połącz ponownie, oraz potwierdź, gdy integracja odświeży członkostwo. Nie zakładaj, że rola Discord automatycznie przyznaje uprawnienia administratora txAdmin; własny model uprawnień txAdmin pozostaje osobną kontrolą, chyba że udokumentowana funkcja wyraźnie je mapuje.
Chroń token i granicę uprawnień
- Nigdy nie wklejaj tokenu na czacie Discord, w zgłoszeniu pomocy technicznej widocznym dla innych ani w zasobie po stronie klienta.
- Nie umieszczaj go w repozytorium Git ani nie przechowuj na publicznym zrzucie ekranu.
- Ogranicz dostęp zarówno do aplikacji Discord Developer Portal, jak i do ustawień txAdmin.
- Zresetuj token po jego ujawnieniu lub gdy administrator z dostępem odejdzie.
- Okresowo przeglądaj uprawnienia serwera i kanału bota.
Lista kontrolna rozwiązywania problemów
| Objaw | Sprawdzać |
|---|---|
| Bot pozostaje offline | Token należy do poprawnego bota, nie zawiera białych znaków, nie został zresetowany, a logi txAdmin pokazują próbę logowania |
| Bot jest online, ale nie może publikować | Wybrany kanał, uprawnienia do wyświetlania/wysyłania/osadzania i nadpisy kanałów |
| Status nigdy się nie aktualizuje | Funkcja statusu włączona, poprawny kanał, stan txAdmin/FXServer i log integracji |
| Członek roli jest odrzucany | Poprawny identyfikator serwera/roli, faktycznie przypisana rola, zachowanie odświeżania/ponownego połączenia i wszelkie wymagane intencje członka |
| Nieautoryzowany członek jest akceptowany | Zasady dostępu awaryjnego, wiele dozwolonych ról i konfiguracja uprawnień po stronie serwera |
| Zatrzymano po zresetowaniu tokenu. | txAdmin nadal ma stary token; zapisz nowy i zrestartuj zgodnie z wymaganiami |
Ostateczne weryfikacja
- Bot loguje się po czystym restarcie bez błędów tokenu.
- Status publikuje tylko w zamierzonym kanale.
- Minimalna rola bota może zaktualizować wiadomość bez szerszych uprawnień serwera.
- Dozwolony użytkownik testowy przechodzi regułę roli/białej listy.
- Niedozwolony użytkownik testowy nie przechodzi tej samej reguły.
- Ani dostęp do Discord, ani ukryty przycisk interfejsu użytkownika nie omijają własnych uprawnień administratora txAdmin.
Gdy te sprawdzenia przejdą niezależnie, integracja jest łatwiejsza w utrzymaniu: jedna tożsamość bota, jeden chroniony sekret, wąsko określony dostęp do kanałów i jasne zasady dotyczące statusu, białej listy i administracji.