Ten przewodnik przeprowadzi Cię przez konfigurację serwera FiveM (wieloosobowy GTA V) hostowanego w Legion Hosting — od uzyskania klucza licencyjnego CFX i skonfigurowania TXAdmin, po edycję server.cfg i łączenie graczy.
Zanim zaczniesz: Upewnij się, że masz swoje poświadczenia logowania do GPanel z e-maila powitalnego oraz że Twój serwer FiveM został utworzony na Twoim koncie. Jeśli nie uruchamiałeś wcześniej serwera, przeczytaj najpierw Przewodnik uruchamiania serwera.
Wymagania wstępne
- Serwer FiveM Legion Hosting (aktywny na Twoim koncie)
- Konto na forum Cfx.re (darmowe — wymagane do wygenerowania klucza licencyjnego)
- Dostęp do GPanel
- Klient FiveM zainstalowany na Twoim komputerze (fivem.net)
Krok 1: Uzyskaj swój klucz licencyjny CFX
Każdy serwer FiveM wymaga unikalnego klucza licencyjnego od Cfx.re (twórców FiveM). Ten klucz jest darmowy i powiązany z Twoim kontem Cfx.re.
- Przejdź do https://keymaster.fivem.net/ i zaloguj się za pomocą swojego konta na forum Cfx.re.
- Kliknij New Server (lub Register a new server).
- Wypełnij szczegóły:
- Label: Przyjazna nazwa dla Twojego serwera (np. "My Legion FiveM Server")
- Server IP Address: Wprowadź adres IP swojego serwera z GPanel (zobacz Jak znaleźć adres IP i port swojego serwera)
- Server Type: Wybierz odpowiedni typ (zwykle "Other / Apache / nginx")
- Kliknij Generate.
- Skopiuj wygenerowany klucz licencyjny — będzie potrzebny w kolejnych krokach.
Zachowaj swój klucz licencyjny w tajemnicy. Nie udostępniaj go publicznie. Jeśli Twój klucz zostanie naruszony, możesz go unieważnić na stronie Keymaster i wygenerować nowy.
Krok 2: Pierwsze uruchomienie serwera i konfiguracja TXAdmin
Serwery FiveM hostowane w Legion Hosting zawierają TXAdmin — internetowy panel zarządzania, który działa równolegle z Twoim serwerem FiveM. Przy pierwszym uruchomieniu TXAdmin przeprowadzi Cię przez początkową konfigurację.
Uruchamianie serwera
- Zaloguj się do GPanel i wybierz swój serwer FiveM.
- Przejdź do zakładki Startup i zlokalizuj zmienną FIVEM_LICENSE (lub o podobnej nazwie). Wklej tutaj swój klucz licencyjny CFX i zapisz.
- Przejdź do zakładki Console i kliknij Start.
- Obserwuj wyjście konsoli. Przy pierwszym uruchomieniu serwer pobierze wymagane artefakty FiveM — może to zająć kilka minut.
- Gdy TXAdmin będzie gotowy, zobaczysz w konsoli komunikat zawierający URL TXAdmin oraz kod PIN.
Znajdowanie URL TXAdmin: TXAdmin działa na osobnym porcie niż serwer gry. Sprawdź wyjście konsoli lub zakładkę Network w GPanel, aby poznać port TXAdmin. Format URL to
http://YOUR_SERVER_IP:TXADMIN_PORT.
Ukończenie konfiguracji TXAdmin
- Otwórz URL TXAdmin w swojej przeglądarce.
- Wprowadź PIN wyświetlony w wyjściu konsoli GPanel.
- Utwórz swoje konto administratora TXAdmin (nazwa użytkownika i hasło).
- TXAdmin przeprowadzi Cię przez kreatora konfiguracji:
- Server Name: Wybierz nazwę wyświetlaną w przeglądarce serwerów FiveM.
- Deployment Type: Wybierz szablon (np. "Popular Recipes" dla wstępnie skonfigurowanej bazy lub "Remote URL / Template", jeśli masz własną konfigurację).
- Server Data Folder: Pozostaw domyślną wartość, chyba że masz konkretny powód, aby ją zmienić.
- CFX Key: Jeśli zostaniesz ponownie poproszony, wklej swój klucz licencyjny.
- Ukończ kreator i pozwól TXAdmin zakończyć wdrażanie plików serwera. Może to zająć kilka minut.
Zapisz swoje poświadczenia TXAdmin. Jeśli utracisz dostęp do swojego konta administratora TXAdmin, będziesz musiał usunąć profil TXAdmin i ponownie uruchomić konfigurację. Zapisz swoją nazwę użytkownika i hasło.
Krok 3: Skonfiguruj server.cfg
Plik server.cfg jest głównym plikiem konfiguracyjnym Twojego serwera FiveM. TXAdmin generuje podstawowy podczas konfiguracji, ale warto go przejrzeć i dostosować.
Dostęp do server.cfg
- W GPanel kliknij zakładkę Files.
- Przejdź do folderu danych serwera (zwykle katalog główny lub folder utworzony przez szablon TXAdmin).
- Kliknij
server.cfg, aby otworzyć go w edytorze wbudowanym.
Niezbędne ustawienia
| Ustawienie | Opis | Przykład |
|---|---|---|
sv_hostname |
Nazwa serwera wyświetlana w przeglądarce serwerów FiveM | "My Legion FiveM Server" |
sv_licenseKey |
Twój klucz licencyjny CFX z Keymaster | "cfxk_xxxxxxxxxxxxxxxxxxxx" |
sv_maxclients |
Maksymalna liczba graczy dozwolonych na serwerze | 48 |
endpoint_add_tcp |
Adres i port nasłuchiwania TCP | "0.0.0.0:YOUR_PORT" |
endpoint_add_udp |
Adres i port nasłuchiwania UDP | "0.0.0.0:YOUR_PORT" |
sv_endpointprivacy |
Ukrywa adresy IP graczy na liście serwerów | true |
sets sv_projectName |
Krótka nazwa projektu wyświetlana w szczegółach przeglądarki serwerów | "My RP Server" |
sets sv_projectDesc |
Krótki opis wyświetlany w szczegółach przeglądarki serwerów | "A custom roleplay server" |
Minimalny przykład server.cfg:
# Server Identity
sv_hostname "My Legion FiveM Server"
sets sv_projectName "My RP Server"
sets sv_projectDesc "A custom roleplay server hosted by Legion Hosting"
# License Key
sv_licenseKey "cfxk_YOUR_KEY_HERE"
# Network — use the port assigned in GPanel
endpoint_add_tcp "0.0.0.0:YOUR_PORT"
endpoint_add_udp "0.0.0.0:YOUR_PORT"
# Player Limit
sv_maxclients 48
# Privacy
sv_endpointprivacy true
# Resources
ensure mapmanager
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap
ensure chat
Port musi odpowiadać GPanel. Port w
endpoint_add_tcp i endpoint_add_udp musi odpowiadać portowi gry przypisanemu do Twojego serwera w GPanel. Sprawdź zakładkę Network w GPanel, aby poznać swój konkretny port.
Krok 4: Łączenie się z Twoim serwerem FiveM
Gdy Twój serwer jest skonfigurowany i działa, gracze mogą się połączyć za pomocą przeglądarki serwerów FiveM lub połączenia bezpośredniego.
Połączenie bezpośrednie
- Otwórz klienta FiveM.
- Naciśnij F8, aby otworzyć konsolę FiveM, lub kliknij przycisk Direct Connect na ekranie głównym.
- Wprowadź IP i port gry swojego serwera w formacie
IP:PORT. - Kliknij Connect.
Znajdowanie swojego IP i portu: Sprawdź zakładkę Network w GPanel lub zobacz Jak znaleźć adres IP i port swojego serwera.
Przeglądarka serwerów
- Otwórz klienta FiveM i kliknij Play.
- W przeglądarce serwerów wyszukaj nazwę swojego serwera (wartość
sv_hostnamez server.cfg). - Kliknij swój serwer, a następnie kliknij Connect.
Serwer nie pokazuje się w przeglądarce? Nowe serwery mogą potrzebować 5-15 minut, aby pojawić się na liście serwerów FiveM po uruchomieniu. W międzyczasie użyj połączenia bezpośredniego. Sprawdź również, czy Twój
sv_licenseKey jest prawidłowy, a porty w server.cfg odpowiadają Twojej konfiguracji sieci GPanel.
Zarządzanie serwerem za pomocą TXAdmin
Po początkowej konfiguracji TXAdmin zapewnia internetowy pulpit nawigacyjny do codziennego zarządzania serwerem. Uzyskaj do niego dostęp pod adresem http://YOUR_SERVER_IP:TXADMIN_PORT.
| Funkcja | Opis |
|---|---|
| Dashboard | Przeglądaj status serwera, liczbę graczy i metryki wydajności w skrócie. |
| Players | Zobacz graczy online, wyrzucaj lub banuj graczy, przeglądaj historię graczy. |
| Live Console | Wykonuj komendy serwera w czasie rzeczywistym, tak samo jak w konsoli w grze. |
| Resources | Uruchamiaj, zatrzymuj i restartuj poszczególne zasoby bez restartowania całego serwera. |
| Server Log | Przeglądaj logi działań w celu audytu działań graczy i administratorów. |
| CFG Editor | Edytuj server.cfg bezpośrednio z TXAdmin bez potrzeby korzystania z menedżera plików GPanel. |
| Scheduled Restarts | Konfiguruj automatyczne restarty w ustalonych interwałach, aby utrzymać serwer w świeżości. |
Uzyskiwanie pomocy
Jeśli postępowałeś zgodnie z tym przewodnikiem, a nadal doświadczasz problemów:
- Skopiuj wszelkie komunikaty o błędach z konsoli GPanel lub logu TXAdmin.
- Zanotuj, na którym kroku utknąłeś i co już próbowałeś.
- Otwórz zgłoszenie do wsparcia pod adresem https://legionhosting.net/submitticket.php z tymi informacjami. Nasz zespół pomoże Ci tak szybko, jak to możliwe.
