Jak dodać skrypt (zasób) do serwera FiveM

Wszystko, co dodajesz do serwera FiveM - skrypty, mapy, auta, ubrania - to zasoby (resources). Każdy zasób to folder z plikiem fxmanifest.lua. Dodanie nowego zajmuje kilka minut.

1. Sprawdź, co pobierasz

Zanim wgrasz skrypt, upewnij się, że:

• jest pod Twój framework (ESX Legacy, QBCore, Qbox) albo „standalone”,
• ma w opisie listę wymagań (np. ox_lib, oxmysql) - zainstaluj je najpierw,
• pochodzi z zaufanego źródła. Skrypty z „wycieków” często zawierają tylne furtki (backdoory) dające obcym pełny dostęp do serwera.

2. Rozpakuj i sprawdź strukturę

Po rozpakowaniu w folderze zasobu musi być bezpośrednio plik fxmanifest.lua:

moj-skrypt/
  fxmanifest.lua
  client.lua
  server.lua
  config.lua

Częsty błąd: folder w folderze (moj-skrypt/moj-skrypt-main/fxmanifest.lua). Serwer takiego zasobu nie znajdzie.

Nazwa folderu to nazwa zasobu. Usuń z niej dopiski typu -main czy -v2.1, jeśli dokumentacja skryptu podaje inną nazwę - inne skrypty mogą odwoływać się do niego po nazwie.

3. Wgraj na serwer

W panelu gier otwórz zakładkę Files i przejdź do folderu resources (przy txAdmin: txData/NazwaSerwera.base/resources). Dobrą praktyką jest trzymanie własnych skryptów w osobnym folderze w nawiasach, np. [moje].

Wgraj plik ZIP (Upload), a potem Unarchive. Duże paczki map i aut szybciej wgrasz przez SFTP.

4. Tabele w bazie

Jeśli skrypt ma plik .sql, trzeba go zaimportować do bazy danych. Dane dostępu znajdziesz w zakładce Databases. Import zrobisz programem HeidiSQL albo w konsoli bazy - opis w poradniku Baza danych MySQL w FiveM.

5. Dodaj do server.cfg

Na końcu listy zasobów w server.cfg (w txAdmin: Settings → CFG Editor) dopisz:

ensure moj-skrypt

Jeśli wgrałeś go do folderu [moje], a w server.cfg masz już ensure [moje], nic więcej nie trzeba.

Kolejność ma znaczenie: skrypt musi być pod frameworkiem i bibliotekami, z których korzysta.

6. Uruchom bez restartu

W konsoli txAdmin:

refresh
ensure moj-skrypt

refresh wczytuje listę zasobów od nowa, ensure uruchamia (albo restartuje) zasób. Przy dużych zmianach bezpieczniej zrestartować cały serwer.

Mapy (MLO) i auta

Mapy i auta to zwykle zasoby „stream” - zawierają folder stream z plikami modeli. Wgrywa się je tak samo i dodaje przez ensure. Uważaj na rozmiar: każdy gracz pobiera je przy pierwszym wejściu, więc setki aut po 50 MB wydłużą wejście na serwer do kilkunastu minut.

Najczęstsze błędy w konsoli

• „Couldn't find resource moj-skrypt” - zła nazwa w ensure albo folder w folderze.
• „No such export … in resource ox_lib” - brakuje wymaganej biblioteki albo startuje za późno.
• „Table … doesn't exist” - nie zaimportowano pliku SQL.
• Skrypt działa, ale nic nie robi - zwykle zły framework (skrypt ESX na QBCore) albo brak konfiguracji w config.lua.

Aktualizacja: 2026-09-21