Ten przewodnik opisuje, jak zainstalować zasoby (skrypty) na Twoim serwerze FiveM, skonfigurować bazę danych MySQL dla frameworków takich jak ESX lub QBCore oraz zrozumieć kolejność ładowania zasobów. Jeśli nie ukończyłeś jeszcze początkowej konfiguracji serwera, zacznij najpierw od Przewodnika konfiguracji serwera FiveM.

Instalowanie zasobów i skryptów

Serwery FiveM są rozszerzane za pomocą zasobów (zwanych też skryptami). Zasoby dodają funkcje takie jak salony samochodowe, prace, elementy HUD, frameworki i więcej.

Jak zainstalować zasób

1. Pobierz zasób z jego źródła (GitHub, fora Cfx.re, Tebex itp.).
2. Wyodrębnij folder zasobu z pliku ZIP/archiwum, jeśli to konieczne.
3. Prześlij folder zasobu do katalogu resources/ swojego serwera za pomocą zakładki Files w GPanel lub przez SFTP.
4. Otwórz server.cfg i dodaj linię ensure dla zasobu:

# Add your custom resources
ensure my-new-resource

5. Zrestartuj serwer z GPanel lub TXAdmin, aby zasób się załadował.

Manifesty zasobów

Każdy prawidłowy zasób musi zawierać plik manifestu. Nowoczesne zasoby używają fxmanifest.lua, natomiast starsze używają __resource.lua. Jeśli pobrany folder zasobu nie zawiera żadnego z tych plików, zasób się nie załaduje. Niektóre pobrania zagnieżdżają właściwy folder zasobu wewnątrz zewnętrznego folderu — upewnij się, że folder, który umieszczasz w resources/, to ten, który zawiera manifest.

Kolejność ładowania zasobów

Zasoby ładują się w kolejności, w jakiej pojawiają się w server.cfg. Jeśli zasób zależy od innego (na przykład skrypt pracy zależny od frameworku takiego jak ESX lub QBCore), upewnij się, że zależność jest wymieniona przed zasobem, który jej potrzebuje:

# Database resource first
ensure oxmysql

# Framework second
ensure es_extended

# Then resources that depend on the framework
ensure esx_basicneeds
ensure esx_jobs
ensure esx_vehicleshop

Organizowanie zasobów za pomocą folderów kategorii

Możesz organizować zasoby w podfoldery wewnątrz katalogu resources/. Użyj notacji nawiasów kwadratowych w server.cfg, aby zapewnić cały folder kategorii:

# Ensure all resources inside resources/[esx]/
ensure [esx]

# Ensure all resources inside resources/[standalone]/
ensure [standalone]

To ładuje każdy zasób w obrębie nazwanego podfolderu. Jest to wygodny sposób grupowania powiązanych skryptów bez wymieniania każdego z osobna.

Dynamiczne ładowanie zasobów przez TXAdmin

Nie zawsze potrzebujesz pełnego ponownego uruchomienia serwera, aby załadować nowy zasób. TXAdmin może uruchamiać, zatrzymywać i restartować poszczególne zasoby ze swojej strony Resources. Po przesłaniu nowego zasobu i dodaniu jego linii ensure możesz uruchomić następującą komendę w konsoli na żywo TXAdmin:

refresh
ensure my-new-resource

Komenda refresh nakazuje serwerowi ponowne przeskanowanie katalogu resources/ w poszukiwaniu nowych wpisów.

Konfiguracja bazy danych (MySQL / MariaDB)

Wiele frameworków i zasobów FiveM (takich jak ESX, QBCore lub vRP) wymaga bazy danych MySQL lub MariaDB. Legion Hosting zapewnia poświadczenia bazy danych wraz z Twoim serwerem.

Znajdowanie poświadczeń bazy danych

1. W GPanel przejdź do zakładki Databases.
2. Jeśli żadna baza danych jeszcze nie istnieje, kliknij New Database, aby ją utworzyć.
3. Zanotuj następujące szczegóły:
   • Host bazy danych (adres i port)
   • Nazwa bazy danych
   • Nazwa użytkownika
   • Hasło (kliknij ikonę oka, aby je odsłonić)

Konfigurowanie połączenia z bazą danych

Szczegóły połączenia z bazą danych są ustawiane w server.cfg za pomocą ciągu połączenia. Dokładny format zależy od tego, którego zasobu MySQL używasz, ale najczęstszy format to:

# MySQL connection string (oxmysql / mysql-async format)
set mysql_connection_string "mysql://USERNAME:PASSWORD@HOST:PORT/DATABASE_NAME?charset=utf8mb4"

Zastąp symbole zastępcze swoimi rzeczywistymi poświadczeniami z zakładki Databases. Na przykład:

set mysql_connection_string "mysql://u123_fivem:[email protected]:3306/s123_fivem?charset=utf8mb4"

Wybór zasobu MySQL

Niezależnie od tego, którego zasobu MySQL używasz, musi on być zapewniony w server.cfg przed wszelkimi zasobami, które od niego zależą:

# Database connection
set mysql_connection_string "mysql://USERNAME:PASSWORD@HOST:PORT/DATABASE_NAME?charset=utf8mb4"

# MySQL resource — must load before framework
ensure oxmysql

# Framework
ensure es_extended

Podstawy frameworków

Framework zapewnia podstawowe systemy rozgrywki, na których budują inne zasoby — takie rzeczy jak tożsamość gracza, pieniądze, ekwipunek, prace i pojazdy. Dwa najpopularniejsze frameworki FiveM to:

Większość frameworków jest instalowana za pomocą systemu przepisów (recipe) TXAdmin podczas początkowej konfiguracji. Jeśli wybrałeś przepis taki jak "QBCore" lub "ESX" podczas konfiguracji TXAdmin, framework i jego podstawowe zależności są już zainstalowane. Jeśli musisz zainstalować framework ręcznie, postępuj zgodnie z jego oficjalną dokumentacją:

• Dokumentacja ESX
• Dokumentacja QBCore

Uzyskiwanie pomocy

Jeśli potrzebujesz pomocy przy instalacji zasobów lub konfiguracji bazy danych:

1. Sprawdź dokumentację zasobu lub jego stronę na GitHub pod kątem instrukcji instalacji i znanych problemów.
2. Przejrzyj konsolę GPanel lub logi TXAdmin pod kątem komunikatów o błędach.
3. Otwórz zgłoszenie do wsparcia pod adresem https://legionhosting.net/submitticket.php z komunikatami o błędach i nazwą zasobu, który próbujesz zainstalować.

Powiązane artykuły

• Przewodnik konfiguracji serwera FiveM
• Rozwiązywanie problemów FiveM
• Jak przesyłać pliki przez SFTP
• Jak znaleźć adres IP i port swojego serwera