Skip to main content

Dependências

Base Five (vRP)

O recurso já vem pré-configurado para a base Five Network (vRP). A integração fica isolada em server/class/framework.lua.

five-vehicles

Opcional. Necessário apenas se você usar recompensas do tipo vehicle. A entrega usa o export giveVehicle.
A persistência padrão usa o playerdata do vRP (vRP.UserData e vRP.setUData), sem necessidade de criar tabelas. Para outro backend, reescreva loadUser e saveUser no framework.lua.

Instalação do Recurso

1

Copie a pasta do recurso

Coloque a pasta core-battlepass dentro do diretório de recursos do seu servidor (ex: resources/[core]/).
2

Informe o token de licença

Abra o arquivo token.lua na raiz do recurso e substitua pelo token recebido.
token.lua
3

Adapte o server/class/framework.lua

Arquivo único de integração com o seu framework, já pronto para vRP. Veja a seção Adaptação de Framework.
4

Configure o shared/config.lua

Defina temporada, recompensas, missões, preços e cores. Veja a seção Configuração.
5

Adicione à server.cfg

Inicie o recurso depois do vrp (e do five-vehicles, se usar recompensas de veículo).
Você só precisa editar shared/config.lua e server/class/framework.lua. Os demais arquivos contêm a lógica do sistema e não devem ser alterados.

Adaptação de Framework

Toda a comunicação com o framework está isolada em server/class/framework.lua. O arquivo já vem implementado para vRP. Para outro framework, reescreva as funções mantendo o nome e o retorno esperado.
O sistema usa um identificador único e permanente como chave no banco.
Em outros frameworks, retorne o identificador permanente: identifier (ESX) ou citizenid (QBCore).
Saldo gasto para comprar níveis e o passe premium. Aponte para a moeda do seu servidor.
Cada type de benefício de globalConfig.rewards é resolvido aqui. Adicione um handler novo para criar um tipo novo de recompensa.
O ctx recebido por cada handler contém:
Por padrão usa o playerdata do vRP. Troque por oxmysql ou outro banco mantendo as assinaturas.

Configuração

Toda a configuração fica em shared/config.lua, na tabela global globalConfig.
Concede XP automaticamente a cada X minutos de conexão.
Uma entrada por nível (1 até totalLevels), cada uma com os tiers classic e premium. Cada tier tem name, image (URL na UI) e a lista benefits.
group aceita exatamente "Diárias", "Semanais" ou "Temporada". reset define quando o progresso zera.
O progresso é avançado por outros scripts com addMissionProgress.