FiveM server.cfg vysvetlený riadok po riadku (vrátane OneSync)

server.cfg je hlavný konfiguračný súbor FiveM servera: určuje port, názov v zozname serverov, license key, game build, OneSync, spúšťané resources a práva adminov. Prejdeme ho riadok po riadku a pri každom nastavení povieme, čo robí a akú hodnotu zvoliť.

Kde server.cfg nájdete#

• Server s txAdminom: server.cfg je v priečinku, ktorý ste zvolili pri nasadení receptu (txAdmin ho navrhuje ako txData/<NAZEV>_<KOD>.base). Najpohodlnejšie ho upravíte v txAdmine v ľavom menu CFG Editor, uložíte klávesmi Ctrl+S. Cestu nájdete v txAdmine v Settings › FXServer (pole Server Data Folder, pole CFG File Path uvidíte po zobrazení rozšírených volieb).
• Server bez txAdminu: server.cfg je v hlavnom priečinku servera. Upravíte ho v zákazníckom účte v záložke Súbory (návod).

Zmeny v server.cfg sa prejavia až po reštarte servera.

Ako sa server.cfg číta#

• Súbor sa číta zhora nadol, riadok po riadku. Každý riadok je jeden príkaz serverovej konzoly.
• Text za # je komentár a server ho ignoruje. Riadok „vypnete“ tým, že na jeho začiatok dáte #.
• Hodnoty s medzerami dávajte do úvodzoviek: sv_hostname "Muj server".
• Keď je rovnaké nastavenie v súbore dvakrát, platí to posledné.
• Príkazom exec soubor.cfg načítate ďalší konfiguračný súbor (napríklad exec permissions.cfg). Hodí sa pre prehľadnosť.

Premenné (convary) sa nastavujú tromi príkazmi:

Ukážkový server.cfg#

Ukážka vychádza z predvolenej konfigurácie FiveM a receptov txAdminu. Jednotlivé bloky vysvetľujeme nižšie.

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

# --- Zoznam serverov ---
sv_hostname "Muj RP server"
sets sv_projectName "Muj RP server"
sets sv_projectDesc "Slovenský roleplay server s vlastnými skriptmi"
sets tags "roleplay, slovak, esx"
sets locale "sk-SK"
load_server_icon logo.png
#sv_master1 ""

# --- Kľúče ---
sv_licenseKey "<LICENSE_KEY>"
set steam_webApiKey "none"

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

# --- OneSync (iba bez txAdminu, pozri nižšie) ---
set onesync on

# --- Databáza ---
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ávnenia ---
add_ace group.admin command allow
add_ace group.admin command.quit deny
add_principal identifier.fivem:<FIVEM_ID> group.admin

Hodnoty v špicatých zátvorkách nahraďte svojimi údajmi (zátvorky zmažte): <LICENSE_KEY> je kľúč z Cfx.re Portalu, databázové údaje nájdete v záložke Databázy, <FIVEM_ID> je číselné ID vášho účtu Cfx.re (ako ho zistiť, je v časti o oprávneniach).

Sieť a sloty#

30120 je predvolený port FiveM. U nás má server port, ktorý vidíte v záložke Sieť, a ten musí byť v oboch riadkoch endpoint_add_*. Pozor po nasadení receptom txAdminu: ak txAdmin port servera nepozná, zapíše do server.cfg práve predvolený 30120. Skontrolujte ho a prípadne prepíšte.

Názov a zoznam serverov#

sets sv_projectName a sets sv_projectDesc sú povinné. Keď chýbajú, server pri štarte vypíše chybu a v zozname sa nemusí objaviť.

Farby v názve sa píšu kódmi ^0 až ^9 (napríklad ^1 červená). Nepreháňajte to, príliš „ozdobený“ názov môže zoznam serverov skrátiť.

Kľúče#

Hra a zabezpečenie#

Vybrané game buildy (každý obsahuje aj všetky staršie DLC):

Úplný a aktuálny zoznam je v dokumentácii FiveM (odkaz dole). Vyšší build znamená väčšie sťahovanie pre hráčov pri prvom pripojení.

OneSync#

OneSync je synchronizačný systém FiveM: server pozná polohu a stav všetkých hráčov a entít (áut, postáv, objektov) a sám rozhoduje, čo komu pošle. Vďaka tomu zvládne viac hráčov a skripty môžu pracovať s entitami priamo na serveri. Moderné frameworky (ESX Legacy, QBCore, Qbox) OneSync vyžadujú.

Limity slotov:

• OneSync je zadarmo do 48 slotov. Viac slotov vyžaduje predplatné FiveM Element Club Argentum alebo vyššie na Cfx.re Portali (otvorí sa v novom okne).
• sv_maxclients 32 a viac vyžaduje OneSync on alebo legacy, viac než 64 iba on.
• Predplatné samo počet slotov nezvýši. Po zakúpení musíte zvýšiť sv_maxclients a server reštartovať.

Kde OneSync zapnúť:

• S txAdminom: iba v txAdmine, Settings › FXServer › rozšírené voľby › OneSync (odporúčané OneSync On). Riadky set onesync v server.cfg txAdmin sám zakomentuje s poznámkou onesync MUST only be set in the txAdmin settings page.
• Bez txAdminu: riadkom set onesync on v server.cfg.

Platforma FiveM for GTAV Enhanced už synchronizáciu cez hráčov (P2P) nepoužíva, hra vždy beží cez server.

Resources a poradie ensure#

Resources sa spúšťajú v poradí, v akom sú v súbore. Preto:

1. Hore štandardné resources FiveM (mapmanager, chat, spawnmanager …).
2. Potom knižnice, od ktorých závisia ostatné: oxmysql, ox_lib.
3. Potom jadro frameworku (es_extended, qb-core, qbx_core).
4. Nakoniec skripty frameworku a vaše vlastné skripty.

Keď skript stojí pred svojou závislosťou, nespustí sa. Podrobnosti v návode FiveM resources.

Oprávnenia ACE#

FiveM má vstavaný systém oprávnení (ACL). Skladá sa z dvoch príkazov:

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 smie používať všetky príkazy (command je všeobecné právo na príkazy).
• add_ace group.admin command.quit deny – okrem príkazu quit, ktorý vypína server.
• add_principal identifier.fivem:<FIVEM_ID> group.admin – hráč s daným identifikátorom patrí do skupiny group.admin a dedí jej práva.

Všeobecne: add_ace <KDO> <CO> allow|deny dá právo, add_principal <KDO> <SKUPINA> zaradí hráča do skupiny. Opačné príkazy sú remove_ace a remove_principal. Či má niekto právo, zistíte v konzole príkazom test_ace <KDO> <CO>.

Identifikátory hráčov:

Identifikátory konkrétneho hráča nájdete v txAdmine: Players, kliknite na hráča a otvorte záložku IDs. Pridanie admina robí txAdmin sám (riadok {{addPrincipalsMaster}} v recepte). Frameworky majú vlastné skupiny adminov, pozri ESX, QBCore, alebo Qbox?.

Overenie#

1. Uložte server.cfg a reštartujte server.
2. V konzole (zákaznícky účet alebo Live Console v txAdmine) skontrolujte, že sa pri štarte neobjavili chyby a resources sa spustili (Started resource …).
3. V prehliadači otvorte http://<IP_ADRESA>:<PORT>/info.json (adresa zo záložky Sieť). Uvidíte JSON s verejným nastavením servera, okrem iného hodnoty nastavené cez sets (sv_projectName, locale, tags).
4. Server skontrolujte nástrojom CFX Resolver: ukáže názov, sloty, OneSync aj vynútený build.

Keď niečo nefunguje#

Hlásenia, ktoré tu nenájdete, hľadajte v prehľade Časté chyby FiveM servera.

Server nie je v zozname serverov alebo je „súkromný“#

• Riadok sv_master1 "" nesmie byť aktívny. Zakomentujte ho #.
• Skontrolujte, že máte sets sv_projectName aj sets sv_projectDesc.
• Po štarte môže trvať až 8 minút, kým sa server v zozname objaví.
• Overte, že sa na server dá pripojiť priamo: v hre F8 a connect <IP_ADRESA>:<PORT>.

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

Hráč a server majú odlišnú revíziu buildu, typicky krátko po aktualizácii hry. Aktualizujte artefakty servera (návod). Hráči môžu v klientovi FiveM prepnúť Update Channel (ozubené koleso › Game).

Hráči sa dlho pripájajú alebo sa zaseknú na sťahovaní#

Po zmene sv_enforceGameBuild si každý hráč sťahuje dáta DLC. Je to jednorazové. Ak sa zaseknú opakovane, skontrolujte, že build existuje (tabuľka vyššie) a že ste neurobili preklep.

V server.cfg sa objavil riadok ## [txAdmin CFG validator]: …#

txAdmin zakomentoval riadok, ktorý v server.cfg byť nesmie, a za dvojbodku napísal dôvod. Najčastejšie onesync MUST only be set in the txAdmin settings page. (OneSync patrí do nastavení txAdminu) alebo you MUST NOT start/stop/ensure txadmin resources. (txAdmin sa spúšťa sám, ensure monitor zmažte).

Nedá sa nastaviť viac než 48 slotov#

Bez predplatného Element Club Argentum je limit 48. Pri serveri bez txAdminu môže počet slotov riadiť aj premenná v záložke Nastavenia › Premenné.

Zmena sa po reštarte vrátila#

Upravili ste riadok, ktorý pri štarte prepisuje premenná zo záložky Nastavenia, alebo iný súbor, než ktorý server načítava. Pri txAdmine skontrolujte CFG File Path v Settings › FXServer.

Ďalšie zdroje#

• FiveM: Server Commands (otvorí sa v novom okne)
• FiveM: OneSync (otvorí sa v novom okne)
• FiveM: Convars (set, setr, sets) (otvorí sa v novom okne)
• FiveM: Server Issues (otvorí sa v novom okne)