> ## Documentation Index
> Fetch the complete documentation index at: https://support.zonely.gen.tr/llms.txt
> Use this file to discover all available pages before exploring further.

# ZonelyCoreFiveM

> FiveM sunucunuza ZonelyCoreFiveM eklentisini kurmak ve web sitenizden komut göndermek için adım adım kurulum rehberi.

Web sitenizi ZonelyCoreFiveM ile entegre etmeden önce en güncel resmi sürümü kullandığınızdan emin olun. En yeni ZonelyCoreFiveM sürümünü buradan indirebilirsiniz:\
[https://zonely.gen.tr/plugins/zonelycorefivem-1-0-0.zip](https://zonely.gen.tr/plugins/zonelycorefivem-1-0-0.zip)

## 1) Ön Gereksinimler

* Çalışan bir **FiveM** sunucusu (Linux veya Windows).
* Sunucuda `resources/` altında bir **zonelycorefivem** klasörü.
* Güvenlik duvarı veya bulut güvenlik duvarı erişimi (örneğin 30120 gibi bir HTTP portuna izin vermek için).

## 2) Eklentiyi Sunucuya Kurma

1. `zonelycorefivem` klasörünü sunucunuzdaki `resources/` dizinine yükleyin.
2. `resources/zonelycorefivem/config.json` dosyasını açıp yapılandırın:

```json theme={null}
{
  "apiKey": "YOUR_KEY",
  "httpPort": 30120
}
```

* **ApiKey**: Panelde gireceğiniz **API Anahtarı** ile eşleşmelidir.
* **HttpPort**: Eklentinin dinleyeceği HTTP portu (örneğin **30120**).

3. `sunucu.cfg` dosyasına şu satırı ekleyin:

```cfg theme={null}
ensure zonelycorefivem
```

4. Sunucuyu yeniden başlatın veya `restart zonelycorefivem` komutunu çalıştırın.

<Tip>
  Oyun portu ile eklentinin HTTP portunu karıştırmayın. Eklenti **httpPort** değerini kullanır (örneğin 30120).
</Tip>

## 3) Panelde Sunucu Kaydı Oluşturma

1. Yönetici paneline giriş yapın, **Çeşitli** bölümüne (fırça simgesi) gidin ve **Sunucular** sayfasını açın.
2. **Sunucu Ekle** düğmesine tıklayın.
3. Alanları doldurun:
   * **Eklenti**: `ZonelyCoreFiveM`
   * **Sunucu IP Adresi**: Sunucu IP'si veya erişilebilir bir alan adı
   * **HTTP Portu**: `config.json` → `httpPort` değeri (örneğin **30120**)
   * **API Anahtarı**: `config.json` → `apiKey` değeri
4. **Eklenti Bağlantısını Kontrol Et** düğmesine tıklayın.
5. Başarılı olursa kaydetmek için **Yayınla** düğmesine tıklayın.

<Warning>
  Paneldeki **API Anahtarı**, `config.json` içindeki `apiKey` değeriyle tam olarak eşleşmelidir.
</Warning>

## 4) Sorun Giderme

* **Bağlantı başarısız oldu veya zaman aşımına uğradı**
  * `zonelycorefivem` çalışıyor mu? (`ensure zonelycorefivem`)
  * `config.json` → `apiKey` ile paneldeki **API Anahtarı** eşleşiyor mu?
  * `httpPort` (örneğin 30120) güvenlik duvarınızda veya bulut güvenlik duvarınızda **panel IP adresi** için açık mı?
  * Panel sunucusunun oyun sunucusuna **ağ erişimi** var mı (DNS, yönlendirme, sağlayıcı güvenlik duvarı)?
* **404 veya bulunamadı**
  * Klasör yapısı doğru mu? `resources/zonelycorefivem`
  * `sunucu.cfg` içinde `ensure zonelycorefivem` var mı?
  * Sunucu konsolunda eklentiyle ilgili hata var mı?
* **Komutlar pasif görünüyor**
  * Geçerli FiveM konsol komutları mı kullanıyorsunuz?
  * Resource adı doğru mu? (`ensure my_resource`)
  * Bazı ayarlar sunucunun veya etkilenen resource'un yeniden başlatılmasını gerektirebilir.

## 5) Güvenlik İpuçları

* **API Anahtarını** yalnızca yetkili yöneticiler bilmelidir.
* HTTP portunu (örneğin 30120) yalnızca **panel IP adresine** açın.
* Panelinizi **HTTPS** üzerinden yayınlayın.
* Başarısız denemeler için **rate limit** uygulayın ve log tutun.

## 6) SSS

**API Anahtarı nedir ve nerede bulabilirim?**\
Eklenti klasöründeki `config.json` dosyasında `apiKey` olarak yer alır. Aynı değeri panele girin.

**Varsayılan port nedir?**\
Örnek **30120** kullanır. Kendi `config.json` dosyanızda tanımlı portu kullanın.

**IP yerine alan adı kullanabilir miyim?**\
Evet. Panelin erişebildiği herhangi bir alan adını kullanabilirsiniz.

**Panel ve FiveM aynı makinedeyse 127.0.0.1 kullanabilir miyim?**\
Evet. Farklı makinelerde çalışıyorlarsa herkese açık IP veya erişilebilir bir alan adı kullanın.

**“Connection Failed” hatası alıyorum. Önce neyi kontrol etmeliyim?**\
`sunucu.cfg` içinde `ensure zonelycorefivem` bulunduğundan, `config.json` içindeki `apiKey` değerinin panel değeriyle eşleştiğinden ve portun panel IP adresine açık olduğundan emin olun.

**Sağlayıcı tarafında ek kural gerekir mi?**\
Evet. İşletim sistemi güvenlik duvarına ek olarak **panel IP adresinden** erişime izin veren sağlayıcı düzeyi bir kural oluşturun.

**Birden fazla FiveM sunucusu ekleyebilir miyim?**\
Evet. Her sunucu için ayrı kayıt oluşturun ve benzersiz IP, port ve API Anahtarı kombinasyonları atayın.

**Komutları nasıl yazmalıyım?**\
Panelde komutun başına eğik çizgi koymayın. Örneğin `durum`, `restart my_resource`.

<Check>
  Kurulum tamamlandı. Artık panel üzerinden FiveM sunucunuza komut gönderebilirsiniz.
</Check>