Jak podłączyć bazę danych do serwera FiveM

Jak podłączyć bazę danych do serwera FiveM

Każdy sensowny framework roleplay na FiveM trzyma swoje dane w MySQL: postacie, prace, pojazdy, ekwipunek, konta bankowe. Twój serwer FiveM w DoomHosting ma miejsce na bazę MySQL, którą tworzysz sam w zakładce Bazy danych w panelu, a do podłączenia wystarczy jedna linia w server.cfg. Ten poradnik pokazuje, jak utworzyć bazę, złożyć connection string oczekiwany przez oxmysql, gdzie wpisać tę linię i jak zaimportować schemat ESX lub QBCore.

Co będzie potrzebne

• Serwer FiveM w DoomHosting, który już się uruchamia. Jeśli jeszcze nie startuje, najpierw ustaw klucz licencyjny: jak uzyskać klucz licencyjny FiveM.
• oxmysql, czyli resource, przez który każdy nowoczesny framework rozmawia z MySQL. ESX i QBCore dostarczają go razem ze sobą.
• Klient MySQL na komputerze, jeśli planujesz import schematu frameworka. HeidiSQL (Windows) i DBeaver (wszystkie systemy) są darmowe.

Utwórz bazę danych w panelu

1. Otwórz swoje serwery gier i kliknij swój serwer FiveM.
2. W nawigacji sekcji, w grupie Zaawansowane, otwórz Bazy danych.
3. Kliknij Nowa baza danych, wpisz krótką nazwę (tylko litery, cyfry i podkreślenia) i zatwierdź.

Tworzymy bazę oraz pasującego użytkownika z wygenerowanym hasłem. Nazwa automatycznie dostaje prefiks, więc baza nazwana esx kończy jako coś w rodzaju s1708_esx, a użytkownik wygląda jak u1708_esxdemo.

Wiersz pokazuje trzy pola z danymi dostępowymi. Host to adres bazy razem z portem, Nazwa użytkownika to wygenerowany użytkownik, a Hasło jest ukryte, dopóki nie klikniesz ikony oka. Kliknięcie pola kopiuje jego wartość. Po prawej są dwa przyciski: Nowe hasło zmienia hasło (wszystko, co nadal używa starego, natychmiast przestaje działać), a kosz usuwa bazę i wszystkie jej dane bezpowrotnie.

Nagłówek karty liczy Twoje miejsca, na przykład 1 z 1 baz danych w użyciu. Jedno miejsce wystarcza na normalną instalację ESX lub QBCore, bo framework i wszystkie jego resources korzystają z tej samej bazy. Napisz do supportu, jeśli Twoja konfiguracja naprawdę potrzebuje drugiej.

Złóż swój connection string

oxmysql czyta jedną convar, mysql_connection_string, i przyjmuje dwa formaty:

set mysql_connection_string "mysql://u1708_esxdemo:[email protected]:3306/s1708_esx"
set mysql_connection_string "user=u1708_esxdemo;password=YourPassword;host=203.0.113.10;port=3306;database=s1708_esx"

Cztery wartości weź bezpośrednio z zakładki Bazy danych: użytkownika z Nazwa użytkownika, hasło z Hasło, nazwę bazy z tytułu wiersza, a adres z Host. Pole Host zawiera już port w formie adres:port. W formacie URI wklejasz je bez zmian po znaku @. W formacie klucz i wartość dzielisz je na dwukropku: adres do host=, a port do port=.

Użyj drugiego formatu. Generowane przez nas hasła mieszają litery i cyfry ze znakami ze zbioru ! @ = . + ^, a oxmysql wymienia ; , / ? : @ & = + $ # jako znaki zarezerwowane w connection stringu. Hasło z @, = lub + po cichu psuje format mysql://: parser czyta część hasła jako nazwę hosta, a połączenie kończy się błędem przy danych, które są całkowicie poprawne. Forma user=...;password=... nie ma tej pułapki.

Dodaj to do server.cfg

1. Otwórz zakładkę Pliki i kliknij server.cfg, aby edytować go w przeglądarce.
2. Umieść connection string powyżej wszystkich linii z resources, a oxmysql uruchom przed frameworkiem:

set mysql_connection_string "user=u1708_esxdemo;password=YourPassword;host=203.0.113.10;port=3306;database=s1708_esx"

ensure oxmysql
ensure es_extended

3. Zapisz plik, a potem zrestartuj serwer na górze panelu. Convary są czytane tylko przy starcie, więc zmiana nic nie da, dopóki serwer się nie zrestartuje.

Dwóch rzeczy nie ruszaj. Nasz start przy każdym bootowaniu przepisuje linie endpoint_add_tcp i endpoint_add_udp na przydzielony Ci port, więc ich edycja nie ma sensu. I traktuj server.cfg jak plik z sekretami: leży w nim teraz hasło do bazy obok klucza licencyjnego, więc nigdy nie wklejaj go na kanał supportu na Discordzie bez zamazania obu.

Jeśli włączyłeś txAdmin przyciskiem Włącz txAdmin w Przeglądzie, FXServer nie wykonuje już /home/container/server.cfg bezpośrednio. txAdmin przejmuje start i uruchamia serwer z własnego folderu danych /home/container/txData, więc edytuj ten server.cfg, który leży tam w folderze wdrożenia, albo skorzystaj z edytora CFG wbudowanego w txAdmin. Do panelu webowego wchodzisz przez Otwórz txAdmin w Przeglądzie.

Zainstaluj oxmysql

Najpierw zajrzyj do resources. Recipes ESX i QBCore prawie zawsze zawierają już oxmysql, a druga kopia daje konflikt nazw resources, nie szybszy serwer.

Jeśli go brakuje, pobierz najnowszy release z repozytorium oxmysql, rozpakuj go i wgraj folder oxmysql do katalogu resources z zakładki Pliki. Potem dodaj ensure oxmysql powyżej resources frameworka, jak wyżej. Jeśli w Twojej konfiguracji nadal leżą mysql-async lub ghmattimysql, usuń je: oxmysql udostępnia ich exporty, a uruchomienie obu daje zdublowane query handlery.

Dokumentacja oxmysql opisuje resztę, w tym set mysql_debug true, które wypisuje każde zapytanie w konsoli, oraz set mysql_slow_query_warning 150 do oznaczania wolnych zapytań.

Uwagi o ESX i QBCore

Oba frameworki pytają bazę przez oxmysql, więc jeden connection string obsługuje i framework, i wszystkie resources na nim. Czego żaden z nich nie zrobi za Ciebie, to utworzenie tabel. Te importujesz sam:

1. Zainstaluj HeidiSQL lub DBeaver na komputerze.
2. Utwórz nowe połączenie MySQL lub MariaDB z adresem i portem z pola Host oraz Nazwa użytkownika i Hasło z zakładki Bazy danych. Tworzony przez nas użytkownik może łączyć się z dowolnego adresu, więc klient na Twoim domowym łączu zadziała bez dodatkowej konfiguracji.
3. Wybierz swoją bazę, otwórz plik .sql frameworka i wykonaj go.

Dla ESX to plik SQL z es_extended plus to, co dorzuca każdy addon. Zobacz dokumentację ESX. Dla QBCore najpierw importujesz dump z qb-core, a potem pliki poszczególnych resources, tak jak opisuje dokumentacja QBCore. Zaimportuj schemat przed pierwszym startem z włączonym frameworkiem, inaczej konsola zapełni się błędami o brakujących tabelach.

Jedna rzecz warta uwagi przy kopiach zapasowych: kopie z panelu archiwizują pliki serwera, a nie bazę MySQL. Przed dużą aktualizacją frameworka albo wipe'em wyeksportuj dump .sql swoim klientem.

Częste problemy

Failed to connect albo odmowa dostępu przy starcie. W dziewięciu przypadkach na dziesięć w stringu nadal jest localhost. W kontenerze gry nie działa żaden serwer MySQL, więc hostem musi być adres z zakładki Bazy danych.

Dane są poprawne, a logowanie i tak się nie udaje. Hasło zawiera @, = lub +, a Ty używasz formatu mysql://. Przejdź na formę user=...;password=...;host=.... Kliknięcie Nowe hasło też może dać czystsze hasło, ale drugi format to pewne rozwiązanie.

Resources startują, zanim convar zostanie ustawiony. oxmysql łączy się w chwili uruchomienia, więc linia set mysql_connection_string musi stać powyżej ensure oxmysql. Używaj set, nie sets ani setr: te rozsyłają wartość do każdego łączącego się gracza.

Po zmianie w konfiguracji nic się nie zmieniło. Zrestartuj serwer. Działający serwer nigdy nie czyta server.cfg ponownie.

Błędy o nieznanych tabelach lub kolumnach. Połączenie działa, ale schemat nigdy nie został zaimportowany albo trafił do złej bazy. Sprawdź w HeidiSQL, że tabele leżą w Twojej bazie z prefiksem, a nie w drugiej, utworzonej ręcznie.

Edytowałeś server.cfg, ale txAdmin jest włączony. txAdmin uruchamia własną kopię w /home/container/txData. Edytuj tę, bo plik, który zmieniłeś, po prostu nigdy nie zostanie odczytany.

Zakładka Bazy danych mówi, że bazy są niedostępne. Twój serwer nie ma miejsca na bazę danych. Napisz do supportu, sprawdzimy usługę.

Następne kroki

Twój framework ma teraz gdzie trzymać dane. Jeśli wciąż jesteś w trakcie konfiguracji, poradnik o kluczu licencyjnym znajdziesz tutaj: jak uzyskać klucz licencyjny FiveM. Wszystkie szczegóły planów, sprzętu i cen są na stronie hosting serwerów FiveM.