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

# Kurulum ve bağlantı

> FiveM Web Panel bağlantısını doğrula ve plugin durumunu kontrol et

Bu sayfa, FiveM sunucunun [https://fivem.nodx.org](https://fivem.nodx.org) paneline doğru bağlandığını kontrol etmek için kullanılır.

## Plugin'i sunucuya kur

Satın alma ve hesap aktivasyonu tamamlandıktan sonra Panel'e giriş yap. **Plugin** sayfasından sunucuna özel plugin paketini indir.

<Steps>
  <Step title="Plugin paketini indir">
    Panelde doğru sunucuyu seç, **Plugin** sayfasını aç ve güncel paketi indir.
  </Step>

  <Step title="Resource klasörüne yükle">
    İndirdiğin paketin içindeki `nodx-fivem-panel` klasörünü FiveM sunucunun `resources` klasörüne yükle.
  </Step>

  <Step title="Config bilgilerini kontrol et">
    `nodx-fivem-panel/config.lua` dosyasındaki API adresi, lisans ve Server ID alanlarını kontrol et.
  </Step>

  <Step title="server.cfg satırlarını ekle">
    Aşağıdaki örneği kendi `server.cfg` dosyana ekle.
  </Step>

  <Step title="Resource'u başlat">
    Sunucuyu yeniden başlat veya konsolda `ensure nodx-fivem-panel` komutunu çalıştır.
  </Step>
</Steps>

<Warning>
  Klasör adı `nodx-fivem-panel` olarak kalmalıdır. Klasör adını değiştirirsen `ensure` ve ACE izinlerindeki resource adı da eşleşmez.
</Warning>

## config.lua nasıl doldurulur?

Panelden sunucuna özel indirilen plugin paketinde **Lisans Anahtarı** ve **Server ID** otomatik doldurulmuş olabilir. Genel Tebex paketini kullanıyorsan bu değerleri Panel'deki **Plugin** veya **Sunucu** sayfasından alarak kendin girmelisin.

```lua theme={null}
Config = {}
Config.ApiUrl = 'https://fivemapi.nodx.org'
Config.PublicApiUrl = Config.ApiUrl
Config.LicenseKey = 'PANELDEN_ALDIĞIN_LİSANS'
Config.ServerId = 'PANELDEN_ALDIĞIN_SERVER_ID'
Config.Framework = 'auto'
```

| Alan                  | Kullanılacak değer                                                              |
| --------------------- | ------------------------------------------------------------------------------- |
| `Config.ApiUrl`       | `https://fivemapi.nodx.org`                                                     |
| `Config.PublicApiUrl` | Canlı görüntü için oyuncuların erişebileceği API adresi; varsayılan değer doğru |
| `Config.LicenseKey`   | Panelde seçili sunucuya ait lisans anahtarı                                     |
| `Config.ServerId`     | Panelde seçili sunucunun benzersiz Server ID değeri                             |
| `Config.Framework`    | Otomatik algılama için `auto`; gerekirse `qb`, `esx` veya `standalone`          |

<Warning>
  Lisans anahtarını başka biriyle paylaşma ve aynı lisansı birden fazla FiveM sunucusunda kullanma. Her lisans yalnızca bağlı olduğu Server ID ile çalışır.
</Warning>

## server.cfg nasıl doldurulur?

NODX resource'unu framework, veritabanı ve envanter gibi temel resource'lardan sonra başlat. Canlı görüntü özelliği için `screenshot-basic`, NODX resource'undan önce çalışmalıdır.

```cfg theme={null}
## Framework ve veritabanı
ensure oxmysql
ensure qb-core

## Canlı görüntü desteği
ensure screenshot-basic

## NODX FiveM Web Panel
ensure nodx-fivem-panel

## Panelden resource başlatma, durdurma ve yeniden başlatma kullanacaksan ekle
add_ace resource.nodx-fivem-panel command.start allow
add_ace resource.nodx-fivem-panel command.stop allow
add_ace resource.nodx-fivem-panel command.restart allow
```

ESX kullanıyorsan `ensure qb-core` yerine kendi ESX resource'unu kullan. Veritabanı resource'un farklıysa `ensure oxmysql` satırını kendi veritabanı resource'una göre düzenle.

| Özellik                | Gerekli satır                                             |
| ---------------------- | --------------------------------------------------------- |
| Temel Panel bağlantısı | `ensure nodx-fivem-panel`                                 |
| Canlı oyuncu görüntüsü | `ensure screenshot-basic`                                 |
| Resource kontrolleri   | Üç `add_ace` izni                                         |
| Veritabanı özellikleri | Desteklenen veritabanı resource'u NODX'ten önce başlamalı |
| Framework özellikleri  | QBCore veya ESX resource'u NODX'ten önce başlamalı        |

<Note>
  Resource başlatma ve durdurma özelliklerini kullanmayacaksan `add_ace` satırlarını eklemek zorunda değilsin. Daha sınırlı yetki daha güvenlidir.
</Note>

## İlk başlatma ve doğrulama

Sunucu konsolunda resource'u başlattıktan sonra hata olmadığını kontrol et:

```text theme={null}
ensure nodx-fivem-panel
```

Ardından Panel'de:

1. **Plugin** sayfasını aç.
2. **Son bağlantı** değerinin güncellendiğini kontrol et.
3. **Health check** çalıştır.
4. Framework, veritabanı ve desteklenen resource'ların algılandığını kontrol et.
5. **Oyuncular** ve **Resource'lar** sayfalarını açarak veri geldiğini doğrula.

<Tip>
  `ensure nodx-fivem-panel` sonrasında bağlantı gelmiyorsa ilk kontrol edeceğin alanlar `Config.ApiUrl`, `Config.LicenseKey`, `Config.ServerId` ve sunucunun internete çıkış erişimidir.
</Tip>

## Kurulumdan sonra kontrol etmen gerekenler

<Steps>
  <Step title="Doğru panel adresini kullan">
    FiveM paneline [https://fivem.nodx.org](https://fivem.nodx.org) üzerinden giriş yap.
  </Step>

  <Step title="Sunucunu seç">
    Panelde üst bölümden veya sunucu seçiciden işlem yapmak istediğin sunucuyu seç.
  </Step>

  <Step title="Plugin bağlantısını kontrol et">
    **Sunucu durumu**, **Son bağlantı** ve **Plugin versiyonu** alanlarına bak.
  </Step>

  <Step title="Health check çalıştır">
    Paneldeki **Health check** veya **Test et** butonu ile bağlantının güncel olup olmadığını doğrula.
  </Step>

  <Step title="Oyuncu ve resource listesini kontrol et">
    Oyuncular, resource'lar veya entegrasyonlar boş görünüyorsa önce bağlantı ve yetki testlerini incele.
  </Step>
</Steps>

## Bağlantı durumu alanları

| Alan              | Ne anlatır?                                                    |
| ----------------- | -------------------------------------------------------------- |
| Son bağlantı      | Plugin'in panele en son ne zaman ulaştığını gösterir           |
| Plugin versiyonu  | Sunucudaki panel plugin sürümünü gösterir                      |
| Sunucu ID         | İşlemlerin hangi sunucuya ait olduğunu ayırmak için kullanılır |
| Lisans durumu     | Sunucunun aktif pakete bağlı olup olmadığını gösterir          |
| Capability durumu | Sunucunun hangi panel özelliklerini desteklediğini gösterir    |

<Note>
  Yeni kurulumdan sonra bazı bilgiler birkaç dakika içinde senkron olur. Çok beklemeden işlem yapmak istersen **Test et** butonu en hızlı kontrol yoludur.
</Note>

## Yeni sunucu eklediğinde ne olur?

Yeni bir FiveM sunucusu kurduğunda panel otomatik olarak o sunucuyu ayrı kayıt gibi görmelidir. Böylece test sunucusundaki dosyalar, oyuncular veya entegrasyonlar canlı sunucuda görünmez.

Görmen gereken beklenen davranış:

| Durum                | Beklenen sonuç                                       |
| -------------------- | ---------------------------------------------------- |
| Yeni sunucu bağlandı | Panelde ayrı sunucu olarak görünür                   |
| Eski sunucu seçili   | Eski sunucunun oyuncuları ve entegrasyonları görünür |
| Yeni sunucu seçili   | Sadece yeni sunucuya ait veriler görünür             |
| Lisans eşleşmiyor    | İşlem engellenir ve test ekranında uyarı çıkar       |

## Plugin güncelleme akışı

Panelde güncelleme destekleniyorsa önerilen sıra şöyledir:

<Steps>
  <Step title="Mevcut durumu kontrol et">
    **Plugin versiyonu** ve **Son bağlantı** alanlarını incele.
  </Step>

  <Step title="Yedek al">
    Güncelleme öncesi panelin sunduğu yedekleme adımını tamamla.
  </Step>

  <Step title="Güncellemeyi başlat">
    **Güncelle** butonunu kullan. Panel güncelleme durumunu işlem geçmişinde gösterir.
  </Step>

  <Step title="Resource yeniden başlatılsın">
    Güncelleme sonrası plugin tekrar başlatılır ve bağlantı doğrulanır.
  </Step>

  <Step title="Health check çalıştır">
    Versiyon, bağlantı ve capability durumlarının güncellendiğini doğrula.
  </Step>
</Steps>

## Bağlantı yoksa hızlı kontrol listesi

| Belirti                   | Kontrol                                                        |
| ------------------------- | -------------------------------------------------------------- |
| Oyuncular boş             | Sunucu seçimi, plugin bağlantısı ve son bağlantı zamanı        |
| Resource listesi boş      | Plugin yetkileri ve sunucudaki resource durumu                 |
| Market veya kapı yok      | İlgili entegrasyonun aktifliği ve test sonucu                  |
| Canlı görüntü gelmiyor    | Oyuncu client erişimi ve screenshot desteği                    |
| Test sonucu bekliyor      | Capability senkronu ve agent bağlantısı                        |
| `license.invalid`         | Lisans anahtarı veya Server ID yanlış ya da başka sunucuya ait |
| `screenshot-basic` hatası | `screenshot-basic`, NODX resource'undan önce başlamamış        |
| Resource başlamıyor       | Klasör adı veya `ensure nodx-fivem-panel` satırı yanlış        |

<Warning>
  Aynı lisansı veya aynı sunucu bilgisini birden fazla müşteride kullanma. Panel işlemleri sunucu, workspace ve lisans eşleşmesine göre ayrılmalıdır.
</Warning>