> ## Documentation Index
> Fetch the complete documentation index at: https://wiki.nodx.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Envanter ve araçlar

> Oyuncu envanteri, garaj, özel araçlar ve addon araç katalogları

Bu sayfa, oyuncu envanteri ve araç yönetimi için kullanılan panel alanlarını anlatır.

## Envanter görüntüleme

Oyuncu detayında **Envanter** sekmesini açarak oyuncunun üzerindeki eşyaları görebilirsin.

| Alan      | Açıklama                                   |
| --------- | ------------------------------------------ |
| Eşya kodu | Scriptlerde kullanılan item adı            |
| Label     | Panelde görünen okunabilir isim            |
| Miktar    | Oyuncuda bulunan adet                      |
| Slot      | Envanterdeki konum                         |
| Metadata  | Seri no, kalite, açıklama gibi ek bilgiler |

## Envanter işlemleri

Yetkine göre aşağıdaki işlemleri yapabilirsin:

| İşlem            | Kullanım                                           |
| ---------------- | -------------------------------------------------- |
| Eşya ekle        | Oyuncuya belirli miktarda item verir               |
| Eşya sil         | Seçili itemi oyuncudan kaldırır                    |
| Miktar güncelle  | Item adedini değiştirir                            |
| Metadata düzenle | Desteklenen envanterlerde item detayını değiştirir |
| Envanter temizle | Oyuncunun envanterini tamamen temizler             |

<Warning>
  Envanter temizleme ve yüksek miktarlı item verme işlemleri kritik işlem sayılır. Bu işlemler audit log'a düşer.
</Warning>

## Araç listesi ve garaj

Oyuncu detayındaki **Garaj** sekmesi, oyuncuya ait araçları listeler.

| Alan     | Açıklama                                      |
| -------- | --------------------------------------------- |
| Plaka    | Aracın plakası                                |
| Model    | FiveM araç kodu                               |
| Label    | Panelde gösterilen araç adı                   |
| Durum    | Garajda, dışarıda veya çekilmiş gibi durumlar |
| Sahiplik | Araç sahibinin karakter veya lisans eşleşmesi |

## Özel araç ekleme

Sunucular sadece FiveM'in varsayılan araçlarını kullanmaz. Addon araçlar için panelde özel araç tanımlayabilirsin.

Özel araçta önerilen alanlar:

| Alan      | Örnek         | Açıklama                                    |
| --------- | ------------- | ------------------------------------------- |
| Araç kodu | `rs7c8`       | Sunucuda spawn edilen model adı             |
| Label     | `Audi RS7 C8` | Panelde görünen isim                        |
| Kategori  | `Donator`     | Listeleme ve filtreleme için                |
| Görsel    | Araç resmi    | Oyuncuya veya yetkiliye gösterilecek görsel |
| Aktiflik  | Aktif         | Araç seçim listesinde görünüp görünmeyeceği |

<Tip>
  Araç kodu sunucudaki model adıyla aynı olmalı. Label farklı olabilir; label sadece panelde okunabilir isim göstermek için kullanılır.
</Tip>

## Oyuncuya araç verme

<Steps>
  <Step title="Oyuncuyu bul">
    **Oyuncular** sayfasından oyuncuyu ara ve detayını aç.
  </Step>

  <Step title="Araç sekmesine gir">
    **Garaj** veya **Araçlar** sekmesini aç.
  </Step>

  <Step title="Araç seç">
    Varsayılan listeden veya özel araç kataloğundan araç seç.
  </Step>

  <Step title="Plaka ve label kontrol et">
    Gerekirse plaka, label ve kategori bilgisini düzenle.
  </Step>

  <Step title="İşlemi onayla">
    Panel aracı oyuncuya ekler ve işlem kaydını audit log'a yazar.
  </Step>
</Steps>

## Araç görünmüyorsa

| Belirti                         | Kontrol                                               |
| ------------------------------- | ----------------------------------------------------- |
| Garaj boş                       | Doğru oyuncu ve doğru sunucu seçili mi?               |
| Model kodu görünüyor, label yok | Özel araç katalogunda label tanımı var mı?            |
| Görsel çıkmıyor                 | Araç görseli eklenmiş mi?                             |
| Araç verilemiyor                | Entegrasyon testinde araç ekleme capability aktif mi? |
| Başka pakette çalışmıyor        | Entegrasyon mapping'i o pakete göre ayarlanmış mı?    |

## Paket uyumluluğu

Farklı garaj veya araç paketleri farklı veri alanları kullanabilir. Bu yüzden panelde entegrasyon ayarları, mümkün olduğunda paket bazlı özelleştirilebilir olmalıdır.

Örnek:

| Paket farkı                        | Panelde ayarlanması gereken |
| ---------------------------------- | --------------------------- |
| Plaka alanı farklı                 | Plaka alanı mapping'i       |
| Araç kodu farklı tabloda           | Model alanı mapping'i       |
| Sahiplik karakter ID ile tutuluyor | Sahip alanı mapping'i       |
| Görsel ayrı katalogda              | Araç katalog görseli        |