FiveM Framework Rehberleri: Doğru Altyapı, Entegrasyon ve Test
QBCore, ESX, Standalone, vRP ve OX/Qbox için gerçek resource adlarını ve desteklenen veri sınırlarını karşılaştırın. Kurulum süresi özel scriptlerinize ve yapılacak testlere bağlıdır.
Kısa cevap: Önce çekirdeği ve envanteri ayrı belirleyin; sonra doğru AC ayarını ve kabul testini seçin.
Kurulum ve veri desteği karşılaştırması
| Altyapı | AC framework alanı | Veri desteği | Rehber |
|---|---|---|---|
| QBCore | qb | players / citizenid; desteklenen indeksler | Kurulum rehberi → |
| ESX | esx | users / identifier; desteklenen indeksler | Kurulum rehberi → |
| Standalone | standalone | Custom oyun verisi köprüde desteklenmez | Kurulum rehberi → |
| vRP / vRPex | standalone: genel kontroller | vRP özel ekonomi/karakter şeması desteklenmez | Kurulum rehberi → |
| Qbox / ox_core | qbox / standalone | Qbox desteklenen şema; saf ox_core desteklenmez | Kurulum rehberi → |
Gerçek kurulumunuzu nasıl seçersiniz?
qb-core → qb; es_extended → esx; qbx_core → qbox. Standalone ve özel vRP için genel standalone modu. ox_inventory bir core değildir; saf ox_core ayrı değerlendirilir. auto seçildiğinde çözümlenen değeri konsolda doğrulayın.
Profil seçimi özel event kurallarını yazmaz
Bir event’in keşfedilmesi veya framework adının görünmesi, scriptin fiyat, miktar, konum ve izin kurallarını doğru doğruladığını göstermez. Özel shop, job, reward ve inventory işlemleri sunucuda kendi kontrollerini yapmalıdır. Normal eşya hareketinin tespit logu üretmemesi tek başına hata değildir. Veri okumasını, yetkisiz isteğin reddini ve gerçek tespit koşulunu ayrı test edin.
Framework ile envanteri ayrı ayrı belirleyin
Oyuncu durumunu gerçekten yöneten resource’u kaydedin: QBCore için qb-core, Qbox için qbx_core, ESX için es_extended. Ardından envanter resource’unu ve API değişikliklerini belirleyin. Bilinen framework adı, üçüncü taraf banka veya envanter scriptlerinin tamamının uyumlu olduğunu kanıtlamaz. Çalışan bağımlılık sırasını koruyun; sorun çözmek için farklı core’ları beraber çalıştırmayın.
Pakette mevcut framework alanını düzenleyin. QBCore için qb, Qbox için qbox kullanılır; bunlar ayar değeri, klasör adı değildir. Otomatik tespit için auto seçeneği bulunur. Başlangıç çıktısında ve güvenilir sunucu kodundan GetStatus ile çözümlenen framework’ü kontrol edin. Veritabanı köprüsü çalışan core resource’larını ayrıca tespit eder; kendi durumu henüz başlamamış bağımlılığı gösterebilir.
-- Mevcut framework alanını düzenleyin; tabloyu değiştirmeyin.
ts.Framework.framework = "qb"
-- Diğer desteklenen değerler: "esx", "qbox", "auto", "standalone"
Karakter verisini tam uyumluluk varsaymadan kontrol edin
Köprü okumalarında QBCore/Qbox citizenid, ESX identifier kullanır. Çevrimiçi sunucu ID değerleri geçicidir; kalıcı karakter kimliği yerine kullanılamaz. Oyuncu ve araç okumaları desteklenen sütun ve indeks ister. Özelleştirilmiş yapı sınırsız taranmak yerine reddedilebilir.
- Nakit, banka, meslek ve bir aracı bilinen test karakterinin ayrıntılarını okuyup oyunla karşılaştırın.
- ox_inventory çalışıyorsa küçük çevrimiçi envanter sonucunu gerçek karakterle karşılaştırın. Kesilme uyarısına dikkat edin; stash veya rastgele metadata beklemeyin.
- Framework API hata veriyorsa başlangıç ve sürüm uyumluluğunu inceleyin. Silah kontrolü erişilemeyen API’yi belirsiz kabul eder; oyuncunun silahı olmadığına kanıt saymaz.
Oyuncuların kullandığı gerçek akışları test edin
Framework tespiti her özel event’in yetki, konum, fiyat veya ödül kuralını bilemez. Bu kuralları scriptiniz sunucuda doğrulamalıdır. Profil seçmek, güvensiz para veya eşya event’ini kendiliğinden güvenli yapmaz. AC entegrasyonu çağırmadan oyuncunun sunucudaki source değerini ve etkin görev ya da oturumunu doğrulayın.
Standalone ve vRP sunucuları uygun genel AC kontrollerini kullanabilir; mevcut köprü bunların özel karakter veya ekonomi şemalarını destekleme garantisi vermez. İlgisiz SQL tablolarını kullanmak yerine desteklenmeyen özellikleri personele açıklayın. Core, envanter veya meslek scripti değiştiğinde entegrasyonları tekrar kontrol edin.
Her testte kullanılan core ve envanter sürümünü tam olarak kaydedin. Core yeniden başlatılırsa çevrimiçi API sonucunu yorumlamadan önce test karakterini yeniden bağlayın. Veritabanı şeması ve AC cezasını aynı anda değiştirmeyin. Değişiklikleri ayırmak, hangi adımın sorun ürettiğini bulmanızı ve çalışan ayara geri dönmenizi kolaylaştırır.
- Karakter değişimi, respawn ve hastane canlandırması kalıcı muafiyet bırakmamalı.
- Ev, garaj ve hapishane ışınlaması hareketten hemen önce MarkTeleport bildirmeli.
- Envantersiz arena silahı güvenilir sunucu resource’undan kısa AllowWeapon çağrısı almalı.
- Polis işlemleri, personel araçları, marketler ve meşru büyük ödüller daha ağır ceza seçmeden kayıtlara göre test edilmeli.
Tekrarlanabilir başlangıç ölçümü alın
Ayar değiştirmeden önce temsilî bir oyun oturumunda sunucu profili alın. Oyuncu sayısını, artifact ve resource sürümlerini, yapılan işlemleri kaydedin. Sakin rol, kalabalık garaj ve çatışma farklı yük üretir. Tek değişiklik yaptıktan sonra aynı tür oturumla karşılaştırın. Sunucu CPU süresi, hitch uyarısı ve sorgu davranışı sabit FPS artışı vaadinden daha yararlıdır.
Aşağıdaki komutlar sınırlı örnek kaydeder ve durumunu gösterir. Profili açmadan kaydın bitmesini bekleyin. Her takılmayı anticheat’e bağlamak yerine sıçramanın hangi resource ve thread’den geldiğini inceleyin. Değişen ayarı tam adıyla özel önce/sonra notuna yazın. Kısa kayıt, yoğun saatteki bütün yükü öngöremez.
profiler record 500
profiler status
profiler view
tosunac_doctor
Güncelleme, geri dönüş ve destek kaydı
Core, envanter, meslek scripti veya AC güncellendiğinde ilgili kabul testini yeniden çalıştırın. Aynı anda şema, ceza ve kaynak sürümü değiştirmeyin. Sorun yeni değişiklikten kaynaklanıyorsa yedeklenmiş resource ve ayarlara planlı bakımda dönün; veritabanı geri yüklemesini veri kaybını değerlendirmeden yapmayın. Desteğe artifact/core/envanter/AC sürümü, resource adı, test adımları, saat ve anahtarsız ilk hata mesajını verin. Oyuncu kimliklerini, lisansları, parolaları ve token’ları açık kayıtta paylaşmayın.
İlgili kurulum ayrıntıları
Kurulum dokümanı · Veritabanı köprüsü · Server export rehberi
Sıkça Sorulan Sorular
Framework değişince yalnız panel ayarı yeterli mi?
Hayır. Core API, envanter, karakter kimliği, SQL şeması ve özel event akışları değişebilir. Yedek ve yeniden kabul testi gerekir.
Köprü verisi gelmiyorsa koruma kapalı mı?
Hayır. Veri köprüsü izin ve şema uyumluluğu ile genel AC kontrolleri farklıdır. Durumu ve hatayı ayrı inceleyin.
Birden fazla sunucum olabilir mi?
Hesabınızın ücretli planındaki sunucu kotasını ve her sunucunun kendi lisansını kontrol edin; farklı kurulumları ayrı doğrulayın.