txAdmin na serwerze FiveM : do czego służy i jak działa

txAdmin FiveM to natywny panel zarządzania, który pozwala administratorom serwerów ról kontrolować działanie instancji FXServer bez ciągłego grzebania w konsoli tekstowej. W tym artykule wyjaśniam, jak działa ten panel, do czego faktycznie służy i jak wykorzystać jego funkcje monitoringu, restartów, zarządzania graczami oraz konfiguracji zasobów w codziennej administracji.

Czym jest txAdmin i jak działa jako panel zarządzania serwerem FiveM

txAdmin to oficjalne narzędzie wbudowane w FXServer, czyli silnik, na którym działają serwery FiveM i RedM. Panel uruchamia się razem z procesem serwera i udostępnia interfejs webowy dostępny przez przeglądarkę, zwykle pod adresem IP serwera na porcie 40120. Nie jest to osobna aplikacja do zainstalowania – txAdmin jest zintegrowany z binarką FXServer od kilku lat i stał się standardowym sposobem na zarządzanie instancją bez konieczności ręcznego edytowania plików przez SSH przy każdej drobnej zmianie.

Panel działa na zasadzie warstwy pośredniej między administratorem a procesem gry. txAdmin odpala, monitoruje i w razie potrzeby restartuje proces FXServer, jednocześnie czytając logi w czasie rzeczywistym i udostępniając je w czytelnej formie w przeglądarce. Dzięki temu administrator nie musi logować się do systemu plików, żeby sprawdzić, czy serwer się nie zawiesił albo dlaczego dany zasób (resource) rzuca błędem przy starcie.

Jeśli dopiero zaczynasz pracę z tym typem projektu, dobrym punktem wyjścia jest hosting FiveM skonfigurowany pod panel Pterodactyl, z którego poziomu uruchamiasz FXServer, a następnie wchodzisz w logikę txAdmin od środka działającej instancji.

Warto rozróżnić dwie rzeczy, które często się mylą: panel Pterodactyl zarządza kontenerem i zasobami maszyny (CPU, RAM, pliki, restart procesu), natomiast txAdmin działa wewnątrz tego kontenera i zarządza samą logiką gry – graczami, zasobami FiveM, harmonogramem restartów skryptowych. To dwa różne poziomy administracji, które się uzupełniają, a nie konkurują.

Monitoring i konsola na żywo w panelu txAdmin

Jedną z głównych funkcji txAdmin jest monitoring w czasie rzeczywistym. Panel pokazuje zużycie CPU i RAM przez proces FXServer, liczbę połączonych graczy, aktualny tickrate oraz historię wydajności w formie wykresów. To pozwala szybko zdiagnozować, czy spadek płynności rozgrywki wynika z przeciążonego skryptu, czy z problemów sieciowych.

Konsola live

Zakładka konsoli w txAdmin odzwierciedla to, co normalnie widziałbyś w terminalu uruchamiającym FXServer. Możesz tam na żywo czytać logi startowe zasobów, błędy Lua/JS, ostrzeżenia o brakujących zależnościach oraz wpisywać komendy bezpośrednio z przeglądarki, bez potrzeby otwierania osobnej sesji SSH.

ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap
ensure esx_menu_default

Każda z tych linii to przykład standardowej konfiguracji w pliku server.cfg, którą txAdmin odczytuje i prezentuje w zakładce zasobów, pokazując status „started”, „error” lub „stopped” dla każdego wpisu.

Historia zdarzeń i alerty

Panel loguje restarty, crashe, awarie zasobów oraz działania administratorów (kicki, bany, ostrzeżenia) w jednym miejscu. Dzięki temu w razie sporu z graczem albo nagłego zamknięcia serwera masz pełną historię zdarzeń bez przeszukiwania wielu plików tekstowych ręcznie.

Funkcja monitoringu	Co pokazuje
Wykres CPU/RAM	Obciążenie procesu FXServer w czasie
Lista graczy online	Identyfikatory, czas gry, ping
Log konsoli	Błędy startowe zasobów, ostrzeżenia skryptowe
Historia akcji admina	Kicki, bany, warny, restarty ręczne

Zarządzanie graczami, restarty i harmonogramy w txAdmin

Druga fundamentalna funkcja txAdmin to moderacja graczy. Panel pokazuje listę aktywnych graczy z ich identyfikatorami (Steam, Discord, FiveM, license), co jest kluczowe przy nakładaniu banów trwałych zamiast tylko blokowania adresu IP, który łatwo zmienić.

Akcje moderacyjne

• Kick pojedynczego gracza z podaniem powodu widocznego w logu
• Ban tymczasowy lub stały, powiązany z identyfikatorem, nie tylko z IP
• Warn z licznikiem ostrzeżeń widocznym dla innych administratorów
• Podgląd historii połączeń danego gracza na przestrzeni dni

Wszystkie te działania są zapisywane w dzienniku administracyjnym txAdmin, co ułatwia egzekwowanie regulaminu społeczności i rozstrzyganie sporów, gdy gracz kwestionuje decyzję moderatora.

Harmonogram restartów

txAdmin pozwala ustawić automatyczne restarty serwera o stałych porach, co jest standardową praktyką przy projektach RP z dużą liczbą skryptów. Restart czyści pamięć zajmowaną przez wycieki w zasobach i resetuje ewentualne zawieszone wątki, zanim staną się problemem widocznym dla graczy.

# Przykładowy wpis w harmonogramie txAdmin
04:00 - restart serwera
12:00 - restart serwera
20:00 - restart serwera

Przed każdym zaplanowanym restartem panel może wysłać ostrzeżenie na czacie w grze (np. 60, 30 i 10 sekund przed), żeby gracze zdążyli dokończyć istotne akcje, zamiast tracić postęp w trakcie przerwania sesji.

Role i uprawnienia administracyjne

txAdmin obsługuje system kont z różnymi poziomami uprawnień – można nadać komuś dostęp tylko do podglądu konsoli, bez możliwości restartu czy edycji plików, co jest przydatne przy większym zespole moderatorów, gdzie nie każdy powinien mieć pełną kontrolę nad instancją.

Konfiguracja zasobów i recipe w txAdmin

Zasoby (resources) to serce każdego serwera FiveM – skrypty odpowiedzialne za ekonomię, frakcje, pojazdy czy interfejs HUD. txAdmin ułatwia zarządzanie nimi na kilku poziomach: od prostego włączania/wyłączania, po pełne wdrożenia przez system recipe.

Lista zasobów i kolejność ładowania

Kolejność w pliku server.cfg ma znaczenie – zasoby bazowe (frameworki typu ESX czy QBCore) muszą ładować się przed skryptami, które od nich zależą. Panel wizualnie pokazuje, które zasoby wystartowały poprawnie, a które zgłosiły błąd zależności.

ensure es_extended
ensure esx_menu_default
ensure esx_menu_dialog
ensure esx_menu_list
ensure esx_society
ensure esx_policejob

Deployer i recipe

Przy pierwszym uruchomieniu txAdmin oferuje tzw. deployer – narzędzie do instalacji gotowych zestawów skryptów (recipe) opisanych w formacie YAML. Recipe automatyzuje pobranie frameworka, zasobów dodatkowych i wygenerowanie podstawowego pliku konfiguracyjnego, co znacząco skraca czas potrzebny na przygotowanie działającego środowiska RP od zera.

$ yarn
$ pnpm
name: qbcore-base
author: community
resources:
  - qb-core
  - qb-inventory
  - qb-menu

Zmienne środowiskowe i convary

Część konfiguracji serwera odbywa się przez convary ustawiane bezpośrednio w server.cfg, które txAdmin odczytuje i pozwala edytować z poziomu zakładki ustawień, bez ręcznej edycji pliku przez edytor tekstowy.

sv_hostname "Moj serwer RP"
sv_maxclients 64
sv_endpointprivacy true
txAdmin-menuAlignRight false

Dzięki temu zmiany w konfiguracji można wprowadzać na żywo, a panel sam zajmuje się zapisem pliku i – jeśli to konieczne – restartem procesu, żeby nowe ustawienia zaczęły obowiązywać.

Dla administratorów zarządzających wieloma projektami jednocześnie warto też zajrzeć do wszystkich naszych serwerów gier, żeby zobaczyć, jak podobna logika panelu zarządzania sprawdza się przy innych tytułach opartych na frameworkach modowych.

txAdmin FiveM to narzędzie, które realnie upraszcza codzienną pracę administratora – monitoring w czasie rzeczywistym, zarządzanie graczami, harmonogram restartów i obsługa zasobów działają z jednego miejsca, bez potrzeby ciągłego przełączania się między konsolą a plikami konfiguracyjnymi. Poznanie tych funkcji to podstawa sprawnego prowadzenia projektu RP.

FAQ

Czy txAdmin trzeba instalować osobno na serwerze FiveM?

Nie, txAdmin jest wbudowany w binarkę FXServer od kilku wersji i uruchamia się automatycznie razem z procesem serwera, bez dodatkowej instalacji.

Jak uzyskać dostęp do panelu txAdmin po uruchomieniu serwera?

Panel jest dostępny przez przeglądarkę pod adresem IP serwera i domyślnym portem 40120, a dostęp konfiguruje się przy pierwszym uruchomieniu poprzez konto administratora.

Czym różni się txAdmin od panelu Pterodactyl?

Pterodactyl zarządza kontenerem i zasobami systemowymi (CPU, RAM, pliki, start/stop procesu), a txAdmin działa wewnątrz tego kontenera i zarządza logiką gry: graczami, zasobami FiveM oraz harmonogramem restartów skryptowych.