Ana içeriğe atla
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

​
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:
{
  "apiKey": "YOUR_KEY",
  "httpPort": 30120
}
  • ApiKey: Panelde gireceğiniz API Anahtarı ile eşleşmelidir.
  • HttpPort: Eklentinin dinleyeceği HTTP portu (örneğin 30120).
  1. sunucu.cfg dosyasına şu satırı ekleyin:
ensure zonelycorefivem
  1. Sunucuyu yeniden başlatın veya restart zonelycorefivem komutunu çalıştırın.
Oyun portu ile eklentinin HTTP portunu karıştırmayın. Eklenti httpPort değerini kullanır (örneğin 30120).

​
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.
Paneldeki API Anahtarı, config.json içindeki apiKey değeriyle tam olarak eşleşmelidir.

​
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.
Kurulum tamamlandı. Artık panel üzerinden FiveM sunucunuza komut gönderebilirsiniz.