mirror of
https://github.com/jimathy/jim_bridge.git
synced 2026-08-17 22:16:03 +01:00
b0b139b179
PS-Inv used to be exactly the same as QB-Inv so alot of the function calls were shared This separates them and makes it easier to make changes to support their inventory Also unified the calls for server side functions into single functions instead of having separate per inventory Also moves: - `invImg()` to inventories.lua - `registerStash()` to stashcontrol.lua
260 lines
8.7 KiB
Lua
260 lines
8.7 KiB
Lua
-------------------------------------------------------------
|
|
-- Item Availability & Inventory Retrieval
|
|
-------------------------------------------------------------
|
|
---
|
|
--- Locks or unlocks the player's inventory.
|
|
--- Freezes/unfreezes the player's position, sets inventory busy state, and toggles hotbar usage.
|
|
---
|
|
--- @param toggle boolean True to lock inventory; false to unlock.
|
|
---
|
|
--- @usage
|
|
--- ```lua
|
|
--- lockInv(true) -- Lock inventory.
|
|
--- lockInv(false) -- Unlock inventory.
|
|
--- ```
|
|
function lockInv(toggle)
|
|
FreezeEntityPosition(PlayerPedId(), toggle)
|
|
LocalPlayer.state:set("inv_busy", toggle, true)
|
|
LocalPlayer.state:set("invBusy", toggle, true)
|
|
TriggerEvent('inventory:client:busy:status', toggle)
|
|
TriggerEvent('canUseInventoryAndHotbar:toggle', not toggle)
|
|
end
|
|
--- Checks if a player has the specified items in their inventory.
|
|
---
|
|
--- Verifies whether the required quantities are present. Returns a boolean and a table of details.
|
|
---
|
|
--- @param items string|table A single item name or table with required amounts.
|
|
--- @param amount number The required quantity (default 1).
|
|
--- @param src number|nil Player source ID (defaults to caller).
|
|
--- @return boolean boolean True if all items are available; otherwise, false.
|
|
--- @return table|nil table Table detailing counts for each item.
|
|
---
|
|
---@usage
|
|
--- ```lua
|
|
--- local hasAll, details = hasItem({"health_potion", "mana_potion"}, 2, playerId)
|
|
--- if hasAll then
|
|
--- -- Proceed with action
|
|
--- else
|
|
--- -- Inform the player about missing items
|
|
--- end
|
|
--- ```
|
|
function hasItem(items, amount, src)
|
|
local amount = amount and amount or 1
|
|
local grabInv, foundInv = getPlayerInv(src)
|
|
if type(items) ~= "table" then items = { [items] = amount and amount or 1, } end
|
|
|
|
if grabInv then
|
|
local hasTable = {}
|
|
for item, amt in pairs(items) do
|
|
if not Items[item] then print("^4ERROR^7: ^2Script can't find ingredient item in Shared Items - ^1"..item.."^7") end
|
|
|
|
local count = 0
|
|
for _, itemData in pairs(grabInv) do
|
|
if itemData and itemData.name == item then
|
|
count += (itemData.count or itemData.amount or 1)
|
|
end
|
|
end
|
|
foundInv = foundInv:gsub("%-", "^7-^6"):gsub("%_", "^7_^6")
|
|
local foundMessage = "^6Bridge^7: ^3hasItem^7[^6"..foundInv.."^7]: "..tostring(item).." ^3"..count.."^7/^3"..amt
|
|
if count >= amt then foundMessage = foundMessage.." ^5FOUND^7" else foundMessage = foundMessage .." ^1NOT FOUND^7" end
|
|
debugPrint(foundMessage)
|
|
hasTable[item] = { hasItem = count >= amt, count = count }
|
|
end
|
|
for k, v in pairs(hasTable) do
|
|
if not v.hasItem then
|
|
return false, hasTable
|
|
end
|
|
end
|
|
return true, hasTable
|
|
end
|
|
end
|
|
|
|
--- Retrieves a player's inventory based on the active inventory system.
|
|
---
|
|
--- @param src number|nil The player source ID (if nil, retrieves current player's inventory).
|
|
--- @return table|nil table The inventory items.
|
|
--- @return string|nil string The name of the inventory system.
|
|
---
|
|
---@usage
|
|
--- ```lua
|
|
--- local inventory, system = getPlayerInv(playerId)
|
|
--- if inventory then
|
|
--- -- Process inventory
|
|
--- end
|
|
--- ```
|
|
function getPlayerInv(src)
|
|
local grabInv = nil
|
|
local foundInv = ""
|
|
|
|
if isStarted(OXInv) then
|
|
foundInv = OXInv
|
|
if src then
|
|
grabInv = exports[OXInv]:GetInventoryItems(src)
|
|
else
|
|
grabInv = exports[OXInv]:GetPlayerItems()
|
|
end
|
|
|
|
elseif isStarted(QSInv) then
|
|
foundInv = QSInv
|
|
if src then
|
|
grabInv = exports[QSInv]:GetInventory(src)
|
|
else
|
|
grabInv = exports[QSInv]:getUserInventory()
|
|
end
|
|
|
|
elseif isStarted(OrigenInv) then
|
|
foundInv = OrigenInv
|
|
if src then
|
|
grabInv = exports[OrigenInv]:getInventory(src)
|
|
else
|
|
grabInv = exports[OrigenInv]:getInventory()
|
|
end
|
|
|
|
elseif isStarted(CoreInv) then
|
|
foundInv = CoreInv
|
|
if src then
|
|
grabInv = exports[CoreInv]:getInventory(src)
|
|
else
|
|
grabInv = exports[CoreInv]:getInventory()
|
|
end
|
|
|
|
elseif isStarted(CodeMInv) then
|
|
foundInv = CodeMInv
|
|
if src then
|
|
grabInv = exports[CodeMInv]:GetInventory(getPlayer(src).citizenId, src)
|
|
else
|
|
grabInv = exports[CodeMInv]:getUserInventory()
|
|
end
|
|
|
|
elseif isStarted(TgiannInv) then
|
|
foundInv = TgiannInv
|
|
if src then
|
|
grabInv = exports[TgiannInv]:GetPlayerItems(src)
|
|
else
|
|
grabInv = exports[TgiannInv]:GetPlayerItems()
|
|
end
|
|
|
|
elseif isStarted(QBInv) then
|
|
foundInv = QBInv
|
|
if src then
|
|
grabInv = Core.Functions.GetPlayer(src).PlayerData.items
|
|
else
|
|
grabInv = Core.Functions.GetPlayerData().items
|
|
end
|
|
|
|
elseif isStarted(PSInv) then
|
|
foundInv = PSInv
|
|
if src then grabInv = Core.Functions.GetPlayer(src).PlayerData.items
|
|
else grabInv = Core.Functions.GetPlayerData().items end
|
|
|
|
elseif ESX and isStarted(ESXExport) then
|
|
foundInv = ESX
|
|
if src then
|
|
local xPlayer = ESX.GetPlayerFromId(src)
|
|
grabInv = xPlayer.inventory
|
|
else
|
|
local xPlayer = ESX.GetPlayerData() -- Client side, if available
|
|
grabInv = xPlayer.inventory
|
|
end
|
|
|
|
elseif isStarted(RSGInv) then
|
|
foundInv = RSGInv
|
|
if src then
|
|
grabInv = Core.Functions.GetPlayer(src).PlayerData.items
|
|
else
|
|
grabInv = Core.Functions.GetPlayerData().items
|
|
end
|
|
|
|
else
|
|
print("^4ERROR^7: ^2No Inventory detected ^7- ^2Check ^3starter^1.^2lua^7")
|
|
end
|
|
return grabInv, foundInv
|
|
end
|
|
|
|
|
|
function isInventoryOpen()
|
|
if isStarted(OXInv) then
|
|
return LocalPlayer.state.invBusy
|
|
|
|
elseif isStarted(QSInv) then
|
|
return exports[QSInv]:inInventory()
|
|
|
|
elseif isStarted(OrigenInv) then
|
|
return exports[OrigenInv]:IsInventoryOpen()
|
|
|
|
elseif isStarted(CoreInv) then
|
|
return exports[CoreInv]:isInventoryOpen()
|
|
|
|
elseif isStarted(CodeMInv) then
|
|
return false
|
|
-- CodeM doesn't have a function to check if the inventory is open
|
|
-- No idea what it uses, so it just skips the check
|
|
|
|
elseif isStarted(TgiannInv) then
|
|
return exports[TgiannInv]:IsInventoryActive()
|
|
|
|
elseif isStarted(QBInv) then
|
|
return LocalPlayer.state.inv_busy
|
|
|
|
elseif isStarted(PSInv) then
|
|
return LocalPlayer.state.inv_busy
|
|
|
|
elseif ESX and isStarted(ESXExport) then
|
|
return false
|
|
|
|
elseif isStarted(RSGInv) then
|
|
return LocalPlayer.state.inv_busy
|
|
|
|
end
|
|
end
|
|
|
|
-------------------------------------------------------------
|
|
-- Item Image Retrieval
|
|
-------------------------------------------------------------
|
|
|
|
--- Retrieves the NUI link for an item's image from the active inventory system.
|
|
---
|
|
--- @param item string The item name.
|
|
--- @return string string A `nui://` link to the item's image, or an empty string if not found.
|
|
---
|
|
--- @usage
|
|
--- ```lua
|
|
--- local imageLink = invImg("health_potion")
|
|
--- if imageLink ~= "" then print(imageLink) end
|
|
--- ```
|
|
function invImg(item)
|
|
local imgLink = ""
|
|
if item ~= "" and Items[item] then
|
|
if isStarted(OXInv) then
|
|
imgLink = "nui://"..OXInv.."/web/images/"..(Items[item].image or "")
|
|
|
|
elseif isStarted(QSInv) then
|
|
imgLink = "nui://"..QSInv.."/html/images/"..(Items[item].image or "")
|
|
|
|
elseif isStarted(CoreInv) then
|
|
imgLink = "nui://"..CoreInv.."/html/img/"..(Items[item].image or "")
|
|
|
|
elseif isStarted(CodeMInv) then
|
|
imgLink = "nui://"..CodeMInv.."/html/itemimages/"..(Items[item].image or "")
|
|
|
|
elseif isStarted(OrigenInv) then
|
|
imgLink = "nui://"..OrigenInv.."/html/img/"..(Items[item].image or "")
|
|
|
|
elseif isStarted(QBInv) then
|
|
imgLink = "nui://"..QBInv.."/html/images/"..(Items[item].image or "")
|
|
|
|
elseif isStarted(PSInv) then
|
|
imgLink = "nui://"..PSInv.."/html/images/"..(Items[item].image or "")
|
|
|
|
elseif isStarted(TgiannInv) then
|
|
imgLink = "nui://inventory_images/images/"..(Items[item].image or "")
|
|
|
|
elseif isStarted(RSGInv) then
|
|
imgLink = "nui://"..RSGInv.."/html/images/"..(Items[item].image or "")
|
|
|
|
else
|
|
print("^4ERROR^7: ^2No Inventory detected for invImg - Check starter.lua")
|
|
end
|
|
end
|
|
return imgLink
|
|
end |