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 emserver/class/framework.lua. O arquivo já vem implementado para vRP. Para outro framework, reescreva as funções mantendo o nome e o retorno esperado.
Identidade do jogador
Identidade do jogador
O sistema usa um identificador único e permanente como chave no banco.
Moeda da loja (diamantes / Gemstone)
Moeda da loja (diamantes / Gemstone)
Saldo gasto para comprar níveis e o passe premium. Aponte para a moeda do seu servidor.
Entrega de recompensas (handlers)
Entrega de recompensas (handlers)
Cada O
type de benefício de globalConfig.rewards é resolvido aqui. Adicione um handler novo para criar um tipo novo de recompensa.ctx recebido por cada handler contém:Persistência
Persistência
Por padrão usa o playerdata do vRP. Troque por oxmysql ou outro banco mantendo as assinaturas.
Configuração
Toda a configuração fica emshared/config.lua, na tabela global globalConfig.
Abertura, cores e logo
Abertura, cores e logo
Temporada e progressão
Temporada e progressão
Economia
Economia
XP por tempo online
XP por tempo online
Concede XP automaticamente a cada X minutos de conexão.
Recompensas por nível
Recompensas por nível
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.Missões
Missões
group aceita exatamente "Diárias", "Semanais" ou "Temporada". reset define quando o progresso zera.
