Databáze MySQL pro FiveM server (oxmysql)

Většina RP frameworků (ESX, QBCore, Qbox) i mnoho skriptů ukládá data – postavy, peníze, inventáře, vozidla – do databáze MySQL/MariaDB. FiveM server se k ní připojuje přes resource oxmysql.

1. Vytvoř databázi v panelu

1. Přihlas se do panelu dash.coldhost.eu a otevři svůj FiveM server.
2. Otevři sekci Databáze a vytvoř novou databázi. Zadej název (např. fivem).
3. Panel vygeneruje přístupové údaje: host (endpoint), port, uživatelské jméno, heslo a název databáze. Název i uživatel mohou mít automaticky přidaný prefix – vždy používej přesně to, co panel zobrazí.

2. Nainstaluj oxmysql

Pokud jsi server nasadil přes recept v txAdminu, oxmysql už nejspíš máš. Jinak:

1. Stáhni aktuální release oxmysql z jeho oficiálního GitHubu (overextended). Stahuj sestavený release, ne zdrojový kód.
2. Nahraj složku oxmysql do resources (postup v návodu Instalace skriptů).
3. V server.cfg ho spusť jako jeden z prvních resources, před frameworkem.

3. Nastav connection string

Do server.cfg přidej připojovací řetězec. Nejčastěji ve formátu URI:

set mysql_connection_string "mysql://UZIVATEL:HESLO@HOST:PORT/DATABAZE?charset=utf8mb4"

ensure oxmysql
ensure es_extended

Hodnoty nahraď údaji z panelu. Druhá podporovaná varianta je zápis po položkách:

set mysql_connection_string "user=UZIVATEL;password=HESLO;host=HOST;port=PORT;database=DATABAZE;charset=utf8mb4"

4. Import SQL souborů

Frameworky a skripty často obsahují soubor .sql s tabulkami. Importovat ho můžeš přes webovou správu databáze (pokud ji panel nabízí) nebo libovolným MySQL klientem (např. HeidiSQL) s údaji z panelu. Importuj ho před prvním spuštěním skriptu.

5. Ověř připojení

Restartuj server a sleduj konzoli. oxmysql po úspěšném připojení vypíše informaci o navázaném spojení s databází. Chyby jako Access denied znamenají špatné jméno nebo heslo, ECONNREFUSED či timeout ukazují na špatný host nebo port.