This section covers the script’s integrations, including adapters and bridge files that connect it with other Quasar resources or third-party scripts for better compatibility and smoother server interaction.
Clear Player Inventory
Quasar Inventory has very useful events when emptying a certain player's inventory. This system will apply, for example, to your esx_ambulancejob but can be used in other assets.
Below we will give a brief summary of the use of the ClearInventory export, which allows us to save some items in the event that it is executed. For example, we can execute it when it dies and it loses all the items, except its id_card or its phone, example:
lua
local saveItems = {
'id_card', -- Add here the items that you do NOT want to be deleted'phone',
}
exports['qs-inventory']:ClearInventory(source, saveItems)
To clean up inventories after death, we need to make a series of changes to our esx_ambulancejob or use that reference in your ambulancejob resource.
We will apply the changes in the following event RegisterServerCallback esx_ambulancejob:removeItemsAfterRPDeath as follows:
lua
ESX.RegisterServerCallback('esx_ambulancejob:removeItemsAfterRPDeath', function(source, cb)local xPlayer = ESX.GetPlayerFromId(source)
if Config.RemoveCashAfterRPDeath thenif xPlayer.getMoney() > 0then
xPlayer.removeMoney(xPlayer.getMoney(), "Death")
endif xPlayer.getAccount('black_money').money > 0then
xPlayer.setAccountMoney('black_money', 0, "Death")
endendif Config.RemoveItemsAfterRPDeath thenlocal saveItems = {
'id_card', -- Add here the items that you do NOT want to be deleted'phone',
}
exports['qs-inventory']:ClearInventory(source, saveItems)
endif Config.RemoveWeaponsAfterRPDeath thenlocal weapons = exports['qs-inventory']:GetWeaponList()
for k,v inpairs(weapons) do
xPlayer.removeInventoryItem(v.name, 1 )
endend
cb()
end)
Clothing Items Events
Quasar Inventory now brings a clothing system that was requested by multiple customers in our community, which is based on turning any clothing store into a clothing store with metadata, the metadata will share information between players and each garment will have its own data, allowing us to use different clothes as items.
To use the clothing integration feature, you may need to make a small modification to your clothing system. Many paid clothing systems already include this modification by default, but if not, you can ask the creator of your clothing system for assistance.
Our asset has a loop that continuously checks the player's clothes, ensuring they are always represented as items within the inventory NUI. When opening a clothing store menu, this loop needs to be temporarily stopped using a specific export from our system. Once the menu is closed, the loop can be resumed.
Example: Stopping the clothing loop when opening the store#
When you open the clothing store menu, you need to call the export to stop the loop:
lua
-- Event to open the clothing store
RegisterNetEvent('openClothingStore', function()
exports['qs-inventory']:setInClothing(true) -- Stops the clothing loop
TriggerEvent('your-clothing-system:openMenu') -- Replace with your clothing system's open eventend)
Example: Resuming the clothing loop when closing the store#
When the clothing store menu is closed, you must call the export to resume the loop:
lua
-- Event to close the clothing store
RegisterNetEvent('closeClothingStore', function()
TriggerEvent('your-clothing-system:closeMenu') -- Replace with your clothing system's close event
exports['qs-inventory']:setInClothing(false) -- Resumes the clothing loopend)
Adding Custom Weapons
Quasar Inventory now brings a clothing system that was requested by multiple customers in our community, which is based on turning any clothing store into a clothing store with metadata, the metadata will share information between players and each garment will have its own data, allowing us to use different clothes as items.
First, create a new entry inside Config.CustomWeapons using the weapon’s spawn name as the key (for example, WEAPON_AK47). Inside this entry you can define all the attachments available for that weapon, such as clips, scopes, suppressors, or other components, linking each attachment to its corresponding item name used in your server.
Within the same configuration, you can also control the weapon’s durability by adjusting the numeric value assigned to it, allowing you to define how quickly the weapon degrades with use.
After configuring the weapon in the script, you must also register both the weapon and its attachments in your framework files. Add the attachments as usable items in items.lua, and ensure the weapon exists in weapons.lua, making sure the weapon name matches exactly the one defined in Config.CustomWeapons.
Once everything is saved, restart the server. The custom weapon will then be available in-game with its attachments and durability system fully working.
Give Starter Items
Quasar Inventory integrates a small system of starter items which are an edition for esx, since qbcore has them in an automated way. To add starter items we will have to apply some changes to our esx_identity, which we must already have one integrated into our server natively.
To integrate the native inventory events on starter items, we will search within our esx_identity/client/main.lua for the following callback, which we will use as a guide.
Once all the steps are ready, we will apply the list of starting items within the inventory in qs-advancedinventory/server/custom/framework/esx.lua, where we will have the complete list as an example by default, remember to add items that you have in your qs- advancedinventory/shared/items.lua.
Stash Integration
The stashes in Quasar Inventory are really useful, smart and simple to integrate into other scripts. This system is completely standalone for both esx and qbcore, follow the following steps to integrate it into your other assets.
To integrate a stash, either through export or event, we must have an identification to give to said store, in the case of the examples mentioned it will be lockerID, do not forget to give it the specific value of this identification or use your own identifier for a private stash. If you want to make a completely personal stash, you can use your player's id as the stash id using client-side ESX.GetPlayerData().identifier.
To integrate stashes we have two methods, the basic event without the use of export which is the simplest to apply or the more complex export which can be used both on the client and on the server.
Don't forget to give the values corresponding to the lockerID example, in that case we must modify it for the identification that we will decide to give to the stash or simply delete it and give it a name.
In the case of wanting to integrate it on the client or server side through a faster export, we can execute either of these two events, depending on your situation.
You can also make use of the integration of stores in other assets in a simple way, we will leave an example using command of its basic use, then you yourself can easily integrate it as portable stores or static stores using loops on the client side.
This step is not completely mandatory, but we will teach you how to apply metadata to the weapon_petrolcan of assets like LegacyFuel or similar so that they break when you finish filling a certain amount of gasoline in a car. Quasar Store has an exclusive fuel system called Fuel Stations, which you will find at an exclusive price in our official store. This asset integrates the entire system automatically and has completely impressive functions.
It depends on the version of LegacyFuel you will have to add an event so that it gives you the item since some versions do not bring that natively, use our resource and it will be more functional and faster for you.
The integration is very simple, we will search on the client side for the following code:
This event will point us to the point where we should add our custom event, which will be just below it, make sure not to replace the previous event, simply use it as a guide to place the inventory event.
Quasar Inventory includes a simple system that allows you to open another player’s inventory — useful for actions like searching a suspect, checking a gang member, or inspecting a teammate. This feature can be used in third-party assets, such as police systems, gang scripts, or custom commands.
Here is an example of how to trigger another player’s inventory using the event manually.
You must provide the server ID of the nearby player you want to search, along with an optional config indicating which inventory types can be accessed:
lua
RegisterCommand('search', function(source, args, raw)-- Replace '1' with the player ID you want to search (e.g., from your logic)
TriggerServerEvent('inventory:server:OpenInventory', 'otherplayer', 1, {
type = 'hotbar'-- Options: 'hotbar', 'wallet', or 'all'
})
end)
The system allows different access modes to a player’s inventory. Using 'hotbar', only the items placed in the hotbar will be visible. With 'wallet', it will open wallet-type items such as IDs, cards, or cash. Using 'all', you get full access to the target player’s inventory. You can implement this in any asset or create your own logic to dynamically determine the target player’s ID.
These items cannot be taken from another player's inventory, but they can still be used or dropped manually. That means a player can still drop the item on the ground and give it away, which will not be blocked by the system.
Money Item (QB)
Quasar Inventory integrates an advanced money as item system in which you can use money in item format, the system varies depending on qbcore and esx, but here we will focus on the information for qbcore.
This optional system for qbcore can be enabled by running it from server/custom/framework/qb.lua. To do this we will use the configuration that we will see below:
lua
UseCashAsItem = false-- Choose whether to use money as an item
CashItem = 'cash'-- Choose the money item, it only works if I enable the configurable above
In this configuration we will place whether or not we want to use this system and below the name of the item that will be the money, in this case it is cash. This item must be added in your qb-core/shared/items.lua.
