Script de negociação CodeM (ESX/QB)

CodeM Trading Script – Sistema seguro de troca de itens e moedas entre jogadores

O CodeM Trading Script permite negociações seguras e intuitivas entre jogadores no seu servidor FiveM. Este sistema de negociação completo oferece troca de itens em tempo real, transações de moedas, requisitos de dupla confirmação, proteção anti-fraude, registro do histórico de negociações, interface de usuário moderna, negociação baseada na distância e integração completa com o framework – criando um mercado seguro onde os jogadores podem trocar itens, veículos e dinheiro diretamente, sem intervenção do administrador ou negociações arriscadas com drop-trading.

O que está incluído

Este pacote completo de negociação inclui uma interface segura que exibe as ofertas de ambas as partes, troca de itens compatível com qualquer item do inventário e com controle de quantidade, negociação de dinheiro com limites configuráveis, sistema de dupla confirmação que exige a aceitação de ambos os jogadores, atualizações de negociação em tempo real conforme os itens são adicionados ou removidos, cancelamento de negociação que permite a qualquer uma das partes abortar, proteções antifraude que impedem a duplicação de itens e explorações, histórico de negociações com rastreamento de transações concluídas, negociação baseada na distância que exige proximidade física, mecanismo de tempo limite que impede negociações abertas indefinidamente e registro abrangente para resolução de disputas.

Principais características

• Janela de Negociação Segura – Interface de tela dividida que exibe suas ofertas de um lado e as ofertas de seus parceiros do outro, com clara separação visual.
• Troca de itens – Negocie quaisquer itens do inventário com seleção de quantidade, verificação de peso e preservação de metadados (acessórios de armas, durabilidade, etc.)
• Negociação de dinheiro – Troque dinheiro em espécie juntamente com itens com limites de transação mínimos/máximos configuráveis e suporte para dinheiro não declarado (ESX)
• Confirmação dupla – Ambos os jogadores devem clicar em Aceitar antes que a transação seja executada, evitando transações apressadas ou acidentais.
• Atualizações em tempo real – A janela de negociação é atualizada instantaneamente quando itens são adicionados/removidos, mostrando as ofertas atuais antes da confirmação final.
• Cancelamento de transação Qualquer uma das partes pode cancelar a transação a qualquer momento antes da confirmação final, com devolução automática do item.
• Proteção contra duplicação – A validação no servidor impede a exploração de duplicação de itens e manipulação de inventário.
• Requisitos de distância – Os jogadores devem estar a uma distância configurável para iniciar e manter negociações, evitando tentativas de fraude remota.
• Pedidos de troca – Envie solicitações de troca para jogadores próximos, exibindo uma notificação para que eles possam aceitar ou recusar.
• Histórico comercial – Registro completo de todas as transações concluídas com data e hora, itens trocados e participantes para resolução de disputas.
• Sistema de tempo limite – As negociações são canceladas automaticamente após um período de inatividade configurável, evitando negociações pendentes indefinidamente.
• Verificação de peso – Verifica se ambos os jogadores têm capacidade de inventário suficiente antes de permitir a execução da transação.
• Sistema de lista negra – Configurar itens que não podem ser negociados (ferramentas administrativas, itens especiais, objetos de missão)
• Tempos de espera para trocas – Períodos de espera opcionais entre negociações para evitar spam ou manipulação de mercado.
• Efeitos sonoros – Feedback de áudio para solicitações de troca, adições de itens, confirmações e conclusões.

Perfeito para

• Servidores Econômicos – Permite uma economia controlada pelos jogadores com troca direta de itens e moedas sem vendedores NPC.
• Servidores de RPG – Suporta cenários comerciais realistas, como encenação de mercadores, transações comerciais e venda de itens pessoais.
• Servidores de Sobrevivência – Essencial para o comércio de recursos, trocas de equipamentos e cooperação comunitária.
• Servidores Públicos – Impede fraudes por meio de drop trading, fornecendo um mecanismo de troca seguro e transparente.
• Comunidades na lista branca – Facilita a interação entre jogadores e o comércio em comunidades fechadas.
• Trabalho Sistemas – Dá suporte a transações comerciais, como a compra de suprimentos de atacadistas ou a venda de produtos para clientes.

Fluxo de trabalho do processo de negociação

Iniciando a negociação: Um jogador se aproxima de outro (dentro de um raio configurável, geralmente de 3 a 5 metros) e abre o menu de negociação, selecionando o jogador alvo. O alvo recebe uma notificação com o nome do negociador e pode aceitar ou recusar. Após a aceitação, a janela de negociação se abre simultaneamente para ambos os jogadores.

Adicionando ofertas: Cada jogador adiciona itens do seu inventário e/ou dinheiro à sua parte da negociação de forma independente. À medida que os itens são adicionados, eles aparecem em tempo real nas janelas de negociação de ambos os jogadores. Os jogadores podem remover itens antes da confirmação final. A verificação de peso garante que o jogador que recebe os itens tenha espaço no inventário.

Fase de Confirmação: Quando ambos os jogadores estiverem satisfeitos com as ofertas, cada um clica no botão Aceitar. A primeira aceitação mostra o status Aguardando o outro jogador. Assim que ambos aceitarem, uma breve contagem regressiva (3-5 segundos) começa, permitindo a revisão final. Qualquer um dos jogadores ainda pode cancelar durante a contagem regressiva.

Execução de ordens: Após a contagem regressiva, itens e dinheiro são transferidos simultaneamente entre os inventários. O servidor valida todas as transferências, evitando duplicação. Uma notificação de sucesso é exibida para ambos os jogadores. A janela de troca fecha automaticamente. A transação é registrada no histórico.

Cancelamento: Qualquer jogador pode clicar em Cancelar a qualquer momento antes da contagem regressiva final. Todos os itens oferecidos retornam instantaneamente aos seus proprietários originais. A janela de troca se fecha com a notificação de cancelamento.

Proteções contra fraudes

Validação no servidor: Todas as transações são executadas no servidor com verificações de validação que garantem que os jogadores realmente possuam os itens oferecidos, que haja espaço suficiente no inventário para recebê-los, que os valores estejam corretos e dentro dos limites, que os itens não sejam duplicados durante a transferência e que os metadados sejam preservados corretamente. As informações exibidas no lado do cliente são verificadas em relação à autoridade do servidor, impedindo manipulações.

Sistema de confirmação: A exigência de confirmação dupla impede golpes de troca rápida, nos quais os negociadores alteram as ofertas no último segundo. A contagem regressiva de 3 a 5 segundos após a aceitação de ambas as partes oferece uma oportunidade final de revisão. As atualizações em tempo real mostram exatamente o que cada participante está oferecendo antes da execução.

Fiscalização da distância: As negociações são canceladas automaticamente se os jogadores se afastarem muito durante a transação, evitando situações em que um jogador foge durante a negociação. A verificação de proximidade é executada continuamente durante todo o processo de negociação.

Registro de Comércio: Os registros completos de transações permitem que os administradores investiguem negociações contestadas, verifiquem o que foi trocado, identifiquem tentativas de fraude e resolvam conflitos com base em evidências. Os registros incluem identificadores de jogadores, itens trocados, quantidades, horários e status de sucesso/cancelamento da negociação.

Especificações técnicas

• Desempenho: Impacto no servidor de aproximadamente 0,015 ms, operações de inventário otimizadas e validação.
• Banco de dados: Armazena o histórico de negociações com dados dos participantes, itens trocados e registros de data e hora das transações.
• Sistemas de inventário: Compatível com ox_inventory, qb-inventory, qs-inventory, esx_inventory e soluções personalizadas.
• Tecnologia de interface do usuário: Interface NUI moderna com design responsivo e sincronização em tempo real.
• Segurança: Validação no servidor de todas as operações, prevenindo explorações e duplicação.
• Tamanho do arquivo: Aproximadamente 6 MB, incluindo elementos da interface do usuário, efeitos sonoros e configuração.

Instalação

1. Faça o download do pacote do script de negociação CodeM a partir da sua confirmação de compra.
2. Extraia o recurso para o diretório de recursos do seu servidor.
3. Importe o arquivo SQL fornecido para criar a tabela de histórico de negociações no banco de dados.
4. Configure as definições do framework em config.lua (ESX/qbNúcleo detecção)
5. Defina limites de distância para negociações, tempos limite de confirmação e períodos de espera.
6. Configure os limites de transferência de dinheiro e os itens bloqueados.
7. Personalize as cores e posições da interface do usuário para combinar com o tema do servidor.
8. Adicionar garantir codem-trading para server.cfg
9. Reinicie o servidor e teste a troca de mensagens entre dois jogadores.
10. Verifique se todos os itens foram transferidos corretamente, preservando os metadados.

Compatibilidade de Framework

• ✅ ESX Legado – Integração completa com o inventário do ESX, sistemas monetários (dinheiro vivo/dinheiro ilícito) e dados do jogador.
• ✅ qbNúcleo – Suporte completo ao QB com metadados de inventário, gestão de caixa e gerenciamento de jogadores
• ✅ QBOX – Compatível com os recursos modernos do framework QBOX
• ✅ Standalone – Pode operar com estruturas personalizadas através da configuração da ponte de inventário.

Opções de configuração

• Distância comercial: Defina a distância máxima entre os jogadores para iniciar e manter as trocas de bola (padrão: 3-5 metros).
• Tempo limite de confirmação: Duração da contagem regressiva após ambas as confirmações antes da execução (padrão: 3-5 segundos)
• Tempo limite de inatividade: Cancelar automaticamente as negociações após X minutos de inatividade (padrão: 2 a 5 minutos)
• Limites de gastos: Defina valores mínimos e máximos em dinheiro por transação, evitando microtransações ou transferências excessivas.
• Tempo de espera para trocas: Exigir X segundos entre negociações consecutivas por jogador (opcional, evita spam)
• Itens na lista negra: Defina os itens que não podem ser negociados (ferramentas administrativas, itens de missão, armas especiais).
• Efeitos sonoros: Ativar/desativar feedback de áudio e personalizar arquivos de som.
• Personalização da interface do usuário: Ajuste cores, posições, transparência e estilo para combinar com a estética do servidor.

Histórico Comercial e Registro de Dados

Cada transação concluída é registrada no banco de dados com informações abrangentes, incluindo identificadores de ambos os jogadores (licença, Steam, etc.), todos os itens trocados com suas respectivas quantidades, valores transferidos, data e hora exatas e status de sucesso da transação. Os administradores podem consultar o histórico de transações para investigar atividades suspeitas, resolver disputas entre jogadores sobre itens desaparecidos, acompanhar a atividade do mercado e os itens mais populares, identificar possíveis explorações ou padrões incomuns e fornecer evidências para recursos ou denúncias de banimento.

A integração opcional com webhook do Discord envia notificações em tempo real de negociações de alto valor (com limite configurável), ajudando os administradores a monitorar a economia em busca de manipulação ou tentativas de RMT (negociação com dinheiro real).

Possibilidades de integração

• Scripts da Loja: Os proprietários de empresas podem transferir estoque para suas lojas em vez de usar comandos de administrador.
• Sistemas de trabalho: Facilitar a troca direta entre serviços, como mecânicos comprando peças de fornecedores ou chefs adquirindo ingredientes.
• Sistemas de gangues: Membros de gangues negociam armas, drogas ou recursos dentro da organização.
• Roteiros de Habitação: Troque itens de mobília, chaves de propriedades ou decorações de casas entre jogadores.
• Scripts de veículos: Trocar a propriedade de veículos através do sistema de negociação (se configurado para suportar itens de veículos)
• Sistemas de Criação: Os jogadores negociam matérias-primas ou produtos manufaturados, dando suporte às cadeias de produção.

O que o torna especial

O CodeM Trading Script elimina a prática perigosa de drop trading, onde jogadores deixam itens no chão na esperança de que outros jogadores paguem por isso. O drop trading é facilmente explorável – jogadores podem fugir com os itens, terceiros podem pegar os itens deixados ou golpistas podem alegar que nunca receberam os itens. Este script oferece uma troca segura, transparente e simultânea, onde ninguém pode pegar itens sem oferecer o que foi combinado. A interface em tempo real mostra exatamente o que cada jogador está oferecendo antes da execução da transação, evitando golpes de isca e troca. A dupla confirmação com contagem regressiva impede decisões precipitadas. Mais importante ainda, a validação no servidor torna os exploits e a duplicação impossíveis, criando um ambiente de negociação confiável, mesmo em servidores públicos.

Melhoria da economia

O sistema de comércio seguro possibilita uma economia genuinamente controlada pelos jogadores, onde eles se especializam em coletar, fabricar ou revender recursos, criando dinâmicas de mercado. Os coletores de recursos vendem matérias-primas para os artesãos, que por sua vez vendem os produtos acabados aos consumidores, estabelecendo cadeias de suprimentos. A descoberta de preços ocorre naturalmente por meio de negociação, em vez de preços fixos definidos por NPCs. O comércio gera interação social – os jogadores precisam se comunicar, negociar e se encontrar pessoalmente, em vez de usar casas de leilão impessoais. Isso gera interpretação de personagens orgânica e construção de comunidade.

Exemplos de casos de uso

Interpretação de papéis de mercador: O jogador estabelece uma banca no mercado e negocia com os clientes usando este sistema. Os clientes navegam pelo estoque, negociam preços e concluem transações seguras. O comerciante acompanha as vendas por meio do histórico de transações, gerenciando o giro de estoque.

Negócios de drogas: Um criminoso vende drogas para outro jogador através do sistema de trocas. Ambas as partes confirmam as quantidades e o pagamento antes da execução. Se polícia Se houver interrupção, qualquer um dos dois pode cancelar a negociação instantaneamente. Não há evidências perdidas para coletar.

Venda de equipamentos: O mecânico fabrica peças de veículos e as vende aos clientes. O cliente paga em dinheiro, recebe as peças e a transação é concluída. O mecânico tem comprovante de venda em seu histórico de transações caso o cliente conteste a venda posteriormente.

Negociação de recursos: O minerador vende o minério ao artesão. O artesão processa o minério em barras e vende ao armeiro. O armeiro fabrica armas e vende para membros de gangues. Cadeia de produção completa facilitada por um sistema de comércio seguro.

Recursos de administração

Os administradores do servidor têm controles especiais, incluindo a visualização do histórico completo de negociações, a busca de negociações por identificador de jogador, a filtragem por tipo ou valor do item, a exportação de registros de negociações para análise, a identificação de padrões de negociação suspeitos e, opcionalmente, o bloqueio de jogadores específicos (tempo de espera ou lista negra). O painel de administração fornece informações sobre a economia do servidor, incluindo os itens mais negociados, os valores médios das transações e a atividade de negociação por horário do dia.

Suporte e atualizações

Comprehensive documentation covers installation, configuration, inventory system integration, troubleshooting, and best practices for economy management. Active support via ticket system for technical assistance and customization help. Regular updates add community-requested features like vehicle trading, trade templates, and advanced filtering.

Scripts ESX relacionados

• Script de planta de maconha
• Roteiro do FiveM Motel
• Assalto a caixa eletrônico (explosão de C4, animação de perfuração)
• Wais HUD V5 (ESX/QB)