Adicionando Itens

Todos os itens da base são definidos em um único arquivo, a fonte da verdade para qualquer recurso:

resources/vrp/config/Item.lua

Esse arquivo declara uma tabela List, onde cada chave é o “spawn” (nome interno) do item. Esse spawn é o identificador usado em todo o servidor: comandos de admin, receitas de crafting, lojas, baús, inventário. Quando um recurso precisa dar/remover/checar um item, ele usa essa chave (ex.: "repairkit01", "water", "copper"). Outros recursos também podem registrar itens em runtime sem editar o Item.lua:

AddEventHandler("AddItem", function(Name, Table)
    List[Name] = Table
end)

A chave do item (spawn) não precisa ser igual ao campo Index. Vários itens reaproveitam o mesmo Index (e a mesma imagem) com spawns diferentes, ex.: spray_ballas, spray_vagos usam Index = "sprays".

Estrutura de um item

Exemplo real do arquivo (repairkit02):

["repairkit02"] = {
    Index = "repairkit02",
    Name = "Kit de Reparos",
    Description = "Solucione problemas com facilidade...",
    Rarity = "rare",
    Type = "Comum",
    Weight = 3.75,
    Economy = 875,
    Recycle = {
        ["scotchtape"] = 1,
        ["copper"] = 10,
        ["aluminum"] = 12
    }
},

Campos suportados:

Campo	Tipo	Significado
`Index`	string	Identificador da imagem (`ItemsURL .. Index`). Pode ser compartilhado.
`Name`	string	Nome exibido.
`Description`	string	Descrição. Aceita HTML básico e tags `<common>`, `<epic>`, `<legendary>`.
`Type`	string	`"Comum"`, `"Consumível"`, `"Armamento"`, `"Attachs"`. Padrão `"Comum"`.
`Weight`	number	Peso unitário (Kg). Padrão `0.0`.
`Rarity`	string	`"common"`, `"rare"`, `"epic"`, `"legendary"`. Padrão `"normal"`.
`Economy`	number	Preço base na economia. Padrão `0`.
`Max`	number	Quantidade máxima por slot (stack).
`Durability`	number	Horas até estragar (consumíveis) ou durabilidade total (equipamentos).
`Charges`	number	Número de usos/cargas.
`Market`	bool	Negociável no mercado entre jogadores.
`Delete`	bool	Deletável/consumido no uso.
`Recycle`	table	Itens obtidos ao reciclar (`spawn = quantidade`).
`Execute`	table	Ação ao usar: `{ Type = "Server", Event = "nome:evento" }`.
`Backpack`	number	Peso extra que a mochila concede.
`Fridge`	bool	Pode ser guardado em geladeiras.
`Arrest` / `Police`	bool	Item ilícito / de uso policial.

O mínimo prático é Index, Name, Type e Weight.

Como adicionar um item

Abra o arquivo de itens

Abra resources/vrp/config/Item.lua.

Adicione a entrada na tabela List

Dentro de List = { ... }, adicione a entrada (chave = spawn):

["meu_item"] = {
    Index = "meu_item",
    Name = "Meu Item",
    Description = "Um item de exemplo.",
    Type = "Comum",
    Weight = 0.50,
    Economy = 250,
    Market = true
},

Para um consumível com ação ao usar

["meu_consumivel"] = {
    Index = "meu_consumivel",
    Name = "Meu Consumível",
    Type = "Consumível",
    Weight = 0.25,
    Durability = 12,
    Delete = true,
    Execute = { Type = "Server", Event = "meurecurso:Usar" }
},

Suba a imagem no CDN

Suba a imagem no CDN (nome igual ao Index).

Reinicie o recurso vrp

Reinicie o recurso vrp (não há build de NUI para itens).

Itens gerados automaticamente

Blueprints: itens com Blueprint = <n> ganham automaticamente um item blueprint_<spawn>.
Clonagem (plantações): Clones + Puritys geram itens base e mudas por pureza.

Funções auxiliares (helpers)

No fim do Item.lua. Todas recebem o spawn:

Função	Retorno	Padrão
`ItemList()`	A tabela `List` inteira	N/A
`ItemExist(Item)`	A tabela do item ou `nil`	`nil`
`ItemIndex(Item)`	`Index` (imagem)	`false`
`ItemName(Item)`	`Name`	`"Deletado"`
`ItemType(Item)`	`Type`	`"Comum"`
`ItemWeight(Item)`	`Weight`	`0.0`
`ItemMaxAmount(Item)`	`Max` (limite de stack)	`false`
`ItemDescription(Item)`	`Description`	`false`
`ItemDurability(Item)`	`Durability`	`false`
`ItemExecute(Item)`	tabela `Execute`	`false`
`ItemEconomy(Item)`	`Economy`	`0`
`ItemRarity(Item)`	`Rarity`	`"normal"`
`ItemRecycle(Item)`	tabela `Recycle`	`false`
`BlockMarket(Item)`	`Market`	`false`
`BlockDelete(Item)`	`Delete`	`false`
`ItemTypeCheck(Item, Mode)`	Se o item é do tipo informado	`false`
`ItemUnique(Item)`	Item único (não empilha)	`false`
`ItemSerial(Item)`	Item com número de série	`false`
`ItemBackpack(Item)`	`Backpack` (peso extra)	`false`
`ItemLoads(Item)` / `ItemRepair(Item)`	Cargas e reparo	`false`
`ItemWater(Item)` / `ItemLostWater(Item)`	Hidratação ganha e perdida	`false`
`ItemAnim(Item)`	Animação ao usar	`false`
`ItemVehicle(Item)`	Veículo associado ao item	`false`
`ItemArrest(Item)`	Item ilícito	`false`
`ItemFridge(Item)`	Pode ir na geladeira	`false`

Não existe função MaxItens. O limite por slot é lido por ItemMaxAmount(Item) (campo Max).

Imagens dos itens

A imagem é resolvida a partir de uma URL base (CDN) em Global.lua:

ItemsURL = "https://cdn.fivenetwork.dev/Itens/"

Caminho final = ItemsURL + o campo Index. Ex.: repairkit02 → https://cdn.fivenetwork.dev/Itens/repairkit02. Para usar seu CDN, altere ItemsURL.

Customização

Cores de raridade: bloco Theme em Global.lua (common, rare, epic, legendary).
Itens iniciais do personagem: tabela CharacterItens em Global.lua (chaves = spawns válidos).
Reaproveite imagens com o mesmo Index para variações cosméticas.
Economia: Economy + Market = true para deixar negociável.

Após alterar o Item.lua, reinicie o recurso vrp.

Começando

Configuração da Base

Referência Rápida

Recursos

Scripts

Framework vRP

Estrutura de um item

Como adicionar um item

Funções auxiliares (helpers)

Imagens dos itens

Customização

​Estrutura de um item

​Como adicionar um item

​Funções auxiliares (helpers)

​Imagens dos itens

​Customização

Estrutura de um item

Como adicionar um item

Funções auxiliares (helpers)

Imagens dos itens

Customização