QBox Caça aos Ovos de Páscoa para FiveM

ss_easter, de ShoeShuffler/Shuffle Shop, coloca ovos coletáveis em locais configurados para personagens Qbox. O código usa qbx_core, ox_lib, oxmysql, ox_inventory e ox_target. A configuração fornecida lista 24 locais; arquivos de modelos são um requisito separado, não incluídos automaticamente com o script.

Prepare modelos, itens e persistência

O README vincula modelos da ShopFusion e permite configurar seus próprios modelos. Associe cada chave de Config.EggLocations a um item de inventário e seu modelo a um prop carregado por streaming. Revise as instruções para a versão instalada de ox_inventory em vez de copiar campos de exemplo sem conferir.

Ao iniciar o recurso, o servidor cria uma tabela ss_easter se ela não existir. As coletas são armazenadas em JSON por citizenid único; o limite pretendido é uma coleta de cada ovo por personagem. Faça backup do banco e preserve a tabela nas atualizações; esvaziá-la reinicia o histórico.

Inventário e recompensas precisam de testes

O servidor valida um ID de ovo configurado e rejeita coletas a mais de oito metros. Verifica o estado salvo, mas o grava antes de chamar AddItem e não confere se a inclusão deu certo. Um inventário cheio pode, portanto, deixar o ovo registrado como coletado sem entrega. Revise o tratamento de falhas antes de habilitar recompensas.

Leitura das coletas, gravação do histórico, entrega de itens e prêmios bancários não formam uma transação única nem são protegidos por bloqueio de coleta por personagem. Teste pedidos repetidos e simultâneos, capacidade do inventário, reconexão, personagens separados e cada marco configurado. O cliente remove o ovo local antes da resposta do servidor; pedidos rejeitados também precisam de recuperação.

Fonte e escopo da análise

Código-fonte conferido em 10 de setembro de 2026 na revisão b1a881576314632512409295b5c221648da70438; o manifesto declara a versão 1.0.0. Nenhum modelo de ovo foi instalado e não houve teste de banco de dados, recompensa ou multijogador.

Examinar o código de ss_easter