mri_Qfleecaheist — Manual

Assalto aos 6 bancos Fleeca do mapa, com cutscene de abertura do cofre, minigame de furadeira a laser, carrinhos de loot e venda para um comprador.

Sumário

1. Dependências
2. Instalação
3. Fluxo do assalto
4. Configuração
5. Bancos
6. Comandos
7. Log no Discord
8. Integrações
9. Entrypoints para outros recursos
10. Estrutura de arquivos

Dependências

O fxmanifest.lua não declara dependencies — as dependências acima vêm dos exports chamados no código.

Instalação

1. Copie a pasta mri_Qfleecaheist para resources/.

2. Adicione ao server.cfg:

   ensure mri_Qfleecaheist

3. Cadastre os itens usados pelo recurso no inventário:

   Item	Uso
   drill	Exigido para usar a furadeira nos pontos de drill
   bag	Exigido para pegar o loot (grab central, carrinhos e furadeira)
   diamond	Recompensa (carrinho de diamante e caixa-forte)
   goldbar	Recompensa (carrinho de ouro, grab central e caixa-forte)
   cryptostick	Recompensa aleatória na venda ao comprador

   Os nomes de drill, bag, diamond e goldbar podem ser trocados em config.lua. O cryptostick está fixo no server.lua.

4. Troque o webhook do Discord em server.lua — veja Log no Discord.

Fluxo do assalto

1. Início — o jogador chega a até 10 metros do scenePos do banco e atira (IsPedShooting). O servidor checa a contagem de policiais em serviço e o cooldown do banco.
2. Cutscene — o NPC refém (scenePed) executa a cena sincronizada mp_missheist_ruralbank, o alerta é enviado à polícia via ps-dispatch, e as portas do cofre (v_ilev_gb_teldr e hei_prop_heist_sec_door / v_ilev_gb_vauldr) giram até o doorHeading configurado.
3. Loot — dentro do cofre, o jogador se aproxima dos pontos e pressiona E:
   • Grab central — pilha de ouro ou de dinheiro (sorteada por grabReward). Rende multiGrabCount de goldTrolly (15 barras) ou de cashTrolly (100.000 em dinheiro).
   • Carrinhos — cada carrinho é sorteado por trollyReward entre ouro, dinheiro e diamante. A animação dura cerca de 37 segundos e entrega o item correspondente.
   • Furadeira — abre o minigame de scaleform (drilling.lua). Se concluído, entrega a recompensa lockbox (20 unidades de ouro ou diamante, sorteado). Se falhar, o ponto volta a ficar disponível.
4. Saída — ao se afastar mais de 30 metros do banco depois de ter pego algum loot, um blip do comprador aparece no mapa.
5. Venda — chegando a até 15 metros do buyerPos, roda a cutscene hs3f_all_drp3 e o servidor vende todo o diamond e o goldbar do inventário pelos sellPrice configurados.

Configuração

Tudo fica em config.lua.

Config['FleecaMain']

Config['FleecaHeist'][n]

Uma entrada por banco. Todos os campos são obrigatórios.

Strings

Tabela de textos exibidos ao jogador (wait_nextheist, minute, need_item, police_alert, drill, grab_trolly, grab, deliver_to_buyer, buyer_blip, need_police, total_money). Não há sistema de locales — edite direto no config.lua.

As tabelas GrabCash, LaserDrill e Trolly no fim do arquivo definem os dicionários de animação das cenas sincronizadas. Não devem ser alteradas.

Bancos

O cooldown é guardado em memória (lastRob) e reseta quando o recurso reinicia.

Comandos

Log no Discord

O server.lua envia um embed via webhook em dois momentos: quando um assalto começa e quando um jogador vende o loot ao comprador.

discord = {
    ['webhook'] = 'https://discord.com/api/webhooks/...',
    ['name'] = 'rm_fleecaheist',
    ['image'] = 'https://cdn.discordapp.com/avatars/...'
}

O valor que vem no repositório é o webhook do autor original. Troque pelo seu antes de subir o recurso, ou os logs do seu servidor vão para um Discord de terceiros.

Integrações

ps-dispatch

O alerta policial é enviado exclusivamente por exports['ps-dispatch']:FleecaBankRobbery(1), chamado no início de cada assalto. O código de alerta interno (fleecaheist:client:policeAlert, que desenha um blip de raio) continua registrado, mas nada no recurso o dispara.

qb-log

Ao usar /pdfleeca ou o evento radialmenu:resetFleeca, o recurso dispara qb-log:server:CreateLog no canal heistreset. Se o qb-log não estiver instalado, o evento simplesmente não é tratado.

Radial menu

O evento de servidor radialmenu:resetFleeca faz o mesmo que /pdfleeca, mas sem o fallback de permissão god — só funciona para policial em serviço. Registre-o no seu menu radial para dar aos policiais a opção de limpar a cena.

Entrypoints para outros recursos

Evento radialmenu:resetFleeca (servidor)

Limpa o cenário do banco mais próximo do jogador. Exige job police em serviço.

TriggerServerEvent('radialmenu:resetFleeca')

Evento fleecaheist:client:nearBank (cliente)

Dispara o reset a partir do cliente: procura um banco a até 20 metros e pede ao servidor para resetá-lo.

TriggerClientEvent('fleecaheist:client:nearBank', source)

Callbacks de servidor

Registrados via QBCore.Functions.CreateCallback:

-- retorna true se há policiais em serviço suficientes
QBCore.Functions.TriggerCallback('fleecaheist:server:checkPoliceCount', function(ok) end)
 
-- retorna true se o banco `index` não está em cooldown (e marca o início do assalto)
QBCore.Functions.TriggerCallback('fleecaheist:server:checkTime', function(ok) end, index)
 
-- retorna se o jogador tem ao menos 1 unidade do item, e o label do item
QBCore.Functions.TriggerCallback('fleecaheist:server:hasItem', function(has, label) end, 'bag')

Estrutura de arquivos

mri_Qfleecaheist/
├── client.lua        — início do assalto, cenas sincronizadas, portas do cofre, grab/carrinhos/furadeira, venda ao comprador
├── server.lua        — callbacks de polícia/cooldown/item, entrega e venda de recompensas, sync de estado, /pdfleeca, webhook do Discord
├── drilling.lua      — minigame de furadeira (scaleform, base do meta-hub)
├── config.lua        — Config.FleecaMain, Config.FleecaHeist (6 bancos), Strings e dicionários de animação
└── fxmanifest.lua