O start.bat ideal deve garantir que o servidor limpe o cache e utilize os recursos de performance do Windows.

@echo off
title WarnDocs 3.0 - Servidor de Alta Performance
color 0b
echo ====================================================
echo    WARNDOCS 3.0 - OTIMIZACAO DE PERFORMANCE
echo ====================================================
echo [1/3] Limpando Cache do Servidor...
if exist cache rd /s /q cache
echo [2/3] Definindo Prioridade do Processo...
echo [3/3] Iniciando FXServer com Build 3407...
..\artifacts\FXServer.exe +set sv_enforceGameBuild 3407 +exec server.cfg
pause

Script para reabrir o servidor automaticamente em caso de queda (Crash):

@echo off
title WarnDocs 3.0 - Monitoramento Anti-Crash
color 0c
:run
echo ====================================================
echo    SISTEMA DE MONITORAMENTO ATIVO (24H ONLINE)
echo ====================================================
echo [%time%] Iniciando servidor...
start /wait /high ..\artifacts\FXServer.exe +set sv_enforceGameBuild 3407 +exec server.cfg
echo.
echo ====================================================
echo    [ALERTA] SERVIDOR FECHADO OU CRASHADO!
echo    REINICIANDO EM 10 SEGUNDOS...
echo ====================================================
timeout /t 10
goto run

• taskkill /f /im FXServer.exe : Força o fechamento de todos os servidores travados.
• netstat -ano | findstr :30120 : Verifica se a porta do servidor está sendo usada por outro processo.
• ipconfig /all : Identifica o endereço IP local e físico para configuração de licença.

Os valores acima são otimizados para uma VPS padrão de 8GB a 16GB RAM. Veja como ajustar baseado no seu plano:

• VPS 4GB: Use metade dos valores de TxdStore e FragmentStore para evitar estouro de memória física.
• VPS 16GB+: Você pode dobrar o StaticBounds para 10000 se o seu servidor tiver muitos mapas pesados.
• Dica de Ouro: Nunca defina valores infinitos. O motor RAGE tem limites físicos; valores muito altos podem causar instabilidade no sistema operacional da VPS.

Nesta seção, você define a "alma" do servidor. Os comentários no código ajudam a identificar onde cada link ou nome deve ser inserido.

• Config.Logo_Cidade: O link da imagem (PNG/JPG) que aparecerá em todos os menus e notificações.
• nome_cidade: Define o nome que aparece no "Game Type" do FiveM e em tags internas.
• dinheiro_inicial: O valor que o jogador recebe assim que cria o personagem (Padrão: 35.000).
• whitelist: Se estiver como true, apenas jogadores aprovados podem entrar. Se false, o servidor é aberto.

Config.Logo_Cidade = "https://i.imgur.com/9tgc2PX.png" -- Link da Logo
Config.Basico = {
    nome_cidade = "Base Core", -- Nome nas tags e Game Type
    link_loja = "www.warn-nuis.com", -- Link da sua loja
    dinheiro_inicial = 35000, -- Dinheiro ao criar personagem
    whitelist = true, -- Ativa/Desativa Whitelist
}

Define onde o jogador começa e o que ele carrega para sobreviver nos primeiros momentos.

• creatorCoords: A sala de criação de personagens. Geralmente um local fechado ou "vazio".
• spawnCoords: O local exato onde o player "nasce" na cidade após terminar a criação.
• itens_inicial: Tabela de itens obrigatórios. Cada item tem seu nome (spawn name) e quantidade.

spawn = {
    creatorCoords = { x = -811.7, y = 175.22, z = 76.73, h = 107.72 },
    spawnCoords = { x = 272.47, y = -1197.29, z = 29.28 },
},
itens_inicial = {
    [1] = { item = "milkfrutos", quantidade = 5 }, -- Comida inicial
    [2] = { item = "catburger", quantidade = 5 }, -- Comida inicial
    [3] = { item = "cellphone", quantidade = 1 }, -- Celular
    [4] = { item = "radio", quantidade = 1 }, -- Rádio
    [5] = { item = "dollars", quantidade = 5000 }, -- Dinheiro "limpo"
}

Essencial para otimização. Servidores com muitos NPCs tendem a ter mais lag e menor FPS.

• VehicleDensity: Densidade de carros de NPCs. (0.0 remove todos).
• PedDensity: Densidade de pessoas andando. (0.0 remove todos).
• limpar_vehs: Limpa veículos vazios a cada X minutos (Evita poluição visual e lag).
• limpar_npcs: Remove NPCs gerados aleatoriamente a cada X minutos.

npcs = {
    VehicleDensity = 0.0, -- Densidade de Carros (NPC)
    PedDensity = 2.0, -- Densidade de Pedestres (NPC)
},
otimizacoes = {
    limpar_vehs = { ativo = true, minutos = 180 }, -- Limpa carros a cada 3h
    limpar_npcs = { ativo = true, minutos = 10 }, -- Limpa NPCs a cada 10min
}

Configura quem pode usar cada comando e para qual Webhook a log de uso será enviada.

• perms: Lista de grupos que têm acesso ao comando (Ex: "Admin", "Moderator").
• webhook: Link do canal do Discord onde a ação será registrada.
• /mundo: Altera a dimensão (routing bucket) para evitar ser visto por outros.
• /god: Dá vida infinita ao jogador especificado ou a si mesmo.

Config.Comandos = {
    ["/mundo"] = { perms = { "Admin","Moderator" }, webhook = "" },
    ["/god"] = { perms = { "Admin","Moderator","Helper" }, webhook = "" },
    ["/nc"] = { perms = { "Admin","Moderator","Helper" }, webhook = "" }, -- NoClip
    ["/group"] = { perms = { "Admin" }, webhook = "" }, -- Seta cargo
    ["/tuning"] = { perms = { "Admin" }, webhook = "" }, -- Tuna o carro
}

Integração automática com o Discord para dar benefícios a Streamers, TikTokers e Boosters.

• role_id: O ID do cargo no seu servidor do Discord.
• beneficios: O que o jogador ganha ao ter esse cargo (Grupos, Carros exclusivos, Itens).
• skin_adultos: Bloqueia ou permite skins específicas para esses cargos.

Influencer_Config = {
    settings = {
        [1] = { 
            role_id = "ID_DO_CARGO",
            beneficios = {
                grupos = { 'Influencer' },
                carros = { { carro = "sl63amg22", baby = false } }
            }
        }
    }
}

Configurações de assaltos a NPCs e venda de drogas com sistema de perícia policial.

• Config.Roubo_NPC: Itens e dinheiro que podem ser obtidos ao render um NPC na rua.
• Config.Venda_Drogas: Preços dinâmicos (Min/Max) e a Fórmula Química para a polícia identificar a droga.
• wnPoliceSystem: A fórmula molecular (Ex: C21H30O2) que aparece no laboratório de perícia.

Config.Venda_Drogas = {
    itens = {
        { item = "lean", priceMin = 220, priceMax = 300, wnPoliceSystem = "C21H30O2" },
        { item = "cocaine", priceMin = 220, priceMax = 300, wnPoliceSystem = "C43K12M9" },
    }
}

Gerenciamento de restrições de veículos e capacidades físicas (Reboque).

• carros_baby: Carros exclusivos para crianças. Adultos são ejetados automaticamente.
• carros_blindado: Veículos que possuem proteção extra contra disparos.
• reboques: Veículos que têm a física habilitada para guinchar outros carros.

carros_baby = { ['babyamarokbr'] = true, ['miniaranha'] = true },
carros_blindado = { [GetHashKey('wrbmwg05')] = true },
reboques = { ['flatbed'] = true, ['WRflatbed'] = true }

Monitore ações suspeitas e evite que cheaters spawnem itens ou dinheiro.

• Inventario-UsarItem: Registra cada item usado por qualquer jogador.
• Função-giveInventoryItem: Log crucial para detectar se alguém está ganhando itens fora do sistema normal.
• Função-Hackers: Monitora se algum script vital foi parado por programas externos.

Configurações de lucro para atividades ilegais e locais de roubo rápido.

• Multiplicar: Fator de lucro sobre o valor do veículo no banco de dados. (Recomendado: 1.5).
• quantidade_policia: Mínimo de policiais em serviço para iniciar um roubo a registradora.
• TempoDeRoubo: Tempo em segundos que o jogador deve ficar parado para concluir o roubo.

Config.Desmanche = {
    Valor_Default = 50000, -- Se o carro não tiver preço no SQL
    Multiplicar = 1.5, -- Multiplicador de lucro
}
Config.Roubo_Registradora = {
    quantidade_policia = 2, -- Policiais necessários
    TempoDeRoubo = 15, -- Segundos
    dinheiro_ganho = { minimo = 3000, maximo = 5000 }
}

Gerenciamento de pagamentos automáticos e comandos de visualização de serviço.

• cooldown: Intervalo em minutos para o recebimento do salário (Padrão: 30 min).
• Config.ComandoStatus: Define quais profissões aparecem no comando /status (Ex: Hospital, Polícia).
• Config.RoupaPresidio: Define automaticamente a skin que o jogador usará ao ser preso.

Config.Salarios = {
    cooldown = 30, -- Minutos entre salários
    lista = {
        { title = "Diamante", cargo = "VipDiamante", valor = 5000 },
        { title = "Influencer", cargo = "Influencer", valor = 4000 }
    }
}
Config.ComandoStatus = {
    [1] = { nome = "Hospital", permissao = "Paramedic" },
    [4] = { nome = "Policia", permissao = "Police" }
}

Cada NPC é definido por um bloco de código dentro da tabela pedList. Veja o que cada parâmetro faz:

• coords: Localização exata (X, Y, Z e H - Rotação).
• model: O modelo do Ped. Pode ser o Hash (0x...) ou o nome da skin ("ig_benny").
• anim: A animação que o NPC ficará executando em loop (Dicionário e Nome da animação).
• distance: Distância em metros para o NPC ser "spawnado" (carregado) na tela do jogador.
• wnTarget (Opcional): Se true, o NPC aceita interações do sistema de "Z" (Target).

{
    distance = 100,
    coords = { 953.93, -943.76, 42.95, 90.71 },
    model = { 0xC4B715D2, "ig_benny" },
    anim = { "anim@heists@heist_corona@single_team", "single_team_loop_boss" }
}

O seu arquivo já vem pré-configurado com locais essenciais:

• Mecânica Sul (OVERSPEED): Configurado nas linhas 10-22 com modelos ig_benny.
• Mercado Ilegal: Localizado nas linhas 46-60. Possui o parâmetro wnTarget = true para interação.
• NPCs de Venda (Ponte/Túnel/Praia): Diversos NPCs espalhados para sistemas de economia e rotas.
• Munição & Armas: NPCs vendedores configurados com animações de atendente.

Para adicionar um novo NPC, basta copiar um bloco existente e alterar as coordenadas:

1. Pegue as coordenadas no jogo (/coords).
2. Escolha um modelo de Ped (Ex: s_m_y_blackops_01).
3. Defina uma animação (Ex: WORLD_HUMAN_GUARD_STAND).
4. Cole o novo bloco antes do último } do arquivo.

Diferente de zonas circulares simples, a Base Warn utiliza PolyZone, permitindo criar polígonos complexos que se ajustam perfeitamente ao formato de praças, hospitais e interiores.

• vector2(X, Y): Cada ponto que forma o desenho da zona no mapa.
• minZ / maxZ: Define a altura mínima e máxima da zona (Chão e Céu).
• debugPoly: Se true, mostra as linhas da zona dentro do jogo para testes.

["Praca"] = PolyZone:Create({
    vector2(205.79, -1024.9),
    vector2(208.78, -1025.24),
    -- ... outros pontos
},{
    ["name"] = "Praca",
    ["minZ"] = 0.00,
    ["maxZ"] = 150.00
})

Ao entrar em uma Safezone, o servidor pode disparar estados locais (LocalState) para habilitar funções de áudio ou músicas específicas.

• status = true: Ativa o sistema de áudio na zona.
• LocalState: Define a tag de permissão ou estado para scripts de terceiros.

SpotifyInfos = {
    ["Praca"] = { status = true },
    ["Hospital"] = { LocalState = "Paramedic" },
    ["Cafe"] = { LocalState = "Cafe" }
}

Sua base já vem com as seguintes zonas protegidas:

• Praça Principal: A maior zona, cobrindo todo o centro social.
• Spawn: Proteção para players que acabaram de entrar no servidor.
• Hospital: Área neutra para tratamento médico.
• Café & OverSpeed: Zonas de interação social e mecânica.

Blips são os marcadores visuais no mapa do GTA V. Eles ajudam os jogadores a se localizarem e encontrarem serviços essenciais na cidade.

• Sprite (ID): O ícone que aparece (Ex: 52 para Loja, 361 para Posto).
• Cor: A cor do ícone (Ex: 2 para Verde, 1 para Vermelho, 4 para Azul).
• Escala: O tamanho do ícone no mapa (Padrão: 0.7 ou 0.8).
• Nome: O texto que aparece ao passar o mouse sobre o ícone no mapa.

Embora o arquivo possa variar, a estrutura padrão para adicionar blips na Base Warn segue este modelo:

{ 
    name = "Loja de Departamento", 
    coords = { 25.65, -1346.58, 29.49 }, 
    id = 52, 
    color = 2, 
    scale = 0.5 
}

Você pode consultar a lista completa de IDs no site oficial do FiveM Documentation.

Cada animação é registrada com um nome curto (atalho) que o jogador usará no chat (Ex: /e joinha). A estrutura básica define como o personagem deve se comportar:

• dict: O dicionário de animação do GTA V.
• anim: O nome da animação específica dentro do dicionário.
• prop: Objeto que o personagem segura (Ex: prop_amb_beer_bottle).
• flag: Define o comportamento (Ex: 49 permite andar enquanto executa).
• loop: Se a animação deve se repetir infinitamente ou rodar apenas uma vez.

["bahia"] = { 
    dict = "paper_1_rcm_alt1-8", 
    anim = "player_one_dual-8", 
    prop = "time03prop", 
    flag = 49, 
    mao = 28422 
}

O arquivo é organizado em grandes blocos para facilitar a localização:

• Sociais: Joinha, tchau, palmas, apontar.
• Trabalho: Bandeja de garçom, prancheta, ferramentas, varrer.
• Esportes: Karatê, boxe, alongamentos, flexões.
• Interação: Sentar, deitar, encostar em paredes, carona.
• Diversos: Spray de pichação, usar celular, beber, comer.

Ao adicionar novas animações, preste atenção aos seguintes pontos:

• Props: Se a animação usa um objeto, você deve configurar o mao (osso da mão) e as posições (pos1 a pos6) para que o objeto não fique flutuando.
• Flags: Use flag = 49 para animações da parte superior do corpo que permitem ao jogador continuar andando.
• Comando /e: Todas as animações cadastradas aqui podem ser testadas no jogo usando /e [nome].

O bloqueio funciona através de uma blacklist dividida por gênero (Masculino e Feminino). Você pode bloquear qualquer categoria de roupa:

• mascara, maos, calca, cabelo.
• mochila, sapato, acessorios, blusa.
• colete, jaquetas, chapeu, oculos.

Além de apenas bloquear, você pode definir uma permissão específica para que apenas certos jogadores possam ver e usar o item.

['mascara'] = {
    [37] = { permission = 'jns.acess' }, -- Apenas quem tem a permissão 'jns.acess' pode usar a máscara ID 37
}

• ID do Item: O número entre colchetes (Ex: [37]) corresponde ao ID da roupa no menu da loja.
• Gênero: Certifique-se de adicionar o bloqueio tanto no mp_m_freemode_01 (Homens) quanto no mp_f_freemode_01 (Mulheres) se o item for para ambos.
• Limpeza: Deixe as tabelas vazias se não houver bloqueios para aquela categoria específica.

Estes comandos funcionam apenas diretamente no console do servidor ou via RCON:

• kickallc: Kicka todos os jogadores via console.
• msgdc: Envia mensagem de "Cidade Online" no chat.
• reloadconfig: Recarrega as configurações do geral.lua ou blip-mapa.lua sem reiniciar a base.
• playersc: Lista a quantidade de jogadores online no console.

Siga estes passos para configurar a identidade visual dos seus menus:

1. Hospedagem: Suba as imagens do seu inventário e carros para um servidor (Ex: Imgur ou Host próprio).
2. Configuração: No bloco url_images, cole o link base terminando com /.
3. Discord: Vá ao Portal de Dev do Discord, crie uma aplicação e cole o ID em SetDiscordAppId.

url_images = {
    inventario = "http://mauiimagens.shop/imagens/itens/", -- Link das imagens dos itens
    garagem = "http://mauiimagens.shop/imagens/cars/", -- Link das imagens dos carros
}

Ajuste o fluxo da cidade para ganhar FPS:

• VehicleDensity: Recomendado 0.0 para servidores RP pesados.
• PedDensity: Quantidade de pedestres (0.0 remove todos).
• limpar_vehs: Defina ativo = true e o tempo em minutos para deletar carros abandonados.
• limpar_npcs: Essencial para limpar peds gerados aleatoriamente pelo GTA a cada X minutos.

Como usar os bônus visuais e integrações:

• Players Fake: Altere os números em cada horário (ex: ["18:00"] = 50) para adicionar 50 "jogadores fantasmas" na contagem visual nesse horário.
• FiveManage: Gere seu token no painel oficial para habilitar o gerenciamento web.
• Sistema de Derrubar: Se ativo = true, o jogador cai ao apertar "E" duas vezes. O stress define quanto ele ganha por queda.

Para dar itens e carros automáticos para quem tem cargo no Discord:

1. Pegue o ID do seu Servidor (Guild ID).
2. Pegue o ID do Cargo (Role ID) no Discord.
3. Em beneficios, adicione os nomes dos grupos e carros (spawn name).
4. Use baby = true se o carro for exclusivo para skins de criança.

[1] = { 
    role_id = "1461824631399780576",
    beneficios = {
        grupos = { 'Influencer','Spotify' },
        carros = { { carro = "bmwm3", baby = false } }
    }
}

Como criar ou editar um cargo:

• Nome: Nome visual que aparece no inventário.
• Posicao: Ordem no ranking do menu (1 é o topo).
• Permissoes: A tag que você usará nos scripts (Ex: "Admin").
• Hiarquia: Lista de cargos que este cargo pode gerenciar/setar.
• Service: Se true, o jogador pode "bater ponto" com este cargo.