From 0ae1f372424bfa748e1fbaf179b685368b1f742f Mon Sep 17 00:00:00 2001 From: Jim Shield Date: Wed, 25 May 2022 10:34:05 +0100 Subject: [PATCH] Update README.md --- README.md | 24 +++++++++++++++++++++++- 1 file changed, 23 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 1f3a883..0916a66 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,27 @@ # jim-consumables Consumables script for QBCore +# What is this? +This script is designed as a replacement/override for food and drink consumables in qb-smallresources -Call this a PRE Alpha. The base is here but needs alot fixing up. Don't recommend it to be used in a live enviroment yet. +It's main purpose was to make it possible to not stand up while sitting due to lazy events such as ClearPedTasks in most scripts, this one is designed to cancel the animation you have chosen, not all animations. This includes progressbar. + +# Installation +This script is recommended to be ran last/at the bottom of your server.cfg because this is intended to take control of items, if ran too early the original script may override this one. + +It already takes control of default qbcore food and drink, but you would probably want to add more. + +To add an item, you only need to add a new item table in the Config.Consumables like this: +```lua + ["heartstopper"] = { + emote = "burger", -- Select an emote from below, it has to be in here + stress = math.random(1,2), -- Amount of stress relief, can be 0 + heal = 0, -- Set amount to heal by after consuming + armor = 5, -- Amount of armor to add + type = "food", -- Type: "alcohol" / "drink" / "food" + effect = { effect = "healdouble", }, -- The status effect given by the item, "heal" / "healdouble" / "stamina" + stats = { hunger = math.random(10,20), }, -- The stats of the item, if not found in the items.lua + }, +``` + +This script supports dpemotes style emotes, so if you have some that you want to be triggered when eating or drinking drop it in the Config.Emotes