FiveM Resources

Zarządzanie zasobami (resources) dla serwerów FiveM.

Czym są FiveM resources?

Resources to skrypty Lua i assety które rozszerzają funkcjonalność serwera FiveM. W przeciwieństwie do modów ARK, resources FiveM są:

• Napisane w Lua/JavaScript - Kod źródłowy jest dostępny i edytowalny
• Hot-reloadable - Możesz restartować resource bez restartu całego serwera
• Modułowe - Jeden resource = jedna funkcjonalność
• Dependency-based - Resources mogą wymagać innych resources

Popularne typy resources:

• Gamemodes - ESX, QBCore, vRP (całe frameworki roleplay)
• Jobs - Police, EMS, mechanic, taxi
• UI - HUD, inventories, menus
• Vehicles - Custom pojazdy
• Maps - Custom budynki i lokacje
• Utilities - Admin tools, anti-cheat, logging

Różnice między ARK mods a FiveM resources

Cecha	ARK Mods	FiveM Resources
Format	Skompilowane pliki (.pak)	Lua scripts (.lua)
Instalacja	Przez SGS Hub + CurseForge	Ręczne + txAdmin
Restart	Wymaga restartu serwera	Hot-reload możliwy
Edycja	Niemożliwa (closed source)	Pełna edycja kodu
Dependencies	Automatyczne w SGS Hub	Ręczna konfiguracja
Źródła	CurseForge, Steam Workshop	GitHub, forum.cfx.re, Tebex

Instalacja resources przez txAdmin

SGS Hub używa txAdmin jako frontendu dla serwerów FiveM. Większość operacji resources wykonujesz przez txAdmin.

Dostęp do txAdmin

1. Panel serwera FiveM → zakładka txAdmin
2. SGS Hub otworzy txAdmin w nowej karcie
3. Zaloguj się (hasło ustawiłeś podczas pierwszego uruchomienia)

Metoda 1: Przez Recipe Builder (zalecane dla początkujących)

Recipe Builder to kreator gotowych setupów FiveM (ESX, QBCore, itp.)

Krok 1: Otwórz Recipe Builder

1. W txAdmin → Recipe Builder
2. Zobaczysz listę gotowych recipes:
   • ESX Legacy - Framework roleplay
   • QBCore - Nowoczesny framework RP
   • Vanilla - Czysty FiveM bez frameworka
   • Custom recipes - Społecznościowe setupy

Krok 2: Wybierz recipe

1. Kliknij recipe (np. "ESX Legacy")
2. Przeczytaj opis:
   • Jakie resources zostaną zainstalowane
   • Wymagania (database, API keys)
   • Szacowany czas instalacji
3. Kliknij Deploy Recipe

Krok 3: Konfiguracja

Recipe może poprosić o:

• Database credentials - MySQL host, user, password, database name
• License keys - Steam API key, Discord bot token
• Server info - Nazwa serwera, max players

Krok 4: Instalacja

1. txAdmin pobiera wszystkie resources z GitHub
2. Konfiguruje server.cfg
3. Importuje database schema (jeśli potrzebny)
4. Konfiguruje dependencies
5. Proces trwa ~5-15 minut

Krok 5: Pierwszy start

1. txAdmin automatycznie restartuje serwer
2. Poczekaj ~2-5 minut
3. Serwer pojawi się na liście Cfx.re

Recipe Builder = szybki start

Recipe Builder to najszybszy sposób na setup FiveM serwera z kompleksnym gamemode. ESX/QBCore recipes instalują 50-100 resources w jednym kroku!

Metoda 2: Ręczna instalacja z GitHub

Dla zaawansowanych użytkowników którzy chcą dodać konkretny resource.

Krok 1: Znajdź resource

1. Wyszukaj resource na GitHub lub forum.cfx.re
2. Przykład: qb-policejob
3. Sprawdź README.md dla instrukcji instalacji i dependencies

Krok 2: Pobierz resource

1. Kliknij Code → Download ZIP
2. Rozpakuj ZIP na swoim komputerze
3. Folder powinien zawierać:

   qb-policejob/
   ├── client/
   ├── server/
   ├── config.lua
   ├── fxmanifest.lua
   └── README.md

Krok 3: Upload do serwera

Opcja A: Przez txAdmin

1. txAdmin → Resources → Upload
2. Wybierz folder qb-policejob
3. txAdmin uploaduje files do /resources/

Opcja B: Przez SGS Hub Files

1. Panel serwera → zakładka Files
2. Nawiguj do /resources/[local]/
3. Kliknij Upload → Wybierz folder
4. Poczekaj na zakończenie uploadu

Krok 4: Dodaj do server.cfg

1. txAdmin → Config Editor lub SGS Hub → Files → server.cfg
2. Dodaj linię:

   ensure qb-policejob

3. Zapisz plik

Krok 5: Zainstaluj dependencies

Jeśli resource wymaga innych resources (np. qb-core, qb-target):

1. Sprawdź fxmanifest.lua:

   dependencies {
       'qb-core',
       'qb-target'
   }

2. Upewnij się że dependencies są zainstalowane przed tym resourcem
3. W server.cfg dependencies muszą być nad resourcem:

   ensure qb-core
   ensure qb-target
   ensure qb-policejob

Krok 6: Restart resource

W txAdmin:

1. Resources → Znajdź qb-policejob
2. Kliknij Restart
3. Sprawdź Status - powinno być "Started" (zielony)

Sprawdzaj logi

Po starcie resourcea, sprawdź Live Console w txAdmin. Szukaj błędów:

ERROR: Could not load resource qb-policejob
ERROR: Missing dependency qb-core

Metoda 3: Przez Tebex (płatne resources)

Tebex to marketplace z płatnymi resources FiveM (skrypty premium).

Krok 1: Kup resource

1. Przejdź do Tebex
2. Kup resource (ceny: $5-$200+)
3. Otrzymasz link do pobrania + license key

Krok 2: Aktywuj licencję

1. Zaloguj się do Keymaster Tebex
2. Wprowadź Cfx.re license key Twojego serwera
3. Resource zostanie przypisany do Twojego serwera

Krok 3: Instalacja

Podobnie jak Metoda 2 (ręczna instalacja), ale:

• Resource może być encrypted (.fxap files)
• Resource sprawdzi licencję przy starcie
• Bez valid license = resource nie wystartuje

Zarządzanie resources w txAdmin

Lista resources

txAdmin → Resources

Zobaczysz wszystkie zainstalowane resources:

• Name - Nazwa resourcea
• Status - Started, Stopped, Failed
• Type - Script, Map, Gamemode, etc.
• Author - Twórca
• Version - Wersja
• Actions - Start, Stop, Restart, Delete

Filtry:

• Running only - Pokaż tylko działające
• Failed only - Pokaż tylko błędne
• Search - Wyszukaj po nazwie

Start/Stop/Restart resources

Start resource:

1. Znajdź resource na liście
2. Jeśli Status = Stopped, kliknij Start
3. Status zmienia się na Started

Stop resource:

1. Kliknij Stop obok działającego resourcea
2. Resource zatrzymuje się bez restartu serwera
3. Gracze stracą funkcjonalność tego resourcea

Restart resource:

1. Kliknij Restart
2. Resource zatrzymuje się i startuje ponownie
3. Zmiany w kodzie zostaną załadowane

Hot-reload

Największa zaleta FiveM! Możesz edytować kod resourcea i restartować go bez restartu całego serwera. Gracze nawet nie zauważą (poza krótkim freezem UI).

Restart all resources:

1. txAdmin → Resources → Restart All
2. Wszystkie resources restartują się sekwencyjnie
3. Czas: ~30-60 sekund

Usuwanie resources

Krok 1: Stop resource

Zatrzymaj resource przed usunięciem.

Krok 2: Delete

1. txAdmin → Resources → Znajdź resource
2. Kliknij Delete
3. Potwierdź usunięcie
4. Resource zostaje usunięty z /resources/

Krok 3: Usuń z server.cfg

1. Otwórz server.cfg
2. Usuń linię ensure <resource-name>
3. Zapisz

Database cleanup

Usunięcie resourcea NIE usuwa danych z database! Jeśli resource stworzył tabele SQL, musisz je usunąć ręcznie:

DROP TABLE qb_policejob;
DROP TABLE qb_police_evidence;

Sprawdź README resourcea dla listy tabel do usunięcia.

Konfiguracja resources

Edycja config.lua

Większość resources ma plik config.lua z ustawieniami.

Krok 1: Otwórz config

Opcja A: Przez txAdmin

1. txAdmin → Resources → Kliknij resource
2. Files → config.lua
3. Edytuj w built-in editorze

Opcja B: Przez SGS Hub

1. Panel serwera → Files
2. /resources/<resource-name>/config.lua
3. Edytuj w SGS Hub editor

Krok 2: Edytuj ustawienia

Przykład qb-policejob/config.lua:

Config = {}

Config.UseTarget = true               -- Użyj qb-target zamiast draw markers
Config.Locations = {
    ["duty"] = {
        vector3(442.57, -982.31, 30.68)  -- LSPD duty toggle
    },
}

Config.Items = {
    handcuffs = "handcuffs",
    spikestrip = "spike_strip",
}

Zmień wartości według potrzeb.

Krok 3: Zapisz i restart

1. Zapisz plik
2. txAdmin → Resources → Restart resource
3. Zmiany wejdą w życie natychmiast

Database configuration

Resources łączą się z MySQL database przez server.cfg.

Przykład konfiguracji (QBCore):

# MySQL connection
set mysql_connection_string "mysql://user:password@localhost/database_name?charset=utf8mb4"

# Resources
ensure qb-core
ensure qb-policejob

Jak ustawić database:

1. Utwórz MySQL database (przez PHPMyAdmin lub cPanel)
2. Importuj schema z resourcea (qb-policejob/schema.sql)
3. Zaktualizuj connection string w server.cfg
4. Restart all resources

Shared database dla ESX/QBCore

Wszystkie resources danego frameworka (ESX lub QBCore) współdzielą tę samą database. Nie twórz oddzielnych databases dla każdego resourcea!

Troubleshooting

Resource nie startuje

Sprawdź txAdmin Live Console:

Error: "Resource not found"

• Sprawdź czy folder resourcea istnieje w /resources/
• Sprawdź czy nazwa w server.cfg zgadza się z nazwą folderu

Error: "Failed to load resource manifest"

• fxmanifest.lua jest błędnie skonfigurowany
• Sprawdź syntax errors (missing quotes, brackets)

Error: "Missing dependency"

• Resource wymaga innego resourcea który nie jest zainstalowany
• Zainstaluj dependency i restart

Error: "Database connection failed"

• MySQL connection string jest nieprawidłowy
• Sprawdź user/password/database name
• Upewnij się że MySQL server działa

Resource działa, ale features nie działają

Sprawdź:

1. Config.lua - Czy ustawienia są poprawne?
2. Permissions - Czy masz admin rights w grze?
3. Dependencies - Czy wszystkie zależności są started?
4. Database - Czy tabele zostały zaimportowane?

Debug mode: Włącz debug w config.lua (jeśli dostępny):

Config.Debug = true

Restart resource, sprawdź console dla debug info.

Performance issues

Symptomy:

• Niski FPS graczy
• Wysoki ms na serwerze
• Lagi podczas używania features

Rozwiązania:

1. Sprawdź resource monitor w txAdmin:
   • Resources → Performance
   • Sortuj według CPU/Memory usage
   • Resources z >10ms są problematyczne
2. Optymalizuj kod - Zmniejsz częstotliwość Citizen.CreateThread
3. Usuń nieużywane resources - Każdy resource zjada zasoby
4. Upgrade serwera - FiveM może wymagać więcej RAM/CPU

Następne kroki

• Pliki i backupy - Zarządzanie plikami serwera i kopie zapasowe
• Troubleshooting FiveM - Rozwiązywanie problemów FiveM