Tento průvodce popisuje, jak instalovat zdroje (skripty) na váš FiveM server, nastavit MySQL databázi pro frameworky jako ESX nebo QBCore a porozumět pořadí načítání zdrojů. Pokud jste ještě nedokončili počáteční nastavení serveru, začněte nejprve s Průvodcem nastavením FiveM serveru.

Instalace Zdrojů a Skriptů

FiveM servery se rozšiřují pomocí zdrojů (nazývaných také skripty). Zdroje přidávají funkce jako autobazary, práce, HUD prvky, frameworky a další.

Jak nainstalovat zdroj

1. Stáhněte zdroj z jeho původního umístění (GitHub, Cfx.re fóra, Tebex atd.).
2. V případě potřeby rozbalte složku zdroje ze ZIP/archivu.
3. Nahrajte složku zdroje do adresáře resources/ na vašem serveru pomocí záložky Files v GPanel nebo přes SFTP.
4. Otevřete server.cfg a přidejte řádek ensure pro daný zdroj:

# Add your custom resources
ensure my-new-resource

5. Restartujte server z GPanel nebo TXAdmin, aby se zdroj načetl.

Manifesty zdrojů

Každý platný zdroj musí obsahovat soubor manifestu. Moderní zdroje používají fxmanifest.lua, zatímco starší používají __resource.lua. Pokud stažená složka zdroje neobsahuje ani jeden z těchto souborů, zdroj se nenačte. Některé stažené soubory vnořují skutečnou složku zdroje do vnější složky — ujistěte se, že složka, kterou umístíte do resources/, je ta, která obsahuje manifest.

Pořadí načítání zdrojů

Zdroje se načítají v pořadí, v jakém se objevují v server.cfg. Pokud zdroj závisí na jiném (například skript práce závisí na frameworku jako ESX nebo QBCore), zajistěte, aby byla závislost uvedena před zdrojem, který ji potřebuje:

# Database resource first
ensure oxmysql

# Framework second
ensure es_extended

# Then resources that depend on the framework
ensure esx_basicneeds
ensure esx_jobs
ensure esx_vehicleshop

Organizace zdrojů pomocí složek kategorií

Zdroje můžete organizovat do podsložek uvnitř adresáře resources/. Použijte závorky v server.cfg pro načtení celé složky kategorie:

# Ensure all resources inside resources/[esx]/
ensure [esx]

# Ensure all resources inside resources/[standalone]/
ensure [standalone]

Tím se načtou všechny zdroje v dané pojmenované podsložce. Je to pohodlný způsob, jak seskupit související skripty, aniž byste museli každý z nich vypisovat jednotlivě.

Načítání zdrojů za běhu přes TXAdmin

K načtení nového zdroje není vždy nutný úplný restart serveru. TXAdmin může spouštět, zastavovat a restartovat jednotlivé zdroje ze stránky Resources. Po nahrání nového zdroje a přidání jeho řádku ensure můžete v živé konzoli TXAdmin spustit následující příkaz:

refresh
ensure my-new-resource

Příkaz refresh sdělí serveru, aby znovu prohledal adresář resources/ pro nové položky.

Nastavení Databáze (MySQL / MariaDB)

Mnoho FiveM frameworků a zdrojů (jako ESX, QBCore nebo vRP) vyžaduje MySQL nebo MariaDB databázi. Legion Hosting poskytuje přihlašovací údaje k databázi s vaším serverem.

Nalezení přihlašovacích údajů k databázi

1. V GPanel přejděte na záložku Databases.
2. Pokud ještě žádná databáze neexistuje, klikněte na New Database a vytvořte ji.
3. Poznamenejte si následující údaje:
   • Hostitel databáze (adresa a port)
   • Název databáze
   • Uživatelské jméno
   • Heslo (klikněte na ikonu oka pro jeho zobrazení)

Konfigurace připojení k databázi

Údaje pro připojení k databázi se nastavují v server.cfg pomocí připojovacího řetězce. Přesný formát závisí na tom, který MySQL zdroj používáte, ale nejběžnější formát je:

# MySQL connection string (oxmysql / mysql-async format)
set mysql_connection_string "mysql://USERNAME:PASSWORD@HOST:PORT/DATABASE_NAME?charset=utf8mb4"

Nahraďte zástupné hodnoty skutečnými přihlašovacími údaji ze záložky Databases. Například:

set mysql_connection_string "mysql://u123_fivem:[email protected]:3306/s123_fivem?charset=utf8mb4"

Výběr MySQL zdroje

Ať už použijete jakýkoli MySQL zdroj, musí být v server.cfg načten před všemi zdroji, které na něm závisí:

# Database connection
set mysql_connection_string "mysql://USERNAME:PASSWORD@HOST:PORT/DATABASE_NAME?charset=utf8mb4"

# MySQL resource — must load before framework
ensure oxmysql

# Framework
ensure es_extended

Základy Frameworků

Framework poskytuje základní herní systémy, na kterých staví ostatní zdroje — věci jako identita hráče, peníze, inventář, práce a vozidla. Dva nejpopulárnější FiveM frameworky jsou:

Většina frameworků se instaluje přes systém receptů TXAdmin během počátečního nastavení. Pokud jste si během nastavení TXAdmin vybrali recept jako "QBCore" nebo "ESX", framework a jeho základní závislosti jsou již nainstalovány. Pokud potřebujete framework nainstalovat ručně, postupujte podle jeho oficiální dokumentace:

• ESX Documentation
• QBCore Documentation

Získání Pomoci

Pokud potřebujete pomoc s instalací zdrojů nebo konfigurací databáze:

1. Zkontrolujte dokumentaci zdroje nebo jeho stránku na GitHub pro pokyny k instalaci a známé problémy.
2. Prohlédněte si konzoli GPanel nebo logy TXAdmin pro chybové zprávy.
3. Otevřete tiket podpory na https://legionhosting.net/submitticket.php s vašimi chybovými zprávami a názvem zdroje, který se pokoušíte nainstalovat.

Související Články

• Průvodce nastavením FiveM serveru
• Řešení problémů s FiveM
• Jak nahrávat soubory přes SFTP
• Jak zjistit IP adresu a port serveru