Resources můžeš využít k rozšíření svého herního serveru FiveM o další funkce. To se hodí zejména v případě, že plánuješ větší projekt, například roleplay server. Bez těchto dodatečných resources se takový projekt jen těžko obejde.
FiveM a jeho komunita nabízejí obrovský výběr resources. Přehled těch nejoblíbenějších najdeš na fóru Cfx.re: https://forum.cfx.re/c/development/releases/7
Nejrychleji nainstaluješ resource přímo v dashboardu pomocí FiveM Resource Installeru. Nahraješ ZIP archiv a installer uloží resource do správné složky, přidá ji do server.cfg a případné SQL soubory může na přání importovat do tvé databáze. Klasický postup přes SFTP najdeš níže.
Resource Installer je k dispozici pro servery FiveM. Pro FiveM Enhanced a RedM použij postup přes SFTP.
Otevři dashboard svého serveru FiveM, přejdi na kartu Tools a vyber FiveM Resource Installer. Server kvůli tomu nemusíš zastavovat.
Podmínkou je, aby už v txAdmin byla nastavená serverová šablona (Recipe). Teprve potom bude k dispozici soubor server.cfg a složka resources, do kterých může installer zapisovat.
Nahraj resource jako ZIP archiv. Stažení z GitHubu přes Code → Download ZIP nebo ZIP archiv vydání fungují přímo.
- Povoleny jsou ZIP soubory do 100 MB (po rozbalení maximálně 400 MB a 5 000 souborů).
- Archivy RAR a 7z nejdřív znovu zabal jako ZIP.
- Installer sám odstraní nadbytečné mezilehlé složky (například
moje-resource-main) a z názvu vynechá označení verze a příponu-main. - Pokud archiv obsahuje více resources, installer je zobrazí jednotlivě a seřadí podle jejich závislostí.
- Spustitelné soubory, například
.exe,.batnebo.sh, se na tvůj server nikdy nezapíšou.
Než cokoli nainstaluješ, installer ti ukáže obsah archivu:
- Název a cílová složka: Název může obsahovat písmena, číslice a znaky
_,.a-(maximálně 64 znaků). V části Složka v resources/ vybereš kategorii, například[standalone]. Pokud ji archiv neobsahuje, předvolí se[local]. Možnost Přímo do resources/ (bez složky) uloží resource bez složky kategorie. - Závislosti: U každé závislosti (například ESX, QBCore, Qbox, ox_lib nebo oxmysql) uvidíš, jestli je v archivu, na serveru, nebo na serveru chybí. Závislosti, které se objevují pouze v kódu a nejsou uvedené v
fxmanifest.lua, jsou označené jako předpokládané. - Bezpečnostní kontrola: Installer zkontroluje všechny soubory
.luaa.jsna známé vzorce škodlivého kódu. Pokud něco najde, zobrazí upozornění. Přesto můžeš pokračovat v instalaci, ale bezpečnostní kontrola resource při příštím spuštění serveru deaktivuje. Pokud se domníváš, že jde o falešný poplach, kontaktuj naši podporu. - SQL soubory: Zobrazí se dodané soubory
.sqlspolu s informací, které tabulky vytvářejí, mění nebo naplňují.
Pokud už resource na serveru máš, installer instalaci standardně přeruší. Pokud ji chceš nahradit (například při aktualizaci), zaškrtni Přepsat existující resource. Tím se nahradí celá složka včetně tvého nastavení, například config.lua. Předtím se stará složka uloží jako archiv do backups/resource-installer/.
Nech zaškrtnutou možnost Přidat do server.cfg, aby se spouštěla automaticky. Installer pak do server.cfg aktivní složky serveru přidá ensure <Name> za závislosti resource a předtím zazálohuje původní server.cfg jako server.cfg.bak-….
Klikni na Nainstalovat na server. Zobrazí se průběh instalace (zálohování, rozbalení, uložení, úprava server.cfg a kontrola výsledku). Instalace bude pokračovat, i když stránku zavřeš.
Ve výsledku uvidíš, jak se resource spouští:
- Do server.cfg byl přidán řádek ensure: vše je hotovo.
- Už byla uvedena v server.cfg: řádek už existoval.
- Spouští se přes složku kategorie: v
server.cfguž mášensure [Kategorie], které spustí i tuto resource. - Řádek ensure stále chybí: přidej
ensure <Name>doserver.cfgručně (viz Aktivace).
Aby FiveM novou resource načetlo, restartuj server pomocí možnosti Restartovat server. Případně zadej v živé konzoli nejprve refresh a potom ensure <Name>.
Pokud resource potřebuje databázi, můžeš její SQL soubor importovat přímo z installeru. To se neděje automaticky – import proběhne pouze tehdy, když u příslušného souboru klikneš na Importovat do databáze.
- Vyber databázi svého serveru. Hlavní databáze je předvolená. Pokud server zatím žádnou databázi nemá, vytvoř ji na kartě Databáze pomocí možnosti Vytvořit databázi.
- Pokud soubor obsahuje tabulky, které už existují, dialog tě na to upozorní. Nech vybranou možnost Přeskočit existující tabulky (doporučeno). Stávající tabulky a jejich data tak zůstanou beze změny.
- Pokud máš aktivní ZapX Pass, databáze se před importem automaticky zazálohuje. Bez Passu potvrď Importuji bez zálohy.
- Klikni na Importovat nyní.
Každý soubor může mít velikost až 2 MB a obsahovat až 5 000 SQL příkazů. Větší soubory importuj přes phpMyAdmin podle návodu FiveM: Import SQL souboru.
Import vždy probíhá do vybrané databáze. Řádky jako CREATE DATABASE … nebo USE … proto nejsou povolené. Pokud je soubor obsahuje, nebudou importovány. Odstraň tyto řádky, znovu zabal ZIP a nahraj ho znovu.
| Hlášení nebo problém | Řešení |
|---|---|
| Archivy RAR a 7z nejsou podporovány | Rozbal archiv a znovu zabal složku jako ZIP. |
| Tento archiv nelze nainstalovat | Zkontroluj název a cílovou složku. Pokud už v jiné složce existuje resource se stejným názvem, přejmenuj novou nebo odstraň tu starou. Pokud archiv neobsahuje fxmanifest.lua (nebo __resource.lua), nejde o resource, ale například pouze o mapu nebo soubor vozidla. |
| Na serveru chybí závislost | Nejdřív nainstaluj chybějící resource (například ox_lib), také pomocí installeru. Bez ní se resource většinou nespustí. |
| Upozornění na chybějící Recipe neboli serverovou šablonu | Nejdřív nastav serverovou šablonu v txAdmin a potom installer znovu otevři. |
| Na tomto serveru už probíhá instalace | Počkej, až probíhající instalace skončí. Její průběh se dál zobrazuje na stránce. |
| Instalace byla přerušena nebo selhala | Zkontroluj server a spusť instalaci znovu. Pokud byla přepsána existující resource, installer při chybě obnoví její původní složku. |
| SQL: USE není povoleno nebo Vytváření, změna či mazání databází není povoleno | Odstraň z SQL souboru řádky USE a CREATE DATABASE a znovu nahraj ZIP. |
| SQL: Chyba na řádku … | Příkazy až po tento řádek už byly provedeny. Oprav soubor a spusť import znovu s vybranou možností Přeskočit existující tabulky. |
| Resource se po restartu nespustí | V živé konzoli zkontroluj chybové hlášení, zda běží všechny závislosti a zda je řádek ensure uvedený až za nimi. Pomoc s častými chybami najdeš v článku FiveM: Časté problémy. |
Chceš archiv nejdřív zkontrolovat, aniž bys ho instaloval? Náš bezplatný nástroj FiveM Resource Installer ho analyzuje přímo v prohlížeči, aniž by se cokoli nahrávalo.
Hledáš pro svůj server ty správné resources? Projdi si náš pečlivě sestavený seznam nejoblíbenějších a nejdoporučovanějších resources, vylepši si hraní a dolaď svůj server k dokonalosti. Inspiruj se a najdi doplňky, které se hodí právě k tvému projektu.
- ESX Framework – Jeden z nejstarších a nejrozšířenějších frameworků pro roleplay s největší základnou skriptů a komunity.
- QBCore Framework – Moderní a přehledně strukturovaný RP framework s vlastním ekosystémem resources a aktivní komunitou.
- Qbox – Novější fork QBCore s důrazem na vyšší kvalitu a podporou TypeScriptu.
- ox_lib – Sdílená knihovna nástrojů (Overextended), kterou jako závislost využívá řada dalších resources.
- ox_inventory – Inventární systém kompatibilní s různými frameworky (ESX/QBCore/Qbox), který je dnes považovaný za neoficiální standard.
- ox_target – Samostatná resource pro interakce typu „Third-Eye“ s objekty, zónami a hráči.
- ps-dispatch – Rozšířený systém dispečinku a tísňových volání (Project Sloth) pro roleplay policie a záchranných složek.
Nakonec restartuj server. Nainstalovaná resource se načte při příštím úplném spuštění. Resource pro svůj herní server FiveM jsi úspěšně nainstaloval. Pomocí nástroje ZapX Resource Maker si můžeš nechat vytvořit i vlastní menší resources. Pokud máš další otázky nebo potřebuješ pomoc, náš tým podpory je ti k dispozici každý den! 🙂