Skip to main content

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.
Abates e vitórias acumulados de cada jogador, usados no ranking e na patente.
Registra quais tiers de recompensa cada jogador já resgatou, um registro por tier.
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 em server-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.
Usadas para exibir nomes no lobby, no kill feed e no ranking, e para liberar os comandos de administrador.
Guardam e restauram o jogador ao entrar e sair da partida, e cuidam do que precisa ser resetado nesse meio-tempo.
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.