Přejít na obsah

FiveM: Instalace resources – kliknutím nebo přes SFTP

Nainstaluj resources pro FiveM kliknutím pomocí Resource Installeru v dashboardu: nahraj ZIP, automaticky přidej řádek ensure a přímo importuj SQL soubor. Případně je nainstaluj ručně přes SFTP.

17. listopadu 20267 Min. doba čtení28 Zobrazení0 užitečné

Úvod

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.

Instalace resources pomocí Resource Installeru

Informace

Resource Installer je k dispozici pro servery FiveM. Pro FiveM Enhanced a RedM použij postup přes SFTP.

Krok 1: Otevři installer

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.

Krok 2: Nahraj ZIP archiv

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, .bat nebo .sh, se na tvůj server nikdy nezapíšou.

Krok 3: Zkontroluj analýzu

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 .lua a .js na 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 .sql spolu 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/.

Krok 4: Nainstaluj resource a nastav automatické spuštění

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.cfg už máš ensure [Kategorie], které spustí i tuto resource.
  • Řádek ensure stále chybí: přidej ensure <Name> do server.cfg ruč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>.

Krok 5: Importuj SQL soubor (volitelné)

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.

  1. 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.
  2. 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.
  3. Pokud máš aktivní ZapX Pass, databáze se před importem automaticky zazálohuje. Bez Passu potvrď Importuji bez zálohy.
  4. 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.

Informace

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.

Časté chyby a jejich řešení

Hlášení nebo problémŘešení
Archivy RAR a 7z nejsou podporoványRozbal archiv a znovu zabal složku jako ZIP.
Tento archiv nelze nainstalovatZkontroluj 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ávislostNejdří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 šablonuNejdřív nastav serverovou šablonu v txAdmin a potom installer znovu otevři.
Na tomto serveru už probíhá instalacePočkej, až probíhající instalace skončí. Její průběh se dál zobrazuje na stránce.
Instalace byla přerušena nebo selhalaZkontroluj 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í povolenoOdstraň 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.
Informace

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.

Oblíbené resources

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.

Závěr

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! 🙂

FAQ

Často kladené dotazy

Pomocí FiveM Resource Installeru na kartě Tools v dashboardu serveru: nahraj ZIP, zkontroluj analýzu a spusť instalaci. Installer uloží resource do správné složky a přidá ji do server.cfg.
ZIP archivy do 100 MB. Soubory RAR a 7z nejdřív znovu zabal jako ZIP.
Ne. Installer zobrazí dodané SQL soubory, ale importuje je až po kliknutí na „Importovat do databáze“. Soubory můžou mít velikost až 2 MB.

Zpětná vazba

Pomohl ti tento článek?

Tvoje zpětná vazba nám pomáhá lépe určovat priority a upravovat obsah.

0 od 0 Uživatelé označili tento článek za užitečný.

Osobní pomoc

Návod nestačí?

Naše podpora ZAP zná tvůj produkt — stručně popiš, co potřebuješ, a osobně ti pomůžeme.

Zappy zná tento návod a odpoví ti přímo v chatu.