Instalacja nowego skryptu na serwerze FiveM opartym o framework ESX (Extended Server) to jedna z podstawowych umiejętności każdego administratora. Choć proces może wydawać się prosty, pominięcie kluczowych kroków często prowadzi do błędów, niestabilności serwera lub nieprawidłowego działania funkcji. Ten poradnik przeprowadzi Cię przez cały proces krok po kroku, zapewniając, że każdy nowy zasób zostanie dodany poprawnie i bezproblemowo.
Dzięki tej instrukcji nauczysz się nie tylko wgrywać pliki, ale również importować niezbędne dane do bazy danych i poprawnie konfigurować plik startowy serwera. Opanowanie tej procedury to fundament dalszego rozwoju Twojego projektu roleplay.
Wymagania Wstępne
- Dostęp do plików serwera (poprzez FTP, SFTP lub panel hostingowy).
- Działający serwer FiveM z zainstalowanym frameworkiem ESX.
- Dostęp do bazy danych serwera (np. przez HeidiSQL lub phpMyAdmin).
- Podstawowa znajomość struktury folderów serwera FiveM (w szczególności folderu
resourcesi plikuserver.cfg). - Edytor kodu, np. Visual Studio Code, do edycji plików konfiguracyjnych.
Przewodnik Krok po Kroku
- Pobranie skryptu: Znajdź i pobierz skrypt, który chcesz zainstalować. Upewnij się, że pochodzi z zaufanego źródła (np. oficjalne forum FiveM, GitHub autora) i jest kompatybilny z Twoją wersją ESX. Zazwyczaj skrypty są spakowane w archiwum .zip lub .rar.
- Wypakowanie i umieszczenie plików: Rozpakuj pobrane archiwum. Otrzymasz folder z plikami skryptu. Zmień nazwę folderu na prostą i pozbawioną znaków specjalnych (np. z
esx_jobs-mainnaesx_jobs). Następnie przenieś cały ten folder do kataloguresourcesna Twoim serwerze. Dobrą praktyką jest trzymanie skryptów ESX w podfolderze, np.resources/[esx]/. - Import bazy danych (.sql): Wiele skryptów ESX wymaga dodania nowych tabel lub danych do bazy. Przejrzyj pliki skryptu w poszukiwaniu pliku z rozszerzeniem
.sql(np.esx_jobs.sql). Jeśli go znajdziesz, otwórz program do zarządzania bazą danych (HeidiSQL, phpMyAdmin), połącz się z bazą swojego serwera i zaimportuj/uruchom ten plik. Spowoduje to wykonanie zawartych w nim zapytań SQL. - Dodanie wpisu w
server.cfg: Otwórz plikserver.cfgw głównym katalogu serwera. Znajdź sekcję, w której uruchamiasz inne zasoby (zwykle linie zaczynające się odensurelubstart). Dodaj nową linię, aby uruchomić swój skrypt. Pamiętaj, że nazwa musi być identyczna z nazwą folderu, który umieściłeś wresources. - Kolejność uruchamiania: Upewnij się, że skrypt jest uruchamiany PO swoich zależnościach. Na przykład, większość skryptów ESX musi być uruchomiona po
ensure es_extended. Umieść wpis w odpowiednim miejscu w plikuserver.cfg. - Restart serwera i weryfikacja: Zapisz zmiany w pliku
server.cfgi zrestartuj cały serwer FiveM. Obserwuj konsolę serwera podczas uruchamiania. Szukaj komunikatów o błędach związanych z nowym skryptem. Jeśli wszystko przebiegło pomyślnie, skrypt powinien być aktywny.
Przykładowy Kod / Konfiguracja
Poniżej znajduje się przykład, jak powinien wyglądać fragment pliku server.cfg po dodaniu kilku podstawowych skryptów ESX. Zwróć uwagę na kolejność – najpierw uruchamiane są podstawowe zasoby frameworka, a dopiero później skrypty, które z nich korzystają.
# ================= ESX Framework =================
# Upewnij się, że te zasoby są uruchamiane przed skryptami, które od nich zależą.
ensure es_extended
ensure esx_menu_default
ensure esx_menu_dialog
ensure esx_menu_list
# ================= Skrypty dodatkowe ESX =================
# Tutaj dodajesz swoje nowe skrypty.
ensure esx_skin
ensure esx_society
ensure esx_addonaccount
ensure esx_addoninventory
ensure esx_billing
ensure esx_jobs # <-- Nasz nowo dodany skrypt
W powyższym przykładzie komenda ensure esx_jobs informuje serwer, aby załadował zasób znajdujący się w folderze o nazwie esx_jobs wewnątrz katalogu resources.
Podsumowanie
Prawidłowa instalacja skryptów ESX jest kluczowa dla stabilności i funkcjonalności serwera. Zawsze pamiętaj o sprawdzeniu zależności (tzw. requirements lub dependencies), przeczytaniu pliku README.md dołączonego do skryptu oraz o wykonaniu kopii zapasowej bazy danych przed importem plików .sql. Po dodaniu każdego nowego zasobu, najlepszym nawykiem jest dokładne sprawdzenie konsoli serwera w poszukiwaniu ewentualnych błędów.
Teraz, gdy znasz już proces, możesz śmiało rozbudowywać swój serwer o nowe, ekscytujące funkcje, które zapewni społeczność ESX.
