🇺🇸 ABOUT THIS FILE (ultimate edition)
Title: Custom Gunrack & Scene Management (In-Game Editor, Limits & Independent Audio)
Overview:
Custom Gunrack is a highly immersive, feature-rich, and advanced weapon, gear, and scene management plugin for LSPDFR. Access your arsenal directly from your cruiser's trunk or from inside the vehicle. Powered by a rock-solid RAGENativeUI infrastructure, this mod completely eliminates legacy scrolling glitches and clutter by organizing everything into professional submenus. With an integrated in-game configuration editor, custom weapon registry, tactical scene equipment, and a hardware-direct audio bypass engine, this mod delivers the ultimate sandbox experience for your patrol.
🌟 Key Features:
1. Structured Submenu Layout & Clean UI
No More Clutter: Say goodbye to endless messy lists. Eklenti features a beautifully structured menu layout grouped under categorized submenus: "Weapons," "Armor," and "Utility."
Anti-Flicker Scrolling: Completely rewrote the menu engine to solve legacy flickering/flashing bugs during scrolling. It is now buttery smooth and perfectly safe for sensitive eyes.
Live Status Badges: Weapon slots stream live inventory data, displaying sharp green
~g~TAKEor red~r~RETURNstatus labels instantly based on what you are currently carrying.
2. Dynamic Custom Weapon (Add-on) & Attachment Editor
In-Game Custom Weapon Registry: You are no longer locked into basic standard weapons. Use the
[+] Add Custom Weaponprompt to add ANY vanilla or custom Add-on weapon (e.g., Pump Shotgun MK2, Heavy Revolver, or modded firearms) with its specific class category directly via the on-screen keyboard.Weapon-Specific Attachment Libraries: Add custom attachment names and component hash codes (
COMPONENT_...) to your custom weapons via checkboxes. The mod auto-saves preferences and equips attachments automatically whenever you retrieve the weapon.Live Configuration Purger: A fully operational developer tool layer. Press
Ctrl + ENTERover any entry to open a live name/hash editor, or pressShift + ENTERto permanently wipe unwanted entries from your INI configurations instantly.Clipboard Integration: Easily copy
WEAPON_orCOMPONENT_strings from your browser; the on-screen keyboard parses the Windows clipboard and auto-pastes it for you.
3. Realism-Driven Inventory Limits & Proximity Locks
Category Class Restrictions: Enforce realism on duty with strict carrying capacities for rifles, shotguns, SMGs, snipers, and pistols. If your rifle limit is set to 1, taking a new rifle from the trunk automatically puts your current rifle back onto the rack, keeping your weapon wheel clean.
Smart Distance Exemption: The Utility menu remains open at any distance so you can securely block roads. However, magic-spawning firearms or refilling armor from afar is strictly locked, triggering an emergency warning: “You must be near the trunk or gunrack to take/return weapons!”
4. Tactical Gear & Scene Equipment
Traffic Control Objects: Secure active perimeters by deploying Traffic Cones and Police Barriers directly at your feet. Built with a strict memory safety loop (5 active props max; the oldest automatically de-spawns to protect FPS).
Spike Strips: Deploy up to 4 persistent spike strips during pursuits to stop fleeing suspects.
Medical Kit & Energy Bar: Use the medkit to fully restore health/armor or consume an energy bar for a +15% sprint speed boost and infinite stamina for 60 seconds.
Standard Issue Gear: Quickly grab or return your Taser, Fire Extinguisher, Heavy Flashlight, or full 100% Armor + Tactical Helmet.
⚙️ Technical Details (Under the Hood):
Independent Hardware Audio Engine: Overhaul mods like RealisticHolster, DeadlyWeapons, and Axon Bodycam tend to freeze and mute GTA V's native internal Frontend sound channels. To bypass this entirely, this eklenti executes an asynchronous hardware audio injector that pushes sound waves directly through your Windows sound card. Highly crisp, un-mutable custom
.wavtracks are triggered for racking weapons (rack.wav), returning weapons (return.wav), and equipping armor (armor.wav).Auto-Sync Engine: Runs a silent background scanner every 2 seconds on duty. It detects your equipped firearms and automatically forces your INI-saved attachments onto them, overriding LSPDFR's barebones default weapon loadouts.
Fully Configurable Keybinds: Fully customizable key structures. Supports
ModifierKeyconfigurations in the INI file, allowing combinations likeLeftShiftKey + CapsLockto avoid keybind conflicts.
🇹🇷 BU DOSYA HAKKINDA (nihai sürüm)
Başlık: Custom Gunrack & Olay Yeri Yönetimi (Oyun İçi Editör, Sınırlandırmalar & Bağımsız Ses Motoru)
Genel Bakış:
Custom Gunrack, LSPDFR için geliştirilmiş son derece gerçekçi, hafif ve gelişmiş bir silah, ekipman ve olay yeri yönetim eklentisidir. Cephaneliğinize doğrudan devriye aracınızın bagajından veya araç içinden erişin. Güçlü bir RAGENativeUI altyapısı ile donatılan bu mod, eski sürümlerde yaşanan ekran kırpışmalarını tamamen yok ederek her şeyi profesyonel alt menüler altında toplar. Oyun içi konfigürasyon editörü, özel Add-on silah ekleme paneli, taktiksel olay yeri ekipmanları ve oyun motorunu baypas eden donanımsal ses motoru sayesinde devriyelerinizde eksiksiz bir rol deneyimi sunar.
🌟 Temel Özellikler:
1. Kategorize Edilmiş Düzenli Arayüz
Sıfır Karmaşa: Tüm eşyaların tek listede yüzünüze fırlatıldığı eski düzen bitti. Eklenti; "Weapons (Silahlar)", "Armor (Zırhlar)" ve "Utility (Araç-Gereç)" alt menüleri ile kusursuz bir düzen sunar.
Kırpışmasız Akıcı Gezinme: Menüde aşağı/yukarı kaydırma yaparken yaşanan göz yorucu ekran kırpışmaları (flickering) yeni mimariyle tamamen çözülmüştür. Epilepsi hastaları ve hassas gözlü oyuncular için tamamen kararlıdır.
Canlı Durum Etiketleri: Silah satırları envanterinizi anlık olarak tarayarak, üzerinizdeki silahlara göre yeşil renkli
~g~TAKE(AL) veya kırmızı renkli~r~RETURN(BIRAK) rozetlerini dinamik olarak günceller.
2. Özel Silah (Add-on) & Eklenti Oyun İçi Editörü
Oyun İçinden Silah Ekleme: Standart silahlara mahkum değilsiniz.
[+] Add Custom Weaponpaneliyle, oyundaki klavye ekranını kullanarak dilediğiniz özel veya modlu Add-on silahı kod adıyla ve kategorisiyle sisteme anında ekleyebilirsiniz.Silaha Özel Eklenti (Attachment) Kütüphanesi: Eklediğiniz her özel silahın altına; fener, susturucu, dürbün gibi eklentileri (
COMPONENT_...) checkbox mantığıyla kaydedebilirsiniz. Mod, tercihlerinizi INI dosyasına yazar ve silahı bagajdan her aldığınızda otomatik takılı getirir.Gelişmiş Canlı Düzenleme Paneli: Menüdeki bir nesne üzerindeyken
Ctrl + ENTER(Düzenle) yaparak canlı olarak isim/kod değiştirebilir,Shift + ENTER(Sil) yaparak harici dosyalara dokunmadan o silahı veya eklentiyi tüm INI kayıtlarından tek salisede kazıyabilirsiniz.Gelişmiş Panodan Yapıştırma: Tarayıcıdan kopyaladığınız
WEAPON_veyaCOMPONENT_kodları, oyun içi klavye açıldığında Windows panosundan otomatik okunarak girdi alanına saniyeler içinde yapıştırılır.
3. Gerçekçi Envanter Limitleri & Mesafe Bariyeri
Kategori Bazlı Silah Sınırı: Devriye sırasında gerçekçiliği artırmak için tüfek, pompalı, SMG, sniper ve tabancalar için taşıma limitleri getirildi. Örneğin tüfek limitiniz 1 ise, bagajdan yeni bir tüfek aldığınızda elinizdeki eski tüfek otomatik olarak bagaj rafına geri bırakılır.
Akıllı Mesafe Kilidi: Oyuncu araçtan uzaklaşsa bile yola duba/çivi dizebilsin diye Utility menüsü açık kalır. Ancak, araçtan uzaktayken bagajdan hileyle tüfek çekmek veya medkit basmak kilitlenmiştir ve uzaktan basıldığında ekranda kırmızı renkli “You must be near the trunk or gunrack...” uyarısı çıkar.
4. Taktiksel Ekipmanlar & Olay Yeri Yönetimi
Yol Kapatma Ekipmanları: Güvenli bir çevre şeridi oluşturmak için yere Traffic Cone (Duba) ve Police Barrier (Polis Bariyeri) yerleştirebilirsiniz. Harita performansını korumak için maksimum 5 aktif nesne sınırı konulmuştur (En eskisi otomatik silinir).
Çivi Tuzağı (Spike Strip): Kovalamacaları bitirmek için yere 4 adede kadar kalıcı çivi tuzağı serebilirsiniz.
İlk Yardım & Enerji Barı: Can/zırh doldurmak için medkit kullanabilir veya 60 saniye boyunca %15 depar hızı artışı ile sınırsız nefes almak için enerji barı tüketebilirsiniz.
Standart Ekipmanlar: Şok Cihazı (Taser), Yangın Söndürücü, Ağır El Feneri veya %100 Çelik Yelek + Taktiksel Kask seçeneklerine tek tıkla erişin.
⚙️ Teknik Detaylar:
Bağımsız Donanımsal Ses Motoru: RealisticHolster, DeadlyWeapons ve Axon Bodycam gibi ağır modlar oyunun dahili ses kanallarını kilitler ve diğer eklentilerin seslerini yutar. Bu engeli aşmak için, sesler oyun motorundan tamamen bağımsız, asenkron bir
Task.Rundöngüsüyle doğrudan Windows ses kartı sürücünüz üzerinden kulaklığa basılır. Silah alma (rack.wav), silahı bagaja koyma (return.wav) ve zırh kuşanma (armor.wav) sesleri harici dosyalarla tamamen ayrıştırılmıştır.Otomatik Senkronizasyon (Auto-Sync) Motoru: Göreve çıktığınızda arka planda her 2 saniyede bir sessizce çalışır. Elinizdeki silahları tarar ve INI dosyanızdaki kayıtlı eklentilerinizi (fener, şarjör vb.) silaha anında entegre ederek LSPDFR'ın boş silah verme sorununu çözer.
Gelişmiş Tuş Kombinasyonları: INI dosyasındaki
ModifierKeyseçeneği sayesinde menüyü açmak içinLeftShiftKey + CapsLockgibi çift tuş kombinasyonları atayabilir, diğer modların tuş çakışmalarını engelleyebilirsiniz.
Edited by v0ed
Brand new RAGENativeUI infrastructure, in-game custom weapon/attachment editor, tactical scene equipment (cones/barriers), proximity locks, and a hardware-direct independent audio engine fix.
What's New in Version 1.0.1
Released
🇺🇸 THE GRAND OVERHAUL UPDATE (v1.0.1 - Ultimate Edition)
Based directly on community feedback and rigorous user testing, the legacy single-list layout has been completely deprecated. The plugin has been completely rewritten under a brand-new dynamic RAGENativeUI framework to deliver a premium, seamless tactical sandbox experience.
🛠️ Resolved Legacy Issues (Feedback Bug Fixes)
Menu Flashing & Flickering Defeated: The annoying glitch where the menu would quickly blink/disappear during scrolling has been entirely eradicated thanks to the new RNUI drawing infrastructure. Navigation is now buttery smooth and 100% safe for players with sensitive eyes or epilepsy.
Reliable Single-Tap Initialization: Fixed the dual-input glitch that forced users to press the toggle key twice. The menu now triggers reliably and instantly upon a single key press (e.g., CapsLock).
Keyboard Focus Protection: Integrated robust state locks (
_isKeyboardActive) to ensure that native keyboard overlays (DISPLAY_ONSCREEN_KEYBOARD) freeze background inputs, preventing duplicate UI overlaps or overlapping window crashes upon pressingESC.
📦 Clean Submenu Categorization (Goodbye Clutter!)
Structured UI Flow: Having every firearm and piece of equipment pushed onto a single flat list is a thing of the past. Utilizing our backend
_groupingEnabledlogic, items are now beautifully organized into standalone submenus: "Weapons," "Armor," and "Utility."Dynamic Inventory Status Labels: All firearm entries dynamically stream their status from the player's real-time inventory, showcasing a green
~g~TAKEor a red~r~RETURNlabel instantly.
🔫 Next-Gen Custom Weapon (Add-on) & Attachment Editor
In-Game Custom Weapon Registry: Full support for custom, overwritten, and custom Add-on firearms has been coded from scratch. Via the
[+] Add Custom Weaponpanel, players can type any custom weapon string and assign it to its designated limit class.Weapon-Specific Attachment Libraries: Each custom weapon hosts its own standalone attachment submenu. Components (Suppressors, flashlights, scopes) are managed via robust checkbox hooks, mapped directly into the INI file, and auto-load seamlessly whenever the firearm is retrieved.
Live Configuration Purger: Added a fully operational developer tool layer. Pressing
Ctrl + ENTERover any item opens a live rename editor, while pressingShift + ENTERcompletely purges all corresponding data strings from the INI file, refreshing the active menu matrix instantly.
🚓 Tactical Scene Management & Proximity Barriers
All-New Scene Equipment: Introduced deployable
Traffic ConesandPolice Barriersto secure active perimeters. Engineered a strict memory safety loop (MaxTrafficObjects = 5) ensuring older objects automatically clean up to preserve game performance.Proximity Exemption for Utilities: The Utility menu features distance immunity, allowing officers to deploy spike strips or cones far away from their cruiser. However, magic-spawning rifles or refilling health from afar is strictly locked, outputting a red warning text: "You must be near the trunk or gunrack..."
Dynamic Inventory Class Restrictions: Implemented class-based inventory thresholds (
_maxRifles,_maxShotguns). If a limit is breached, the plugin's priority loop forces the character to return the currently owned class firearm back to the rack before issuing the new asset.
🔊 Independent Hardware Audio Engine
Native Audio Mute Bypass: Diagnosed a deep engine restriction where heavy-duty scripts (RealisticHolster, DeadlyWeapons, Axon Bodycam) completely seized and muted GTA V's native internal sound channels.
Windows Audio Hardware Injection (
System.Media): Bypassing the native engine completely, audio effects are pushed directly to the Windows sound driver layer via an asynchronousTask.Runloop. This guarantees that sound waves are processed directly via hardware without being intercepted by game scripts. Highly crisp, un-mutable audio responses are now triggered for racking weapons (rack.wav), returning weapons (return.wav), and donning tactical vests (armor.wav).Smart Clipboard Injection: To aid usability, any
WEAPON_orCOMPONENT_string copied to the Windows Clipboard prior to opening the prompt is parsed and auto-pasted directly into the text field.
----------------🇹🇷 BÜYÜK YENİLENME VE EVRİM GÜNCELLEMESİ (v1.0.1 - Nihai Sürüm)
Topluluğumuzdan ve oyunculardan gelen harika geri bildirimler doğrultusunda, eklentinin eski sürümündeki tüm kronik optimizasyon pürüzleri giderilmiş ve mod baştan aşağı yeniden yazılarak RAGENativeUI destekli yepyeni bir dinamik menü altyapısına taşınmıştır.
Aşağıda, ilk sürüme kıyasla koda eklenen tüm devrimsel yenilikler ve oyuncu isteklerine verilen mekanik yanıtlar listelenmiştir:
🛠️ Çözülen Kronik Sorunlar (Bug Fixes)
Pürüzsüz Menü Akışı (Anti-Flicker): Eski menü altyapısında aşağı/yukarı kaydırma yaparken veya tuşları basılı tutarken menünün saliselik yok olup geri gelmesi (flashing/flickering) sorunu yeni RNUI mimarisi ile tamamen çözülmüştür. Epilepsi hastaları ve hassas gözlü oyuncular için %100 güvenli ve akıcı bir gezinme sağlandı.
Tek Tıkla Kararlı Açılış: Menüyü ekrana getirmek için tuşa inatla iki kez basma zorunluluğu (Double-tap bug) tamamen ortadan kaldırılmıştır. Eklenti artık CapsLock veya atanan anahtar tuşa tek bir basışta anında açılır.
Klavye Çakışma Koruması: Oyun içi klavye (
DISPLAY_ONSCREEN_KEYBOARD) ekranı etkinken menü girdilerinin arkada bugda kalması veyaESCtuşuna basıldığında menülerin üst üste binmesi (CloseAllMenusveBuildMenusoptimizasyonları ile) kökten engellendi.
📦 Yeni Kategori ve Alt Menü Düzeni (Clutter Fix)
Kategorize Edilmiş Temiz Arayüz: Tüm silahların ve eşyaların tek bir ekranda oyuncunun yüzüne fırlatıldığı eski düzensiz yapı tamamen terk edildi. Kodumuza entegre edilen
_groupingEnabledmantığıyla, eşyalar "Weapons (Silahlar)", "Armor (Zırhlar)" ve "Utility (Araç-Gereç)" alt menüleri altında profesyonelce gruplandı.Canlı Durum Bilgisi (Dynamic Labels): Silahların sağ tarafında anlık olarak oyuncunun envanter durumuna göre yeşil renkli
~g~TAKEveya kırmızı renkli~r~RETURNetiketleri dinamik olarak güncellenir.
🔫 Gelişmiş Özel Silah (Add-on) & Eklenti Editörü
Oyun İçinden Özel Silah Ekleme: Oyuncuların en çok istediği Add-on/Modlu silah desteği sıfırdan koda işlendi.
[+] Add Custom Weaponbutonuyla, oyun içinden istenen her silah kod adı ve kategorisiyle sisteme dahil edilebilir.Silaha Özel Eklenti (Attachment) Kütüphanesi: Eklenen her özel silahın altına oyun içinden dinamik olarak fener, susturucu, dürbün (
COMPONENT_...) gibi eklentiler checkbox mantığıyla eklenebilir. Eklentiler INI dosyasına kalıcı olarak yazılır ve silah her alındığında otomatik takılı gelir.Gelişmiş Düzenleme Paneli: Silahlar ve eklentiler üzerinde
Ctrl + ENTER(Düzenleme) yapıldığında canlı olarak isim/kod değiştirilebilir;Shift + ENTER(Kalıcı Silme) yapıldığında ise harici dosyalara dokunmadan ilgili tüm INI satırları tek salisede kazınır.
🚓 Taktiksel Olay Yeri Yönetimi & Limit Bariyerleri
Yeni Alan Güvenliği Ekipmanları: Bagaj menüsüne yol kapatma operasyonları için
Traffic Cone(Duba) vePolice Barrier(Polis Bariyeri) eklendi. Harita limitlerini korumak için maksimum 5 nesne sınırı (MaxTrafficObjects) konuldu ve en eskisinin otomatik silinmesi sağlandı.Akıllı Mesafe Bariyeri: Oyuncu araçtan uzaklaşsa bile yola duba/çivi dizebilsin diye Utility menüsü açık kalır. Ancak, gerçekçilik gereği araçtan uzaktayken bagajdan silah çekmek veya medkit basmak engellenmiştir. Uzaktan silah alınmaya çalışıldığında kırmızı renkli uyarı geçilir.
Kategori Tabanlı Envanter Limiti: Oyuncunun üstünde taşıyabileceği silah sayısını dengelemek için kategori tabanlı limitler (
_maxRifles,_maxShotgunsvb.) getirildi. Örneğin; tüfek limiti 1 ise, bagajdan yeni bir tüfek alındığında üstteki eski tüfek otomatik olarak bagaja bırakılır.
🔊 Bağımsız Donanım Ses Motoru (Audio Engine Overhaul)
Oyun Motoru Ses Blokajı Baypası: RealisticHolster, DeadlyWeapons ve Axon Bodycam gibi ağır modların oyunun dahili ses kanallarını (
PLAY_SOUND_FRONTEND) kilitlemesi ve eklentimizin seslerini yutması sorunu tamamen baypas edildi.Windows Audio Entegrasyonu (
System.Media): Sesler oyun motorundan tamamen bağımsız olarakTask.Runasenkron döngüsüyle doğrudan Windows ses sürücüsü üzerinden kulaklığa basılır. Bu sayede oyun içi modlar ne kadar yoğun olursa olsun seslerin kesilmesi engellenmiştir. Silah alma (rack.wav), silahı bagaja koyma (return.wav) ve çelik yelek giyme (armor.wav) ses profilleri birbirinden tamamen bağımsız harici dosyalara dönüştürüldü.Gelişmiş Panodan Yapıştırma (Clipboard): Geliştiriciler ve oyuncular için tarayıcıdan kopyalanan
WEAPON_veyaCOMPONENT_kodları, oyun içi klavye açıldığında panodan otomatik okunarak girdi alanına otomatik yapıştırılır.
MEDIA:
Short Description
AI disclosure
The author has disclosed that AI tools were used in creating the following aspects of this file:
- Description
- Images
- Mod and Mod Content (Moderate)
Testing: v0ed
Documentation: v0ed
Generative AI was used to assist with code optimization, formatting, and documentation.
Recommended Comments
Create an account or sign in to comment