> ## Documentation Index
> Fetch the complete documentation index at: https://docs-beta.new-host.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Zarządzanie Zasobami

> Instalacja i zarządzanie zasobami przez txAdmin

# 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
```

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

## Zarządzanie w txAdmin

### Lista Zasobów

W txAdmin → **Resources**:

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

### Operacje

<Tabs>
  <Tab title="Start">
    Uruchamia zasób bez restartu całego serwera

    Użyj gdy dodasz nowy zasób
  </Tab>

  <Tab title="Stop">
    Zatrzymuje zasób

    <Warning>Gracze stracą dostęp do funkcji</Warning>
  </Tab>

  <Tab title="Restart">
    Stop + Start

    Użyj po edycji konfiguracji zasobu
  </Tab>
</Tabs>

## Instalacja Zasobów

### Przez SFTP/Edytor Plików

<Steps>
  <Step title="Pobierz Zasób">
    Z GitHub lub forum FiveM
  </Step>

  <Step title="Prześlij">
    Użyj SFTP lub edytora plików w panelu NEW-HOST

    Prześlij do odpowiedniego folderu:

    * `/resources/[esx]/` - Dla ESX
    * `/resources/[qb]/` - Dla QBCore
    * `/resources/[standalone]/` - Niezależne
    * `/resources/[custom]/` - Własne
  </Step>

  <Step title="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)
  </Step>

  <Step title="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
  </Step>
</Steps>

### 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:

<Steps>
  <Step title="Otwórz Live Console">
    txAdmin → **Live Console**
  </Step>

  <Step title="Wpisz Komendę">
    Wpisz: `refresh` i naciśnij Enter

    Komenda przeskanuje folder resources i zaktualizuje listę
  </Step>

  <Step title="Sprawdź Resources">
    Przejdź do **Resources** - nowe zasoby powinny być widoczne
  </Step>
</Steps>

## Edycja Konfiguracji

### Przez Edytor Plików NEW-HOST

<Steps>
  <Step title="Panel Pliki">
    Panel NEW-HOST → **"Pliki"**
  </Step>

  <Step title="Znajdź Config">
    Przejdź do `resources/[folder]/zasob/config.lua`
  </Step>

  <Step title="Edytuj">
    Otwórz edytor i wprowadź zmiany
  </Step>

  <Step title="Zapisz">
    Zapisz plik
  </Step>

  <Step title="Restart Zasobu">
    W txAdmin → Resources → Restart tego zasobu
  </Step>
</Steps>

### 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

<CardGroup cols={2}>
  <Card title="ESX GitHub" icon="github">
    [github.com/esx-framework](https://github.com/esx-framework)

    Oficjalne zasoby ESX
  </Card>

  <Card title="QBCore GitHub" icon="github">
    [github.com/qbcore-framework](https://github.com/qbcore-framework)

    Oficjalne zasoby QBCore
  </Card>

  <Card title="Forum FiveM" icon="comment">
    [forum.cfx.re](https://forum.cfx.re)

    Społeczność - darmowe i płatne
  </Card>

  <Card title="GTA5-Mods" icon="car">
    [gta5-mods.com](https://gta5-mods.com)

    Pojazdy i mapy
  </Card>
</CardGroup>

## 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
```

<Warning>
  Zawsze ładuj dependencies PRZED zasobami które ich wymagają
</Warning>

## Aktualizacja Zasobów

<Steps>
  <Step title="Backup">
    Skopiuj aktualną wersję (download przez SFTP)
  </Step>

  <Step title="Stop Zasób">
    W txAdmin zatrzymaj zasób
  </Step>

  <Step title="Pobierz Nową Wersję">
    Z GitHub
  </Step>

  <Step title="Zastąp Pliki">
    Prześlij nowe pliki przez SFTP/edytor
  </Step>

  <Step title="Start">
    Uruchom zasób w txAdmin
  </Step>
</Steps>

## 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:**

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

### Konflikt Zasobów

**Objaw:**

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

**Rozwiązanie:**

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

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

**Rozwiązanie:**

1. Otwórz **Live Console**
2. Wpisz komendę: `refresh`
3. Sprawdź **Resources** - zasób powinien być widoczny
4. 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

<CardGroup cols={2}>
  <Card title="SFTP" icon="folder-open" href="/sftp/getting-started">
    Prześlij zasoby przez SFTP
  </Card>

  <Card title="Baza Danych" icon="database" href="/fivem/database">
    Konfiguruj MySQL dla zasobów
  </Card>
</CardGroup>