Personalização

O mic_boosting possui duas camadas. Um config.lua curto guarda as poucas opções decididas uma única vez — framework, como o tablet abre, quem é administrador e o idioma. Tudo sobre a jogabilidade fica no banco de dados e é editado em tempo real pelo painel administrativo (/boostingconfig), sem precisar reiniciar.

Qual arquivo decide o quê

Onde	O que ele decide	Aberto para edição
`config.lua`	Framework, item/comando do tablet, acesso admin, idioma, sistema de interação, trabalhos policiais, fixadores de teste	Sim
`shared/prices.lua`	Valores iniciais para seis configurações de economia — lido apenas na primeiríssima inicialização (veja abaixo)	Sim
`locales/*.lua`	Cada notificação e cada texto do tablet, um arquivo por idioma; `locales/locale.lua` é o carregador	Sim
`bridge/server_bridge.lua`	Framework, dinheiro, itens, item utilizável, contagem de policiais, verificação de admin, entrega de carro na garagem	Sim
`bridge/client_bridge.lua`	Notificações, aviso de texto na tela, interações de target, alerta de despacho policial	Sim
`items/`	Definições de itens para ox_inventory, QBCore e ESX, e as sete imagens de itens	Sim
`ui/`	O próprio tablet (HTML, CSS, JS)	Protegido (Escrow)
`client/`, `server/`	A lógica do jogo e o back-end do painel administrativo	Protegido (Escrow)
Painel administrativo (`/boostingconfig`)	Locais, pontos de entrega, classes, carros, guardas, minigames, loja de ferramentas, progressão, economia	Dentro do jogo

Os arquivos abertos são os listados em escrow_ignore no fxmanifest.lua: config.lua, locales/, shared/ e bridge/.

config.lua

Framework e idioma

Opção	O que faz	Padrão
`Config.Framework`	`'auto'` verifica por `qb-core`, depois `es_extended`, senão standalone. O QBox é detectado como `qb-core`, por meio de sua compatibilidade com o QBCore. Ou force `'qbcore'` (também para QBox), `'esx'`, `'standalone'`	`'auto'`
`Config.CoreResource`	Está no arquivo, mas não é lido nesta versão: a detecção sempre procura por resources chamados `qb-core` e `es_extended`	`''`
`Config.Locale`	Idioma das notificações e do tablet. Usa inglês como fallback	`'en'`

Abrindo o tablet

Opção	O que faz	Padrão
`Config.TabletOpenMode`	`'item'`, `'command'` ou `'both'`	`'item'`
`Config.TabletItem`	O item utilizável que abre o tablet	`mic_boosting_tablet`
`Config.TabletCommand`	O comando que abre o tablet, no modo `command` ou `both`	`boosting`

Acesso administrativo

Opção	O que faz	Padrão
`Config.AdminCommand`	Comando que abre o painel administrativo	`boostingconfig`
`Config.AdminGroups`	Cargos que contam como admin. O ESX compara o grupo do jogador; o QBCore consulta `HasPermission` em cada	`admin`, `superadmin`, `god`
`Config.AdminAce`	Uma ACE que também torna você admin. O único caminho no standalone. `false` desativa isso	`command`

A mesma verificação decide quem vê a aba Admin dentro do tablet. Mais detalhes em ⌨️ Comandos e permissões.

Interação e polícia

Opção	O que faz	Padrão
`Config.InteractionSystem`	Como a opção de lockpick aparece no carro: `'ox_target'`, `'qb_target'` ou `'drawtext'` (pressione E)	`'ox_target'`
`Config.PoliceJobs`	Trabalhos contabilizados para o mínimo de policiais online de cada classe	`police`, `sheriff`, `lspd`, `bcso`

Com ox_target, o carro também mostra uma opção separada de EMP Jammer para quem estiver carregando um. Nos outros modos, o bloqueador ainda é usado — automaticamente, quando o arrombamento começa.

Testes

Opção	O que faz	Padrão
`Config.ForceDropoffId`	Envia todos os contratos para este ponto de entrega	`nil` (aleatório)
`Config.ForceLocationId`	Faz todos os contratos surgirem neste local de coleta	`nil` (aleatório)
`Locations.BlipRadius`	Raio em metros do círculo de busca ao redor do carro-alvo	`150.0`

shared/prices.lua — apenas na primeira inicialização

Este arquivo insere seis valores de economia no banco de dados na primeira vez que o resource inicia (quando a tabela de configurações está vazia). Depois disso, editá-lo não muda nada — altere-os na aba Settings do painel administrativo.

Prices.Tools no mesmo arquivo não é o que a loja de ferramentas vende: a loja lê seu catálogo na aba Market do painel administrativo.

O painel administrativo

/boostingconfig abre o painel na aba Locations. Adicione o nome de uma aba para abri-lo diretamente nela: locations, dropoffs, classes, vehicles, setups, progression, minigames, market ou settings — por exemplo /boostingconfig classes.

Aba	O que você gerencia lá
Locations	Locais de coleta: uma posição de carro e quatro posições de guardas em cada um, as classes permitidas e a configuração de guardas por classe. Teleporte, reordene, edite, exclua ou posicione um novo no mapa
Drop-Offs	Onde os carros são entregues. Posicione novos no mapa, teleporte-se, exclua
Classes	Tudo referente a cada classe (tabela abaixo)
Vehicles	A lista de carros de onde cada classe sorteia seus alvos
NPC Setups	Configurações nomeadas de guardas e suas armas
Progression	Desafios, marcos, conquistas e vantagens
Minigames	Cada minigame, suas configurações de dificuldade, ativado/desativado e quais classes o utilizam
Market	A loja de ferramentas: itens e bônus, preço, moeda (MB ou dinheiro), valor, classe mínima, ativado/desativado
Settings	Economia, calor (heat), a aba de Ferramentas e o marcador de ponto de entrega

Posicionando no mundo. Novos locais e pontos de entrega são posicionados com um modelo fantasma: E confirma, a roda do mouse gira, Backspace cancela. Em um local de coleta, posiciona-se primeiro o carro, depois os quatro guardas e, por fim, define-se o nome.

Classes

Vêm seis por padrão: D, C, B, A, S e S+.

Configuração	O que faz
Rótulo, nível mínimo	O nome exibido e o nível necessário para pegá-la (D 0, C 3, B 6, A 10, S 15, S+ 20)
Faixa de XP, faixa de pagamento	O que um carro entregue concede, sorteado entre os dois valores
Limite de tempo	Minutos para entregar
Tempo de recarga (Cooldown)	Segundos antes que o mesmo jogador possa pegar outro
Mín / máx da fila	Quanto tempo a fila leva para encontrar um contrato
Limites diários	Contratos por jogador e por equipe por dia (0 = ilimitado)
Máximo de tentativas de lockpick	Tentativas antes que a fechadura trave de vez
Alerta policial	Se a polícia recebe um alerta de despacho para esta classe
Ganho de calor (Heat)	Calor adicionado por trabalho
Mínimo de policiais online	Policiais necessários online para entrar na fila ou aceitar. Vem em 2 para todas as classes
Estrelas de procurado	Nível de procurado dado ao ladrão assim que o carro é aberto (D 1 … S+ 5)

Settings (Configurações)

Configuração	O que faz	Valor padrão
VIN Scratch Multiplier	A taxa para raspar o VIN é 35% do pagamento × este valor, paga em MB	`4.0`
XP per Level	XP necessário para o próximo nível = nível × este valor	`500`
Heat Decay per Minute	Calor removido a cada minuto dos jogadores que estão online	`2`
Max Heat	Neste nível de calor, contratos são recusados até que esfrie	`100`
Hide Locked Items	Oculta itens da loja de ferramentas acima da classe do jogador	Desativado
Dropoff marker	Ativado/desativado, tipo de marcador, cor (RGBA) e tamanho	Ativado, tipo 2, vermelho
Queue Fee, Crypto Rate	Listados no painel. Nesta versão, entrar na fila é grátis e uma entrega credita o pagamento total em MB	`0`, `0.10`

Começando do zero

boostingseed, digitado no console do servidor, limpa as tabelas de configuração e restaura os padrões originais. Os dados dos jogadores — perfis, níveis, MB, equipes, contratos e anúncios no mercado — não são afetados.

Idiomas

Onze vêm em locales/: en, es, fr, pt (Português do Brasil), de, tr, it, nl, pl, cs, ru. Defina Config.Locale para um deles. Uma chave ausente em um idioma usa o texto em inglês como fallback.

Para adicionar um idioma:

Copie locales/en.lua para locales/<code>.lua e altere o código do idioma no topo da tabela.
Traduza os valores nas duas metades: script (notificações — mantenha %s e %d) e ui (o tablet — mantenha os espaços reservados {name}). date.intl_locale define o formato da data na tela de bloqueio.
Adicione o arquivo em shared_scripts no fxmanifest.lua, após locales/en.lua, e depois execute refresh.
Defina Config.Locale para o novo código.

A bridge

Ambos os arquivos da bridge são abertos, e é neles que você conecta um framework personalizado, inventário, sistema de notificação ou dispatch.

bridge/server_bridge.lua

Função	Para que serve
Detecção de framework	Escolhe `qbcore`, `esx` ou `standalone` e imprime no console
`GetPlayerIdentifier`	citizenid no QBCore, identifier no ESX, `license:` no standalone
`GetPlayerJob`, `GetPoliceCount`	Nomes de trabalho e quantos jogadores possuem um trabalho listado em `Config.PoliceJobs`
`AddMoney`, `RemoveMoney`	Recompensas em dinheiro e compras em dinheiro usam a conta `money`
`AddItem`, `RemoveItem`, `HasItem`	ox_inventory primeiro quando está em execução, caso contrário o framework
`RegisterUsableItem`	Torna o item do tablet utilizável (ESX e QBCore; não faz nada no standalone)
`GiveVehicle`	Coloca um carro com VIN raspado na garagem: `owned_vehicles` no ESX, `player_vehicles` em `pillboxgarage` no QBCore
`IsAdmin`	A ACE primeiro, depois `Config.AdminGroups`
`Notify`	Notificação do framework enviada pelo servidor

bridge/client_bridge.lua

Função	Para que serve
`Notify`	Notificação do QBCore ou ESX, feed nativo no standalone
`ShowTextUI`, `HideTextUI`	O aviso na tela no modo `drawtext`. Exemplos comentados para okokTextUI e cd_drawtextui
`ClientHasItem`	Verificação de item no cliente, usada pela opção de EMP no carro
`AddEntityInteraction`, `RemoveEntityInteraction`	ox_target / qb-target / drawtext no carro
`PoliceDispatch`	Executa no cliente de cada policial quando um alerta é disparado. Padrão: uma notificação e um blip piscando por 60 segundos. Exemplos comentados para cd_dispatch e ps-dispatch

A maioria das notificações que um jogador vê vem de dentro do próprio tablet na forma de toasts, e não através do framework.