Eşya Kullanım Etkisi API
dream_vending
betiği, oyuncunun bir eşyayı kullandığında nasıl etkilendiğini tanımlamak için merkezi bir sistem olan (DreamCore.Items
) kullanır. Bu API, iyileştirme, animasyonlar veya sarhoşluk gibi görsel etkiler gibi eşyalara kolayca etkiler atamanızı sağlar.
🔧 Kullanım
Eşyayı etkilerle kullanılabilir hale getirmek için, DreamCore.Items
tablosunda bir use
fonksiyonu ile tanımlayın:
DreamCore.Items = {
['mocha'] = { -- Bu, eşyalarınız sisteminde tanımlandığı gibi eşya adıdır (ör. mocha, water, burger)
use = function(playerId)
TriggerClientEvent('dream_vending:client:ApplyItemEffects', playerId, {
-- Etkiler tablo (dizi) olarak iletilir.
{ type = 'addArmor', amount = 2 }, -- Oyuncu önce 2 zırh alacak
{ type = 'drinkAnim', prop = 'ng_proc_coffee_01a' } -- Zırhtan sonra içecek
})
end
},
-- Daha fazla eşya ekleyin ;)
}
💡 Not: Eğer başka bir betik eşyayı yönetiyorsa, basitçe onu
DreamCore.Items
içine dahil etmeyin.
⚙️ Desteklenen Etki Türleri
Aşağıda, dream_vending:client:ApplyItemEffects
etkinliği için desteklenen type
değerlerinin bir listesi bulunmaktadır:
🩺 addHeal
Oyuncunun sağlığını artırır.
{ type = 'addHeal', amount = 10 }
💔 removeHeal
Oyuncunun sağlığını azaltır.
{ type = 'removeHeal', amount = 10 }
🛡️ addArmor
Oyuncunun zırhını artırır.
{ type = 'addArmor', amount = 10 }
💥 removeArmor
Oyuncunun zırhını azaltır.
{ type = 'removeArmor', amount = 10 }
🍔 eatAnim
Yeme animasyonu oynatır. İsteğe bağlı olarak bir prop ayarlayabilirsiniz.
{ type = 'eatAnim', prop = 'prop_cs_burger_01' }
🥤 drinkAnim
İçme animasyonu oynatır. İsteğe bağlı olarak bir prop ayarlayabilirsiniz.
{ type = 'drinkAnim', prop = 'prop_ecola_can' }
🍻 sarhoş
Sarhoş bir görsel ve hareket etkisi uygular.
İsteğe bağlı parametreler:
intensity
(float): Kamera sarsıntı şiddetiveryDrunk
(boolean): Yürüme tarzını değiştirir
{ type = 'drunk', intensity = 1.0, veryDrunk = true }
⏱️ Gecikmeli Etkiler
Bir etkiyi timeout
parametresiyle (milisaniye cinsinden) geciktirebilirsiniz:
{ type = 'addHeal', amount = 10, timeout = 3000 }
💡 İpuçları
- Bir eşyada birden fazla etkiyi bir araya getirebilirsiniz.
- Gerçekçi kalmaya çalışın: Bir viski sadece bir piña colada'dan daha fazla alkol içerir.
- GTA V'de var olan prop'ları kullanın (ör.
prop_ecola_can
,ng_proc_coffee_01a
, vb.). - Özel etkiler mi istiyorsunuz?
ApplyItemEffects
etkinliğine yenieffectType
işleme ekleyin (Kaynak sürümünü satın almanız gerekmektedir).