Drs MarketPlace

Transforma o teu servidor FiveM num verdadeiro mercado entre jogadores com o DRS Marketplace.

Um sistema completo de compra e venda de itens integrado com QBCore, com interface NUI moderna, anúncios persistentes e controlo seguro das transações através do servidor.

✨ Principais funcionalidades

🏪 Mercado físico

• NPC configurável para abrir o mercado

• Sistema de interação através da tecla E

• Área de interação configurável

• Blip configurável no mapa

• Possibilidade de adicionar vários mercados/localizações

• Sem necessidade de comandos

📦 Venda de itens

• Escolhe diretamente itens do teu inventário

• Define a quantidade que queres vender

• Define o preço do anúncio

• Possibilidade de publicar anúncios anonimamente

• Limite configurável de anúncios por jogador

• Possibilidade de impedir vários anúncios do mesmo item

• Itens específicos podem ser bloqueados através de uma blacklist

🛒 Compra de itens

• Pesquisa por nome do item

• Ordenação por preço ou quantidade

• Visualização detalhada do anúncio

• Nome do vendedor

• Quantidade disponível

• Peso do item

• Preço

• Taxa de compra

• Confirmação da compra

• Validação das transações no servidor

💰 Sistema de vendas

Quando um item é vendido:

• O item é entregue automaticamente ao comprador

• O dinheiro da venda fica disponível para o vendedor

• O vendedor pode recolher os ganhos através do próprio marketplace

• Sistema de taxa configurável para o vendedor

• Taxa fixa configurável para o comprador

📋 Gestão dos teus anúncios

Uma área dedicada para:

• Ver anúncios ativos

• Remover anúncios

• Ver itens vendidos

• Recolher dinheiro das vendas

• Consultar o estado dos anúncios

🔒 Segurança

O processamento das principais operações é realizado no servidor, incluindo:

• Validação do preço

• Validação da quantidade

• Verificação do inventário

• Verificação da propriedade dos anúncios

• Verificação do saldo

• Prevenção de compra do próprio anúncio

• Devolução automática do item caso exista um erro ao criar o anúncio

• Reembolso automático caso a compra não consiga entregar o item

🗄️ Persistência MySQL

Os anúncios são guardados na base de dados através de oxmysql, permitindo que continuem disponíveis mesmo depois de reiniciar o servidor.

Inclui ficheiro SQL para instalação da tabela necessária.

🎨 Interface NUI

Interface moderna e totalmente integrada no jogo com:

• Design próprio

• Pesquisa

• Ordenação

• Cards de produtos

• Página de detalhes

• Gestão de anúncios

• Interface de publicação

• Feedback de sucesso/erro

⚙️ Configuração

Grande parte do sistema pode ser configurada diretamente no config.lua, incluindo:

• Conta utilizada para pagamentos

• Taxa do vendedor

• Taxa fixa do comprador

• Preço mínimo/máximo

• Número máximo de anúncios

• Itens bloqueados

• NPC

• Localizações

• Raio de interação

• Blip

• Resource utilizado para imagens

• Discord Webhook

• Restrição de anúncios duplicados

🔌 Dependências

•

• QBCore

•

• oxmysql

• Inventário compatível com o sistema de itens/imagens do QBCore

O marketplace foi desenvolvido especificamente para ambientes QBCore.

📁 O que recebes

•

• drs_marketplace

• Client

• Server

• NUI

• Configuração

• SQL de instalação

•

• fxmanifest.lua

🚀 Instalação

• Coloca drs_marketplace na pasta resources.

• Executa o install.sql na tua base de dados.

• Configura o config.lua.

• Adiciona ensure drs_marketplace ao server.cfg.

• Reinicia o servidor.

Pronto. O teu servidor passa a ter um mercado entre jogadores totalmente integrado com o QBCore.

🛠️ DRS Scripts

Scripts FiveM desenvolvidos com foco em qualidade, configuração e integração com o teu servidor.

Para suporte ou dúvidas sobre o produto, contacta-nos através do nosso sistema de suporte.