Jak Skonfigurować Bazę Danych MariaDB dla Serwera FiveM? Poradnik Techniczny

Prawidłowo skonfigurowana baza danych to kręgosłup każdego serwera FiveM RP. Odpowiada za przechowywanie danych graczy, ich ekwipunku, pojazdów i postępów w grze. Wybór i konfiguracja odpowiedniego systemu, takiego jak MariaDB, jest kluczowa dla zapewnienia stabilności, wydajności i bezpieczeństwa Twojego serwera. Bez niej, żadne dane nie byłyby trwale zapisywane.

W tym poradniku przeprowadzimy Cię krok po kroku przez cały proces konfiguracji bazy danych MariaDB do współpracy z Twoim serwerem FiveM. Dowiesz się, jak stworzyć bazę, użytkownika oraz jak poprawnie skonstruować tzw. „connection string” w pliku server.cfg, aby wszystko działało bez zarzutu.

Wymagania Wstępne

• Dostęp do serwera VPS lub dedykowanego z uprawnieniami roota/administratora.
• Zainstalowany serwer MariaDB (lub możliwość jego instalacji).
• Dostęp do konsoli serwera (np. przez SSH).
• Dostęp do plików serwera FiveM, w szczególności do pliku server.cfg.
• Podstawowa znajomość działania konsoli Linux lub Windows.

Przewodnik Krok po Kroku

1. Instalacja serwera MariaDB

   Jeśli jeszcze nie masz zainstalowanej MariaDB, musisz to zrobić. Dla systemów opartych na Debianie/Ubuntu, możesz użyć następującej komendy: sudo apt update && sudo apt install mariadb-server. Po instalacji zaleca się uruchomienie skryptu zabezpieczającego: sudo mysql_secure_installation.

2. Tworzenie bazy danych i użytkownika

   Połącz się z konsolą MariaDB za pomocą komendy sudo mysql -u root -p. Następnie stwórz nową bazę danych oraz dedykowanego użytkownika, który będzie miał do niej dostęp. Zastąp 'nazwa_bazy', 'nazwa_uzytkownika' i 'mocne_haslo' swoimi własnymi wartościami.

   CREATE DATABASE nazwa_bazy CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
   CREATE USER 'nazwa_uzytkownika'@'localhost' IDENTIFIED BY 'mocne_haslo';
   GRANT ALL PRIVILEGES ON nazwa_bazy.* TO 'nazwa_uzytkownika'@'localhost';
   FLUSH PRIVILEGES;
   EXIT;

   Ważne: Użycie 'localhost' oznacza, że tylko aplikacje działające na tej samej maszynie (jak Twój serwer FiveM) będą mogły się połączyć. Jest to najbezpieczniejsza opcja.

3. Konfiguracja pliku server.cfg

   Teraz musisz poinformować swój serwer FiveM, jak ma się połączyć z nowo utworzoną bazą danych. Otwórz plik server.cfg i dodaj lub zmodyfikuj linię odpowiedzialną za połączenie z bazą. Najczęściej używane skrypty do obsługi bazy to mysql-async lub nowszy oxmysql.

4. Importowanie wymaganych plików .sql

   Wiele frameworków (jak ESX, QBCore) oraz niektóre skrypty dostarczają plik z rozszerzeniem .sql, który zawiera początkową strukturę tabel. Musisz zaimportować ten plik do swojej bazy danych. Możesz to zrobić za pomocą narzędzia takiego jak HeidiSQL, DBeaver lub bezpośrednio z konsoli poleceniem: mysql -u nazwa_uzytkownika -p nazwa_bazy < sciezka/do/pliku.sql.

5. Uruchomienie i weryfikacja

   Uruchom serwer FiveM. Obserwuj konsolę startową w poszukiwaniu komunikatów o pomyślnym połączeniu z bazą danych (np. "mysql-async connected!"). Jeśli pojawią się błędy związane z uwierzytelnianiem lub połączeniem, sprawdź dokładnie dane w swoim connection stringu.

Przykładowy Kod / Konfiguracja

Poniżej znajduje się przykład, jak powinien wyglądać wpis w pliku server.cfg, który konfiguruje połączenie z bazą danych. Upewnij się, że ta linia jest dodana lub odkomentowana (nie ma znaku # na początku).

# Upewnij się, że uruchamiasz skrypt do obsługi bazy PRZED skryptami, które z niej korzystają
ensure mysql-async

# Konfiguracja połączenia z bazą danych MariaDB/MySQL
set mysql_connection_string "mysql://nazwa_uzytkownika:mocne_haslo@localhost/nazwa_bazy?charset=utf8mb4"

Ten ciąg znaków, znany jako "connection string", zawiera wszystkie niezbędne informacje: typ bazy (mysql), nazwę użytkownika, hasło, adres hosta (localhost) oraz nazwę bazy danych. Parametr ?charset=utf8mb4 zapewnia prawidłowe kodowanie znaków, co jest ważne dla polskich liter i emoji.

Podsumowanie

Poprawna konfiguracja bazy danych MariaDB jest fundamentalnym krokiem w tworzeniu profesjonalnego serwera FiveM. Dzięki temu poradnikowi posiadasz wiedzę niezbędną do stworzenia bezpiecznego i wydajnego połączenia między serwerem gry a miejscem przechowywania jego danych. Pamiętaj, aby zawsze używać silnych, unikalnych haseł dla użytkowników bazy danych.

Kolejnym krokiem powinno być wdrożenie systemu regularnych kopii zapasowych (backupów) Twojej bazy danych. Utrata danych graczy może być katastrofalna dla społeczności serwera, dlatego lepiej zapobiegać niż leczyć.