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.