Instalacja nowych skryptów to fundament zarządzania serwerem FiveM opartym na frameworku QBCore. Choć proces może wydawać się skomplikowany dla początkujących, w rzeczywistości jest logiczny i powtarzalny. Ten poradnik przeprowadzi Cię krok po kroku przez cały proces, od pobrania plików po finalną weryfikację działania skryptu na Twoim serwerze.
Dzięki tej instrukcji nauczysz się bezpiecznie dodawać nowe funkcjonalności do swojego świata RP, unikać typowych błędów konfiguracyjnych i diagnozować ewentualne problemy. Zaczynajmy!
Wymagania Wstępne
- Dostęp do plików serwera (poprzez FTP, np. FileZilla, lub panel hostingowy).
- Podstawowa znajomość struktury folderów serwera FiveM (zwłaszcza folderu resources).
- Edytor kodu, taki jak Visual Studio Code (zdecydowanie odradzamy Notatnik).
- Działający serwer FiveM oparty na frameworku QBCore.
- Narzędzie do zarządzania bazą danych (np. HeidiSQL lub phpMyAdmin), jeśli skrypt tego wymaga.
Przewodnik Krok po Kroku
- Krok 1: Pobranie skryptu
Znajdź skrypt, który chcesz zainstalować. Najpopularniejsze źródła to GitHub, forum Cfx.re oraz dedykowane sklepy. Zawsze upewnij się, że pobierasz skrypty z zaufanych źródeł, aby uniknąć złośliwego oprogramowania. Pobierz pliki skryptu, zazwyczaj w formacie archiwum .zip.
- Krok 2: Umieszczenie plików na serwerze
Rozpakuj pobrane archiwum .zip. Otrzymasz folder o nazwie zbliżonej do nazwy skryptu (np.
qb-mechanicjob). Przenieś ten cały folder do kataloguresourcesna swoim serwerze. Dobrą praktyką jest utrzymywanie porządku, więc umieść go w odpowiednim podfolderze, np.resources/[qb]/lubresources/[standalone]/. - Krok 3: Dodanie wpisu w `server.cfg`
Otwórz plik
server.cfgw głównym katalogu serwera. Musisz poinformować serwer, że ma uruchomić nowy zasób. Dodaj nową linię, najczęściej w sekcji z innymi skryptami, o treści:ensure nazwa-folderu-skryptu. Na przykład:ensure qb-mechanicjob. Kolejność ma znaczenie! Jeśli skrypt zależy od innych zasobów (np. qb-core), upewnij się, że jest uruchamiany po nich. - Krok 4: Import bazy danych (jeśli wymagane)
Wiele skryptów (np. prace, gangi, systemy mieszkań) wymaga utworzenia tabel w bazie danych. W folderze skryptu poszukaj pliku z rozszerzeniem
.sql. Jeśli go znajdziesz, musisz zaimportować go do swojej bazy danych za pomocą HeidiSQL lub phpMyAdmin. Zazwyczaj jest to prosta operacja typu „Importuj” lub „Uruchom plik SQL”. - Krok 5: Konfiguracja skryptu
Prawie każdy skrypt posiada plik konfiguracyjny, najczęściej o nazwie
config.lua. Otwórz go i dostosuj ustawienia do swoich potrzeb – mogą to być pozycje na mapie, ceny, wymagane przedmioty czy uprawnienia. Zawsze dokładnie czytaj komentarze pozostawione przez autora skryptu. - Krok 6: Restart serwera i weryfikacja
Po wykonaniu wszystkich powyższych kroków zrestartuj serwer FiveM. Uważnie obserwuj konsolę serwera podczas uruchamiania. Szukaj ewentualnych błędów (zazwyczaj oznaczonych na czerwono) związanych z nowym skryptem. Jeśli wszystko poszło gładko, wejdź na serwer i przetestuj nową funkcjonalność.
Przykładowy Kod / Konfiguracja
Poniżej znajduje się fragment pliku server.cfg pokazujący, jak prawidłowo dodawać wpisy dla skryptów QBCore. Zwróć uwagę na kolejność – framework i jego kluczowe komponenty muszą być uruchomione przed skryptami, które z nich korzystają.
# ================= QBCore Framework =================
ensure qb-core
ensure qb-input
ensure qb-menu
ensure qb-target
# ================= Prace (Jobs) =================
ensure qb-policejob
ensure qb-mechanicjob # <-- Nasz nowo dodany skrypt
ensure qb-taxi
# ================= Inne Skrypty =================
ensure qb-garages
ensure qb-housingW tym przykładzie upewniamy się, że qb-core jest załadowany jako jeden z pierwszych. Następnie dodajemy nasz nowy skrypt qb-mechanicjob w sekcji dedykowanej pracom. Taka organizacja pomaga utrzymać porządek w konfiguracji.
Podsumowanie
Poprawna instalacja skryptu QBCore sprowadza się do kilku prostych, logicznych kroków. Kluczem do sukcesu jest dokładność, czytanie dokumentacji (plików README) dołączonej do skryptów oraz zachowanie porządku w plikach serwera. Pamiętaj, aby zawsze instalować jeden skrypt na raz i testować go – dzięki temu, w razie problemów, od razu będziesz wiedzieć, co jest ich źródłem.
Teraz, gdy znasz już proces, możesz śmiało rozbudowywać swój serwer o nowe, ekscytujące funkcje. Powodzenia!
