Özel paket uyarlama

Sunucunda özel geliştirilmiş veya Panel’in otomatik algılamadığı bir paket varsa Özel entegrasyon oluşturarak paketi Panel’e bağlayabilirsin.

Başlamadan önce gerekli bilgiler

Bilgi	Örnek
Resource adı	`custom-housing`
Kategori	Housing
Kullanılacak Panel işlemleri	Listele, düzenle, sil
Paket erişim yöntemi	Export, event veya veritabanı
Beklenen parametreler	Oyuncu ID, kayıt ID, payload
Dönen veri biçimi	Liste veya obje

Uyarlama yöntemi

Panel kategorisini seç

Paketin hangi Panel sayfasını besleyeceğini belirle.

Doğru capability'yi seç

Capability’yi elle uydurmak yerine kategori için önerilen listeden seç.

Önce okuma action'ını ekle

Listeleme veya detay görüntüleme işlemini bağla ve test et.

Yazma desteğini ayrı ekle

Oluşturma, düzenleme ve silme işlemlerini ayrı capability olarak tanımla.

Oyun içinde doğrula

Panel cevabıyla yetinme; değişikliğin paket ve oyun içinde uygulandığını kontrol et.

Kategoriye göre doğru capability seçimi

İhtiyaç	Doğru örnek	Yanlış örnek
Evleri listele	`housing.list`	`houses.list`
Marketleri listele	`shops.list`	`shop.list`
Kapıları listele	`doorlock.list`	`doors.list`
Araç anahtarlarını listele	`vehiclekeys.list`	`keys.list`
Karakter mesleğini değiştir	`character.job.set`	`job.set`

Tam CRUD desteği

CRUD; oluşturma, okuma, düzenleme ve silme işlemlerinin tamamını ifade eder. Bir resource’un algılanması veya listeleme yapabilmesi tam CRUD desteği olduğu anlamına gelmez.

Seviye	Hazır işlemler	Panel davranışı
Salt okunur	Yalnızca list/get	Kayıtlar görünür, değiştirilemez
Kısmi yazma	List ve update	Kayıtlar düzenlenir, oluşturulamaz veya silinemez
Tam CRUD	List/get/create/update/delete	Panel’den tam yönetim yapılabilir

Örnek tam housing mapping’i

{
  "housing.list": {
    "type": "export",
    "side": "server",
    "resource": "custom-housing",
    "name": "GetPanelHouses"
  },
  "housing.create": {
    "type": "export",
    "side": "server",
    "resource": "custom-housing",
    "name": "CreatePanelHouse",
    "args": ["payload"]
  },
  "housing.update": {
    "type": "export",
    "side": "server",
    "resource": "custom-housing",
    "name": "UpdatePanelHouse",
    "args": ["payload.id", "payload"]
  },
  "housing.delete": {
    "type": "export",
    "side": "server",
    "resource": "custom-housing",
    "name": "DeletePanelHouse",
    "args": ["payload.id"]
  }
}

Paket güncellemesi sonrası

Paket geliştiricisi export, event, tablo veya alan adını değiştirebilir. Her paket güncellemesinden sonra:

Resource’un algılandığını kontrol et.
Okuma action’larını yeniden test et.
Test sunucusunda bir yazma işlemi uygula.
Oyun içi durumla veritabanının aynı kaldığını doğrula.
Hata varsa entegrasyonu geçici olarak salt okunur kullan.

Sorun giderme

Hata	Anlamı	Çözüm
Resource tespit edilemedi	Ad yanlış veya resource çalışmıyor	`ensure` adını ve resource durumunu kontrol et
`capability_not_synced`	Plugin capability’yi henüz bildirmedi	Health check çalıştır ve plugin bağlantısını kontrol et
Export bulunamadı	Export adı veya tarafı yanlış	Paket dokümanını ve server/client seçimini kontrol et
Test başarılı, sayfa boş	Sonuç yolu veya veri biçimi yanlış	Dönen liste alanını kontrol et
Panel değişti, oyun değişmedi	Yalnızca veritabanı güncellendi	Paketin export veya event yöntemini kullan

Özel uyarlamada önce tek bir okuma capability’sini kusursuz çalıştır. Sonra yazma işlemlerini birer birer ekle.

Genel

Discord Bot

FiveM Web Panel

Fatura & Ödeme

Özel paket uyarlama

Başlamadan önce gerekli bilgiler

Uyarlama yöntemi

Kategoriye göre doğru capability seçimi

Tam CRUD desteği

Örnek tam housing mapping’i

Paket güncellemesi sonrası

Sorun giderme

​Başlamadan önce gerekli bilgiler

​Uyarlama yöntemi

​Kategoriye göre doğru capability seçimi

​Tam CRUD desteği

​Örnek tam housing mapping’i

​Paket güncellemesi sonrası

​Sorun giderme

Başlamadan önce gerekli bilgiler

Uyarlama yöntemi

Kategoriye göre doğru capability seçimi

Tam CRUD desteği

Örnek tam housing mapping’i

Paket güncellemesi sonrası

Sorun giderme