Instalacja ESX Legacy na serwerze FiveM

ESX Legacy to najpopularniejszy framework roleplay dla FiveM. Oferuje kompletny system z zawodami, ekonomią, ekwipunkiem i pojazdami, który stanowi fundament praktycznie każdego poważnego serwera RP. Instalacja nie jest trudna, ale jest wystarczająco dużo pułapek. W tym artykule przechodzimy przez cały proces: od pustego serwera FiveM do działającego frameworka ESX.

Czym jest ESX Legacy?

ESX (EssentialMode Extended) zaczął lata temu jako prosty framework i wyrósł na standard dla FiveM roleplay. ESX Legacy to skonsolidowana wersja łącząca wszystkie stare osobne moduły (es_extended, esx_menu, esx_skin) w nowoczesny, utrzymywany pakiet. Jest aktywnie rozwijany przez społeczność i jest w pełni open source.

Framework oferuje:

• System ekonomii z bankiem, gotówką i transakcjami.
• System zawodów i organizacji z konfigurowalnymi profesjami.
• Zarządzanie ekwipunkiem z przedmiotami, bronią i obiektami użytkowymi.
• System postaci i tożsamości z rejestracją i wyborem.

Wymagania

Zanim zaczniesz, upewnij się, że masz przygotowane:

• Serwer FiveM: z zainstalowanym txAdmin (standardowo przy instalacjach serwera FiveM). Potrzebujesz ważnej licencji serwera FiveM z keymaster.fivem.net.
• Baza danych MySQL: ESX przechowuje wszystkie dane w MySQL. Zarówno MariaDB 10.x, jak i MySQL 8.x działają. Utwórz pustą bazę danych z dedykowanym użytkownikiem.
• oxmysql: zalecany resource MySQL dla FiveM. Pobierz najnowszą wersję z GitHub.

Krok 1: konfiguracja bazy danych

Zaloguj się do serwera MySQL i utwórz bazę danych:

CREATE DATABASE esx_db;

CREATE USER 'esxuser'@'localhost' IDENTIFIED BY 'silne_haslo';

GRANT ALL PRIVILEGES ON esx_db.* TO 'esxuser'@'localhost';

FLUSH PRIVILEGES;

Zapisz dane bazy danych; będziesz ich potrzebować do konfiguracji.

Krok 2: instalacja oxmysql

Pobierz oxmysql ze strony GitHub releases. Rozpakuj archiwum do katalogu resources. W pliku server.cfg dodaj:

set mysql_connection_string "mysql://esxuser:silne_haslo@localhost/esx_db?charset=utf8mb4"

ensure oxmysql

Connection string łączy oxmysql z właśnie utworzoną bazą danych. Upewnij się, że ensure oxmysql znajduje się przed wszystkimi innymi zasobami korzystającymi z bazy danych.

Krok 3: pobieranie ESX Legacy

Sklonuj lub pobierz ESX Legacy z oficjalnego repozytorium GitHub (esx-framework). Otrzymasz katalog zawierający zasób core i standardowe zasoby (esx_identity, esx_society, esx_vehicleshop itd.). Skopiuj wszystko do katalogu resources.

Struktura katalogów wygląda typowo tak:

• resources/[esx]/es_extended: framework podstawowy.
• resources/[esx]/esx_identity: rejestracja postaci.
• resources/[esx]/esx_skin: wygląd postaci.
• resources/[esx]/esx_vehicleshop: salon pojazdów.

Krok 4: konfiguracja server.cfg

Dodaj zasoby ESX do server.cfg we właściwej kolejności. Kolejność jest ważna, ponieważ zasoby mają zależności:

1. ensure oxmysql
2. ensure es_extended
3. ensure esx_identity
4. ensure esx_skin
5. ensure esx_vehicleshop
6. Pozostałe zasoby ESX

Możesz też użyć ensure [esx], aby załadować wszystkie zasoby z katalogu esx, ale wtedy masz mniejszą kontrolę nad kolejnością. Przy problemach ręczne określanie jest bardziej niezawodne.

Krok 5: import tabel bazy danych

ESX Legacy zawiera pliki SQL tworzące potrzebne tabele. Zaimportuj główny plik (zazwyczaj es_extended.sql) do bazy danych:

mysql -u esxuser -p esx_db < es_extended.sql

Niektóre dodatkowe zasoby mają własne pliki SQL. Sprawdź każdy katalog zasobów pod kątem pliku .sql i zaimportuj go również. Kolejność nie ma tu znaczenia, o ile główne tabele już istnieją.

Krok 6: pierwsze uruchomienie i weryfikacja

Uruchom serwer przez txAdmin i obserwuj wyjście konsoli. Zwróć uwagę na:

• oxmysql musi pomyślnie połączyć się z bazą danych (zielony komunikat w konsoli).
• es_extended musi załadować się bez komunikatów o błędach.
• Pozostałe zasoby muszą ładować się po es_extended.

Połącz się z serwerem przez FiveM. Jeśli wszystko jest poprawne, otrzymasz ekran rejestracji postaci, gdzie wybierasz imię, datę urodzenia i płeć. Po rejestracji pojawiasz się w świecie ze standardowym startowym budżetem i możesz testować podstawowe funkcje.

Najczęstsze błędy

• Database connection failed: sprawdź connection string pod kątem literówek. Najczęstsza przyczyna to błędne hasło lub nazwa bazy danych.
• Resource not found: sprawdź, czy nazwy katalogów dokładnie odpowiadają liniom ensure w server.cfg. Wielkie litery i podkreślniki mają znaczenie.
• es_extended startuje przed oxmysql: upewnij się, że oxmysql jest zawsze ładowany jako pierwszy w server.cfg.

Następne kroki

Z działającym frameworkiem możesz dalej rozbudowywać:

• Dodawaj zawody przez esx_jobs lub twórz własne zawody z systemem organizacji.
• Zainstaluj bardziej rozbudowany system ekwipunku, taki jak ox_inventory.
• Dodaj HUD z informacjami o pieniądzach, zdrowiu i innych danych.
• Konfiguruj pojazdy, domy i firmy.

Jaka jest różnica między ESX Legacy a QBCore?

Oba to frameworki roleplay dla FiveM. ESX Legacy jest starszy, ma większą społeczność i więcej dostępnych zasobów. QBCore jest nowszy z bardziej nowoczesną strukturą kodu. Wybór zależy od preferencji i tego, jakich zasobów chcesz używać. Wiele skryptów jest dostępnych dla obu frameworków.

Czy mogę instalować zasoby ESX od innych?

Tak. Na platformach takich jak GitHub, Tebex i forum CFX znajdziesz tysiące zasobów kompatybilnych z ESX, zarówno darmowych, jak i płatnych. Zawsze sprawdź, czy zasób jest kompatybilny z ESX Legacy (nie starszym ESX 1.x) i przeczytaj opinie przed instalacją. Niesprawdzone zasoby z nieznanych źródeł mogą stanowić ryzyko bezpieczeństwa.

Ile RAM potrzebuje serwer ESX?

Podstawowy serwer ESX ze standardowymi zasobami działa na 4 GB RAM. Z rozbudowanymi skryptami, niestandardowymi pojazdami i wieloma graczami rośnie to do 6 do 8 GB. Baza danych wymaga oddzielnej pamięci; licz na dodatkowe 1 do 2 GB na MySQL, jeśli działa na tej samej maszynie.

Gotowy, aby uruchomić własny serwer roleplay FiveM? W HostValues FiveM hosting txAdmin, MySQL i pełny dostęp do serwera czekają na Ciebie. ESX Legacy zainstalujesz w ciągu godziny.