Instalace skriptů (resources) na FiveM server

Skripty (ve FiveM se jim říká resources) přidávají na server nové funkce – od jednoduchých příkazů po celé RP systémy. Instalace je ve většině případů stejná: nahrát složku, přidat ji do server.cfg a restartovat.

1. Zkontroluj kompatibilitu

Před instalací si v popisu skriptu ověř, pro jaký framework je určený:

Standalone – funguje bez frameworku.
ESX, QBCore nebo Qbox – vyžaduje daný framework. Skript pro ESX bez úprav nepoběží na QBCore a naopak.

Zkontroluj také závislosti (dependencies) – např. oxmysql nebo ox_lib. Ty musí být nainstalované a spuštěné dřív než samotný skript.

2. Nahraj skript do složky resources

Stažený archiv si nejdřív rozbal u sebe v počítači.
V panelu dash.coldhost.eu otevři správce souborů, případně se připoj přes SFTP (vhodnější pro větší množství souborů).
Najdi složku resources. Často obsahuje podsložky v hranatých závorkách, např. [local] nebo [standalone] – ty slouží jen k třídění.
Nahraj složku skriptu tak, aby v ní byl přímo soubor fxmanifest.lua.

Častá chyba je dvojitá složka, např. resources/muj-skript/muj-skript/fxmanifest.lua. Server pak resource nenajde. Soubor fxmanifest.lua musí být hned v první složce skriptu.

3. Přidej skript do server.cfg

Otevři server.cfg a přidej řádek s názvem složky skriptu:

ensure oxmysql
ensure ox_lib
ensure muj-skript

Na pořadí záleží – závislosti a framework musí být uvedené výš než skripty, které je používají. Pokud skript vyžaduje SQL tabulky, importuj přiložený .sql soubor do databáze (viz Databáze MySQL pro FiveM).

Pokud používáš txAdmin, můžeš server.cfg upravit přímo v jeho CFG editoru. Více v návodu txAdmin.

4. Restartuj a zkontroluj konzoli

Restartuj celý server (nebo jen resource příkazem ensure muj-skript v konzoli serveru). Pak projdi výpis konzole:

Couldn't find resource – špatný název v ensure nebo dvojitá složka.
SCRIPT ERROR – chyba v kódu nebo chybějící závislost; řádek obvykle ukazuje soubor a číslo řádku.
Chyby SQL (např. neexistující tabulka) – nebyl importován .sql soubor.

Chyby se mohou objevit i v klientské konzoli hry (F8) – ty se týkají části skriptu běžící u hráče.

Před instalací většího balíku skriptů si v panelu vytvoř zálohu. Když se něco pokazí, vrátíš se během chvilky zpět.