Instalação

Nota

💬 Precisa de ajuda? Suporte, atualizações e changelogs estão no Discord da Mic Scripts. Abra um ticket com o ID da sua transação Tebex e o erro do console.

Cinco minutos: um arquivo SQL, uma linha no config.lua, uma linha no server.cfg.

---

Antes de começar

Você precisa	Por quê
lb-phone	O aplicativo funciona dentro dele
oxmysql	Ofertas, curtidas e ganhos são salvos no seu banco de dados
ESX, QBCore ou QBox	Inventário, dinheiro e a identidade do jogador

---

1. Coloque a pasta no lugar

Coloque mic_pawnshop dentro de suas resources, por exemplo resources/[mic]/mic_pawnshop.

Cuidado

Mantenha a pasta com o nome mic_pawnshop. As telas do aplicativo fazem chamadas para a resource usando exatamente esse nome; se for renomeada, o aplicativo abre e fica vazio.

---

2. O banco de dados

Importe pawnshop.sql da pasta da resource uma única vez, usando HeidiSQL, phpMyAdmin ou o gerenciador que preferir. Ele cria três tabelas:

Tabela	O que ela armazena
pawn_offers	Cada anúncio: item, quantidade, preço, tipo de preço, vendedor, datas e metadados
pawn_earnings	Os ganhos de cada vendedor aguardando saque
liked_offers	Quem curtiu qual oferta

A resource não cria essas tabelas sozinha.

Funcionou quando as três tabelas estão no mesmo banco de dados que o seu servidor utiliza.

---

3. Inicie após as dependências

No server.cfg, adicione ensure mic_pawnshop em uma linha abaixo de oxmysql, do seu framework e de lb-phone.

O aplicativo aguarda o lb-phone e se adiciona novamente sempre que o lb-phone é reiniciado, então não há problema se o celular iniciar depois; porém, o framework e o oxmysql precisam estar ativos primeiro.

---

4. Informe seu framework e inventário

Abra o config.lua:

Opção	ESX	QBCore	QBox
Config.Framework	"esx"	"qb"	"qb"
Config.InventoryImagePath	"ox_inventory/web/images/"	"qb-inventory/html/images/"	"ox_inventory/web/images/"

O framework não é detectado automaticamente e deve ser escrito em letras minúsculas. No QBox, use "qb": o QBox executa resources de QBCore através de sua camada de compatibilidade. O caminho de imagens serve apenas para as fotos no aplicativo — qualquer inventário funciona, desde que o caminho aponte para a pasta onde ficam as imagens dos itens.

---

5. Itens

Não há nenhum item para adicionar. O aplicativo vende o que os jogadores já carregam consigo. Qualquer coisa que você nunca queira que seja comercializada vai em Config.BlackList (veja Personalização).

---

6. Primeiro teste

1. Abra o lb-phone. O aplicativo Pawn Shop já está na tela inicial — ele vem instalado por padrão.
2. Crie uma oferta: escolha um item do seu inventário, defina uma quantidade e um preço, e escolha Unit (Unidade) ou Total.
3. Em um segundo personagem, abra o aplicativo e compre o item.

Funcionou quando o item sai do inventário do vendedor no momento em que a oferta é publicada, chega ao inventário do comprador quando é comprado, e o vendedor vê o dinheiro em Pending (Pendente) no topo do aplicativo, pronto para transferir.

---

Antes de abrir sua cidade

• Decida de onde vem o dinheiro. Config.Bank = true usa contas bancárias. Pagar com itens exige que o dinheiro seja um item de inventário — leia Personalização primeiro.
• Defina Config.Expire com atenção. Uma oferta que expira é removida junto com seus itens; eles não voltam para o vendedor.
• Preencha Config.BlackList com tudo o que não deve trocar de mãos: a lista padrão traz apenas burger e weapon_appistol como exemplos.
• Mova a loja de penhores para onde desejar, caso ative Config.RequireLocation.