MACH & ONYX FiveM Functions
TODO #
NORMAL BLIPS in blip function
Usable items #
This function replaces the need to add the snipped bellow for every item you want to use, the items still need to to be IN THE DATABASE.
ESX.RegisterUsableItem('fishbait', function(source) //fishbait db item name
local xPlayer = ESX.GetPlayerFromId(source)
xPlayer.removeInventoryItem('fishbait', 1) //fishbait is item name in db
TriggerClientEvent('esx_status:add', source, 'hunger', 8000) //fill food
TriggerClientEvent('esx_basicneeds:onEat', source)
TriggerClientEvent('esx:showNotification', source, _U('used_fishbait'))
//used_fishbait (for translations)
end)
Head to the useable items section in the cfg file.
About the file #
1)Function Name - Usable Items
2)Script Location - server/usableitems.lua (Tebex encrypted)
3)Description - This allows you to add useable items in a simpler config file, rather than having to add 500 Useable item chunks as above
4)UseableItemsDebug - Set this to true to print item registration attempts to the SERVER CONSOLE
5)Note this uses the default ESX Notification, you can change this in “resources\es_extended\client\functions.lua” (which is a good way of globally updating this)
6)The numbers is these docs are low for formatting reasons, 250000 is a reasonable number, 250 IS NOT
Syntax #
Food #
DBName - The item name in the database
Type - Always “food” (lowercase)
Hunger - How much hunger to fill 250000 is about a quarter under normal settings
OnUseNotify - What text to display when used
{dbname = "burger",type="food",hunger=250000,OnUseNotify="Hmmm Burger"},
Drink #
DBName - The item name in the database
Type - Always “drink” (lowercase)
Thirst - How much Thirst to fill 250000 is about a quarter under normal settings
OnUseNotify - What text to display when used
{dbname = "icedtea",type="drink",thirst=250,OnUseNotify="Cold Tea? Are you high?"},
Alcohol #
DBName - The item name in the database
Type - Always “alcohol” (lowercase)
Thirst - How much Thirst to fill 250000 is about a quarter under normal settings
Drunkness - How Drunk to get someone, 100000 is a good value
OnUseNotify - What text to display when used
{dbname = "whiskey",type="alcohol",thirst=250,drunkness=300,OnUseNotify="Hmmm"},
Meal #
DBName - The item name in the database
Type - Always “meal” (lowercase)
Hunger - How much hunger to fill 250000 is about a quarter under normal settings
Thirst - How much Thirst to fill 250000 is about a quarter under normal settings
OnUseNotify - What text to display when used
{dbname = "the_works",type="meal",hunger=300,thirst=320,OnUseNotify="Yummy!"},
This should then look like this #
UseableItemsDebug = false,
UseableItems = {
{dbname = "burger",type="food",hunger=250,OnUseNotify="Hmmm Burger"},
{dbname = "icedtea",type="drink",thirst=250,OnUseNotify="Cold Tea?"},
{dbname = "whiskey",type="alcohol",thirst=250,drunkness=300,OnUseNotify="Hmmm"},
{dbname = "the_works",type="meal",hunger=300,thirst=320,OnUseNotify="Yum"},
},
--Note, set to low numbers for formatting reasons, 250000 is much better choice
Blips #
This script allows you to add radial (Circle) Zones, Area (Square) Zone and Blips
Head to the Blips section in the cfg file.
About the file #
1)Function Name - Blips
2)Script Location - client/blips.lua (Tebex encrypted)
3)Description - This allows you to add blips are zones to the map
4)Blip- Set this to true to print Blip creation attempts to CLIENT Console