Instalacja

Instalacja skryptu FiveM nie jest skomplikowana. Jeśli jednak robisz to pierwszy raz, warto najpierw zrozumieć, jak serwer wczytuje skrypty.

Czym jest skrypt FiveM?

Skrypty FiveM nazywa się zasobami (resources). Zasób to folder, w którym jest wszystko, czego skrypt potrzebuje do działania: pliki klienta, pliki serwera, pliki konfiguracyjne i elementy UI.

Każdy folder zasobu musi zawierać plik fxmanifest.lua. To on mówi serwerowi, co ma wczytać. Bez niego serwer całkowicie pomija folder.

Krok 1: Pobierz i rozpakuj skrypt

Skrypty zwykle dostajesz jako plik .zip lub .rar. Rozpakuj go programem 7-Zip albo WinRAR.

W środku znajdziesz folder zasobu. Powinien zawierać co najmniej:

• fxmanifest.lua
• Jeden lub więcej plików skryptu (client.lua, server.lua, config.lua itd.)

Nie zmieniaj nazw niczego w folderze, chyba że dokumentacja mówi, że to bezpieczne. Ścieżki plików w fxmanifest.lua rozróżniają wielkość liter i muszą dokładnie zgadzać się z prawdziwymi nazwami plików.

Krok 2: Wgraj zasób na serwer

Zasoby trafiają do folderu resources/ w katalogu danych serwera. Typowa struktura wygląda tak:

server-data/
└── resources/
    └── [scripts]/
        └── your-script/
            ├── fxmanifest.lua
            ├── client.lua
            └── server.lua

Foldery w nawiasach kwadratowych, takie jak [scripts], służą tylko do porządkowania. Same nie są zasobami, a skrypty w środku działają normalnie.

Wgraj folder zasobu przez FTP, SFTP albo menedżer plików w panelu hostingu.

Krok 3: Skonfiguruj skrypt

Większość skryptów ma plik config.lua. Otwórz go i ustaw wartości pod swój serwer. Zwykle chodzi o typ frameworka, nazwy jobów i nazwy przedmiotów.

Przeczytaj dokumentację, zanim uruchomisz skrypt. Pominięcie tego kroku to najczęstszy powód, dla którego skrypt nie działa po instalacji.

Krok 4: Dodaj skrypt do server.cfg

Otwórz server.cfg i dodaj tę linię:

ensure your-script

Zamień your-script na dokładną nazwę folderu zasobu. Wielkość liter ma znaczenie.

Jeśli skrypt wymaga innych zasobów, takich jak ESX, QBCore czy ox_lib, upewnij się, że są wpisane wyżej w server.cfg, żeby wczytały się wcześniej.

ensure to obecny standard. Uruchamia zasób i automatycznie restartuje go, jeśli się wysypie. Starsza komenda start nadal działa, ale zalecane jest ensure.

Krok 5: Uruchom zasób

Nie musisz restartować całego serwera. Zasób uruchomisz na dwa sposoby:

• txAdmin: przejdź do panelu Resources, znajdź skrypt i kliknij Start.
• Konsola serwera: wpisz start your-script bezpośrednio w konsoli.

Sprawdź w konsoli, czy nie ma błędów. Jeśli skrypt wczytał się poprawnie, zobaczysz:

Started resource your-script

Najczęstsze problemy

Podsumowanie

1. Rozpakuj archiwum i znajdź folder zasobu.
2. Wgraj go do server-data/resources/.
3. Edytuj config.lua pod ustawienia swojego serwera.
4. Dodaj ensure your-script do server.cfg.
5. Uruchom zasób i sprawdź konsolę pod kątem błędów.

Proces wygląda tak samo przy każdym skrypcie. Zmienia się tylko konfiguracja.