Ana içeriğe atla
Web sitenizi ZonelyCoreFiveM ile entegre etmeden önce, eklentinin en güncel ve resmi sürümünü kullandığınızdan emin olun. En son ZonelyCoreFiveM sürümüne aşağıdaki bağlantıdan ulaşabilirsiniz:
https://zonely.gen.tr/plugins/zonelycorefivem-1-0-0.zip

​
1) Önkoşullar

  • Çalışır durumda bir FiveM sunucusu (Linux/Windows).
  • Sunucuda resources/ altında zonelycorefivem klasörü.
  • Firewall/Cloud firewall erişimi (ör. 30120 gibi bir HTTP portunu izinlemek için).

​
2) Sunucuya eklentiyi yükleyin

  1. zonelycorefivem klasörünü sunucunuzda resources/ dizinine atın.
  2. resources/zonelycorefivem/config.json dosyasını açın ve ayarlayın:
{
  "apiKey": "SIFRENIZ",
  "httpPort": 30120
}
  • apiKey: Yönetim panelinde gireceğiniz API Key ile aynı olmalı.
  • httpPort: Eklentinin dinleyeceği HTTP portu (ör. 30120).
  1. server.cfg içine ekleyin:
ensure zonelycorefivem
  1. Sunucuyu yeniden başlatın (veya restart zonelycorefivem).
Oyun portu ile eklentinin HTTP portunu karıştırmayın. Burada httpPort kullanılır (örn. 30120).

​
3) Panelde sunucu kaydı oluşturun

  1. Yönetim paneline giriş yapın ve sol kısımda bulunan Boya Fırçası (Çeşitli) kısmına girerek açılan pencerede Sunucular sayfasına gidin.
  2. Sunucu Ekle butonuna tıklayın.
  3. Aşağıdaki alanları doldurun:
    • Eklenti: ZonelyCoreFiveM
    • Sunucu IP Adresi: Sunucu IP’si veya erişilebilir domain
    • HTTP Portu: config.json -> httpPort (örn. 30120)
    • API Key: config.json -> apiKey
  4. Eklenti Bağlantısını Kontrol Et butonuna tıklayın.
  5. Başarılı bildirim gelirse Yayınla ile kaydı tamamlayın.
Panelde girdiğiniz API Key, sunucudaki config.json içindeki apiKey ile birebir aynı olmalıdır.

​
4) Sorun Giderme

  • Bağlantı başarısız / zaman aşımı
    • zonelycorefivem etkin mi? (ensure zonelycorefivem)
    • config.json → apiKey ile paneldeki API Key aynı mı?
    • httpPort (örn. 30120) firewall/Cloud firewall’da panel IP’sine izinli mi?
    • Panel sunucusundan oyun sunucusuna ağ erişimi var mı (DNS, yönlendirme, sağlayıcı güvenlik duvarı)?
  • 404 / bulunamadı
    • Klasör yapısı doğru mu? resources/zonelycorefivem
    • server.cfg içinde ensure zonelycorefivem var mı?
    • Sunucu konsolunda eklentiye dair hata mesajı var mı?
  • Komutlar etkisiz görünüyor
    • Geçerli bir FiveM sunucu konsolu komutu mu?
    • Kaynak adı doğru mu? (ensure my_resource)
    • Bazı ayarlar için sunucuyu veya ilgili kaynağı yeniden başlatmak gerekebilir.

​
5) Güvenlik Önerileri

  • API Key yalnızca yetkili yöneticiler tarafından bilinsin.
  • HTTP portunu (örn. 30120) sadece panel IP’sine açın.
  • Panelinizi HTTPS üzerinden çalıştırın.
  • Başarısız denemeler için rate-limit uygulayın ve log tutun.

​
6) SSS

API Key nedir, nereden alırım? Eklenti klasöründeki config.json dosyasında yer alır (apiKey). Panelde aynı değeri girmeniz gerekir. Varsayılan port nedir? Örnek olarak 30120 kullanılır. Kendi config.json dosyanızda hangi port varsa panelde onu girin. IP yerine domain yazabilir miyim? Evet. Panelin erişebildiği bir domain kullanabilirsiniz. Panel ve FiveM aynı makinedeyse 127.0.0.1 yazabilir miyim? Evet. Farklı makinelerde ise genel IP veya erişilebilir bir domain kullanın. “Bağlantı Başarısız” alıyorum, ilk neyi kontrol etmeliyim? server.cfg içinde ensure zonelycorefivem satırının varlığını, config.json → apiKey ile paneldeki değerin eşleştiğini ve portun panel IP’sine açık olduğunu kontrol edin. Cloud/sağlayıcı tarafında ayrıca kural gerekir mi? Evet. Sunucu işletim sistemi firewall’ına ek olarak panel IP’sine izin veren bir kuralı sağlayıcı panelinizde de açmanız gerekebilir. Birden fazla FiveM sunucusu ekleyebilir miyim? Evet. Her sunucu için ayrı bir kayıt oluşturun; her birine uygun IP/port ve benzersiz API Key girin. Komutları nasıl yazmalıyım? Panelde komutun başına / koymadan yazın (örn. status, restart my_resource).
Kurulum tamam! Artık panelden FiveM sunucunuza komut gönderebilirsiniz.