API використання ефектів предметів

Сценарій dream_vending використовує централізовану систему (DreamCore.Items), щоб визначити, як предмети впливають на гравця при використанні. Це API дозволяє легко призначати ефекти предметам, такі як вилікування, анімації або візуальні ефекти, наприклад, сп'яніння.

🔧 Використання

Щоб зробити предмет використовним з ефектами, визначте його в таблиці DreamCore.Items з функцією use:

DreamCore.Items = {
  ['mocha'] = { -- Це назва предмета, визначена в вашій системі предметів (наприклад, mocha, water, burger)
    use = function(playerId)
      TriggerClientEvent('dream_vending:client:ApplyItemEffects', playerId, {
        -- Ефекти передаються як список (масив) таблиць.
        { type = 'addArmor', amount = 2 }, -- Гравець спочатку отримає 2 броні
        { type = 'drinkAnim', prop = 'ng_proc_coffee_01a' } -- Після броні він п'є
      })
    end
  },
  
  -- Додавайте більше предметів ;)
}

💡 Примітка: Якщо інший сценарій керує предметом, просто не включайте його в DreamCore.Items.

⚙️ Підтримувані типи ефектів

Нижче наведений список підтримуваних значень type для події dream_vending:client:ApplyItemEffects:

---

🩺 addHeal

Збільшує здоров'я гравця.

{ type = 'addHeal', amount = 10 }

---

💔 removeHeal

Зменшує здоров'я гравця.

{ type = 'removeHeal', amount = 10 }

---

🛡️ addArmor

Збільшує броню гравця.

{ type = 'addArmor', amount = 10 }

---

💥 removeArmor

Зменшує броню гравця.

{ type = 'removeArmor', amount = 10 }

---

🍔 eatAnim

Відтворює анімацію їжі. Опціонально встановіть реквізит.

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

---

🥤 drinkAnim

Відтворює анімацію пиття. Опціонально встановіть реквізит.

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

---

🍻 drunk

Застосовує візуальний та руховий ефект сп'яніння.

Необов'язкові параметри:

• intensity (число з плаваючою комою): Сила тремтіння камери
• veryDrunk (логічний): Змінює стиль ходи

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

---

⏱️ Затримані ефекти

Ви можете затримати ефект за допомогою параметра timeout (у мілісекундах):

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

---

💡 Поради

• Ви можете накладати кілька ефектів на один предмет.
• Спробуйте залишатися реалістичними: в уиски більше алкоголю, ніж у піна коладі.
• Використовуйте реквізити, які існують у GTA V (наприклад, prop_ecola_can, ng_proc_coffee_01a, тощо).
• Хочете власні ефекти? Додайте нове керування effectType до події ApplyItemEffects (Вам потрібно купити версію з вихідним кодом).