server.cfg FiveM linia po linii (łącznie z OneSync)

server.cfg to główny plik konfiguracyjny serwera FiveM: ustawia port, nazwę na liście serwerów, klucz licencyjny, game build, OneSync, które zasoby startują i uprawnienia adminów. Przejdziemy go linia po linii i przy każdym ustawieniu wyjaśnimy, co robi i jaką wartość wybrać.

Gdzie znaleźć server.cfg#

• Serwer z txAdmin: server.cfg jest w folderze wybranym podczas wdrażania przepisu (txAdmin proponuje txData/<NAZWA>_<KOD>.base). Najłatwiej edytować go w CFG Editor w lewym menu txAdmin; zapisz przez Ctrl+S. Ścieżkę znajdziesz w txAdmin w Settings › FXServer (pole Server Data Folder; pole CFG File Path pojawia się po pokazaniu opcji zaawansowanych).
• Serwer bez txAdmin: server.cfg jest w głównym folderze serwera. Edytuj go w strefie klienta w zakładce Pliki (poradnik).

Zmiany w server.cfg zaczynają działać dopiero po restarcie serwera.

Jak czytany jest server.cfg#

• Plik jest czytany od góry do dołu, linia po linii. Każda linia to jedno polecenie konsoli serwera.
• Tekst po # to komentarz i serwer go ignoruje. Linię „wyłączasz”, stawiając # na jej początku.
• Wartości ze spacjami umieszczaj w cudzysłowach: sv_hostname "Muj server".
• Jeśli to samo ustawienie pojawia się w pliku dwa razy, wygrywa ostatnie.
• Polecenie exec plik.cfg wczytuje inny plik konfiguracyjny (na przykład exec permissions.cfg). Przydatne do utrzymania porządku.

Zmienne (convars) ustawia się trzema poleceniami:

Przykładowy server.cfg#

Przykład opiera się na domyślnej konfiguracji FiveM i przepisach txAdmin. Każdy blok objaśniamy niżej.

# --- Sieć ---
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"
sv_maxclients 48
sv_endpointPrivacy true

# --- Lista serwerów ---
sv_hostname "Muj RP server"
sets sv_projectName "Muj RP server"
sets sv_projectDesc "Czech roleplay server with custom scripts"
sets tags "roleplay, czech, esx"
sets locale "cs-CZ"
load_server_icon logo.png
#sv_master1 ""

# --- Klucze ---
sv_licenseKey "<LICENSE_KEY>"
set steam_webApiKey "none"

# --- Gra i bezpieczeństwo ---
sv_enforceGameBuild 3258
sv_scriptHookAllowed 0
sv_enableNetworkedSounds false
sv_enableNetworkedScriptEntityStates false
sv_filterRequestControl 2

# --- OneSync (tylko bez txAdmin, zobacz niżej) ---
set onesync on

# --- Baza danych ---
set mysql_connection_string "mysql://<USER>:<PASSWORD>@<DATABASE_IP>:3306/<DATABASE_NAME>"

# --- Zasoby ---
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap
ensure oxmysql
ensure [standalone]

# --- Uprawnienia ---
add_ace group.admin command allow
add_ace group.admin command.quit deny
add_principal identifier.fivem:<FIVEM_ID> group.admin

Wartości w nawiasach ostrych zastąp własnymi danymi (nawiasy usuń): <LICENSE_KEY> to klucz z Cfx.re Portal, dane bazy danych są w zakładce Baza danych, a <FIVEM_ID> to numeryczne ID Twojego konta Cfx.re (jak je znaleźć, wyjaśnia sekcja o uprawnieniach).

Sieć i sloty#

30120 to domyślny port FiveM. Na naszych serwerach port Twojego serwera to ten z zakładki Sieć i musi być w obu liniach endpoint_add_*. Uważaj po wdrożeniu przepisem txAdmin: jeśli txAdmin nie zna portu serwera, wpisuje do server.cfg domyślny 30120. Sprawdź go i w razie potrzeby zmień.

Nazwa i lista serwerów#

sets sv_projectName i sets sv_projectDesc są wymagane. Jeśli ich brakuje, serwer wypisuje błąd przy starcie i może nie pojawić się na liście.

Kolory w nazwie zapisuje się kodami ^0 do ^9 (na przykład ^1 dla czerwonego). Nie przesadzaj; lista serwerów może skrócić zbyt „ozdobioną” nazwę.

Klucze#

Gra i bezpieczeństwo#

Wybrane game buildy (każdy zawiera też wszystkie starsze DLC):

Pełna, aktualna lista jest w dokumentacji FiveM (link na dole). Wyższy build oznacza większe pobieranie dla graczy przy pierwszym połączeniu.

OneSync#

OneSync to system synchronizacji FiveM: serwer zna pozycję i stan wszystkich graczy i encji (samochodów, pedów, obiektów) i sam decyduje, co komu wysłać. Dzięki temu obsługuje więcej graczy, a skrypty mogą pracować z encjami bezpośrednio na serwerze. Nowoczesne frameworki (ESX Legacy, QBCore, Qbox) wymagają OneSync.

Limity slotów:

• OneSync jest bezpłatny do 48 slotów. Więcej slotów wymaga subskrypcji FiveM Element Club Argentum lub wyższej w Cfx.re Portal (otwiera się w nowym oknie).
• sv_maxclients od 32 wymaga OneSync on lub legacy; więcej niż 64 wymaga on.
• Sama subskrypcja nie zwiększa liczby slotów. Po jej zakupie trzeba zwiększyć sv_maxclients i zrestartować serwer.

Gdzie włączyć OneSync:

• Z txAdmin: tylko w txAdmin, Settings › FXServer › opcje zaawansowane › OneSync (zalecane OneSync On). txAdmin sam komentuje linie set onesync w server.cfg z dopiskiem onesync MUST only be set in the txAdmin settings page.
• Bez txAdmin: linią set onesync on w server.cfg.

Platforma FiveM for GTAV Enhanced nie używa już synchronizacji peer-to-peer (P2P); gra zawsze działa przez serwer.

Zasoby i kolejność ensure#

Zasoby startują w kolejności, w jakiej występują w pliku. Dlatego:

1. Standardowe zasoby FiveM na górze (mapmanager, chat, spawnmanager …).
2. Potem biblioteki, od których zależą pozostałe: oxmysql, ox_lib.
3. Potem rdzeń frameworka (es_extended, qb-core, qbx_core).
4. Na końcu skrypty frameworka i własne skrypty.

Jeśli skrypt jest przed swoją zależnością, nie wystartuje. Szczegóły w artykule Zasoby FiveM.

Uprawnienia ACE#

FiveM ma wbudowany system uprawnień (ACL). Składa się z dwóch poleceń:

add_ace group.admin command allow
add_ace group.admin command.quit deny
add_principal identifier.fivem:<FIVEM_ID> group.admin

• add_ace group.admin command allow – grupa group.admin może używać wszystkich poleceń (command to ogólne uprawnienie do poleceń).
• add_ace group.admin command.quit deny – z wyjątkiem polecenia quit, które wyłącza serwer.
• add_principal identifier.fivem:<FIVEM_ID> group.admin – gracz z tym identyfikatorem należy do grupy group.admin i dziedziczy jej uprawnienia.

Ogólnie: add_ace <KTO> <CO> allow|deny nadaje uprawnienie, a add_principal <KTO> <GRUPA> umieszcza gracza w grupie. Polecenia odwrotne to remove_ace i remove_principal. Aby sprawdzić, czy ktoś ma uprawnienie, użyj w konsoli polecenia test_ace <KTO> <CO>.

Identyfikatory graczy:

Identyfikatory konkretnego gracza znajdziesz w txAdmin: Players, kliknij gracza i otwórz zakładkę IDs. txAdmin dodaje admina sam (linia {{addPrincipalsMaster}} w przepisie). Frameworki mają własne grupy adminów, zobacz ESX, QBCore czy Qbox?.

Weryfikacja#

1. Zapisz server.cfg i zrestartuj serwer.
2. W konsoli (strefa klienta albo Live Console w txAdmin) sprawdź, czy przy starcie nie pojawiły się błędy i czy zasoby wystartowały (Started resource …).
3. Otwórz w przeglądarce http://<ADRES_IP>:<PORT>/info.json (adres z zakładki Sieć). Zobaczysz JSON z publicznymi ustawieniami serwera, łącznie z wartościami ustawionymi przez sets (sv_projectName, locale, tags).
4. Sprawdź serwer narzędziem CFX Resolver: pokazuje nazwę, sloty, OneSync i wymuszony build.

Rozwiązywanie problemów#

Komunikatów, których tu nie znajdziesz, szukaj w artykule Częste błędy serwera FiveM.

Serwera nie ma na liście serwerów albo pokazuje się jako „prywatny”#

• Linia sv_master1 "" nie może być aktywna. Zakomentuj ją przez #.
• Sprawdź, czy masz zarówno sets sv_projectName, jak i sets sv_projectDesc.
• Pojawienie się serwera na liście może zająć do 8 minut po starcie.
• Sprawdź, czy możesz połączyć się z serwerem bezpośrednio: naciśnij F8 w grze i wpisz connect <ADRES_IP>:<PORT>.

Connection rejected by server: Client/Server game build revision mismatch#

Gracz i serwer mają różne rewizje buildu, zazwyczaj krótko po aktualizacji gry. Zaktualizuj artefakty serwera (poradnik). Gracze mogą przełączyć Update Channel w kliencie FiveM (ikona koła zębatego › Game).

Gracze długo się łączą albo zacinają się na pobieraniu#

Po zmianie sv_enforceGameBuild każdy gracz pobiera dane DLC. Dzieje się to tylko raz. Jeśli zacinają się wielokrotnie, sprawdź, czy build istnieje (tabela wyżej) i czy nie ma literówki.

W server.cfg pojawiła się linia ## [txAdmin CFG validator]: …#

txAdmin zakomentował linię, która nie jest dozwolona w server.cfg, i po dwukropku dopisał powód. Najczęściej to onesync MUST only be set in the txAdmin settings page. (OneSync należy do ustawień txAdmin) albo you MUST NOT start/stop/ensure txadmin resources. (txAdmin startuje sam; usuń ensure monitor).

Nie można ustawić więcej niż 48 slotów#

Bez subskrypcji Element Club Argentum limit wynosi 48. Na serwerze bez txAdmin liczbę slotów może też sterować zmienna w zakładce Ustawienia › Zmienne.

Zmiana cofnęła się po restarcie#

Edytowano linię, którą zmienna z zakładki Ustawienia nadpisuje przy starcie, albo inny plik niż ten, który serwer wczytuje. Z txAdmin sprawdź CFG File Path w Settings › FXServer.

Dalsza lektura#

• FiveM: Server Commands (otwiera się w nowym oknie)
• FiveM: OneSync (otwiera się w nowym oknie)
• FiveM: Convars (set, setr, sets) (otwiera się w nowym oknie)
• FiveM: Server Issues (otwiera się w nowym oknie)