inventory

O inventory é o recurso central de itens da base. Controla a mochila do jogador (NUI), uso de itens (consumíveis, armamento, munição, anexos, arremessos), drops no chão, transferências, crafting via blueprints, missões, baús de loot e sistemas de roubo. Publica a interface inventory (tabela Core) no servidor e cliente.

A definição dos itens (nome, peso, tipo) NÃO fica aqui, está em @vrp/config/Item.lua. O cálculo de peso e GiveItem/TakeItem/CheckWeight pertencem ao core vRP.

Funcionalidades

Mochila com Peso

Inventário NUI com sistema de peso, slots e itens bloqueados, sincronizado com o core vRP.

Uso de Itens

Consumíveis, armamento, munição, anexos e arremessos, com handlers na tabela Use.

Drops no Chão

Itens largados no mundo, desenhados conforme a distância (DistanceDrops).

Crafting

Receitas via blueprints (blueprint_<item>) definidas na tabela Crafting.

Missões

Missões de troca com requisitos e recompensas, definidas na tabela Missions.

Baús e Roubos

Baús de loot e sistemas de roubo (pontos em Robbery), com explosões e despachos.

Dependências

Tunnels: device, player, garages, survival, keyboard, paramedic. Opcionais (runtime): five-skins, five_logs, discord, five-vehicles, party, hud.

Configuração

shared-side/shared.lua — drops, sprays, crafting, missões, roubo

Sem pasta config/.

DistanceDrops = 25   -- distância (m) p/ desenhar drops no chão

Sprays = { spray_ballas = { "Ballas", 50 }, ... }  -- pichações

Crafting = {                          -- receitas (exige blueprint_<item>)
    medkit = { Amount = 1, Required = { saline = 1, alcohol = 1, gauze = 3 } },
}

Missions = {                          -- missões de troca
    { Xp = 100, Code = "MISSION01", Title = "...", Required = { blue_essence = 10 }, Rewards = { purple_essence = 10 } },
}

Robbery = { { Coords = vec3(...), Mode = "Ammunation" }, ... }  -- pontos de roubo

server-side/core.lua — buffs, produtos e baús

Buffs (Dexterity, Luck), Products (coleta: lixo/cemitério/leiteiro), Loots (baús).

server-side/itens.lua — handlers de uso

Handlers de uso de item na tabela Use, chave = Index do item.

Comandos

Comando	Descrição
`/Inventory`	Abre/fecha a mochila (keymapping padrão ``` / OEM_3).
`/objects <hash>`	(Admin nível 4) coloca prop no mundo.

Exports

exports.inventory:Buffs(Mode, Passport)         -- buff ativo? (Dexterity/Luck)
exports.inventory:CleanWeapons(Passport)        -- limpa anexos/munições
exports.inventory:Blueprint(Passport, Item)     -- blueprint aprendido?
exports.inventory:Drops(Passport, source, Item, Amount, Force, Coords)  -- cria drop
exports.inventory:ExistSkin(Passport, Number)   -- skin pertence ao jogador?
exports.inventory:GeneratePlate()               -- placa única

Eventos

Publica a interface inventory (tabela Core) tanto no servidor quanto no cliente.

Recebidos no servidor

Evento	Descrição
`inventory:Cancel`	Cancela a ação/progresso atual do jogador.
`inventory:Loot`	Saqueia um baú de loot (`Number`, `Box`).
`inventory:SaveArena`	Salva anexos/munições do jogador ao entrar na arena.
`inventory:ApplyArena`	Reaplica anexos/munições salvos da arena.
`inventory:ChangePlate`	Altera a placa de um veículo.
`inventory:StealTrunk`	Furta o porta-malas de um veículo.
`inventory:Animals`	Coleta recursos de animais (caça/abate).
`inventory:Products`	Coleta de produtos por serviço (lixo/cemitério/leiteiro).
`inventory:RemoveTyres`	Remove os pneus de um veículo.
`inventory:Drink`	Bebe (consumo de líquido).
`inventory:RefillGallon`	Reabastece um galão.
`inventory:RefillBottle`	Reabastece uma garrafa.
`inventory:Tow`	Carrega item em reboque (`Vehicle`, `Selected`, `Mode`).
`inventory:Stockade`	Saqueia carro-forte (stockade).
`inventory:Carry`	Carrega outro jogador (corda).
`inventory:ServerCarry`	Processa o carregamento entre dois jogadores (algema).
`inventory:CarryDetach`	Solta o jogador carregado.
`inventory:RobberyActive`	Marca um ponto de roubo como ativo.
`inventory:Robbery`	Inicia o roubo (`Number`, `Mode`).
`inventory:Dismantle`	Desmancha um veículo (`Entity`).
`inventory:Boosting`	Atualiza o status de boosting de uma placa.
`inventory:StoreObjects`	Recolhe objetos/props do mundo.
`inventory:BuffServer`	Aplica buff ao jogador (Dexterity/Luck).
`inventory:SkinPlayer`	Aplica skin de arma ao jogador.
`itemdata:Save`	Persiste o conteúdo de um item gravável (ex.: notepad).
`player:RollVehicle`	Vira/desvira um veículo.
`garages:Delete`	Remove um veículo da garagem (`Network`, `Plate`).
`moneywash:Swap`	Troca/processo de itens da lavagem de dinheiro.
`five-vehicles:vehicleCreated`	Hook ao criar um veículo (associa itens).
`Connect`	Carrega o inventário do jogador ao conectar.
`Disconnect`	Salva/limpa o inventário ao desconectar.
`SaveServer`	Persiste inventários/drops/objetos periodicamente.

Cliente: inventário e NUI

Evento	Descrição
`inventory:Open`	Abre a mochila (NUI).
`inventory:Close`	Fecha a mochila.
`inventory:Update`	Atualiza os itens exibidos na NUI.
`inventory:Notify`	Exibe notificação (`Title`, `Message`, `Type`).
`inventory:Use`	Usa um item (`Slot`, `Amount`).
`inventory:Buttons`	Exibe botões contextuais de ação.
`inventory:CloseButtons`	Oculta os botões contextuais.
`inventory:Blueprint`	Atualiza a tela de blueprints/crafting.

Cliente: drops

Evento	Descrição
`inventory:Drops`	Recebe a lista de drops no chão.
`inventory:DropsAdicionar`	Adiciona um drop.
`inventory:DropsRemover`	Remove um drop.
`inventory:DropsAtualizar`	Atualiza a quantidade de um drop.

Cliente: veículos

Evento	Descrição
`inventory:RepairBoosts`	Repara melhorias/boosts do veículo.
`inventory:RepairTyres`	Repara pneus específicos.
`inventory:RepairDefault`	Reparo padrão do veículo.
`inventory:RepairAdmin`	Reparo administrativo.
`inventory:explodeTyres`	Estoura pneus do veículo.
`inventory:Tow`	Inicia o reboque (cliente).
`inventory:ClientTow`	Aplica o reboque (`Vehicle`, `Selected`, `Mode`).
`dismantle:Reset`	Reseta o estado de desmanche.
`dismantle:Dispatch`	Aciona despacho policial no desmanche.

Cliente: armamento e skins

Evento	Descrição
`inventory:Skins`	Recebe as skins de arma disponíveis.
`inventory:CreateWeapon`	Cria/entrega uma arma.
`inventory:RemoveWeapon`	Remove uma arma.
`inventory:verifyWeapon`	Verifica/sincroniza dados de uma arma.
`inventory:CleanWeapons`	Limpa anexos/munições das armas.
`inventory:Camera`	Controla a câmera para captura de screenshot.
`CEventGunShot`	Evento de jogo (tiro) usado para lógica de armas.

Cliente: drogas (consumo)

Evento	Descrição
`Cocaine`	Aplica efeito de cocaína.
`Methamphetamine`	Aplica efeito de metanfetamina.
`Metadone`	Aplica efeito de metadona.
`Heroin`	Aplica efeito de heroína.
`Crack`	Aplica efeito de crack.
`Joint`	Aplica efeito de baseado.
`Oxycontin`	Aplica efeito de oxicodona.
`Energetic`	Aplica efeito de energético (`Time`, `Multiplier`).

Cliente: diversos

Evento	Descrição
`inventory:Cleaner`	Limpa um ped/objeto.
`inventory:Scuba`	Equipa equipamento de mergulho.
`inventory:ScubaRemove`	Remove o equipamento de mergulho.
`inventory:Explosion`	Cria explosão em coordenadas (roubo).
`inventory:Ration`	Distribui ração (caça).
`moneywash:Init`	Inicializa a interação de lavagem de dinheiro.
`moneywash:Send`	Envia dados de lavagem (`Number`, `Value`).

NUI Callbacks

Callback	Descrição
`BackInventory`	Retorna à mochila principal.
`Close`	Fecha a NUI.
`Use`	Usa um item.
`Send`	Transfere item para outro jogador.
`Store`	Guarda item em um container.
`Take`	Retira item de um container.
`Update`	Solicita atualização dos dados.
`Mount`	Monta/carrega um inventário na interface.
`Blueprint`	Abre a tela de blueprints.
`Crafting`	Executa uma receita de crafting.
`Missions`	Abre/lista as missões.
`RescueMission`	Reivindica/resgata a recompensa de uma missão.

Banco de Dados

Não cria tabelas próprias. Persiste via vRP (playerdata/SetData: Ammos, Attachs, Skins, Blueprints, Missions; entitydata p/ objetos). Manipulação de itens/peso via funções do core vRP.

Customização

Itens: @vrp/config/Item.lua (nome/peso/tipo). Comportamento de uso: tabela Use em server-side/itens.lua.
Crafting/Missões/Roubo/Sprays: shared-side/shared.lua.
Coleta/Baús: Products/Loots em server-side/core.lua.
Peso máximo: core vRP (peso base + Backpack de grupos + mochila no slot 104).

A NUI é um build em web-side/ (sem fonte React). Edições visuais nos arquivos diretos.

Começando

Configuração da Base

Referência Rápida

Recursos

Scripts

Framework vRP

Funcionalidades

Mochila com Peso

Uso de Itens

Drops no Chão

Crafting

Missões

Baús e Roubos

Dependências

Configuração

Comandos

Exports

Eventos

Recebidos no servidor

Cliente: inventário e NUI

Cliente: drops

Cliente: veículos

Cliente: armamento e skins

Cliente: drogas (consumo)

Cliente: diversos

NUI Callbacks

Banco de Dados

Customização

​Funcionalidades

Mochila com Peso

Uso de Itens

Drops no Chão

Crafting

Missões

Baús e Roubos

​Dependências

​Configuração

​Comandos

​Exports

​Eventos

​Recebidos no servidor

​Cliente: inventário e NUI

​Cliente: drops

​Cliente: veículos

​Cliente: armamento e skins

​Cliente: drogas (consumo)

​Cliente: diversos

​NUI Callbacks

​Banco de Dados

​Customização

Funcionalidades

Dependências

Configuração

Comandos

Exports

Eventos

Recebidos no servidor

Cliente: inventário e NUI

Cliente: drops

Cliente: veículos

Cliente: armamento e skins

Cliente: drogas (consumo)

Cliente: diversos

NUI Callbacks

Banco de Dados

Customização