Zarządzanie Zasobami w txAdmin

Zasoby (resources) to skrypty dodające funkcje do serwera FiveM.

Czym są Zasoby?

Zasoby mogą być:

Frameworki - ESX, QBCore
Skrypty życiowe - Praca, mieszkania, pojazdy
UI/HUD - Interfejsy użytkownika
Mapy - Customowe lokacje
Narzędzia admin - Komendy, menu
Anty-cheaty - Zabezpieczenia

Struktura Zasobu

moj_zasob/
├── fxmanifest.lua    # Manifest (WYMAGANY)
├── config.lua        # Konfiguracja (opcjonalne)
├── client/           # Kod kliencki
│   └── main.lua
├── server/           # Kod serwerowy
│   └── main.lua
└── html/             # UI (opcjonalne)
    ├── index.html
    └── style.css

Jedynym wymaganym plikiem jest fxmanifest.lua. Wszystkie inne pliki (w tym config.lua) są opcjonalne i zależą od konkretnego zasobu.

Zarządzanie w txAdmin

Lista Zasobów

W txAdmin → Resources:

Status	Ikona	Opis
Running	🟢	Zasób działa
Stopped	🔴	Zasób zatrzymany

Operacje

Start
Stop
Restart

Uruchamia zasób bez restartu całego serweraUżyj gdy dodasz nowy zasób

Instalacja Zasobów

Przez SFTP/Edytor Plików

Pobierz Zasób

Z GitHub lub forum FiveM

Prześlij

Użyj SFTP lub edytora plików w panelu NEW-HOSTPrześlij do odpowiedniego folderu:

/resources/[esx]/ - Dla ESX
/resources/[qb]/ - Dla QBCore
/resources/[standalone]/ - Niezależne
/resources/[custom]/ - Własne

Dodaj do server.cfg

Edytuj server.cfg i dodaj:

ensure nazwa_zasobu

Lub uruchom zasób ręcznie w txAdmin (wtedy musisz go startować po każdym restarcie serwera)

Zastosuj zmiany

Opcja A: Restart serwera (jeśli dodałeś do server.cfg)Opcja B: Wpisz refresh w Live Console, potem Start zasób w Resources

Dodawanie do server.cfg

Aby zasób startował automatycznie przy każdym uruchomieniu serwera:

# Dodaj do server.cfg
ensure nazwa_zasobu

Odświeżanie Listy Zasobów

Po dodaniu nowych zasobów przez SFTP:

Otwórz Live Console

txAdmin → Live Console

Wpisz Komendę

Wpisz: refresh i naciśnij EnterKomenda przeskanuje folder resources i zaktualizuje listę

Sprawdź Resources

Przejdź do Resources - nowe zasoby powinny być widoczne

Edycja Konfiguracji

Przez Edytor Plików NEW-HOST

Panel Pliki

Panel NEW-HOST → “Pliki”

Znajdź Config

Przejdź do resources/[folder]/zasob/config.lua

Edytuj

Otwórz edytor i wprowadź zmiany

Zapisz

Zapisz plik

Restart Zasobu

W txAdmin → Resources → Restart tego zasobu

Przykład config.lua

Config = {}

Config.Locale = 'pl'
Config.EnableDebug = false
Config.MaxDistance = 10.0

Config.Shops = {
    {name = 'Sklep 24/7', coords = vector3(25.7, -1347.3, 29.49)},
    {name = 'Sklep LTD', coords = vector3(-707.5, -914.2, 19.2)}
}

Popularne Źródła Zasobów

ESX GitHub

github.com/esx-frameworkOficjalne zasoby ESX

QBCore GitHub

github.com/qbcore-frameworkOficjalne zasoby QBCore

Forum FiveM

forum.cfx.reSpołeczność - darmowe i płatne

GTA5-Mods

gta5-mods.comPojazdy i mapy

Dependencies (Zależności)

Niektóre zasoby wymagają innych:

-- fxmanifest.lua
dependencies {
    'es_extended',
    'oxmysql'
}

Ważna kolejność w server.cfg:

# 1. Najpierw dependencies
ensure oxmysql
ensure es_extended

# 2. Potem zasoby które ich potrzebują
ensure esx_identity
ensure esx_jobs

Zawsze ładuj dependencies PRZED zasobami które ich wymagają

Aktualizacja Zasobów

Backup

Skopiuj aktualną wersję (download przez SFTP)

Stop Zasób

W txAdmin zatrzymaj zasób

Pobierz Nową Wersję

Z GitHub

Zastąp Pliki

Prześlij nowe pliki przez SFTP/edytor

Start

Uruchom zasób w txAdmin

Rozwiązywanie Problemów

Zasób Nie Startuje

Sprawdź Live Console:

[ERROR] Failed to load resource: broken_resource
[script:error] SCRIPT ERROR: @broken_resource/server/main.lua:15

Przyczyny:

Błąd w kodzie Lua
Brak dependencies
Uszkodzony fxmanifest.lua

Rozwiązanie:

Sprawdź logi w Live Console
Upewnij się że dependencies są zainstalowane i załadowane
Pobierz zasób ponownie

Konflikt Zasobów

Objaw:

[ERROR] Resource 'script_a' conflicts with 'script_b'
[WARNING] Duplicate export: GetPlayerData

Rozwiązanie:

Wyłącz jeden z konfliktujących
Sprawdź dokumentację obu
Poszukaj patcha kompatybilności

Zasób Nie Pojawia Się w Liście

Rozwiązanie:

Otwórz Live Console
Wpisz komendę: refresh
Sprawdź Resources - zasób powinien być widoczny
Jeśli nadal nie widać - sprawdź czy folder zawiera prawidłowy fxmanifest.lua

Organizacja Zasobów

Struktura Folderów

resources/
├── [core]/              # Core frameworka
│   ├── es_extended/
│   └── oxmysql/
├── [esx]/              # Zasoby ESX
│   ├── esx_identity/
│   ├── esx_jobs/
│   └── esx_shops/
├── [standalone]/       # Niezależne
│   ├── mapa_custom/
│   └── hud_custom/
└── [custom]/           # Twoje własne
    └── moj_zasob/

Nazewnictwo

[kategoria] dla folderów nadrzędnych
prefiks_nazwa dla zasobów (np. esx_identity)
Małe litery i podkreślenia
Bez polskich znaków

Następne Kroki

SFTP

Prześlij zasoby przez SFTP

Baza Danych

Konfiguruj MySQL dla zasobów

Rozpocznij

FiveM

SFTP

​Zarządzanie Zasobami w txAdmin

​Czym są Zasoby?

​Struktura Zasobu

​Zarządzanie w txAdmin

​Lista Zasobów

​Operacje

​Instalacja Zasobów

​Przez SFTP/Edytor Plików

​Dodawanie do server.cfg

​Odświeżanie Listy Zasobów

​Edycja Konfiguracji

​Przez Edytor Plików NEW-HOST

​Przykład config.lua

​Popularne Źródła Zasobów

ESX GitHub

QBCore GitHub

Forum FiveM

GTA5-Mods

​Dependencies (Zależności)

​Aktualizacja Zasobów

​Rozwiązywanie Problemów

​Zasób Nie Startuje

​Konflikt Zasobów

​Zasób Nie Pojawia Się w Liście

​Organizacja Zasobów

​Struktura Folderów

​Nazewnictwo

​Następne Kroki

SFTP

Baza Danych

Zarządzanie Zasobami w txAdmin

Czym są Zasoby?

Struktura Zasobu

Zarządzanie w txAdmin

Lista Zasobów

Operacje

Instalacja Zasobów

Przez SFTP/Edytor Plików

Dodawanie do server.cfg

Odświeżanie Listy Zasobów

Edycja Konfiguracji

Przez Edytor Plików NEW-HOST

Przykład config.lua

Popularne Źródła Zasobów

Dependencies (Zależności)

Aktualizacja Zasobów

Rozwiązywanie Problemów

Zasób Nie Startuje

Konflikt Zasobów

Zasób Nie Pojawia Się w Liście

Organizacja Zasobów

Struktura Folderów

Nazewnictwo

Następne Kroki