Ana içeriğe geç

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ı şiddeti
  • veryDrunk (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 yeni effectType işleme ekleyin (Kaynak sürümünü satın almanız gerekmektedir).