API Efektów Użycia Przedmiotów

Skrypt dream_vending wykorzystuje scentralizowany system (DreamCore.Items), aby określić, w jaki sposób przedmioty wpływają na gracza podczas użycia. To API umożliwia łatwe przypisanie efektów do przedmiotów, takich jak leczenie, animacje lub efekty wizualne, jak na przykład upojenie alkoholowe.

🔧 Użycie

Aby uczynić przedmiot użytecznym z efektami, zdefiniuj go w tabeli DreamCore.Items z funkcją use:

DreamCore.Items = {
  ['mocha'] = { -- Jest to nazwa przedmiotu zdefiniowana w systemie przedmiotów (np. mocha, water, burger)
    use = function(playerId)
      TriggerClientEvent('dream_vending:client:ApplyItemEffects', playerId, {
        -- Efekty są przekazywane jako lista (tablica) tabel.
        { type = 'addArmor', amount = 2 }, -- Gracz najpierw otrzyma 2 pancerza
        { type = 'drinkAnim', prop = 'ng_proc_coffee_01a' } -- Po pancerzu pije
      })
    end
  },
  
  -- Dodaj więcej przedmiotów ;)
}

💡 Notka: Jeśli inny skrypt zarządza przedmiotem, po prostu nie dodawaj go do DreamCore.Items.

⚙️ Obsługiwane Typy Efektów

Poniżej znajduje się lista obsługiwanych wartości type dla zdarzenia dream_vending:client:ApplyItemEffects:

---

🩺 addHeal

Zwiększa zdrowie gracza.

{ type = 'addHeal', amount = 10 }

---

💔 removeHeal

Zmniejsza zdrowie gracza.

{ type = 'removeHeal', amount = 10 }

---

🛡️ addArmor

Zwiększa pancerz gracza.

{ type = 'addArmor', amount = 10 }

---

💥 removeArmor

Zmniejsza pancerz gracza.

{ type = 'removeArmor', amount = 10 }

---

🍔 eatAnim

Odtwarza animację jedzenia. Opcjonalnie ustaw rekwizyt.

{ type = 'eatAnim', prop = 'prop_cs_burger_01' }

---

🥤 drinkAnim

Odtwarza animację picia. Opcjonalnie ustaw rekwizyt.

{ type = 'drinkAnim', prop = 'prop_ecola_can' }

---

🍻 drunk

Nadaje efekt wizualny i ruchowy upojenia alkoholowego.

Parametry opcjonalne:

• intensity (float): Siła wstrząsów kamery
• veryDrunk (boolean): Zmienia styl chodzenia

{ type = 'drunk', intensity = 1.0, veryDrunk = true }

---

⏱️ Opóźnione Efekty

Możesz opóźnić efekt za pomocą parametru timeout (w milisekundach):

{ type = 'addHeal', amount = 10, timeout = 3000 }

---

💡 Porady

• Możesz łączyć wiele efektów w jednym przedmiocie.
• Staraj się być realistyczny: whisky zawiera więcej alkoholu niż pina colada.
• Używaj rekwizytów, które istnieją w GTA V (np. prop_ecola_can, ng_proc_coffee_01a, itp.).
• Chcesz niestandardowe efekty? Dodaj nowe obsługi effectType do zdarzenia ApplyItemEffects (Musisz zakupić wersję źródłową).