Skip to Content
🔥 Nová dokumentace BlazeHost.cz je online — prohlédnout
DokumentaceFiveMserver.cfg

server.cfg

server.cfg je hlavní konfigurační soubor FiveM serveru. Určuje jméno serveru, počet slotů, licenci, síťové porty i to, které resources se načtou. Bez něj server nenastartuje.

Kde soubor je

Najdeš ho v kořeni serveru — ve stejné složce, kde je adresář resources. Editovat ho můžeš přes správce souborů v Pterodactylu nebo přes FTP. Po každé změně je nutný restart, změny se za běhu nenačítají.

Nejdůležitější convary

ConvarK čemu slouží
sv_hostnameJméno serveru v seznamu
sv_maxclientsMaximální počet slotů (nad 32 nutný OneSync)
endpoint_add_tcp "0.0.0.0:30120"TCP endpoint, port musí sedět s panelem
endpoint_add_udp "0.0.0.0:30120"UDP endpoint, herní provoz
sv_licenseKeyLicenční klíč z keymaster.fivem.net 
set onesync onZapne OneSync — viz OneSync
sv_endpointprivacy trueSkryje IP hráčů v seznamu připojených
sv_scriptHookAllowedPovolení ScriptHooku (0 = vypnuto, doporučeno)
load_server_iconNačte ikonu serveru (96×96 px PNG)
sv_projectNameKrátký název projektu v F8 konzoli klienta
sv_projectDescPopis projektu v F8 konzoli klienta
set / setrVlastní convar (setr = replikovaný i na klienta)

Port 30120 je výchozí pro FiveM (TCP i UDP). Panel ti může přidělit jiný — vždy použij ten z Pterodactylu, jinak server nebude dostupný.

Načítání resources

Resources se zapínají příkazem ensure. Pořadí je důležité — resource, který na něčem závisí, musí být načten až po své závislosti.

PříkazVýznam
ensure nazevSpustí resource (nebo restartuje, pokud běží) — doporučeno
start nazevSpustí resource jen pokud neběží
stop nazevZastaví resource
server.cfg
# Nejdriv zavislosti (napr. oxmysql), pak framework, pak skripty
ensure oxmysql
ensure es_extended
ensure muj-skript

Oprávnění

Práva adminů řídí add_ace a add_principal. Detailně je popisuje článek Permissions.

server.cfg
add_ace group.admin command allow
add_principal identifier.fivem:1234567 group.admin

Minimální server.cfg

server.cfg
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

# Vychozi resources
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure hardcap

# OneSync a sloty
set onesync on
sv_maxclients 32

# Identita serveru
sv_hostname "BlazeHost RP | CZ/SK"
sv_projectName "BlazeHost RP"
sv_projectDesc "Cesky roleplay server"
sv_scriptHookAllowed 0
sv_endpointprivacy true

# Licence
sv_licenseKey "cfxk_xxxxxxxxxxxxxxxx"

# Admin
add_ace group.admin command allow
add_principal identifier.fivem:1234567 group.admin

sv_licenseKey nikdy nedávej do gitu ani veřejně. Kdo má tvůj klíč, může provozovat server pod tvou licencí a nechat ti ji zablokovat. Pokud se klíč omylem dostane ven, zneplatni ho v keymasteru a vygeneruj nový.

Tipy

  • Rozděl konfiguraci do souborů. Práva drž v permissions.cfg a načti je přes exec permissions.cfg. Hlavní server.cfg zůstane přehledný.
  • Nekopíruj endpoint_add_* naslepo. Port musí odpovídat tomu, který ti přidělil panel, jinak server nebude vidět ani přes přímé připojení.
  • Komentuj pomocí #. Za půl roku budeš rád, že víš, k čemu který řádek je.

Poznámka

server.cfg se čte shora dolů jen jednou při startu. Convar nastavený později přepíše ten dřívější. Když si nejsi jistý, jestli se hodnota načetla, ověř ji v konzoli příkazem se stejným názvem bez hodnoty.

Související články

První spuštěníArtifacts