Framework ayarları

QBCore ve ESX#

Bridge yalnız desteklenen tablo yapıları ve indeksli alanları okur. Eksik sütunlar, desteklenmeyen envanter veya özel kimlikler isteğin reddedilmesine yol açabilir. Boş ya da desteklenmiyor yanıtı veritabanının boş olduğu anlamına gelmez.

Özel oyun akışları#

Karakter seçimini, işleri, ışınlanmayı, garajları ve yetkili araçlarını test sunucusunda deneyin. Yetki kararlarını ve ayrıcalıklı durumu sunucuda doğrulayın. Dar kapsamlı muafiyetleri yalnız etkinliği doğrulayan güvenilir sunucu kodundan uygulayın.

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.

1. Nakit, banka, meslek ve bir aracı bilinen test karakterinin ayrıntılarını okuyup oyunla karşılaştırın.
2. 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.
3. 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.

• Veritabanı köprüsü (Tosun Connect)

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.

• Export ve güven listesi
• Resmî event güvenliği

Ayar adlarını ve algılanan core adlarını doğru okuyun#

AC ayarı ile veritabanı bağlayıcısı aynı kurulumu farklı etiketlerle anlatır: QBCore ayar değeri qb iken köprü sağlık durumunda qbcore görünür. Qbox için qbox kullanılır ve qbx_core resource’u çalışır. Bu adları klasörle eşleştirmek için değiştirmek yerine ait oldukları bağlamda okuyun. Otomatik kurulum vrp veya ox_core’u da tanıyıp ilgili etiketi seçebilir; bu işlem veritabanı köprüsüne desteklenen karakter ya da ekonomi adaptörü kazandırmaz. Desteklenmeyen core’da genel koruma için açık standalone ayarı kullanmak, algılanan adı tam entegrasyon vaadi sanma riskini azaltır.

1. configs/anticheat_config.lua dosyasını ve gerçekten çalışan core’u kontrol edin; bilinçli tek framework seçimini ve mevcut bağımlılık sırasını koruyun.
2. Panel farklı yetenekler gösteriyorsa AC ayarını körlemesine yeniden adlandırmak yerine çalışan core resource’larını ve köprü sağlığını inceleyin.
3. Sırf başka bir durum etiketi görmek için qb-core, qbx_core veya es_extended resource’larını birlikte başlatmayın.

Gerçek rollere göre kabul testi matrisi oluşturun#

Normal oyuncu, polis veya diğer meslek rolleri ve personel için ayrı testler kullanın. Personelde meşru AC muafiyeti olabileceğinden temel oyun akışlarını normal karakterle de deneyin. Giriş, karakter seçimi, ölüm ve canlandırma, ev geçişleri, garajlar, envanter silahları ve sunucunuzun gerçek meslek ödüllerini kapsayın. Her işlemde beklenen konumu, eşya veya hesap sonucunu ve görülen kaydı not edin. Menüler ve script etkinliklerinde başarılı tamamlanma kadar iptali de test edin. Resource’un temiz başlaması; değiştirilmiş envanterin, banka script’inin veya karakter seçicinin entegrasyonun beklediği API’leri kullandığını göstermez.

1. Core veya envanter güncellemesinin öncesinde ve sonrasında aynı küçük test kümesini uygulayın; bir seferde tek bileşeni değiştirin.
2. Hata için core ve envanter sürümünü, çağıran resource’u ve oyuncu rolünü kaydedin; kimlik verilerini özel tutun.
3. Yeniden başlatma veya karakter geçişi sonrasında tekrar bağlanın; yalnız muaf personeli test etmek yerine geçici iznin sona erdiğini doğrulayın.

Özel script sorumluluklarını açıkça belirleyin#

Tespit ayarını, oyun script’lerinizin sahip olduğu kurallardan ayırın. AC özel banka transferinde alıcıyı, bir mesleğin ödül tavanını veya belirli evin sahibini kendiliğinden bilemez. Para, eşya veya konum değiştirmeden önce oyuncuyu, yetkiyi ve sunucunun tuttuğu durumu bu resource’lar doğrulamalıdır. Envanter silah kontrolü desteklenen API’leri kullanır; API’ye ulaşılamaması silah doğurtulduğunun kanıtı değil, bilinmeyen sonuçtur. Karakter okuması farklı sütun veya indeks yüzünden başarısızsa şema uyumluluğunu cezalandırmadan ayrı araştırın. Entegrasyon hatası yüzünden oyuncu cezalandırmayın; eksik adaptörün yerine geniş whitelist koymayın.

1. Framework veya envanter adaptörü için bir sorumlu, her özel işlem için de açıkça belirlenmiş bakım sahibi atayın.
2. Oyun script’inin kendi doğrulamasıyla bir normal yetkili işlemi ve bir reddedilen yetki yolunu yeniden üretin.
3. Genel AC çalışması ile panel veritabanı köprüsünü (Tosun Connect) ayrı değerlendirin; özel tablolar için incelenmiş entegrasyon çalışması gerekir.

Silah envanteri ile karakter ayrıntısını ayrı okuyun#

Aynı sunucuda framework ile envanter sağlayıcısı farklı olabilir. QBCore karakter ve para işlemlerini yönetirken ox_inventory eşya sağlayabilir. Silah sahipliği denetimi, çalışan ox_inventory varsa onu önce kullanır; aksi durumda desteklenen QBCore/Qbox veya ESX API’lerini inceleyebilir. Paneldeki karakter ayrıntısı ise ayrı bir köprü okumasıdır. Bir ekranda eşya görünmesi her silah denetiminin aynı kaynaktan, aynı anda ve aynı biçimde okuduğunu kanıtlamaz. Bu ayrımı özellikle özel cephanelik ve görev script’leriyle çalışırken koruyun; yalnız framework adını değiştirerek veri kaynağını eşitlemiş olmazsınız.

Örneğin ESX’in loadout silah kaydı ile item tabanlı envanter sayısı aynı kavram değildir. Bir API’nin nil, hata veya beklenmeyen veri döndürmesi yokluk kanıtı değildir; desteklenen yöntemin doğru sonuç üretmesini doğrulayın. Testte silahın verildiği anı, normal oyuncu eylemini, kullanılan envanteri ve ilgili kaydı birlikte not edin. Sunucu tarafından meşru olarak envantersiz verilen silah için incelenmiş AllowWeapon entegrasyonu kullanılabilir; bütün kontrolleri kapatmak yerine yalnız gerekli kapsamı seçin. Bu adımlar uyumluluk incelemesidir, bütün olası tespit hatalarının çözülmüş olduğu vaadi değildir.

Core geçişini tablo adından daha geniş değerlendirin#

QBCore’dan ESX’e veya tersine geçiş yalnız ayar etiketini değiştirmek değildir. Mevcut köprü QBCore ailesinde players/citizenid, ESX’te users/identifier bağlamını kullanır. Aynı insanın eski oturum numarası veya görüntülenen adı yeni karakter kaydını tanımlamaz. Para alanları, araç sahibi alanı, envanter ve özel iş kuralları da farklı olabilir. Bu nedenle üretim tablolarını sırf panel sorgusu geçsin diye yeniden adlandırmayın. Yeni core’un veri taşıma planı oyun sunucusunun kendi sorumluluğundadır; AC kurulumu kayıp veriyi dönüştüren genel bir göç aracı değildir.

Önce ayrı test ortamında bir bilinen karakteri ve onun araç kaydını seçin. Core etiketi, kalıcı karakter kimliği, seçilen cash/bank hesabı ve çevrimiçi durumu not ederek küçük okuma yapın. Desteklenen şema veya indeks bulunamıyorsa köprü hatasını veri kaybı gibi yorumlamayın; uyumluluğu bakım sahibi değerlendirsin. Panelden bakiye düzenleme varsayılan olarak açıktır; geçiş onaylanana kadar kullanmayın. Teknik olarak engellemek için manuel modu kullanın: server.cfg’ye set tosun_db_bridge_manual "1" ve set tosun_db_bridge_enabled "1" ekleyin, tosun_db_bridge_money_write satırını eklemeyin. Karakter seçiciyi ve normal envanter işlemini yeniden test edin. Doğru verinin doğru karaktere bağlı olduğu görülmeden yalnız resource’un başlamasını kabul sonucu saymayın.