server.cfg w FiveM: konfiguracja krok po kroku

W skrócie: server.cfg to plik tekstowy z poleceniami konsoli, które FXServer wykonuje po kolei przy starcie (+exec server.cfg). Najważniejsze linie to dwa endpointy z portem, klucz sv_licenseKey, nazwa i opis projektu (sets sv_projectName, sets sv_projectDesc), liczba slotów sv_maxclients z OneSync oraz linie ensure dla zasobów. Poniżej kompletny przykład oparty na oficjalnym wzorze Cfx.re, objaśnienie linii, kolejność ensure i typowe błędy. Stan: FXServer 35245 (Recommended).

Własny serwer FiveM? W HostValues od €5,60 miesięcznie, online w kilka minut. Zobacz plany →

Czym jest server.cfg

Każda linia pliku to zwykłe polecenie konsoli serwera, które można też wpisać ręcznie. Polecenie exec wczytuje plik względem folderu danych serwera, dlatego w oficjalnym poradniku FXServer startuje z folderu server-data z parametrem +exec server.cfg. Linie zaczynające się od # są komentarzami. Zmiany obowiązują po restarcie serwera.

Cały proces zakładania serwera, od klucza po txAdmin, opisuje przewodnik jak stworzyć serwer FiveM; ten artykuł rozwija jego część o server.cfg.

Kompletny przykład server.cfg

Przykład bazuje na wzorze z dokumentacji Cfx.re. Wartości w cudzysłowach należy zastąpić własnymi.

# Adres i port: zwykle zmienia się tylko port
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

# Nazwa, opis i wygląd na liście serwerów
sv_hostname "Mój serwer FiveM"
sets sv_projectName "Mój serwer RP"
sets sv_projectDesc "Polski serwer roleplay z własną ekonomią"
sets tags "roleplay, polska"
sets locale "pl-PL"
#load_server_icon logo.png

# Synchronizacja, sloty i wersja gry
set onesync on
sv_maxclients 48
sv_enforceGameBuild 3889

# Klucze: nigdy przez sets ani setr
sv_licenseKey "TUTAJ_KLUCZ_Z_PORTALU"
set steam_webApiKey ""

# Baza danych dla oxmysql: przed startem zasobów
set mysql_connection_string "mysql://uzytkownik:haslo@localhost:3306/fivem"

# Zasoby: oxmysql, podstawowe, framework, skrypty
ensure oxmysql
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap
ensure rconlog
ensure moj-framework
ensure [skrypty]

# Administratorzy
add_ace group.admin command allow
add_ace group.admin command.quit deny
add_principal identifier.fivem:1 group.admin

# Bezpieczeństwo i widoczność
sv_scriptHookAllowed 0
#sv_master1 ""

Zasoby od mapmanager do rconlog to domyślny zestaw z cfx-server-data. Jeśli framework wymaga innego, pierwszeństwo ma jego instrukcja.

Co oznacza każda linia

sv_maxclients i OneSync

Dokumentacja poleceń serwera podaje zakres od 1 do 2048 slotów. Wartości od 32 wymagają OneSync w trybie on lub legacy, a powyżej 64 wyłącznie on. OneSync jest darmowy do 48 slotów; więcej wymaga subskrypcji Element Club Argentum lub wyższej w portalu Cfx.re. Dlatego oficjalny przykład łączy set onesync on z sv_maxclients 48. Ilu graczy serwer naprawdę udźwignie, zależy jednak głównie od zasobów i skryptów; orientacyjne liczby dla pakietów podaje strona hostingu FiveM.

set, sets i setr: gdzie trzymać hasła

Dokumentacja rozróżnia trzy polecenia. set tworzy zwykłą zmienną dostępną tylko dla skryptów serwera, setr udostępnia ją także skryptom klienta, a sets publikuje nazwę i wartość na liście serwerów i w pliku info.json. Nazwa i opis projektu idą więc przez sets, dane poufne nigdy. Dokumentacja oxmysql wprost zaleca dla connection stringa wyłącznie set; to samo warto stosować dla klucza Steam.

Baza danych: oxmysql

Według dokumentacji oxmysql connection string ustawia się przed startem jakichkolwiek zasobów, a oxmysql uruchamia na początku listy zasobów. Obsługiwane są dwa formaty:

set mysql_connection_string "mysql://uzytkownik:haslo@localhost:3306/fivem"
set mysql_connection_string "user=uzytkownik;password=haslo;host=localhost;port=3306;database=fivem"

Znaki ; , / ? : @ & = + $ # w danych dostępu mogą sprawiać problemy; dokumentacja radzi ich unikać albo przejść na drugi format. Tworzenie bazy i import tabel frameworka opisuje artykuł podłączanie bazy danych FiveM.

Kolejność ensure

FXServer wykonuje plik z góry na dół, więc kolejność linii ma znaczenie. Bezpieczny układ:

1. linie set z danymi bazy i kluczami,
2. ensure oxmysql,
3. zasoby podstawowe,
4. framework (ESX, QBCore lub Qbox),
5. skrypty, które korzystają z frameworka.

Zasób może też sam wymusić wcześniejsze załadowanie innego wpisem dependency w swoim fxmanifest.lua.

Uprawnienia: add_ace i add_principal

add_ace przyznaje lub odbiera principalowi, czyli grupie albo identyfikatorowi gracza, dostęp do obiektu, np. polecenia. add_principal sprawia, że jeden principal dziedziczy uprawnienia drugiego. W przykładzie grupa group.admin może wykonywać wszystkie polecenia poza quit, a identyfikator identifier.fivem:1 trafia do tej grupy. W jego miejsce wpisuje się własny identyfikator; wariant identifier.steam:... wymaga ustawionego steam_webApiKey. Identyfikatory połączonych graczy pokazuje polecenie status (zasób rconlog), a uprawnienie sprawdza test_ace.

Linie ze starszych poradników

Starsze pliki często zawierają sv_endpointPrivacy true. Dokumentacja wciąż opisuje tę zmienną jako ukrywanie adresów IP graczy, ale w kodzie FXServer 35245 jest ona usunięta: po ustawieniu true serwer ostrzega, że adresy graczy nie są już ujawniane w żadnym endpoincie HTTP, i prosi o skasowanie linii. Więcej o tym buildzie w artykule o aktualizacji artifacts FiveM.

Najczęstsze błędy

• Podwójny ensure. ensure restartuje zasób, który już działa. Jeśli zasób stoi w pliku dwa razy albo osobno i ponownie w kategorii (np. ensure qb-core i ensure [qb]), zostanie bez potrzeby uruchomiony drugi raz. Każdy zasób powinien pojawić się w pliku tylko raz.
• Złe cudzysłowy. Wartości ze spacjami muszą być w cudzysłowie. FXServer rozpoznaje tylko prosty cudzysłów "; drukarskie „ ” lub “ ” z edytorów tekstu traktuje jak zwykłe znaki, więc wartość ze spacją nie zostanie odczytana jako całość. Poza cudzysłowem średnik kończy polecenie, dlatego connection string ze średnikami musi stać w cudzysłowie.
• Nieaktualny klucz. Tekst zastępczy changeme, literówka albo stary klucz po ponownym wygenerowaniu w portalu. Po regeneracji nowy klucz trzeba wpisać w konfiguracji. Na jedno konto przypadają najwyżej trzy aktywne klucze.
• Brak sv_projectName lub sv_projectDesc. Serwer zgłasza błąd przy starcie i może nie pojawić się na liście.
• Ponad 48 slotów bez subskrypcji. Serwer i tak pozostanie przy 48 slotach.

Edycja server.cfg na serwerze HostValues

1. Przed większą zmianą warto zrobić kopię zapasową w panelu gry.
2. Plik otwiera się w menedżerze plików panelu gry albo przez SFTP. txAdmin ma też wbudowany edytor CFG z walidacją.
3. Serwer otrzymuje adres IP z jednym portem, widocznym w panelu gry. Właśnie ten port musi stać w obu liniach endpoint.
4. Klucz licencyjny wpisuje się w ustawieniach serwera w panelu gry, w zakładce Startup (zob. uruchomienie serwera FiveM). Jeśli w server.cfg jest również linia sv_licenseKey, powinien w niej stać ten sam, aktualny klucz.
5. Dane do connection stringa pochodzą z bazy MySQL dołączonej do pakietu.
6. Po zapisaniu należy zrestartować serwer i przejrzeć konsolę, gdzie widać błędy zasobów i bazy danych.

Nie mają Państwo jeszcze serwera? Hosting FiveM w HostValues obejmuje panel gry z konsolą, menedżerem plików i SFTP, bazę MySQL z phpMyAdmin oraz txAdmin. W razie pytań support pomaga codziennie od 10:00 do 22:00 przez zgłoszenie lub na Discordzie.

Najczęstsze pytania

Gdzie znajduje się server.cfg?

W folderze danych serwera, z którego FXServer startuje z parametrem +exec server.cfg. W HostValues pliki serwera są dostępne w menedżerze plików panelu gry i przez SFTP.

Ile slotów można ustawić w sv_maxclients?

Od 1 do 2048. Wartości od 32 wymagają OneSync, powyżej 64 w trybie on. Bez subskrypcji Element Club Argentum lub wyższej limit wynosi 48.

Czym różni się ensure od start?

start uruchamia tylko zatrzymany zasób. ensure uruchamia zasób, a jeśli już działa, restartuje go. Oficjalny przykład używa ensure.

Dlaczego serwer nie pojawia się na liście mimo poprawnego klucza?

Najczęściej brakuje sets sv_projectName lub sets sv_projectDesc albo przed sv_master1 nie ma #. Po starcie pojawienie się na liście może też potrwać do ośmiu minut. Bezpośrednie połączenie sprawdza się poleceniem connect IP:port w konsoli F8.

Źródła: dokumentacja Cfx.re: Setting Up a Vanilla FXServer (przykład server.cfg), Server Commands, Convars, OneSync, Server Issues, txAdmin, Resource manifest i Server Download; pomoc Cfx.re: tworzenie klucza, regeneracja klucza i limit kluczy; dokumentacja oxmysql; cfx-server-data; kod źródłowy FXServer 35245: InfoHttpHandler.cpp i Console.cpp. Stan na 16 października 2026.