txAdmin: pierwsza konfiguracja serwera FiveM

txAdmin to panel WWW do zarządzania serwerem FiveM: wdraża serwer z gotowego przepisu, monitoruje go i restartuje oraz zarządza adminami, banami i whitelistą. Przejdziemy pierwsze uruchomienie od PIN-u do działającego serwera i objaśnimy każde pole kreatora konfiguracji.

Jak działa txAdmin#

txAdmin jest częścią każdego serwera FiveM (FXServer), więc nie trzeba niczego osobno pobierać. Gdy FXServer startuje bez parametru +exec server.cfg, zamiast samego serwera gry uruchamia się txAdmin. txAdmin następnie uruchamia serwer gry, monitoruje go i automatycznie restartuje, gdy się zawiesi lub zamrozi.

• txAdmin przechowuje swoje dane (konta adminów, ustawienia, logi, bazę graczy i banów) w folderze txData.
• Interfejs WWW działa na własnym porcie. Domyślny port to 40120, ale na naszych serwerach może być inny.
• Interfejs jest po angielsku. Ten poradnik podaje nazwy przycisków dokładnie tak, jak je zobaczysz.

Otwieranie txAdmin#

1. W strefie klienta otwórz Moje usługi, kliknij swój serwer FiveM i przejdź do zakładki Konsola.

2. Jeśli serwer nie działa, kliknij Start.

3. Poczekaj na ramkę z tekstem All ready! Please access:.

   All ready! Please access:
   http://your-public-ip:40120/
   
   Use the PIN below to register:
   1234

   • Linia pod All ready! Please access: to adres txAdmin. Istotny jest port (liczba po dwukropku).
   • Pod Use the PIN below to register: jest czterocyfrowy PIN do pierwszego logowania. Jest pokazywany, dopóki nie utworzysz pierwszego admina.

4. Wpisz w przeglądarce adres http://<ADRES_IP>:<PORT_TXADMIN>/.

   Zamiast <ADRES_IP> wstaw adres IP z zakładki Sieć (tylko część linii Adres połączenia przed dwukropkiem, na przykład 203.0.113.10). Zamiast <PORT_TXADMIN> wstaw port z ramki w konsoli. Pełny adres wygląda wtedy na przykład tak: http://203.0.113.10:40120/.

   Jeśli zamiast adresu IP widzisz kreskowany pasek, włączony jest tryb streamera. Kliknij Pokaż szczegóły u góry. Tryb streamera ukrywa adresy IP także w wyjściu konsoli, łącznie z portem po nich. Port txAdmin odczytasz wtedy z linii http://your-public-ip:<PORT>/ albo pokaż szczegóły.

   Portu txAdmin nie przydzielamy jeszcze automatycznie. Jeśli nie widzisz go w zakładce Sieć (Adres połączenia lub Dodatkowe porty), poproś nas o port txAdmin (kontakt). Bez niego txAdmin nie otworzy się w przeglądarce.

Jeśli ramka się nie pojawia, a konsola przechodzi od razu do wczytywania zasobów (Started resource …), txAdmin jest wyłączony. Włącz go w zakładce Ustawienia › Zmienne zmienną txAdmin (1 = włączony, 0 = wyłączony) i zrestartuj serwer. Jeśli nie widzisz takiej zmiennej, skontaktuj się z nami (kontakt).

Łączenie z kontem Cfx.re i hasło#

Pierwsze logowanie tworzy głównego admina (Master). Ten admin ma wszystkie uprawnienia i jako jedyny nie może zostać usunięty.

1. Na stronie No Cfx.re account linked wpisz PIN z konsoli (Type in the PIN from the terminal.).

2. Kliknij Link Account.

3. Zaloguj się kontem Cfx.re i potwierdź dostęp przyciskiem Yes, Allow.

   Wrócisz do txAdmin, do formularza rejestracji.

4. Wypełnij formularz:

   Pole	Co wpisać	Dlaczego
   Discord ID	Opcjonalnie. Twoje numeryczne ID użytkownika Discord.	Łączy admina z Discordem (whitelista, polecenia bota txAdmin). Możesz dodać później.
   Backup Password	Hasło o długości 6–⁠128 znaków. Użyj generatora haseł.	Zapasowe logowanie na wypadek, gdy logowanie Cfx.re nie działa.
   Confirm Password	To samo hasło jeszcze raz.	Wyłapuje literówki.

5. Zaakceptuj warunki licencji (Creator PLA) i kliknij Register.

   Otworzy się kreator konfiguracji serwera.

Kreator konfiguracji serwera#

Server Name#

Krótka nazwa serwera dla interfejsu txAdmin i komunikatów na czacie i Discordzie, na przykład Muj RP server. Pole przyjmuje maksymalnie 18 znaków. To nie jest nazwa na liście serwerów FiveM (tę ustawia się w server.cfg). Kliknij Next.

Deployment Type#

Dla pierwszego serwera wybierz Popular Recipes i wskaż przepis:

• Przepis podstawowy (na liście jako FiveM Basic Server lub CFX Default FiveM, zależnie od wersji txAdmin) – minimalny serwer bez frameworka i bez bazy danych. Dobry do prób oraz serwerów freeroam i drift.
• ESX Legacy, QBCore Framework, Qbox Framework – frameworki roleplay. Potrzebują bazy danych. Różnice i jak wybrać opisuje artykuł ESX, QBCore czy Qbox?.

Folder danych serwera#

txAdmin proponuje, gdzie wdrożyć serwer, zazwyczaj txData/<NAZWA>_<KOD>.base. Zostaw proponowaną ścieżkę (We strongly recommend using the path suggested below.) i kliknij Save. W tym folderze przechowywane są server.cfg i resources.

Na ostatnim ekranie (We are almost there!) kliknij Go to Recipe Deployer. Zanim przejdziesz dalej, przygotuj bazę danych (następna sekcja).

Przygotowanie bazy danych#

Przepisy frameworków (ESX, QBCore, Qbox) potrzebują bazy danych. Zanim przejdziesz dalej w txAdmin, utwórz ją w strefie klienta. Przepis podstawowy nie potrzebuje bazy danych, więc przy nim pomiń tę sekcję.

1. W strefie klienta przejdź do zakładki Baza danych.

2. W polu Nazwa bazy danych wpisz na przykład fivem (tylko litery, cyfry i podkreślenia).

3. Pole Dozwolone połączenia z zostaw na %. Znak % oznacza „skądkolwiek”, więc z bazą może łączyć się zarówno serwer, jak i Twój komputer.

4. Kliknij Utwórz bazę danych.

   Lista pokazuje Nazwę bazy danych, Użytkownika, Host i Hasło. Zostaw dane otwarte; za chwilę skopiujesz je do txAdmin. Nazwę bazy skopiuj dokładnie z listy, bo może różnić się od wpisanej.

Wdrażanie przepisu (Server Deployer)#

Step 1: Review Recipe#

txAdmin pokazuje zawartość przepisu: co pobiera, gdzie zapisuje i jaki SQL wykonuje. Uruchamiaj tylko przepisy z zaufanych źródeł (Only run Recipes from trusted sources!). Kliknij Next.

Step 2: Input Parameters#

Pola bazy danych pojawiają się po kliknięciu Show/Hide Database options (advanced). Następnie kliknij Run Recipe.

Step 3: Run Recipe#

txAdmin pobiera pliki i importuje SQL. Przy dużych przepisach (QBCore, Qbox) może to potrwać kilka minut. Po zakończeniu kliknij Next.

Step 4: Configure server.cfg#

Zobaczysz wygenerowany server.cfg. Teraz sprawdź i popraw trzy rzeczy; wszystko inne objaśnia artykuł server.cfg linia po linii:

• endpoint_add_tcp i endpoint_add_udp – port po dwukropku musi być portem gry z linii Adres połączenia w zakładce Sieć (liczba po dwukropku). Jeśli txAdmin nie dostał portu od hosta, wpisuje domyślny 30120. Jeśli się różnią, zmień go w obu liniach, inaczej gracze nie będą mogli się połączyć.
• sv_hostname i sets sv_projectName – nazwa serwera na liście serwerów.
• sets locale "root-AQ" – zmień na język swoich graczy, na przykład sets locale "pl-PL" (lub "en-US" dla angielskiego), aby lista serwerów pokazywała właściwy język.

Kliknij Save & Run Server. Serwer startuje, a txAdmin otwiera Live Console.

Weryfikacja#

• W txAdmin strona Dashboard pokazuje serwer jako online, a w Live Console nie ma czerwonych błędów.
• W grze naciśnij F8, wpisz connect <ADRES_IP>:<PORT> (adres z linii Adres połączenia w zakładce Sieć) i połącz się.
• W grze wpisz na czacie /tx (lub /txadmin): otworzy się menu txAdmin. Działa tylko dla adminów, którzy mają w txAdmin wypełnione ID Cfx.re lub Discord. Klawisz menu ustawisz w grze w Game Settings › Key Bindings › FiveM (pozycja (txAdmin) Menu: Open Main Page).

Zarządzanie adminami#

1. W górnym menu kliknij Admins.

2. Kliknij Add.

3. Wypełnij formularz:

   Pole	Co wpisać
   Username	Nazwa użytkownika do logowania w txAdmin. Jeśli wypełnisz Cfx.re ID, musi zgadzać się z nazwą na forum Cfx.re.
   Cfx.re ID	Opcjonalnie. Nazwa użytkownika na forum.cfx.re (otwiera się w nowym oknie). Umożliwia logowanie przyciskiem Cfx.re i używanie menu /tx w grze.
   Discord ID	Opcjonalnie. Numeryczne ID użytkownika Discord.
   Permissions	Zaznacz tylko to, czego dana osoba naprawdę potrzebuje (tabela niżej).

4. Zapisz. txAdmin pokaże hasło tymczasowe; prześlij je adminowi. Musi je zmienić przy pierwszym logowaniu.

Uprawnienia są przechowywane w pliku txData/admins.json. Admin txAdmin nie jest automatycznie adminem we frameworku (ESX, QBCore). Jak nadać uprawnienia we frameworku, opisuje artykuł ESX, QBCore czy Qbox?.

Zaplanowane restarty#

Regularny restart (raz lub dwa razy dziennie) zwalnia pamięć i czyści uszkodzony stan skryptów. txAdmin ostrzega graczy z wyprzedzeniem.

1. W górnym menu kliknij Settings i otwórz zakładkę FXServer.
2. W Restart Schedule kliknij przycisk +. W oknie Add Restart Time wpisz godzinę, na przykład 06:00. Zamiast tego możesz kliknąć gotową propozycję (1x/day, 2x/day …).
3. Zapisz ustawienia.

Godzina odnosi się do czasu serwera, nie Twojego komputera (Make sure your schedule matches your server time and not your local time.). Jeśli txAdmin pokazuje ostrzeżenie o strefie czasowej, przesuń godzinę o różnicę.

Przydatne części txAdmin#

Rozwiązywanie problemów#

Strona txAdmin się nie ładuje#

• Sprawdź, czy serwer działa i czy konsola pokazuje ramkę All ready! Please access:.
• Użyj adresu IP z zakładki Sieć i portu z ramki. Adres zaczyna się od http://, nie https://.
• Jeśli przeglądarka sama zmienia adres na https://, wpisz go ręcznie razem z http://.
• Port txAdmin musi być wśród portów serwera w zakładce Sieć (Adres połączenia lub Dodatkowe porty). Jeśli go tam nie widzisz, skontaktuj się z nami.

PIN nie działa#

Nowy PIN jest generowany przy każdym starcie, dopóki nie masz pierwszego admina. Użyj PIN-u z najnowszego wyjścia konsoli. Gdy admin już istnieje, PIN nie jest pokazywany; zaloguj się przyciskiem Cfx.re albo hasłem.

Zapomniałem hasła#

Zaloguj się przyciskiem Cfx.re. Jeśli to też nie działa, a jesteś jedynym adminem, skontaktuj się z nami. Usunięcie pliku txData/admins.json sprawia, że txAdmin wraca do PIN-u, ale tracisz wszystkie konta adminów.

Task Failed: Response code 403 (rate limit exceeded)#

Przepis pobiera dziesiątki repozytoriów z GitHuba, a GitHub tymczasowo ograniczył liczbę pobrań. Poczekaj około godziny i uruchom wdrożenie ponownie.

Przepis kończy się błędem bazy danych (ER_ACCESS_DENIED_ERROR, ECONNREFUSED)#

• ER_ACCESS_DENIED_ERROR – błędny użytkownik lub hasło. Skopiuj je ponownie z zakładki Baza danych, bez spacji na początku i końcu.
• ECONNREFUSED lub przekroczenie czasu – błędny adres lub port. Database Host potrzebuje adresu IP z pola Host, nie localhost.
• ER_BAD_DB_ERROR – nazwa bazy danych się nie zgadza. Skopiuj ją dokładnie z listy baz danych.

Inne błędy bazy danych opisuje artykuł Baza danych dla FiveM.

Serwer nie startuje po wdrożeniu#

Najczęstszą przyczyną jest brakujący lub błędny klucz licencyjny (Could not authenticate server license key). Popraw go w CFG Editor według poradnika o kluczu licencyjnym. Inne błędy znajdziesz w artykule Częste błędy FiveM.

Gracze nie mogą się połączyć, mimo że txAdmin pokazuje online#

Gracze łączą się z portem gry z linii Adres połączenia, nie z portem txAdmin. W CFG Editor sprawdź linie endpoint_add_tcp i endpoint_add_udp: obie muszą mieć port z Adresu połączenia, a nie domyślny 30120 z przepisu (chyba że akurat to jest Twój port). Po poprawce zrestartuj serwer. Więcej w artykule server.cfg.

Dalsza lektura#

• FiveM: Setting up a server using txAdmin (otwiera się w nowym oknie)
• FiveM: txAdmin i jego uprawnienia (otwiera się w nowym oknie)
• txAdmin na GitHubie (dokumentacja przepisów i zmiennych) (otwiera się w nowym oknie)