FiveM Araç Anahtarları Scripti: Agency-Vehiclekeys Rehberi 2026

FiveM'de Varsayılan Araç Erişiminin Sorunu

GTA V ve FiveM varsayılan olarak her oyuncunun herhangi bir araca kısıtlama olmadan binmesine ve sürmesine izin verir. Anahtar yok, sahiplik mekaniği yok, yabancı birinin arabasına atlayıp uzaklaşmanın hiçbir sonucu yok. Eğlence odaklı sunucular için bu pek sorun olmasa da, ciddi rol yapma toplulukları için bu varsayılan davranış atmosferi temelden bozar. Her araba ortak bir taksiye dönüşür. Araç hırsızlığı tüm anlamını yitirir. Bir iş hallederken arabanızı bankanın yakınına park etmek, diğer oyuncuların aracı alıp götürmesine karşı bir kumara dönüşür.

Bir FiveM araç anahtarı scripti bu sorunu framework düzeyinde çözer. Sunucuda spawn edilen veya satın alınan her araca sahiplik ve fiziksel anahtarlar bağlayarak, oyuncuların bir arabanın kilidini açması, çalıştırması ve sürmesi için envanterlerinde doğru anahtar eşyasına sahip olmasını gerektirir. Anahtarı olmayan araçlar kilitlidir; bunlara binmeye çalışan bir oyuncu doğrudan engellenir. Sahip olmadığınız bir aracı kullanmak için anahtarı ödünç almanız, düz kontak (hotwire) mekaniğini kullanmanız veya kilidi maymuncukla açmanız gerekir. Bu üç mekanik bir araya gelerek araç etkileşimini sıradan bir durum olmaktan çıkarıp roleplay'e anlamlı bir dinamizm katmanına dönüştürür.

2026 yılında Agency-Vehiclekeys, bu sistemin sorunsuz uygulanmasını isteyen sunucular için derin QBCore ve ESX entegrasyonu, sürükleyici bir düz kontak mini oyunu ve tek seferlik uygun fiyatıyla öne çıkan tercihtir. Bu rehber, bilmeniz gereken her şeyi kapsıyor.

Agency-Vehiclekeys Neler Sunar

Agency-Vehiclekeys, araç sahipliğini gerçek hissettiren beş temel özellik sütunu etrafında inşa edilmiştir:

1. Fiziksel Anahtar Öğeleri

Bir oyuncu bir araç çıkardığında veya satın aldığında, envanterine benzersiz bir anahtar eşyası yerleştirilir. Bu eşya, söz konusu aracın kilidini açmanın ve çalıştırmanın tek yoludur, aracın ağ ID'sine veya plakasına bağlıdır. Anahtar fiziksel olarak başka bir oyuncuya verilebilir, yere atılabilir, bir zulada saklanabilir veya kaybedilebilir. Anahtarınızı kaybederseniz, düz kontak yapmadan veya bir çilingir çağırmadan (yapılandırabileceğiniz bir meslek mekaniği) arabanızı çalıştıramazsınız. Anahtarları gerçek envanter eşyalarına dönüştüren bu tek tasarım kararı, varsayılan FiveM platformunun tek başına destekleyemeyeceği bir dizi özgün rol yapma senaryosu yaratır.

2. Anahtar Paylaşımı

Anahtar paylaşım sistemi, araç sahibinin yedek bir anahtar oluşturup bunu başka bir oyuncuya vermesine olanak tanır. Bu durum ortak kullanılan araçlar, aile araçları, araçları hareket ettirmesi gereken tamirhaneler ve kaçış arabasını paylaşan suç ekipleri için vazgeçilmezdir. Paylaşım basit bir oyun içi etkileşimle yapılır: oyuncuyu hedefleyin, "Give Vehicle Key" seçeneğini seçin ve yedek anahtar envanterlerinde görünsün. Sahip kendi anahtarını korur; alıcı ise orijinaliyle birebir aynı çalışan işlevsel bir kopya elde eder. Araç sahipleri ayrıca istedikleri zaman paylaşılan tüm anahtarları iptal edebilir ve daha önce erişimi olan herkesi devre dışı bırakabilir.

3. Hotwire Mini Oyunu

Bir oyuncu anahtarına sahip olmadığı kilitli bir araca girmeye çalıştığında, kendisine düz kontak yapma seçeneği sunulur. Agency-Vehiclekeys, basit bir zar atışı yerine oyuncu becerisi gerektiren, zaman ayarlı bir kablo eşleştirme mücadelesi olan gelişmiş bir NUI düz kontak mini oyunu içerir. Mini oyunu başarıyla tamamlamak aracı çalıştırır ancak diğer scriptlerin bağlanabileceği sunucu taraflı olayları tetikler: araç sahibini uyarır, polis merkezine bildirim gönderir, olayı MDT'ye kaydeder. Mini oyunun zorluğu ve zaman sınırı tamamen yapılandırılabilir olup araç sınıfına göre farklı zorluk seviyeleri belirleyebilirsiniz (ekonomi sınıfı araçlar daha kolay, süper arabalar daha zor).

4. Maymuncuk Sistemi

Maymuncuk sistemi, kapı kilidini açma adımını düz kontak yapmaktan ayrı olarak ele alır. Envanterinde maymuncuk eşyası bulunan bir oyuncu, bir araç kapısının kilidini açmayı deneyebilir. Bu, düz kontak yaparken araca binebilmenin ön koşuludur: önce kapı kilidini açarsınız, ardından çalıştırmak için düz kontak yaparsınız. Kilit açmanın kendine ait bir mini oyunu ve yapılandırılabilir başarı oranı ile eşya tükenme şansı vardır. Başarısız kilit açma girişimleri maymuncuğu kırabilir (yapılandırılabilir) ve isteğe bağlı olarak yakındaki oyunculara veya polise bildirim gönderebilir. Kilit açma ve ardından düz kontak şeklindeki bu iki adımlı süreç, araç hırsızlığını ciddi RP ortamlarında olması gerektiği gibi anlamlı derecede riskli ve zaman alıcı hale getirir.

5. Kapsamlı QBCore ve ESX Entegrasyonu

Agency-Vehiclekeys, doğrudan QBCore envanteri (ox_inventory uyumlu) ve ESX envanteri ile entegre çalışır. Anahtar eşyaları, simgeleri ve meta verileriyle düzgün envanter nesneleri olarak görünür. Araç sahipliği, QBCore'un araç sahipliği veritabanına bağlanır (player_vehicles) ve ESX eşdeğeri. Bir oyuncu aracını galeriden veya çekilmiş araç otoparkından aldığında, anahtarı otomatik olarak oluşturulur ve envanterine yerleştirilir. Tüm bildirimler, kilit açma/kilitleme onayları, düz kontak uyarıları, maymuncuk girişimleri, sunucunuzun kullanıcı arayüzünün geri kalanıyla uyumlu olması için framework'ünüzün yerel bildirim sistemini kullanır.

Ek Özellikler

Beş temel unsurun ötesinde, Agency-Vehiclekeys çeşitli yaşam kalitesi mekanikleri içerir:

• Kilitleme/Kilit açma animasyonları: Karakter, bir aracı kilitlerken veya kilidini açarken duyulabilir bir tık sesiyle birlikte gerçekçi bir uzanma animasyonu sergiler.
• Yakınlık kilidi: Bir tuş ataması veya radial menu seçeneği kullanarak yapılandırılabilir bir mesafeden kilitleyin ve kilidi açın, kapının hemen yanında durmanıza gerek yoktur.
• Araç alarmı: Maymuncuk veya düz kontak denemesi yapıldığında isteğe bağlı olarak araç alarmını tetikleyin. Alarm yakındaki oyuncuların dikkatini çeker ve sahibine telefon bildirimiyle haber verebilir (Agency Phone yüklüyse).
• Meslekten muaf araçlar: Anahtar sisteminden muaf tutulacak meslek araçlarının (polis arabaları, ambulanslar, çekiciler) bir listesini tanımlayın; görevliler bir anahtar eşyasına ihtiyaç duymadan meslek araçlarına serbestçe binebilir.
• Çekilmiş araç entegrasyonu: Bir araca el konulduğunda, ilişkili anahtar otomatik olarak geçersiz kılınır. Araç otoparktan teslim alındığında yeni bir anahtar oluşturulur.
• Export API: Temiz bir export API'si, diğer scriptlerin anahtar sahipliğini kontrol etmesine, programatik olarak anahtar oluşturmasına veya anahtarları iptal etmesine olanak tanır; mekanik scriptleri, galeri scriptleri ve özel meslek entegrasyonları için oldukça kullanışlıdır.

Kurulum: Adım Adım

Adım 1: Agency-Vehiclekeys Satın Alın

Şuraya gidin: agencyscripts.dev/en/products/vehiclekeys ve tek seferlik satın alımını tamamlayın: €7.99. Ödeme işleminden sonra indirme erişimini Agency Scripts mağaza portalı üzerinden alırsınız. Abonelik yok, yenileme yok, kalıcı olarak sahip olursunuz.

Adım 2: Resource'u Yerleştirin

İndirilen arşivi çıkartın ve şunu bırakın: agency-vehiclekeys klasörünü sunucunuzun resources dizini (veya şu gibi bir alt klasör: resources/[scripts]/).

Adım 3: server.cfg Dosyasına Ekleyin

Açın server.cfg ve ensure satırını framework ve envanter resource'larınızın ardına ekleyin:

ensure agency-vehiclekeys

Adım 4: Config.lua Dosyasını Yapılandırın

Aç agency-vehiclekeys/config/Config.lua ve framework, envanter sistemi ve özellik tercihlerinizi ayarlayın. Temsili bir yapılandırma için aşağıdaki örneğe bakın.

Adım 5: Anahtar Öğelerini Envanterinize Ekleyin

QBCore veya ESX kullanıyorsanız, anahtar eşya tanımını paylaşılan eşyalar dosyanıza ekleyin. Tam eşya tanımı şu adresteki dokümantasyonda verilmiştir: docs.agencyg.de/vehiclekeys. ox_inventory kullanıcıları için eşyayı bunun yerine items.lua dosyanıza ekleyin.

Adım 6: Yeniden Başlatın ve Test Edin

Sunucunuzu yeniden başlatın. Bir araç spawn edin, envanterinizde anahtar eşyasını kontrol edin, aracı kilitleyin, uzaklaşın, geri dönün ve anahtarsız girmeyi deneyin. Ardından anahtarı başka bir oyuncuya vermeyi, lockpick etkileşimini ve hotwire mini oyununu test edin.

Config.lua Örneği

Aşağıda, Agency-Vehiclekeys içindeki en önemli seçenekleri gösteren örnek bir yapılandırma bulunmaktadır:

-- Agency-Vehiclekeys: Config.lua

Config = {}

-- Framework: "qbcore" or "esx"
Config.Framework = "qbcore"

-- Inventory system: "qb-inventory", "ox_inventory", or "esx"
Config.Inventory = "ox_inventory"

-- Item name for vehicle keys in your inventory
Config.KeyItem = "vehicle_key"

-- Item name for lockpicks
Config.LockpickItem = "lockpick"

-- Distance (metres) from which player can lock/unlock their vehicle
Config.LockDistance = 8.0

-- Enable vehicle alarm on hotwire/lockpick attempt
Config.EnableAlarm = true
Config.AlarmDuration = 30  -- seconds

-- Hotwire mini-game settings
Config.Hotwire = {
    enabled    = true,
    timeLimit  = 20,         -- seconds to complete mini-game
    difficulty = "medium",   -- "easy", "medium", "hard"
    -- Per-class overrides (GTA vehicle class numbers)
    classOverrides = {
        [6]  = "easy",   -- off-road: easier
        [7]  = "hard",   -- supercars: harder
        [14] = "hard",   -- military: very difficult
    },
}

-- Lockpick settings
Config.Lockpick = {
    enabled          = true,
    breakChance      = 0.25, -- 25% chance lockpick breaks on failure
    alertPolice      = true, -- send notification to online police on attempt
    alertRadius      = 30.0, -- metres within which police are notified
}

-- Job-exempt vehicles (these jobs can enter any vehicle without a key)
Config.ExemptJobs = { "police", "ambulance", "mechanic", "tow" }

-- Notification system: "qb", "esx", "okok", "ox"
Config.NotifySystem = "qb"

-- Enable export API for other scripts to interact with the key system
Config.EnableExports = true

Framework ve Envanter Uyumluluğu

Agency-Vehiclekeys, ilk andan itibaren aşağıdaki kombinasyonları destekler:

• QBCore + qb-inventory: Tam entegrasyon, anahtarlar QBCore envanter arayüzünde görünür, araç sahipliği şununla senkronize olur: player_vehicles
• QBCore + ox_inventory: Tam entegrasyon, anahtarlar metadata içeren ox eşyaları olarak işlenir, tüm ox_inventory özellikleriyle uyumludur
• ESX + ESX inventory: Tam entegrasyon, anahtarlar ESX envanter sisteminde yer alır, sahiplik ESX araç tablosu ile senkronize edilir

Farklı bir envanter sistemi kullanıyorsanız, export API'si ve açık Lua kod tabanı özel bir köprü eklemeyi oldukça kolaylaştırır. Dokümantasyon bir köprü şablonu içerir.

Dokümantasyon

Tüm dokümantasyona, tüm config seçeneklerine, envanter eşyası tanımlarına, export API referansına, meslek muafiyeti kurulumuna ve SSS'ye şu adresten ulaşabilirsiniz: docs.agencyg.de/vehiclekeys. Belgeler her sürümle birlikte güncel tutulur ve QBCore, ESX ile ox_inventory için kopyala-yapıştır öge tanımları içerir.

Fiyatlandırma: €5.99 Tek Seferlik

Agency-Vehiclekeys fiyatı €7.99 Agency Scripts mağazası üzerinden tek seferlik bir ödeme olarak. Abonelik yok, yenileme yok, sunucu başına ücret yok. Bir kez ödeyin ve sonsuza kadar sahip olun; geçerli ana sürüme ait gelecekteki tüm güncellemeler ek bir ücret olmadan dahildir. Altı euronun altındaki fiyatıyla bu, piyasadaki en uygun maliyetli premium FiveM scriptlerinden biridir. Abonelik modeline sahip başka bir geliştiricinin benzer bir araç anahtarı sistemi bu tutara tek bir ayda mal olur; Agency-Vehiclekeys ise çoğu sunucu sahibinin bir haftada kahveye harcadığı tek seferlik bir fiyat karşılığında size aynı veya daha iyi kaliteyi sunar.

Agency-Vehiclekeys'i Kimler Kullanmalı?

Agency-Vehiclekeys şunlar için doğru seçimdir:

• Ciddi RP sunucuları araç sahipliğinin gerçek bir ağırlık taşımasını isteyen, artık görülen her araca öylece atlamak yok
• İllegal RP Toplulukları araç hırsızlığını ustalık gerektiren, riskli bir faaliyete dönüştüren özgün düz kontak ve maymuncuk mekanikleri isteyen
• Araç galerilerine sahip sunucular, sorunsuz entegrasyon, lisans anahtarı üretiminin satış anında otomatik yapıldığı anlamına gelir
• Polis RP sunucuları, maymuncuk/düz kontak girişimlerindeki alarm uyarıları ve polis bildirimleri gerçek müdahale senaryoları oluşturur
• QBCore ve ESX sunucuları mevcut framework standartlarına saygı duyan, doğrudan entegre edilebilir ve düzenli bakımı yapılan bir anahtar çözümü arayanlar

Özet

Araç anahtarları, rol yapmayı ciddiye alan her sunucu için temel bir mekaniktir. Agency-Vehiclekeys: fiziksel anahtar eşyaları, anahtar paylaşımı, beceriye dayalı düz kontak mini oyunu, iki aşamalı maymuncuk sistemi, araç alarmları ve derin framework entegrasyonuyla eksiksiz bir paketi 7.99 € tek seferlik ücretle sunar. Objektif olarak, FiveM sunucunuz için yapabileceğiniz en değerli yatırımlardan biridir. Mağazayı ziyaret edin, ürünü edinin ve sunucunuzdaki araçların işleyişini bugünden dönüştürün.