Qbox Framework Rehberi: Kurulum, QBCore Köprü ve Geçiş

Qbox is a FiveM roleplay framework that began as a QBCore fork and now provides its own core APIs and resources. It keeps a compatibility bridge for many properly written QBCore resources, but direct database access, internal-file access and unsupported behavior are documented exceptions. Use the official Qbox txAdmin recipe for a new installation and audit every resource before a migration.

Key takeaways

• Qbox is a framework, not merely a bundle of Ox utilities or a renamed QBCore folder.
• The current official install path is the QBox popular recipe in txAdmin.
• The QB bridge can help with compatible resources, but it is not a guarantee for every QBCore script.
• Migration includes configuration, grades, inventory and database conversion, plus resource-by-resource testing.
• There is no source-backed universal performance ranking between Qbox, QBCore and ESX.

What Qbox is

The official Qbox introduction records the project’s creation on 27 September 2022 and describes its origin in QBCore. The project has since developed its own core and related resources. Its compatibility layer exists to ease use of many QB resources while teams adopt current Qbox APIs, but Qbox should be evaluated as its own framework and recipe.

Mevcut qbx_core manifest doğrudan beyan eder ox_lib Ve oxmysql bağımlılıkları. Resmi tarif, eksiksiz bir başlangıç yığınına Qbox ve seçilmiş üçüncü taraf kaynakları bir araya getirir. Tarif içeriği değişebileceğinden, kalıcı bir yükleme eğitiminde uzun bir bağımlılık listesini dondurmak yerine mevcut tarife bağlantı verin.

Qbox'yi resmi tarif aracılığıyla yükleyin

1. Desteklenen bir FXServer ortamı hazırlayın ve paketlenmiş txAdmin kurulumunu açın.
2. Mevcut Qbox kurulum belgelerinde listelenen veritabanı gereksinimlerini karşılayın.
3. Kısmi bir çekirdeği manuel olarak birleştirmek yerine resmi QBox popüler tarifini seçin.
4. Mevcut belgeleri kullanarak tarif değişkenlerini, veritabanı kurulumunu ve sunucu yapılandırmasını tamamlayın.
5. İlk genel başlatmadan önce oluşturulan kaynak listesini ve başlatma sırasını gözden geçirin.
6. Test sunucusunda oyuncu yükünü, karakter oluşturmayı, izinleri, kalıcılığı ve günlükleri doğrulayın.

Rehberlerden kopyalanan kısaltılmış örneklerle satıcı bildirimlerini değiştirmeyin. Resmi sürümleri veya tarif sürümlerini kurun ve bildirimlerini bağımlılık sözleşmesinin bir parçası olarak kabul edin. Bir güncelleme çekirdek veya kütüphane gereksinimini değiştirdiğinde, dağıtımdan önce her bağımlı kaynağı sürüm belgeleriyle karşılaştırın.

Qbox ve QBCore köprüsü

Resmi Qbox dönüştürme kılavuzu, QB köprüsünün uyumluluğu nasıl desteklediğini ve API'lerin aşamalı olarak değiştirildiğini açıklar. Qbox SSS, düzgün yazılmış QBCore betiklerinin çoğunun bu köprü aracılığıyla çalışabileceğini belirtir, ardından önemli istisnaları tanımlar: doğrudan veritabanı tablolarına erişen, dahili çekirdek dosyalarını okuyan veya değiştiren veya desteklenmeyen davranışlara dayanan kaynaklar değişiklik gerektirebilir.

QBCore uyumlu olarak işaretlenmiş bir ürün, bu nedenle ayrı bir hedef olarak Qbox'ye karşı test edilmelidir. Yalnızca belgelenmiş köprüyle kapsanan API'leri kullanıp kullanmadığını, hangi envanter ve hedef sistemlerini beklediğini ve SQL'sinin Qbox'nin aynı şekilde maruz bırakmadığı bir QB şeması varsayıp varsaymadığını sorun.

Mevcut bir QBCore sunucusu için geçiş kontrol listesi

1. Dondurma ve envanter: çekirdek, veritabanı, envanter, işler, çeteler, araçlar, konut, telefonlar, izinler ve özel kaynakları kaydedin.
2. Yedekle: Dönüştürme çalışmasından önce geri yüklenebilir veritabanı ve kaynak anlık görüntüleri oluşturun.
3. Yapılandırmayı gözden geçirin: Qbox yapılandırma dosyalarındaki değişiklikleri ve API erişimini belgeler; eski çekirdek iç öğelerini körü körüne kopyalamayın.
4. Sınıfları ve verileri dönüştürün: Sayısal iş ve çete sınıfları, envanter ve veritabanı dönüştürme için mevcut resmi adımları izleyin.
5. Kaynakları denetleyin: Her entegrasyonu köprüyle kapsanan, uyarlanabilir veya uyumsuz olarak sınıflandırın.
6. Aşamalı olarak test edin: Karakterleri, parayı, işleri, çeteleri, envanteri, araçları, izinleri ve yeniden bağlanma davranışını doğrulayın.
7. Kanıtları inceleyin: sunucu, istemci ve veritabanı günlüklerini inceleyin ve geçiş öncesinde ana kayıt sayılarını karşılaştırın.
8. Geri alma işlemini hazır bulundurun: genel bir dönüştürme parçacığı ile tek üretim veritabanını değiştirmeyin.

Açık nedenlerle Qbox'yi seçin

Qbox, mevcut Qbox tarifini ve API'leri bilinçli olarak isteyen yeni bir sunucuya uyar. Ayrıca, köprü uyumluluğunu denetlemeye ve belgelenmiş dönüştürme çalışmalarını tamamlamaya hazır bir QBCore ekibine de uyabilir. Kritik kaynakların belgelenmemiş çekirdek iç mekanizmalarına güvendiği ve ekibin bunları güvenli bir şekilde değiştiremediği veya uyarlayamadığı durumlarda kötü bir geçiş hedefidir.

bir sayfa tek bir envanterin, veritabanı kitaplığının veya çerçevesinin otomatik olarak daha hızlı olduğunu vaat ettiği için Qbox'yi seçmeyin. Performans, tüm kaynak kümesine, veritabanı iş yüküne, oyuncu davranışına, yapıya ve sunucu yapılandırmasına bağlıdır. Performans bir karar faktörü ise, eşdeğer ortamlarda temsili eylemleri karşılaştırın ve günlükleri saklayın.

Üretim doğrulama

Yalnızca başarılı senaryoları değil, başarılı ve reddedilen eylemleri de test edin. Para değişikliklerinin yalnızca bir kez gerçekleştiğini, iş ve çete izinlerinin yetkisiz oyuncuları reddettiğini, yeniden bağlandığında envanterin tutarlı kaldığını, sahip olunan araçların kalıcı olduğunu ve yönetimsel eylemlerin kaydedildiğini doğrulayın. İstemci istekleri sunucuda doğrulanmalıdır; bir istemci tarafından tetiklenen bir olay, UI onu normal oyunculardan gizlediği için güvenli değildir.

Daha geniş ESX/QBCore/Qbox kararı için çerçeve karşılaştırmasını kullanın. Seçim yaparken ücretli FiveM scriptleri kataloğunu, şununla başlayın QBOX scriptleri and verify the current framework, bridge, inventory and dependency requirements on the product page before purchase.