Sistema de XP e Nível AZ Scripts para FiveM

AZ XP System 1.0.1 inclui caminhos QBCore e ESX, XP persistente e telas circular ou retangular. O framework é escolhido explicitamente por Config.Framework, sem detecção automática. O manifesto ainda exige qb-core e comenta es_extended; alterar só a configuração não prepara ESX.

Alinhe framework, manifesto e banco

Mantenha azs-xpsystem com fxmanifest.lua, client, server e html. Inicie oxmysql e o framework escolhido primeiro. Para ESX, adapte a dependência do manifesto a Config.Framework antes de ensure azs-xpsystem. player_xp usa citizenid no QBCore ou identifier no ESX. Faça backup dos dados: CREATE TABLE IF NOT EXISTS não migra uma tabela do outro framework.

Os valores reais de config.lua são BaseXPPerLevel=1000, XPMultiplier=1.15, MaxLevel=100 e UIStyle=rectangular. O exemplo README usa outros valores. F5 é a tecla padrão de /togglexp; ShowTime=4000 controla a exibição temporária. Balanceie com a configuração instalada.

Mantenha a progressão autoritativa

Os exports de servidor incluem AddXP, AddLevel e GetPlayerXPData. Exports do cliente também pedem concessões, e existe o comando de teste /addxp sem restrição. Os handlers de rede aceitam valores do cliente sem autorização ou limites numéricos. Remova ou restrinja esse caminho e conceda progresso por lógica confiável no servidor com valores validados.

AddLevel muda o nível e zera current_xp sem atualizar total_xp. Ao carregar depois, dados inconsistentes são recalculados de total_xp, podendo desfazer a mudança direta. Mantenha esses valores coerentes e teste concessão, reabertura da interface e reconexão.

O salvamento é assíncrono sem resultado final verificado, e a interface relê o banco. Teste falhas de gravação e concessões simultâneas em vez de aceitar uma notificação como prova de persistência. Em MaxLevel, AddXP ainda pode acumular current_xp; defina o limite desejado e confira ambos os estilos.

Revisado em 11 de setembro de 2026 na revisão 9d53320f9199ba84199f78c81beaa63e23997335. Lua, configuração, manifesto, dois exemplos SQL e HTML/JavaScript NUI foram lidos. Nenhuma concessão de XP, mudança de nível, interface no jogo ou migração foi executada.

Ler AZ XP System na revisão verificada