FiveM server.cfg vysvětlený řádek po řádku (včetně OneSync)

server.cfg je hlavní konfigurační soubor FiveM serveru: určuje port, název v seznamu serverů, license key, game build, OneSync, spouštěné resources a práva adminů. Projdeme ho řádek po řádku a u každého nastavení řekneme, co dělá a jakou hodnotu zvolit.

Kde server.cfg najdete#

• Server s txAdminem: server.cfg je ve složce, kterou jste zvolili při nasazení receptu (txAdmin ji navrhuje jako txData/<NAZEV>_<KOD>.base). Nejpohodlněji ho upravíte v txAdminu v levém menu CFG Editor, uložíte klávesami Ctrl+S. Cestu najdete v txAdminu v Settings › FXServer (pole Server Data Folder, pole CFG File Path uvidíte po zobrazení rozšířených voleb).
• Server bez txAdminu: server.cfg je v hlavní složce serveru. Upravíte ho v zákaznické zóně v záložce Soubory (návod).

Změny v server.cfg se projeví až po restartu serveru.

Jak se server.cfg čte#

• Soubor se čte shora dolů, řádek po řádku. Každý řádek je jeden příkaz serverové konzole.
• Text za # je komentář a server ho ignoruje. Řádek „vypnete“ tím, že na jeho začátek dáte #.
• Hodnoty s mezerami dávejte do uvozovek: sv_hostname "Muj server".
• Když je stejné nastavení v souboru dvakrát, platí to poslední.
• Příkazem exec soubor.cfg načtete další konfigurační soubor (třeba exec permissions.cfg). Hodí se pro přehlednost.

Proměnné (convary) se nastavují třemi příkazy:

Ukázkový server.cfg#

Ukázka vychází z výchozí konfigurace FiveM a receptů txAdminu. Jednotlivé bloky vysvětlujeme níže.

# --- Síť ---
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"
sv_maxclients 48
sv_endpointPrivacy true

# --- Seznam serverů ---
sv_hostname "Muj RP server"
sets sv_projectName "Muj RP server"
sets sv_projectDesc "Český roleplay server s vlastními skripty"
sets tags "roleplay, czech, esx"
sets locale "cs-CZ"
load_server_icon logo.png
#sv_master1 ""

# --- Klíče ---
sv_licenseKey "<LICENSE_KEY>"
set steam_webApiKey "none"

# --- Hra a zabezpečení ---
sv_enforceGameBuild 3258
sv_scriptHookAllowed 0
sv_enableNetworkedSounds false
sv_enableNetworkedScriptEntityStates false
sv_filterRequestControl 2

# --- OneSync (jen bez txAdminu, viz níže) ---
set onesync on

# --- Databáze ---
set mysql_connection_string "mysql://<UZIVATEL>:<HESLO>@<IP_DATABAZE>:3306/<NAZEV_DATABAZE>"

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

# --- Oprávnění ---
add_ace group.admin command allow
add_ace group.admin command.quit deny
add_principal identifier.fivem:<FIVEM_ID> group.admin

Hodnoty ve špičatých závorkách nahraďte svými údaji (závorky smažte): <LICENSE_KEY> je klíč z Cfx.re Portalu, databázové údaje najdete v záložce Databáze, <FIVEM_ID> je číselné ID vašeho účtu Cfx.re (jak ho zjistit, je v části o oprávněních).

Síť a sloty#

30120 je výchozí port FiveM. U nás má server port, který vidíte v záložce Síť, a ten musí být v obou řádcích endpoint_add_*. Pozor po nasazení receptem txAdminu: pokud txAdmin port serveru nezná, zapíše do server.cfg právě výchozí 30120. Zkontrolujte ho a případně přepište.

Název a seznam serverů#

sets sv_projectName a sets sv_projectDesc jsou povinné. Když chybí, server při startu vypíše chybu a v seznamu se nemusí objevit.

Barvy v názvu se píšou kódy ^0 až ^9 (například ^1 červená). Nepřehánějte to, příliš „ozdobený“ název seznam serverů může zkrátit.

Klíče#

Hra a zabezpečení#

Vybrané game buildy (každý obsahuje i všechny starší DLC):

Úplný a aktuální seznam je v dokumentaci FiveM (odkaz dole). Vyšší build znamená větší stahování pro hráče při prvním připojení.

OneSync#

OneSync je synchronizační systém FiveM: server zná polohu a stav všech hráčů a entit (aut, postav, objektů) a sám rozhoduje, co komu pošle. Díky tomu zvládne víc hráčů a skripty mohou pracovat s entitami přímo na serveru. Moderní frameworky (ESX Legacy, QBCore, Qbox) OneSync vyžadují.

Limity slotů:

• OneSync je zdarma do 48 slotů. Víc slotů vyžaduje předplatné FiveM Element Club Argentum nebo vyšší na Cfx.re Portalu (otevře se v novém okně).
• sv_maxclients 32 a víc vyžaduje OneSync on nebo legacy, víc než 64 jen on.
• Předplatné samo počet slotů nezvýší. Po zakoupení musíte zvýšit sv_maxclients a server restartovat.

Kde OneSync zapnout:

• S txAdminem: jen v txAdminu, Settings › FXServer › rozšířené volby › OneSync (doporučeno OneSync On). Řádky set onesync v server.cfg txAdmin sám zakomentuje s poznámkou onesync MUST only be set in the txAdmin settings page.
• Bez txAdminu: řádkem set onesync on v server.cfg.

Platforma FiveM for GTAV Enhanced už synchronizaci přes hráče (P2P) nepoužívá, hra vždy běží přes server.

Resources a pořadí ensure#

Resources se spouštějí v pořadí, v jakém jsou v souboru. Proto:

1. Nahoře standardní resources FiveM (mapmanager, chat, spawnmanager …).
2. Pak knihovny, na kterých závisí ostatní: oxmysql, ox_lib.
3. Pak jádro frameworku (es_extended, qb-core, qbx_core).
4. Nakonec skripty frameworku a vaše vlastní skripty.

Když skript stojí před svou závislostí, nespustí se. Podrobnosti v návodu FiveM resources.

Oprávnění ACE#

FiveM má vestavěný systém oprávnění (ACL). Skládá se ze dvou příkazů:

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 – skupina group.admin smí používat všechny příkazy (command je obecné právo na příkazy).
• add_ace group.admin command.quit deny – kromě příkazu quit, který vypíná server.
• add_principal identifier.fivem:<FIVEM_ID> group.admin – hráč s daným identifikátorem patří do skupiny group.admin a dědí její práva.

Obecně: add_ace <KDO> <CO> allow|deny dá právo, add_principal <KDO> <SKUPINA> zařadí hráče do skupiny. Opačné příkazy jsou remove_ace a remove_principal. Jestli má někdo právo, zjistíte v konzoli příkazem test_ace <KDO> <CO>.

Identifikátory hráčů:

Identifikátory konkrétního hráče najdete v txAdminu: Players, klikněte na hráče a otevřete záložku IDs. Přidání admina dělá txAdmin sám (řádek {{addPrincipalsMaster}} v receptu). Frameworky mají vlastní skupiny adminů, viz ESX, QBCore, nebo Qbox?.

Ověření#

1. Uložte server.cfg a restartujte server.
2. V konzoli (zákaznická zóna nebo Live Console v txAdminu) zkontrolujte, že se při startu neobjevily chyby a resources se spustily (Started resource …).
3. V prohlížeči otevřete http://<IP_ADRESA>:<PORT>/info.json (adresa ze záložky Síť). Uvidíte JSON s veřejným nastavením serveru, mimo jiné hodnoty nastavené přes sets (sv_projectName, locale, tags).
4. Server zkontrolujte nástrojem CFX Resolver: ukáže název, sloty, OneSync i vynucený build.

Když něco nefunguje#

Hlášky, které tu nenajdete, hledejte v přehledu Časté chyby FiveM serveru.

Server není v seznamu serverů nebo je „soukromý“#

• Řádek sv_master1 "" nesmí být aktivní. Zakomentujte ho #.
• Zkontrolujte, že máte sets sv_projectName i sets sv_projectDesc.
• Po startu může trvat až 8 minut, než se server v seznamu objeví.
• Ověřte, že se na server dá připojit přímo: ve hře F8 a connect <IP_ADRESA>:<PORT>.

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

Hráč a server mají odlišnou revizi buildu, typicky krátce po aktualizaci hry. Aktualizujte artefakty serveru (návod). Hráči mohou v klientu FiveM přepnout Update Channel (ozubené kolo › Game).

Hráči se dlouho připojují nebo se zaseknou na stahování#

Po změně sv_enforceGameBuild si každý hráč stahuje data DLC. Je to jednorázové. Pokud se zaseknou opakovaně, zkontrolujte, že build existuje (tabulka výše) a že jste neuvedli překlep.

V server.cfg se objevil řádek ## [txAdmin CFG validator]: …#

txAdmin zakomentoval řádek, který v server.cfg být nesmí, a za dvojtečku napsal důvod. Nejčastěji onesync MUST only be set in the txAdmin settings page. (OneSync patří do nastavení txAdminu) nebo you MUST NOT start/stop/ensure txadmin resources. (txAdmin se spouští sám, ensure monitor smažte).

Nejde nastavit víc než 48 slotů#

Bez předplatného Element Club Argentum je limit 48. U serveru bez txAdminu může počet slotů řídit i proměnná v záložce Nastavení › Proměnné.

Změna se po restartu vrátila#

Upravili jste řádek, který při startu přepisuje proměnná ze záložky Nastavení, nebo jiný soubor, než který server načítá. U txAdminu zkontrolujte CFG File Path v Settings › FXServer.

Další zdroje#

• FiveM: Server Commands (otevře se v novém okně)
• FiveM: OneSync (otevře se v novém okně)
• FiveM: Convars (set, setr, sets) (otevře se v novém okně)
• FiveM: Server Issues (otevře se v novém okně)