esx_basicneeds
Posted: Thu Feb 26, 2026 6:47 pm
https://github.com/esx-framework/ESX-Le ... basicneeds
This script implements hunger and thirst status, they can be increased when eating bread or drinking water.
Configuration
Config.Visible (deprecated)
type: boolean
default: true
description: Show or hide the hunger and thirst status.
Config.Items
type: table
description: Register Items that can be used as food or drinks.
layout:
resetStatus
Client-Sided: Reset the hunger and thirst status.
TriggerEvent('esx_basicneeds:resetStatus')
healPlayer
Client & Server Sided: Heal the player.
TriggerEvent('esx_basicneeds:healPlayer')
TriggerClientEvent('esx_basicneeds:healPlayer', source)
onUse
Client-Sided: Triggered when the player uses an item.
RegisterNetEvent('esx_basicneeds:onUse', function(itemType, propName, anim, pos, rot)
-- Do something
end)
This script implements hunger and thirst status, they can be increased when eating bread or drinking water.
Configuration
Config.Visible (deprecated)
type: boolean
default: true
description: Show or hide the hunger and thirst status.
Config.Items
type: table
description: Register Items that can be used as food or drinks.
layout:
EventsConfig.Items = {
['item'] = { -- Item name
type = 'food', -- "food" or "drink"
prop = "prop_name",
status = 200000, -- how much status will be increased
remove = true, -- remove item after use
anim = {dict = 'anim_dict', name = 'anim_name', settings = {8.0, -8, -1, 49, 0, 0, 0, 0}}, -- animation for eating/drinking
pos = vector3(0.15, 0.03, 0.0), -- prop position
rot = vector3(15.0, 175.0, 5.0) -- prop rotation
},
}
resetStatus
Client-Sided: Reset the hunger and thirst status.
TriggerEvent('esx_basicneeds:resetStatus')
healPlayer
Client & Server Sided: Heal the player.
TriggerEvent('esx_basicneeds:healPlayer')
TriggerClientEvent('esx_basicneeds:healPlayer', source)
onUse
Client-Sided: Triggered when the player uses an item.
RegisterNetEvent('esx_basicneeds:onUse', function(itemType, propName, anim, pos, rot)
-- Do something
end)