qb-vehiclekeys
Araç anahtarı, kilit mesafesi, maymuncuk, kontak kablosu, araç çalma ve meslek araçları için açık kaynak rehberi.
qb-vehiclekeys#
PersistentKeys false iken verilen anahtarlar sunucu yeniden başlatılınca kalıcı olarak saklanmaz; araç sahipliği kayıtları bundan ayrıdır. LockToggleDist 8 m kilit aç/kapat mesafesidir. LockNPCDrivingCars ve LockNPCParkedCars NPC araçlarının başlangıç kilit davranışıdır. UseKeyfob seçeneği alternatif anahtar kullanım biçimidir.
RemoveLockpickNormal ve RemoveLockpickAdvanced başarısız denemede maymuncuğun silinme şansıdır. CarJackEnable, CarjackingTime ve DelayBetweenCarjackings NPC araç gaspını ayarlar. HotwireChance, TimeBetweenHotwires, minHotwireTime ve maxHotwireTime kablo bağlama dengesini belirler. Bu oranları artırmak araç çalmayı kolaylaştırır; polis bildirim ayarlarıyla birlikte değerlendirin.
PoliceAlertChance gündüz, PoliceNightAlertChance gece ihbar olasılığıdır; AlertCooldown tekrar bildirimi sınırlar. SharedKeys, iş araçlarının çalışanlar arasında anahtar paylaşımını tanımlar. İlgili iş kodu QBCore ile aynı olmalıdır. ImmuneVehicles ve NoLockVehicles yalnız özel durumlar içindir; normal oyuncu araçlarını listeye eklemeyin.
Araç satın alımında anahtar verilmesi, satın alma/garaj kaynaklarının bu açık kaynakla uyumlu akışıdır. Araç çıkıyor ama anahtar gelmiyorsa önce araç plakasını, satın alan karakteri ve ilgili kaynakta anahtar verme çağrısının başarılı olduğunu kayıt üzerinden doğrulayın.
Ayar tablosu#
| Ayar | Mevcut değer | Etkisi |
|---|---|---|
| PersistentKeys | false | Sonradan verilen anahtarların yeniden başlatma sonrası saklanma davranışıdır. Araç sahipliği kaydından ayrıdır. true seçmeden önce kalıcı anahtar politikanızı değerlendirin. |
| LockToggleDist | 8 m | Kilit aç/kapat menzilidir. Çok yükseltmek uzaktan kilit kullanımını gerçekçi olmayan hâle getirir. |
| LockNPCDrivingCars / LockNPCParkedCars | false / false | NPC araçlarının başlangıç kilit halidir. İkisini açmak suç/anahtar akışını belirgin biçimde zorlaştırır. |
| UseKeyfob | false | Alternatif anahtar kullanım görünümüdür. Açmadan önce mevcut kilit arayüzüyle çakışmadığını test edin. |
| RemoveLockpickNormal / Advanced | 0.5 / 0.2 | Başarısız maymuncuk denemesinde eşyanın kaybolma olasılığıdır. 0-1 aralığındaki oranı küçük adımlarla değiştirin. |
| CarJackEnable | true | NPC araç gaspı özelliğini açar/kapatır. |
| CarjackingTime | 7500 ms | Gasp işleminin süresidir. Çok kısa değer rol ve polis tepki süresini azaltır. |
| DelayBetweenCarjackings | 10000 ms | Arka arkaya gasp denemeleri arasındaki beklemedir. |
| HotwireChance | 0.5 | Kontak kablolama başarısıdır. Yüzde değil, 0-1 oranıdır. |
| minHotwireTime / maxHotwireTime | 20-40 sn | Kablolama süresinin aralığıdır. |
İş araçları ve istisnalar#
SharedKeys içine eklenen iş adı QBCore iş adıyla birebir aynı olmalıdır; bu, tüm oyunculara anahtar vermek yerine yalnız aynı işteki çalışanlara paylaşım sağlar. ImmuneVehicles ve NoLockVehicles listeleri istisnadır. Normal satın alınabilir araçları bu listelere koymak anahtar/çalınma düzenini bozar. NoCarjackWeapons listesi ise hangi silahlarla NPC gaspı yapılamayacağını tanımlar.
Doğrulama#
Satın alınan araç, iş aracı, NPC araç ve anahtarı paylaşılmış araçla ayrı test yapın. Her testte plaka, karakter, kilitleme, kontak açma ve yeniden başlatma sonrası davranışını kontrol edin. Anahtar eksikse araç satışı veya garaj kaynaklarını değiştirmek yerine önce plaka eşleşmesi ve anahtar olayının kayıt satırından başlayın.