Özelleştirme

Davranış config.lua içindedir. Framework’ünüze, bildirimlerinize veya bir etkinin gerçekte ne yaptığına dokunan her şey, tam da bu nedenle açık bırakılan bridge/ klasöründedir.

Hangi dosya neye karar verir

Dosya veya klasör	Neye karar verir	Açık mı?
`config.lua`	Bu sayfadaki her ayar ve vape listesi	Açık
`locales/*.lua`	Bildirim metinleri, dil başına bir dosya	Açık
`bridge/client_bridge.lua`	İstemcide framework algılama, bildirimler, ilerleme çubuğu ve her etkinin ne yaptığı	Açık
`bridge/server_bridge.lua`	Sunucuda framework algılama, biten bir vape’i kaldırma, envanter kontrolü ve stres kancası `OnVapePuff`	Açık
`bridge/stress.lua`	Stres kancasının eski bir kopyası. Manifest tarafından yüklenmez; bunun yerine `server_bridge.lua` dosyasını düzenleyin	Açık
`client/client.lua`	Vape’i çıkarma, nefes, duman ve senkronizasyonu	Şifreli (escrow)
`server.lua`	Her vape’i kullanılabilir eşya olarak kaydeder ve dumanı aktarır	Şifreli (escrow)
`html/`	İlerleme çubuğu: `index.html`, `style.css`, `script.js`	Düz dosyalar
`stream/`	On vape modeli ve `def_props.ytyp`	Varlıklar
`inventory_items/`	ESX, ox_inventory ve QBCore için hazır eşya tanımları	Referans
`inventory_images/`	Eşya başına bir simge	Varlıklar

Genel ayarlar

Seçenek	Ne yapar	Varsayılan
`Config.Locale`	Bildirimlerin dili	`en`
`Config.ShowNotifications`	Bildirimleri hiç göstermek. Kapalıysa “çıkardı”, “bekleme süresinde”, “boş” veya güç mesajları çıkmaz	`false`
`Config.EnableMaxPuffs`	Vape’ler `puffs` sayılarından sonra biter	`true`
`Config.RemoveVapeCommand`	Vape’i kaldıran sohbet komutu	`vape`
`Config.PuffKey`	Nefes için varsayılan tuş	`E`
`Config.DisableCombatButtons`	Duman çıkarken dövüş düğmelerini (saldırı ve nişan alma) engeller	`true`
`Config.Stress`	Her nefeste stres kancasını çağırır (bkz. Stres)	`true`

Config.PuffKey bir varsayılandır. Nefes, “Vape Puff” adlı bir FiveM tuş atamasıdır; bu yüzden her oyuncu onu Settings › Key Bindings › FiveM altında değiştirebilir ve bir oyuncunun ataması kaydedildikten sonra Config.PuffKey değerini değiştirmek artık onun için bir şeyi değiştirmez.

Can, zırh ve hız

Seçenek	Ne yapar	Varsayılan
`Config.SpeedVapeInfiniteStamina`	Hız etkisi sırasında dayanıklılık azalmaz	`true`
`Config.StaticHealth`	`false`: her can nefesi `Config.Health` ekler. `true`: bir nefes, canı `Config.Health` değerinin altındaysa o değere yükseltir	`false`
`Config.Health`	Eklenen miktar veya yükseltilecek seviye. Statik ayarda oyunun can ölçeği olan 101–200 kullanın	`10`
`Config.StaticArmor`	Zırh için aynı fikir: ekle veya yükselt	`false`
`Config.Armor`	Eklenen miktar veya yükseltilecek seviye (100’e kadar)	`10`

Can her zaman 100 ile 200 arasında, zırh ise 100 veya altında tutulur.

Duman

Seçenek	Ne yapar	Varsayılan
`Config.VapeExhale`	Duman parçacığının boyutu	`0.4`
`Config.SmokeOpacity`	Dumanın ne kadar yoğun olduğu, `0.0` ile `1.0` arası	`1.0`
`Config.SmokeDelay`	Nefes animasyonu ile dumanın görünmesi arasındaki saniye	`1.5`
`Config.Particle`	Hangi parçacığın kullanıldığı: bir `dict` ve bir `name`. `scr_recartheft` içindeki burnout dumanı olarak gelir	`scr_recartheft` / `scr_wheel_burnout`
`Config.SmokeOffset`	Dumanın başa göre nereden başladığı: `PosX`, `PosY`, `PosZ`, `RotX`, `RotY`, `RotZ`	`0.05`, `0.0`, `0.5`, `0`, `0`, `0`

Her bulut 1,5 saniye sürer ve 30 metre içindeki oyunculara gösterilir.

Vape’ler — `Config.Vapes`

Her girdi eşya adı → ayarlar biçimindedir. Hazır gelen tam liste 🎒 Eşyalar sayfasındadır.

Alan	Ne yapar
`prop`	Hangi modelin tutulduğu: `mic_black`, `mic_blue`, `mic_green`, `mic_lightblue`, `mic_orange`, `mic_pink`, `mic_purple`, `mic_red`, `mic_white`, `mic_yellow`
`Label`	İlerleme çubuğunda kullanılan ad
`SmokeColor`	Bir `R`, `G`, `B` rengi veya renk geçişi için `Rainbow` kelimesi
`Cooldown`	Bu vape’in tekrar çekilebilmesi için beklenecek saniye
`puffs`	Bitmeden ve envanterden bir tane alınmadan önceki nefes sayısı
`EffectDuration`	Gücün sürdüğü saniye. Aromalar için `0`
`ShowProgress`	Güç sürerken ilerleme çubuğunu gösterir. Hazır gelen her vape’te kapalıdır
`SpeedMultiplier`	Yalnızca `speed_vape` (sprint) ve `carspeed_vape` (motor) için
`power`	İsteğe bağlı. Birlikte çalıştırılacak etkilerin bir listesi, her birinin kendi sayısıyla (aşağıya bakın)

Bir vape’in hangi etkiye sahip olduğu

Etkiye eşya adı karar verir. invisibility_vape, adı invisibility_vape olduğu için sizi görünmez yapar; power listesi olmayan başka herhangi bir ad bir aromadır.

Bridge’in anladığı etki adları: invisibility_vape, speed_vape, superjump_vape, teleport_vape, invincibility_vape, health_vape (veya health), armor_vape (veya armor), carspeed_vape, freeze_vape, gravity_vape — artı diğerlerinden birini seçen random_vape.

`power` ile etkileri birleştirme

Bir vape’e power listesi verin; vape’in adı ne olursa olsun her nefeste listedeki her etkiyi çalıştırır. Her etkinin yanındaki sayı, health ve armor dışında saniye cinsinden süresidir; bu ikisinde miktardır. Config’deki vape_custom çalışan bir örnektir: 10 can, 10 zırh, 10 saniye hız.

Vape ekleme

Config.Vapes içindeki mevcut bir girdiyi kopyalayın ve ona yeni bir eşya adı verin.
Bir prop, bir SmokeColor, puffs ve Cooldown seçin. Bir güç için ya yukarıdaki etki adlarından birini eşya adı olarak kullanın ya da bir power listesi ekleyin.
Eşyayı diğerleriyle aynı şekilde, bir simgeyle birlikte envanterinize ekleyin.
refresh, ardından restart mic_vape.

Bridge’in anladığı ek etkiler

freeze_vape (hareket edemezsiniz) ve gravity_vape (düşük yerçekimi, daha yavaş hareket) bridge/client_bridge.lua içinde işlenir ve eşya tanımları zaten inventory_items/ içindedir, ancak Config.Vapes içinde girdileri yoktur. Her biri için bir girdi ekleyin — superjump_vape girdisini kopyalayıp adını değiştirin — ve çalışırlar.

transform_vape da eşya dosyalarındadır, ancak hazır gelen config’de bulunmayan bir Config.TransformAnimals listesine ihtiyaç duyar. O listeyi yazıp test etmeye hazır olmadıkça dışarıda bırakın.

Stres

Config.Stress = true iken her nefes, bridge/server_bridge.lua içindeki OnVapePuff fonksiyonunu oyuncunun sunucu ID’siyle çağırır. Hazır haliyle bu fonksiyon yalnızca sunucu konsoluna bir satır yazdırır. İçinde QBCore metadata ve esx_status için yorum satırı örnekler vardır: uygun olanın yorumunu kaldırın veya kendi HUD ya da stres kaynağınızı orada çağırın.

Stres kullanmıyorsanız Config.Stress = false yapın, konsol sessiz kalır.

Diller

locales/ içinde dokuz dosya gelir: en, de, es, fr, it, pl, pt, ru, tr. Birini Config.Locale ile seçin.

Araba hızı vape’i devreye girdiğinde gösterilen car_speed satırı, hazır gelen dosyalarda “No waypoint set!” yazar. Onu kendi dil dosyanızda yeniden ifade edin.

Dil eklemek için: locales/en.lua dosyasını kopyalayın, en üstteki anahtarı kendi kodunuzla değiştirin, çevirin ve dosyayı fxmanifest.lua içinde hem client_scripts hem de server_scripts listesine ekleyin. Config.Locale değerini ayarlayın, refresh yapın ve yeniden başlatın.

Bridge

Sunucunuza bağlı olan her şey bridge/ içindedir.

Dosya	Orada ne değiştirilir
`bridge/client_bridge.lua`	`ShowNotification` — mesajları kendi bildirim kaynağınıza yönlendirin. Etki kodu — bir gücün ne yaptığını değiştirin veya yeni bir etki adı ekleyin. Çubuk için `ShowProgressBar` / `HideProgressBar`
`bridge/server_bridge.lua`	Stres için `OnVapePuff`. Biten bir vape’i kaldırma ve oyuncunun hâlâ onu taşıyıp taşımadığını kontrol etme — ESX veya QBCore’un kendi eşya fonksiyonlarından geçmeyen bir envanter için bu ikisini uyarlayın

Her iki dosya da framework’ü aynı şekilde bulur: başlatılmışsa es_extended, aksi halde qb-core — QBox da QBCore uyumluluğu üzerinden bu şekilde bulunur. Başka bir framework için orada ve yanındaki iki eşya fonksiyonunda bir dal ekleyin.

Komutlar ve tuşlar

Komut veya tuş	Ne yapar	Nerede ayarlanır
Eşyayı kullanmak	Vape’i çıkarır; tekrar kullanmak onu kaldırır	Envanter
E (“Vape Puff”)	Bir nefes çeker	`Config.PuffKey`, ardından her oyuncunun tuş atamaları
`/vape`	Vape’i kaldırır	`Config.RemoveVapeCommand`

Oyuncu artık eşyayı taşımadığında da vape kaldırılır; kaynak bunu her 2,5 saniyede bir kontrol eder.