Agency-Blackmarket: como criar uma economia clandestina sem desestabilizar o servidor

Por que a maioria dos scripts de mercado negro falha

Um script de mercado negro mal projetado é a maneira mais rápida de arruinar a economia de um servidor. Barato demais e todo mundo vira criminoso. Caro demais e ninguém usa. Seguro demais e não há risco. Arriscado demais e os jogadores se esgotam. Agency-Blackmarket foi projetado com o equilíbrio da economia como prioridade principal, a lista de recursos vem em segundo lugar.

Preços dinâmicos conforme a demanda

Os preços de cada item mudam de acordo com quantos jogadores compraram esse item recentemente. Oferta e demanda acontecem automaticamente: se o servidor inteiro estiver comprando AR-15s, o preço dobra em poucas horas. Quando a demanda cai, os preços voltam lentamente ao normal. Isso cria ciclos naturais de mercado em vez de listas de compras com preços fixos.

O fator de risco

Cada visita ao mercado negro tem uma chance configurável de acionar um despacho policial, um evento de emboscada ou um encontro com um NPC rival. O risco aumenta conforme o tamanho da compra. Jogadores atentos aprendem a dividir compras grandes em várias visitas. Os menos cuidadosos são pegos e perdem o que carregam. Essa tensão mantém o RP ilegal interessante.

Ferramentas administrativas

Cada transação é registrada com ID do jogador, item, preço e horário. Os administradores podem ver rapidamente a economia paralela do servidor, definir preços mínimos ou desativar temporariamente itens específicos. É por isso que comunidades profissionais de RP confiam em nós para seus scripts centrais de economia: não vendemos apenas recursos, também entregamos a camada de gerenciamento que os mantém funcionando em grande escala.

Integração com seus empregos

Agency-Blackmarket disponibiliza eventos que Agency-Minerjob, Agency-Admin e seus scripts policiais podem usar. O ecossistema se fortalece: cada script individual é útil por conta própria, mas, juntos, eles criam comportamentos sistêmicos emergentes que você não conseguiria programar manualmente.

Instalação e configuração

Agency-Blackmarket requer oxmysql para registrar transações e persistir preços dinâmicos. Importe blackmarket.sql , coloque a pasta do recurso e adicione ensure agency-blackmarket a server.cfg . As coordenadas dos locais são definidas em config.lua, o recurso vem com seis coordenadas padrão de mercado negro pelo mapa padrão de GTA V, que podem ser substituídas pelas posições do seu MLO personalizado.

Os itens disponíveis para venda precisam existir no registro de itens do seu framework. A configuração inclui uma lista padrão de itens; adicionar ou remover itens é uma simples edição da tabela de configuração.

Opções de configuração

O config.lua oferece controle total sobre a economia e as configurações de risco:

• Catálogo de itens, defina cada item, seu preço base, preço mínimo, preço máximo e fator de elasticidade da demanda.
• Janela de demanda, quantas horas do histórico de compras o algoritmo de preços consulta. Padrão: 6 horas.
• Eventos de risco, configure a chance de despacho policial, de emboscada e de surgimento de NPCs rivais por limite de valor de compra.
• Rotação de locais, os locais do mercado negro podem ser alternados conforme uma programação, incentivando os jogadores a acompanhar informações dentro do jogo para encontrar o local atual.
• Substituição de preços por administradores, administradores seniores podem definir manualmente preços mínimos ou máximos temporários por item durante eventos econômicos.
• Retenção do registro de transações, quantos dias do histórico de compras são mantidos. Padrão: 30 dias.

Compatibilidade com frameworks

Os adaptadores para QBCore e ESX vêm incluídos no pacote. Para standalone, implemente quatro funções de configuração: entregar item, remover dinheiro, acionar alerta policial e a restrição opcional de acesso baseada em emprego. O mecanismo de preços, o sistema de eventos de risco, o gerenciamento de locais e as ferramentas administrativas são totalmente independentes de framework.

Por que isso importa para o roleplay

Uma economia ilegal que funciona com segurança demais acaba virando uma ida rotineira às compras. O sistema de risco do Agency-Blackmarket foi projetado especificamente para fazer cada compra significativa parecer uma decisão, não uma transação. O jogador que passa dez minutos planejando uma grande compra de armas, observando o local, calculando o momento de se aproximar e decidindo se deve levar reforços está fazendo um RP melhor do que o jogador que simplesmente abre um menu e clica em comprar.

Os preços dinâmicos criam uma escassez natural sem intervenção administrativa. Quando o servidor inteiro se prepara para um conflito planejado, o aumento no preço das armas sinaliza isso a todos os jogadores que consultam o mercado. Personagens criminosos experientes aprendem a comprar antes que a demanda aumente. Esse comportamento econômico emergente acrescenta uma camada de profundidade estratégica que menus com preços fixos nunca conseguem oferecer.

O painel administrativo de transações é o que permite gerenciar com responsabilidade a economia de RP. Quando a economia ilegal de um servidor é opaca, os administradores não conseguem saber se o equilíbrio está saudável ou comprometido até que os jogadores comecem a reclamar. Com visibilidade total das transações, você pode ver em tempo real se um jogador ou grupo está comprando em quantidade desproporcional e intervir antes que o desequilíbrio prejudique o ecossistema criminoso do servidor.

Perguntas frequentes

Posso disponibilizar itens específicos apenas para determinadas organizações criminosas?

Sim. Cada item do catálogo oferece suporte a um campo opcional requiredFlag campo. Jogadores com essa flag definida, gerenciada pelo Agency-Admin ou pelo seu próprio sistema, podem ver e comprar o item; os demais o veem esmaecido com o rótulo "restrito". Isso cria um mercado negro por níveis, no qual cargos criminosos de nível mais alto têm acesso a um inventário melhor.

Como funciona o evento de emboscada?

Quando uma emboscada é acionada, um grupo de NPCs hostis surge no local do mercado negro e ataca o jogador imediatamente. A quantidade de NPCs e seus equipamentos variam de acordo com o valor da compra que acionou o evento. Os jogadores que sobrevivem à emboscada ficam com a compra; quem não sobrevive perde o item para o sistema de saque. Isso é intencionalmente rigoroso, o risco precisa ser real.

É possível exportar os dados de preços para análise externa?

O registro de transações no oxmysql pode ser consultado diretamente. Também disponibilizamos uma exportação no servidor exports['agency-blackmarket']:GetPriceHistory(item, hours) que retorna uma tabela de snapshots de preços. Conecte-a a qualquer ferramenta externa de painel se quiser gráficos visuais da economia ilegal do seu servidor ao longo do tempo.

Como evito que um jogador manipule o sistema de demanda para alterar os preços?

Defina Config.PerPlayerDemandCap = true e Config.MaxPlayerDemandWeight = 0.3. Isso limita o quanto o histórico de compras de um único jogador pode influenciar o preço global. A manipulação da demanda por um único comprador ainda é possível, mas exige coordenação contínua entre vários jogadores para provocar mudanças significativas nos preços.

Requisitos

• Servidor FiveM (QBCore, ESX ou standalone)
• oxmysql
• Conta cfx.re com uma licença válida do Agency-Blackmarket
• Opcional: Agency-Admin (para um painel integrado de monitoramento de transações)

Eventos Econômicos Sazonais por meio dos Controles de Preço do Admin

As ferramentas de precificação do admin do Agency-Blackmarket permitem criar eventos econômicos. Veja alguns padrões que funcionam bem:

Evento de corrida armamentista: Reduza os preços das armas em 30% por um período de 48 horas e anuncie a mudança dentro do personagem por meio de transmissões de notícias de NPCs. Isso cria um breve período de aumento da atividade criminosa, para que a polícia possa se preparar para responder. O período termina antes que a economia se desestabilize.

Choque de oferta: Desative temporariamente uma categoria de itens, por exemplo, deixe os explosivos indisponíveis por uma semana. A escassez leva ao acúmulo de itens, ao comércio clandestino entre jogadores e a situações de RP em torno da falta de suprimentos. Restabeleça a disponibilidade e observe o mercado se normalizar.

Introdução de novo contrabando: Lance um novo item com preço alto e baixa queda de demanda. Os primeiros a adotar pagam um valor premium; conforme outros jogadores descobrem o item, a demanda aumenta e os preços disparam antes de se normalizar. O histórico de preços conta a história de como sua comunidade adotou o novo item.

Esses eventos econômicos não exigem que você programe uma lógica personalizada, são mudanças de configuração feitas pelo admin. Essa acessibilidade é o objetivo: admins de servidor que não são desenvolvedores podem criar eventos economicamente interessantes usando apenas o painel de admin do Agency-Blackmarket.