FiveM Asansör Scripti: Agency-Elevator Kurulum Rehberi 2026

FiveM Asansör Script'i Nedir?

Bir FiveM asansör scripti, roleplay sunucunuzdaki çok katlı binalara işlevsel ve etkileşimli asansörler ekleyen özel bir resource'tur. Özel bir asansör scripti olmadan, GTA V / FiveM sunucularındaki oyuncuların yüksek binalarda katlar arasında geçiş yapmasının gerçekçi bir yolu yoktur; merdivenleri, ışınlanma komutlarını veya rol hissini anında bozan hantal geçici çözümleri kullanmak zorunda kalırlar.

Düzgün bir asansör scripti, oyuncular bir asansör alanına girdiğinde onlara oyun içi bir UI paneli sunar. Hedef katlarını seçerler, kapılar animasyonla kapanır, kamera veya karakter hedef kata akıcı bir şekilde geçiş yapar, ses efektleri çalar ve varışta kapılar tekrar açılır. Tüm etkileşim, sonradan eklenmiş bir mekanik gibi değil, oyun dünyasının doğal bir parçası gibi hissettirir.

Ciddi rol yapma sunucuları, apartman kompleksleri, hastane binaları, polis merkezleri, gökdelen ofisleri, otoparklar için iyi bir asansör scripti lüks değildir. Yaşayan bir his veren bina ile içi boş bir dekor gibi hissettiren bina arasındaki farktır. 2026 yılında Agency Scripts tarafından sunulan Agency-Elevator, topluluğun vazgeçilmez ücretsiz çözümü haline geldi ve bu rehber, onu sunucunuzda çalıştırmak için bilmeniz gereken her şeyi kapsıyor.

Neden Agency-Elevator'a İhtiyacınız Var

FiveM topluluk forumlarında ve GitHub üzerinde dolaşan birkaç asansör scripti var, ancak çoğu bir veya daha fazla ciddi sorundan muzdariptir: modern FiveM sürümlerinde bozulan güncelliğini yitirmiş kod, aktif bakım yapılmaması, sabit kodlanmış kat koordinatları, NUI panelinin bulunmaması veya oyuncuların geometrinin içine girmesine neden olan zayıf animasyon yönetimi.

Agency-Elevator tüm bu sorunları temiz bir şekilde çözmek için geliştirildi. Agency Scripts ekibi tarafından aktif olarak sürdürülür, eksiksiz belgelenmiştir ve en önemlisi tamamen ücretsizdir. Hiçbir koşul olmaksızın, doğrudan Tebex mağazasından ücretsiz olarak alabilirsiniz. Öne çıkmasının nedenleri şunlardır:

• Çok kat desteği: Binanızda bulunan kat sayısı kadar kat tanımlayın. Script içinde kodlanmış kesin bir sınır yoktur.
• Akıcı animasyonlar: Script, oyuncuların ani pozisyon sıçramaları görmemesi için native GTA V animasyonlarını ve dikkatle zamanlanmış ışınlanmaları kullanır.
• NUI kat seçimi paneli: Temiz ve hafif bir tarayıcı overlay'i geçerli katı gösterir, oyuncuların hedeflerini seçmek için tıklamasına veya tuşa basmasına olanak tanır.
• Ses efektleri: Asansör çan sesi, kapı açılma/kapanma ve ortam hareket sesleri hazır olarak gelir.
• Tamamen yapılandırılabilir: Her bina, her asansör boşluğu, her kat koordinatı, her kat etiketi, hepsi tek bir Config.lua dosyası.
• Framework bağımsız: QBCore, ESX ve tamamen Standalone kurulumlarla çalışır. Varsayılan olarak framework bağımlılığı yoktur.
• Sıfır maliyet: ÜCRETSİZ, ödeme yok, escrow yok, ücretsiz bir hesap dışında Tebex aboneliği gerekmez.

Ayrıntılı Özellik İncelemesi

Çok Katlı Binalar

Agency-Elevator içerisindeki her asansör, yapılandırmada bir tablo girdisi olarak tanımlanır. Tetikleme bölgesini (oyuncunun asansörü çağırmak için durduğu yer) belirtir, ardından her katı adı, hedef koordinatları (x, y, z, heading) ve isteğe bağlı bir erişim kısıtlaması ile listelersiniz. Tek bir kaynakta dilediğiniz sayıda bina için asansör tanımlayabilirsiniz: hastane, polis merkezi, apartman bloğu, casino kulesi; hepsi tek bir yerden yönetilir.

NUI Paneli

Bir oyuncu asansör tetikleme alanına girdiğinde, ekranda yüzen bir NUI paneli belirir. Mevcut tüm katları etiketleriyle birlikte listeler (örneğin "Zemin Kat", "2. Kat, Daireler", "Çatı Katı"). Oyuncular gidecekleri yere tıklar veya klavye kontrolleriyle gezinir. Panel, Agency Scripts tasarım diline uyacak şekilde stillendirilmiştir ancak sunucunuzun marka kimliğine uyarlamak isterseniz NUI HTML/CSS dosyaları üzerinden tamamen özelleştirilebilir.

Animasyonlar ve Ses

Agency-Elevator, bir kat seçildiğinde kapı kapanma animasyonu ve sesi çalar, ardından yapılandırılabilir bir gecikmeden sonra oyuncuyu sorunsuz bir şekilde hedef kata ışınlar. Varışta kapı açılma sesi çalar ve panel kaybolur. Tüm animasyon ve ses zamanlamaları şurada yapılandırılabilir: Config.lua böylece hissi binanızın asansör hızına uyacak şekilde ayarlayabilirsiniz.

Erişim Kısıtlamaları

Belirli katlar meslek kontrolleri (QBCore/ESX) veya eşya kontrolleriyle kilitlenebilir. Örneğin bir apartman binasının çatı katını penthouse anahtarı eşyasına sahip oyuncularla sınırlandırabilir veya sunucu odası katını polis/yetkili meslekleriyle kısıtlayabilirsiniz. Bir oyuncu gerekli mesleğe veya eşyaya sahip olmadan kısıtlı bir katı seçmeye çalıştığında bir bildirim gösterilir ve asansör hareket etmez.

Yapılandırılabilir Tetikleme Bölgeleri

Her asansör tetikleyicisi bir 3D konum ve yarıçap ile tanımlanır. Yeni oyuncuların asansörü yürüyerek bulabilmesi için isteğe bağlı olarak bir işaretçi (blip) de ekleyebilirsiniz. Sade bir mini harita tercih eden sunucular için işaretçiler kapatılabilir.

Kurulum: Adım Adım

Adım 1: Agency-Elevator İndirin

Şu adresteki Tebex listesine gidin: agency-script.tebex.io/package/7285036 ve Agency-Elevator ürününü sepetinize ekleyin. ÜCRETSİZDİR, ödeme adımını sıfır tutarlı bir siparişle tamamlamanız yeterlidir. İndirme bağlantısını Tebex teslimat sistemi üzerinden (CFX hesabınıza bağlı veya doğrudan indirme olarak) alacaksınız.

Adım 2: Resource'u Yerleştirin

İndirilen arşivi çıkartın ve şunu yerleştirin: agency-elevator klasörü, 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 aşağıdaki satırı framework resource'unuzdan sonra herhangi bir yere ekleyin:

ensure agency-elevator

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

Aç agency-elevator/config/Config.lua ve asansörlerinizi yapılandırın. Tam bir örnek için aşağıdaki bölüme bakın. En azından framework'ünüzü ayarlamanız ve en az iki katı olan en az bir asansör tanımlamanız gerekir.

Adım 5: Sunucuyu Başlatın

Sunucunuzu yeniden başlatın (veya şunu kullanın: refresh + start agency-elevator sunucu konsolunda). Oyun içinde herhangi bir asansör tetikleme bölgesine yürüyün, NUI panelinin görünmesi gerekir. Panel görünmezse herhangi bir hata mesajı için sunucu konsolunu kontrol edin, sorunların çoğu yapılandırmadaki koordinat uyuşmazlıklarıdır.

Config.lua Örneği

Aşağıda, Agency-Elevator yapılandırmasının örnek bir temsili yer almaktadır. Koordinatları sunucunuzun haritasına ve bina iç mekanlarına uyacak şekilde uyarlayın:

-- Agency-Elevator: Config.lua

Config = {}

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

-- Show floor markers on the minimap
Config.ShowBlips = false

-- Default floor label shown when no floor is selected
Config.DefaultFloorLabel = "Select Floor"

-- Elevator transition delay in milliseconds (door close → teleport)
Config.TransitionDelay = 1500

-- Enable NUI debug mode (shows borders on the panel)
Config.Debug = false

-- Define your elevators
Config.Elevators = {
    {
        name = "Mission Row PD - Elevator",
        -- Zone where players stand to call the elevator
        trigger = { x = 441.6, y = -982.3, z = 30.7, radius = 1.5 },
        floors = {
            { label = "Ground Floor",    coords = { x = 441.6, y = -982.3, z = 30.7,  h = 90.0 } },
            { label = "2nd Floor",       coords = { x = 441.6, y = -982.3, z = 34.7,  h = 90.0 } },
            { label = "3rd Floor",       coords = { x = 441.6, y = -982.3, z = 38.7,  h = 90.0 } },
            {
                label = "Roof Access",
                coords = { x = 441.6, y = -982.3, z = 50.7, h = 90.0 },
                -- Restrict to police jobs only
                jobRestrict = { "police", "sheriff" },
            },
        },
    },
    {
        name = "Alta Apartments - Elevator",
        trigger = { x = -268.4, y = -955.8, z = 31.2, radius = 1.5 },
        floors = {
            { label = "Lobby",       coords = { x = -268.4, y = -955.8, z = 31.2, h = 0.0  } },
            { label = "Floor 2",     coords = { x = -268.4, y = -955.8, z = 35.2, h = 0.0  } },
            { label = "Floor 3",     coords = { x = -268.4, y = -955.8, z = 39.2, h = 0.0  } },
            {
                label = "Penthouse",
                coords = { x = -268.4, y = -955.8, z = 48.0, h = 0.0 },
                -- Restrict to players who own this item
                itemRestrict = "penthouse_key",
            },
        },
    },
}

Framework Uyumluluğu

Ayar Config.Framework = "standalone" Agency-Elevator'ın QBCore veya ESX'e hiçbir bağımlılığı olmadan çalışmasını sağlar. Kat seçimi ve NUI paneli standalone modda kusursuz çalışır; framework gerektiren tek özellikler, belirli katlardaki isteğe bağlı meslek ve eşya kısıtlama kontrolleridir. Eğer şunu ayarlarsanız Config.Framework = "qbcore" veya "esx", kısıtlanmış bir kat seçildiğinde script, oyuncu mesleklerini ve envanter eşyalarını kontrol etmek için ilgili bridge'i yükler.

Dokümantasyon ve Destek

Tüm yapılandırma seçenekleri, koordinat ipuçları, NUI özelleştirmesi ve SSS dahil eksiksiz dokümantasyona şuradan ulaşabilirsiniz: docs.agencyg.de/elevator. Sorunla karşılaşırsanız Agency Scripts Discord sunucusu, geliştiriciden ve topluluktan destek almanın en hızlı yoludur.

Fiyatlandırma: Tamamen Ücretsiz

Agency-Elevator şu fiyat etiketine sahiptir: ÜCRETSİZ. Hiçbir hile, escrow kilidi, abonelik veya gizli özellikleri açan premium kademe yoktur. Bu makalede açıklanan tüm özelliklere sahip tam script tamamen ücretsizdir. Bu, Agency Scripts'in hem FiveM topluluğuna katkı sağlama hem de Agency Scripts ürün yelpazesinin kalitesini sergileme yoludur. Ücretli script'lerle aynı derleme kalitesini ve aktif bakımı hiçbir ücret ödemeden elde edersiniz.

Bağlam açısından: CFX forumlarındaki birçok benzer asansör kaynağı ya bakımsızdır, ya kapalı kaynaklıdır ya da Agency-Elevator sisteminin ücretsiz sunduğu işlevsellik için birkaç avro talep eder. Maliyet veya kalite endişeleri nedeniyle sunucunuza asansör eklemeyi erteliyorsanız, artık beklemek için hiçbir neden yok.

Agency-Elevator'ı Kimler Kurmalı?

Agency-Elevator, şunlara sahip her FiveM sunucusu için doğru tercihtir:

• Çok katlı iç mekan binaları, hastaneler, polis karakolları, adliyeler, ofis kuleleri, apartman kompleksleri, otoparklar
• Ciddi RP toplulukları rol atmosferine önem veren ve oyuncuların kat değiştirmek için ışınlanmasını veya sohbet komutları kullanmasını istemeyen
• Herhangi bir framework kurulumu, QBCore, ESX veya tamamen özel standalone altyapılar kutudan çıktığı gibi çalışır
• Kısıtlı bütçeye sahip sunucular, hiçbir maliyeti yoktur, bu nedenle kusursuz bir asansör deneyimi için hiçbir finansal engel bulunmaz

Şimdi Başlayın

İndirme sadece bir tık uzağınızda. Tebex ilanını ziyaret edin, ücretsiz ödemeyi tamamlayın, kaynağı sunucunuza bırakın, ekleyin ensure agency-elevator sizin server.cfg, katlarınızı yapılandırın ve hazırsınız. Tek bir bina için tam kurulum genellikle 15 dakikadan az sürer. Ayrıntılı dokümantasyon şu adreste: docs.agencyg.de/elevator rehberliğe ihtiyaç duyarsanız sizi her seçenekte adım adım yönlendirir.