Dependências
Inicie todas as dependências antes do Five Royale.vRP
O recurso carrega
@vrp/lib/utils.lua e usa o framework para identidade, permissões e persistência temporária. Toda a integração fica isolada em um único arquivo.five-royale-stream
Pacote de assets (props do loot, textura da parede da zona segura) que acompanha o recurso. Precisa iniciar antes do Five Royale.
Instalação do recurso
1
Copie as duas pastas
O pacote vem com
five-royale e five-royale-stream. Coloque as duas dentro do diretório de recursos do seu servidor.2
Configure o recurso
Edite
config.lua conforme a página de Configuração. É onde ficam cor da interface, modos disponíveis, patentes, mapas e loot.3
Adicione à server.cfg
Garanta que a ordem de inicialização respeite as dependências.
4
Teste com o painel
Use
/painelRoyale (precisa de permissão de administrador) para criar uma partida de teste, ou /evento para abrir o tablet e conferir as salas abertas.Banco de dados
O Five Royale cria as tabelas abaixo automaticamente na inicialização. Não é preciso importar nenhum.sql.
royale_stats
royale_stats
Abates e vitórias acumulados de cada jogador, usados no ranking e na patente.
royale_claimed_tiers
royale_claimed_tiers
Registra quais tiers de recompensa cada jogador já resgatou, um registro por tier.
royale_avatars
royale_avatars
URL da foto de perfil escolhida pelo jogador na aba Patente do tablet.
Integração com o framework
As funções que conversam com o seu framework ficam emserver-side/framework.lua. A versão padrão já vem pronta para vRP. Nenhum outro arquivo chama o framework diretamente — para adaptar a outra base, reescreva apenas as funções abaixo mantendo a mesma assinatura.
Identidade e permissões
Identidade e permissões
Usadas para exibir nomes no lobby, no kill feed e no ranking, e para liberar os comandos de administrador.
Estado do jogador
Estado do jogador
Guardam e restauram o jogador ao entrar e sair da partida, e cuidam do que precisa ser resetado nesse meio-tempo.
Outras funções
Outras funções
Quando alguma dessas funções falha, o recurso avisa no console com o prefixo
[framework.lua] em vez de derrubar a partida. Use esse aviso para achar o ponto que ficou fora do padrão na adaptação.Próximos passos
Configuração
Cor da interface, bots, patentes, mapas e loot.
Modos e mecânicas
Times, zona segura, bots e o fluxo completo da partida.

