FiveM'de roleplay sunucusu kurmak isteyen hemen herkes aynı soruyla karşılaşır: ESX mi, QBCore mu, yoksa Qbox mı? Bu üç framework de oyuncu verisi, meslekler, para ve envanter gibi roleplay'in temel sistemlerini hazır sunar; ancak kökenleri, bağımlılıkları ve geliştirme temposu farklıdır.

Bu yazıda üç framework'ü resmî GitHub depolarına ve belgelerine dayanarak tarafsız biçimde karşılaştırıyoruz: her biri nedir, ox_lib ve ox_inventory ile ilişkisi nasıldır, Ekim 2026 itibarıyla bakım durumu nedir ve sunucunuz için nasıl seçim yapabilirsiniz. Bilgiler 31 Ekim 2026 tarihinde depolardan kontrol edildi.

FiveM framework nedir?

Framework, FiveM sunucusunda çalışan ve diğer kaynakların (resource) üzerine kurulduğu çekirdek kaynak setidir. Oyuncu karakterleri, meslekler, para hesapları, envanter ve veritabanı kayıtları gibi ortak işleri üstlenir. Satın aldığınız veya indirdiğiniz kaynakların çoğu belirli bir framework için yazılır; bu yüzden seçiminiz, kullanabileceğiniz kaynak ekosistemini de belirler. Framework olmadan da vanilla bir FiveM sunucusu çalıştırabilirsiniz; kurulum için FiveM sunucu kurulumu rehberimize bakın.

ESX (ESX Legacy)

ESX (ESX Legacy): Bağımlılıklar, Lisans, Bakım durumu, Kurulum

ESX, kendi belgelerine göre 2017'de başlamış bir framework'tür; bugün aktif olarak geliştirilen sürümü ESX Legacy'dir. Çekirdek kaynaklar esx_core GitHub deposunda bulunur. Depoda es_extended çekirdeğinin yanında esx_lib, esx_inventory, esx_multicharacter, esx_identity, esx_skin gibi kaynaklar yer alır.

  • Bağımlılıklar: es_extended manifestinde esx_lib ve oxmysql bağımlılık olarak tanımlıdır.
  • Lisans: Kaynak dosyalarındaki SPDX başlığına göre GPL-3.0-only.
  • Bakım durumu: Depo arşivlenmemiş; son sürüm 18 Ekim 2026 tarihli 1.16.4, son push 27 Ekim 2026.
  • Kurulum: ESX belgeleri MariaDB önerir (XAMPP'ı önermez) ve txAdmin'de Popular Recipes altındaki "ESX Legacy" recipe'iyle kurulum anlatır.

QBCore

QBCore: Bağımlılıklar, Lisans, Bakım durumu, Kurulum

QBCore, deposunda kendini "FiveM RP Framework Core" olarak tanımlayan bir roleplay framework'üdür. Lisans başlığında ESX'ten türediği de görülür. Çekirdek kaynak qb-core'dur; GitHub deposu şu an qb-core GitHub adresindedir (eski qbcore-framework adresi buraya yönlenir).

  • Bağımlılıklar: qb-core manifestinde oxmysql bağımlılık olarak tanımlıdır.
  • Lisans: GPL-3.0.
  • Bakım durumu: Depo arşivlenmemiş; manifestteki sürüm 1.3.0. GitHub'da yayınlanmış bir release bulunmuyor; son commit 24 Ağustos 2026 tarihli.
  • Kurulum: QBCore belgeleri MariaDB + HeidiSQL ile txAdmin'deki "QBCore Framework" şablonunu anlatır.

Qbox (qbx_core)

Qbox, QBCore'dan doğmuş bir framework'tür. qbx_core GitHub deposundaki lisans notuna göre QBCore'dan 23 Eylül 2022'de fork edilmiştir. Amacı kolay kullanılan, performanslı ve güvenli bir temel sunmaktır. En önemli özelliği, mevcut QB kaynaklarının çoğuyla geriye dönük uyumluluk sağlayan bridge katmanıdır: qbx_core manifestinde provide 'qb-core' satırı bulunur, yani qb-core bekleyen kaynaklar için onun yerine geçer.

  • Bağımlılıklar: README'ye göre oxmysql, ox_lib ve ox_inventory. Manifestte ayrıca en az /server:10731 artifact derlemesi ve /onesync koşulu tanımlıdır.
  • Öne çıkanlar: Dahili çoklu karakter, çoklu meslek ve çete desteği, dolu sunucular için kuyruk sistemi, kalıcı oyuncu araçları, export tabanlı API.
  • Lisans: GPL-3.0 (ox_lib'den uyarlanan kod LGPL-3.0-or-later).
  • Bakım durumu: Depo arşivlenmemiş; son sürüm 30 Ekim 2026 tarihli v1.24.1. Bu sürümün notlarında QBCore 1.3.0 fonksiyonları için bridge eklemeleri ve QBCore envanterlerini dönüştürme aracı yer alıyor.
  • Kurulum: Qbox belgeleri MariaDB'yi zorunlu tutar (en az 10.9.0; MySQL ve XAMPP desteklenmez) ve txAdmin'deki "QBox Framework" recipe'iyle kurulumu anlatır.

ox_lib ve ox_inventory nedir, framework'lerle ilişkisi ne?

ox_lib ve ox_inventory, Overextended ekibinin geliştirdiği bağımsız kaynaklardır; bir framework değildir ama birçok framework ve kaynak tarafından kullanılır.

KaynakNe yaparLisansSon sürüm (31.10.2026)
ox_libFiveM kaynakları için modüller ve export'lar sunan kütüphane (Lua ve JS).LGPL-3.0v3.41.0 (25 Ekim 2026)
ox_inventoryMetadata destekli, slot tabanlı envanter.GPL-3.0v2.48.1 (24 Ekim 2026)
oxmysqlFXServer için MySQL kaynağı.LGPL-3.0v2.14.3 (6 Ekim 2026)

ox_inventory belgesine göre gerekli bağımlılıklar oxmysql ve ox_lib'dir. Başlatma sırası şöyle önerilir:

bash
ensure oxmysql
ensure ox_lib
ensure qbx_core      # veya es_extended, ox_core
ensure ox_target     # isteğe bağlı
ensure ox_inventory

Framework uyumu konusunda önemli bir ayrıntı var: ox_inventory'nin desteklediği framework değerleri ox, esx, qbx ve nd'dir. README'de QBCore desteklenen framework'ler arasında listelenmez. Kendi envanter sistemi olan framework'lerde uyumluluk sorunları beklenmesi gerektiği de belgede belirtilir.

Bir kaynakta ox_lib kullanmak için fxmanifest.lua dosyasına şu satır eklenir:

lua
shared_scripts {
    '@ox_lib/init.lua',
}

Karşılaştırma tablosu

Karşılaştırma tablosu: Çekirdek kaynak, Köken, Zorunlu bağımlılıklar (manifest), ox_inventory desteği
ESX LegacyQBCoreQbox
Çekirdek kaynakes_extendedqb-coreqbx_core
Köken2017'de başlayan projeLisans başlığına göre ESX'ten türemişQBCore fork'u (Eylül 2022)
Zorunlu bağımlılıklar (manifest)esx_lib, oxmysqloxmysqlox_lib, oxmysql (+ README'ye göre ox_inventory)
ox_inventory desteğiVar (esx)README'de listelenmiyorVar (qbx)
QB kaynaklarıyla uyumYok (farklı API)DoğalBridge ile çoğu QB kaynağı
Son sürüm1.16.4 (18.10.2026)GitHub release yok, manifest 1.3.0v1.24.1 (30.10.2026)
LisansGPL-3.0-onlyGPL-3.0GPL-3.0
VeritabanıMariaDB önerilirMariaDBMariaDB (en az 10.9.0)

Hangi framework'ü seçmelisiniz?

Tek bir doğru cevap yok; seçim sunucunuzun ihtiyaçlarına ve elinizdeki kaynaklara bağlı. Karar verirken şu soruları sorun:

  • Kullanmak istediğiniz kaynaklar hangi framework için yazılmış? Satın almayı düşündüğünüz script'lerin desteklediği framework'ü kontrol edin. Bu, çoğu zaman kararı tek başına belirler.
  • ox ekosistemini kullanacak mısınız? ox_inventory kullanmak istiyorsanız resmî olarak desteklenen ESX ve Qbox öne çıkar.
  • Elinizde QB kaynakları var mı? Qbox'ın bridge katmanı QB kaynaklarının çoğunu çalıştırmayı hedefler; yine de her kaynağı test etmeniz gerekir.
  • Geliştirme temposu sizin için ne kadar önemli? Depoların son sürüm ve commit tarihlerine kendiniz bakın; tablo bu yazının tarihindeki durumu yansıtır.
  • Ekip bilgisi: Geliştiricilerinizin hangi API'ye alışkın olduğu da önemli bir etkendir.

Kaynaklarınızı yalnızca yasal yollardan edinin. Cfx belgeleri, Hizmet Koşulları'nın kabul ettiği yöntemler dışında satılan ücretli kaynakları istenmeyen kaynaklar arasında sayar. Escrow ile korunan kaynakların lisansı Cfx.re hesabınıza bağlıdır.

Kurulum ve hosting notları

Üç framework de txAdmin recipe'iyle kurulabilir; bu, MariaDB veritabanını hazırladıktan sonra en kolay yoldur. Ayrıntılar için txAdmin rehberimize bakın. Hazır panelli bir hostingde (ör. Pterodactyl) veritabanı genellikle panelden oluşturulur ve bağlantı bilgileri recipe'e girilir. Kurulumda hata alırsanız FiveM sunucu hataları rehberimiz yardımcı olabilir.

Sık Sorulan Sorular

ESX mi QBCore mu daha iyi?

Bu, kullanmak istediğiniz kaynaklara ve ekibinizin deneyimine bağlıdır. İkisi de aktif depolara sahiptir ve GPL-3.0 lisanslıdır. Asıl belirleyici, ihtiyaç duyduğunuz script'lerin hangi framework'ü desteklediğidir.

Qbox, QBCore kaynaklarını çalıştırır mı?

Qbox, bridge katmanıyla mevcut QB kaynaklarının çoğuyla geriye dönük uyumluluk hedefler ve qb-core yerine geçer. "Çoğu" ifadesi önemlidir; her kaynağı test sunucusunda deneyin.

ox_lib bir framework mü?

Hayır. ox_lib, kaynakların kullandığı modüller ve export'lar sunan bağımsız bir kütüphanedir. Qbox için zorunlu bağımlılıktır; ox_inventory de ona ihtiyaç duyar.

Framework'ler OneSync gerektirir mi?

Qbox manifestinde /onesync koşulu açıkça tanımlıdır. Yeni sunucularda OneSync'i set onesync on ile açık tutmak zaten Cfx'in örnek yapılandırmasındaki varsayılandır.

Oyun ve yazılım adları sahiplerine aittir. Bu yazı bağımsız bir teknik rehberdir; adı geçen geliştiricilerle ortaklık ilişkisi bulunduğu anlamına gelmez.

İlgili içerikler: FiveM sunucu kurulumu · txAdmin rehberi · FiveM sunucu hataları · Pterodactyl rehberi · rsync ile yedekleme