Baza danych MySQL w FiveM - oxmysql, HeidiSQL i import plików SQL

Serwery RP zapisują w bazie danych wszystko: postacie, pieniądze, ekwipunek, auta, mieszkania. FiveM łączy się z bazą przez zasób oxmysql. W pakiecie FiveM masz u nas dwie bazy MySQL - jedną na serwer, drugą np. na testy.

1. Utwórz bazę

W panelu gier otwórz zakładkę Databases i kliknij New Database. Po utworzeniu kliknij ikonę oka przy bazie, żeby zobaczyć:

• Endpoint - adres i port, np. 10.0.0.5:3306,
• Username - nazwa użytkownika,
• Password - hasło,
• Database - pełna nazwa bazy (z przedrostkiem, np. s12_rp).

Jeśli hasło wyciekło (np. trafiło na zrzut ekranu), kliknij Rotate Password i zaktualizuj konfigurację.

2. Połączenie z serwerem

W server.cfg (w txAdmin: Settings → CFG Editor) ustaw:

set mysql_connection_string "mysql://uzytkownik:haslo@adres:3306/s12_rp?charset=utf8mb4"

Zamiast uzytkownik, haslo, adres i nazwy bazy wpisz dane z panelu. Jeśli hasło zawiera znaki specjalne (@, :, /, #), użyj drugiego formatu, w którym nie trzeba ich kodować:

set mysql_connection_string "user=uzytkownik;password=haslo;host=adres;port=3306;database=s12_rp;charset=utf8mb4"

oxmysql musi być pierwszym zasobem na liście ensure - inne skrypty potrzebują bazy od razu przy starcie.

3. Połączenie z komputera (HeidiSQL)

Do przeglądania tabel i importu plików SQL użyj darmowego programu HeidiSQL:

1. Nowa sesja, typ sieci MariaDB or MySQL (TCP/IP).
2. Nazwa hosta i port - z pola Endpoint.
3. Użytkownik i hasło - z panelu.
4. Kliknij Otwórz.

Jeśli połączenie z domu nie działa, a serwer łączy się bez problemu, baza może przyjmować połączenia tylko z sieci serwerów. Napisz wtedy zgłoszenie w panelu klienta.

4. Import pliku SQL

Skrypty często mają plik .sql z tabelami. W HeidiSQL:

1. Wybierz swoją bazę z listy po lewej.
2. Plik → Wczytaj plik SQL i wskaż plik.
3. Kliknij Wykonaj (niebieska strzałka albo F9).

Szablony txAdmin (QBCore, ESX) importują swoje tabele same podczas instalacji.

Kopia bazy

Kopie zapasowe w zakładce Backups obejmują pliki serwera, ale nie bazę danych. Przed dużymi zmianami (nowy skrypt ekonomii, aktualizacja frameworka) zrób zrzut bazy w HeidiSQL: prawy przycisk na bazie → Eksportuj bazę jako SQL. Przy wyborze zaznacz tworzenie tabel i dane.

Najczęstsze błędy

• „Access denied for user” - złe hasło albo użytkownik. Skopiuj dane jeszcze raz z panelu.
• „Unknown database” - brak przedrostka w nazwie bazy (rp zamiast s12_rp).
• „ECONNREFUSED” - zły adres albo port w connection stringu.
• Polskie znaki jako krzaczki - dopisz charset=utf8mb4 do connection stringu.

Aktualizacja: 2026-09-21