Instalace ESX nebo QBCore přes txAdmin

Roleplay server na FiveM stojí na frameworku – ten řeší postavy, peníze, práce, inventář a další mechaniky. Nejrozšířenější jsou ESX Legacy a QBCore (a jeho nástupce Qbox). Nejjednodušší cesta k nim vede přes recepty v txAdminu, které framework stáhnou a nastaví za tebe.

Co budeš potřebovat

License key z portálu Cfx.re – jak ho získat.
MySQL databázi – vytvoříš ji v záložce Databáze, postup.
Běžící txAdmin – první spuštění txAdminu.
Aspoň 6 GB RAM pro menší server, 8–12 GB pro větší s mnoha skripty. Spočítej si to v konfigurátoru.

ESX, nebo QBCore?

	ESX Legacy	QBCore / Qbox
Nejvíc hotových skriptů	ano, nejstarší ekosystém	velký a rychle rostoucí
Vhodné pro začátečníka	ano	ano
Moderní struktura kódu	Legacy verze je udržovaná	Qbox je nejmodernější

Rozhoduj podle skriptů, které chceš používat – skripty pro ESX nefungují na QBCore a naopak (pokud nemají „bridge“).

1. Příprava databáze

V panelu otevři záložku Databáze a vytvoř novou databázi.
Poznamenej si adresu (host a port), název databáze, uživatele a heslo. Budeš je zadávat v txAdminu.

2. Spuštění receptu v txAdminu

Otevři txAdmin (adresu a PIN najdeš v konzoli při prvním startu) a projdi úvodní nastavení.
V kroku Deployment Type zvol Popular Recipes.
Vyber ESX Legacy nebo QBCore (případně Qbox).
Vlož license key a údaje k databázi z kroku 1.
Spusť instalaci. txAdmin stáhne framework a skripty, vytvoří tabulky v databázi a připraví server.cfg.
Po dokončení server spusť tlačítkem Start v txAdminu.

Instalace může trvat několik minut – stahuje se hodně souborů. Nezavírej txAdmin, dokud nevypíše, že je hotovo.

3. První připojení

Ve FiveM klientovi stiskni F8 a napiš connect IP:PORT (adresu najdeš v záložce Síť). Při prvním připojení si vytvoříš postavu. Admin práva si dáš v txAdminu v sekci Admins.

4. Přidání dalších skriptů

Nové skripty nahraj do složky resources (např. do [addons]) a přidej do server.cfg řádek ensure nazev_skriptu. Podrobně v návodu Instalace skriptů.

Časté chyby

oxmysql: Access denied / connection refused – špatné údaje k databázi v server.cfg (proměnná mysql_connection_string). Zkopíruj je znovu ze záložky Databáze.
Could not find dependency – skript potřebuje jiný skript (např. ox_lib), který chybí nebo se spouští později. Přidej ho a dej jeho ensure nad skript, který ho používá.
Server se zasekne na „Loading“ – často chybějící nebo nekompatibilní skript. Sleduj konzoli txAdminu, který resource hlásí chybu.
Výkon a „server thread hitch“ – některý skript je náročný. txAdmin má v sekci Diagnostics přehled resource monitoru. Pomůže i silnější procesor – FiveM chce výkon na jádro, proto ho nabízíme i na Ryzenu 9 5900X.