Jak rozjet FiveM server krok za krokem

Rozjet vlastní FiveM server je dnes díky txAdminu mnohem jednodušší než dřív, ale pořád se skládá z několika kroků, které na sebe navazují: licenční klíč, hosting, první spuštění txAdminu, recept s frameworkem, databáze a konfigurace. Tento postup vás provede všemi kroky v pořadí, v jakém je budete dělat, a u každého upozorní na nejčastější chyby.

1. Co budete potřebovat

• Legální kopii GTA V — ne pro server, ale pro každého hráče. FiveM klient se spouští nad nainstalovanou hrou a bez ní se nepřipojí nikdo, ani vy.
• Účet Cfx.re — stejný účet slouží k přihlášení na portal.cfx.re, na fórum a do txAdminu.
• Server — vlastní stroj, VPS, nebo herní hosting. Výběr rozebíráme níže.
• MySQL nebo MariaDB databázi, pokud chcete roleplay framework jako ESX nebo QBCore. Čistý server bez frameworku se bez databáze obejde.

2. Licenční klíč z portálu Cfx.re

Každý FiveM server potřebuje vlastní licenční klíč. Přihlaste se na portal.cfx.re, v sekci pro registraci serverů vytvořte nový klíč a jako IP adresu zadejte adresu serveru, na kterém poběží. Klíč je zdarma a později ho zadáte do txAdminu nebo do server.cfg jako sv_licenseKey. Klíč nikomu neposílejte a nenahrávejte ho do veřejných repozitářů.

3. Kde server poběží

Serverová část FiveM (FXServer) zpracovává většinu práce skriptů v hlavním vlákně, takže rozhoduje hlavně výkon jednoho jádra procesoru, dostatek paměti a rychlý disk. Domácí počítač stačí na testování, pro komunitu ale potřebujete stroj, který běží nonstop, má veřejnou IP adresu a ochranu proti DDoS útokům. Na co se při výběru ptát, shrnuje článek Jak vybrat FiveM hosting.

Pro orientaci v paměti: doporučovač na stránce FiveM tarifů počítá jako výchozí bod zhruba 2 GB pro standalone server, 4 GB pro ESX a 5 GB pro QBCore, a přidává rezervu podle počtu hráčů a náročnosti resources. Odhad předpokládá jednu instanci serveru a databázi na stejném stroji. U nás server běží na procesorech AMD Ryzen 9 5900X s NVMe SSD ve Frankfurtu nad Mohanem, spravujete ho v panelu Pterodactyl a txAdmin i MySQL databáze jsou součástí služby.

4. První spuštění txAdminu

txAdmin je webové rozhraní pro správu serveru, které je součástí serverových buildů FiveM. Při prvním spuštění vypíše do konzole adresu rozhraní a jednorázový PIN. Otevřete adresu v prohlížeči, zadejte PIN a zvolte Link Account — tím txAdmin propojíte se svým účtem Cfx.re, který se stane hlavním (master) účtem. Poté si nastavíte záložní heslo pro případ, že by přihlášení přes Cfx.re nefungovalo. Na našem hostingu je potřeba txAdminu nejdřív přidělit vlastní port; postup je v návodu Databáze a txAdmin.

5. Výběr receptu

Průvodce nastavením se zeptá na název serveru a typ nasazení. Nejjednodušší je zvolit Popular Recipes. Recept (recipe) je předpis, který stáhne framework a základní resources a připraví server.cfg. Nabídka receptů se mění, typicky v ní najdete:

Pokud se mezi frameworky rozhodujete, pomůže srovnání ESX vs QBCore vs Qbox. V dalším kroku (Recipe Deployer) zadáte licenční klíč, u receptů s frameworkem i údaje k databázi, a spustíte nasazení tlačítkem Run Recipe.

6. MySQL databáze a oxmysql

ESX i QBCore komunikují s databází přes knihovnu oxmysql. Ta čte přihlašovací údaje z convaru mysql_connection_string v server.cfg. Recept ho obvykle vyplní sám z údajů, které zadáte; pokud ho nastavujete ručně, podporovány jsou dva formáty:

set mysql_connection_string "mysql://user:password@host:3306/database"
# nebo
set mysql_connection_string "user=user;password=password;host=host;port=3306;database=database"

Pokud heslo obsahuje znaky jako @, :, / nebo ;, může jeden z formátů selhat — vyzkoušejte druhý nebo heslo změňte. Po startu serveru zkontrolujte v konzoli, že se oxmysql úspěšně připojilo.

7. Základy server.cfg

Soubor server.cfg je hlavní konfigurace serveru. Upravit ho můžete v txAdminu nebo přes správce souborů. Nejdůležitější řádky:

sv_hostname "Můj RP server"
sets sv_projectName "Můj RP server"
sets sv_projectDesc "Česká roleplay komunita"
sets tags "roleplay, esx"
sets locale "cs-CZ"
sv_maxclients 32
set onesync on
sv_licenseKey "váš_klíč"

• sv_hostname a sv_projectName — název v seznamu serverů.
• sets tags a sets locale — štítky a jazyk, podle kterých vás hráči najdou ve vyhledávání.
• sv_maxclients — maximální počet hráčů. Nad 32 je nutný OneSync; podmínky pro vyšší počty slotů určuje Cfx.re (viz dokumentace OneSync).
• set onesync on — zapne OneSync, se kterým počítají moderní frameworky.

Kompletní přehled příkazů a convarů najdete v oficiální dokumentaci. Na hostingu s panelem mohou být některé hodnoty (klíč, počet hráčů, název) nastavené i jako proměnné při startu serveru. Pokud změna v server.cfg nemá efekt, zkontrolujte i je.

8. Přidávání resources a pořadí ensure

Nové skripty nahrajete do složky resources (podsložky v hranatých závorkách, např. [jobs], slouží jen k třídění) a v server.cfg je spustíte příkazem ensure. Na pořadí záleží: resource se musí spustit až po všem, na čem závisí.

ensure oxmysql
ensure ox_lib
ensure es_extended
ensure [jobs]
ensure muj_skript

Nejdřív databázová knihovna, pak sdílené knihovny, pak framework a nakonec skripty, které framework používají. Chybové hlášky typu „dependency not found“ nebo nil hodnoty z frameworku po startu obvykle znamenají špatné pořadí nebo chybějící závislost.

9. První restart a připojení

Po úpravách restartujte server a projděte konzoli: hledejte červené chyby, neúspěšné připojení k databázi a resources, které se nespustily. Když je vše v pořádku, připojte se. Ve FiveM otevřete konzoli klávesou F8 a zadejte:

connect ip_adresa:port

Hráčům pak můžete posílat odkaz ve tvaru cfx.re/join/xxxxxx, který server dostane po úspěšném ověření licenčního klíče. Chcete-li zjistit, na jakou adresu takový odkaz vede, použijte nástroj Cfx resolver.

10. Aktualizace artifacts a zálohy

Artifacts jsou serverové binárky FXServeru. Cfx.re vydává nové buildy průběžně a stránka s artifacts označuje doporučený build. Novější verze přinášejí opravy, některé starší skripty ale mohou vyžadovat konkrétní build — proto aktualizujte s rozmyslem a po změně vše otestujte. Jak změnit verzi v našem panelu, popisuje návod FiveM artifacts.

Před každou větší změnou si udělejte zálohu. U nás se server včetně databáze automaticky zálohuje každou noc (držíme posledních 5 dní) a ruční zálohu si spustíte v panelu (základy panelu). Databázi si navíc pravidelně exportujte do SQL souboru, ať máte postavy a inventáře hráčů uložené i mimo server. Když se konfigurace rozbije natolik, že je jednodušší začít znovu, pomůže návod na reinstalaci FiveM serveru.

Shrnutí

Postup je vždy stejný: licenční klíč na portal.cfx.re, server s dostatkem výkonu, první spuštění txAdminu s PINem a propojením účtu Cfx.re, recept s frameworkem, databáze přes oxmysql, úprava server.cfg a správné pořadí ensure. Pak restart, kontrola konzole a připojení přes F8. Jakmile server běží, nezapomínejte na zálohy a uvážlivé aktualizace artifacts. Hotové prostředí s txAdminem a databází najdete v našich FiveM tarifech.