Instalação e autenticação

Passo a passo

1

Cadastre o endereço do servidor

No painel, em Licenças, informe o IP e a porta do seu servidor — os mesmos que os jogadores usam para entrar. Ver como fazer ›
2

Escolha os plugins da licença

Marque quais dos seus plugins ficam ativos naquele endereço e em qual versão. Ver como fazer ›
3

Coloque o jar na pasta plugins

Baixe o StarPlugins.jar e jogue em plugins/. Ele não cria arquivo de configuração nenhum: não há nada para preencher.

4

Ligue o servidor

Deu certo quando o console mostra:

[StarPlugins] IP da máquina: 131.196.197.35:20726
[StarPlugins] Plugins localizados: ["StarVips","StarEssentials"]
[StarPlugins] Carregando 2 plugins, por favor aguarde...

Cadastrando o servidor

Cada licença aparece como um slot na página Licenças. Um slot vazio ainda não aponta para lugar nenhum — é você quem diz para qual servidor ele vale.

1 Clique no ícone de lápis da linha do slot.
2 Preencha o nome (só para você se achar) e o IP:porta do servidor.
3 Salve. A partir daí o botão Plugins daquela linha libera.

A bolinha ao lado do nome diz o estado do servidor:

Âmbar — slot ainda sem endereço configurado.
Vermelha — endereço cadastrado, mas o loader não se conectou nos últimos minutos (servidor desligado ou sem o jar).
Verde — o loader está conectado agora. Passe o mouse para ver a versão dele.

Licença por domínio

Se o slot for de domínio, informe o domínio no lugar do IP: a loja resolve o DNS na hora em que o loader autentica. Serve para quem troca de máquina sem trocar o endereço.

Sub-usuários

O ícone de pessoa dá acesso à licença para outra conta da loja — só para editar o endereço, ou também para gerenciar os plugins. Útil para quem tem equipe.

O mesmo IP:porta não pode estar em duas licenças — é ele que identifica o servidor. Se você mudar de host, edite o slot com o endereço novo.

Adicionando plugins à licença

Comprar um plugin coloca ele na sua conta; direcionar para um servidor é o passo seguinte. Clique em Plugins na linha do slot já configurado.

A janela lista os plugins que você comprou. Os que já estão nessa licença aparecem no topo quando ela abre.
Clique em qualquer ponto da linha para marcar ou desmarcar. Use a busca quando a lista for grande, ou Marcar todos para mandar tudo de uma vez.
Termine em Salvar. Só o que estiver marcado é entregue ao servidor — desmarcar remove o plugin de lá no próximo carregamento.

Qual versão cada plugin usa

O selo à direita do nome mostra o modo atual. A engrenagem abre a lista de versões daquele plugin; os botões no rodapé da janela aplicam o modo em todos de uma vez.

Modo	O que acontece
Auto	Acompanha as atualizações: o servidor sempre sobe com a versão mais nova publicada.
Mais recente	Trava na versão que é a mais nova hoje, e fica nela mesmo quando sair outra.
Manter atual	Continua na versão que esse servidor já estava usando.
Versão escolhida	Uma versão específica que você seleciona na engrenagem.

Depois de salvar, reinicie o servidor para os plugins novos entrarem. Para trocar só a versão de um plugin que já está rodando, use /starplugins menu e clique em Atualizar.

Um plugin marcado como sem versão ainda não tem build publicada e por isso não pode ser selecionado. Plugins que você não comprou não aparecem na lista.

Falha na autenticação

Se o endereço não bate com nenhuma licença, o servidor é desligado de propósito — subir sem os plugins pagos só esconderia o motivo real de tudo estar faltando.

[StarPlugins] Falha na autenticação (not_found: 131.196.197.35:20726), desligando servidor...
[StarPlugins] Siga nosso tutorial de autenticação em: https://starplugins.com.br/tutorial

O endereço entre parênteses é o que a loja enxergou. Confira:

not_found — esse IP:porta não está cadastrado em nenhuma licença sua. Copie exatamente o que apareceu no console para o painel.
expirada — a licença venceu; renove pelo painel.
Licença válida, mas sem plugins — o endereço está certo e nenhum plugin foi marcado para ele. Volte em Adicionando plugins à licença.

Como o loader funciona

Configurações

Cada plugin cria a própria pasta em plugins/<Nome>/, igual a qualquer outro. Editar o config funciona do jeito de sempre.

Nada de jar solto

Os plugins são carregados direto da memória. Você não vai encontrar os .jar na pasta do servidor — é o que protege quem compra e quem vende.

Comandos

/starplugins lista os plugins com os detalhes no hover e /starplugins menu abre o painel para atualizar, carregar e descarregar cada um.

Precisa de internet

O servidor busca os plugins na loja a cada start. Bloquear a saída para starplugins.com.br impede o carregamento.

Travou em algum passo?

Abra um ticket no painel com o print do console — a mensagem de erro já diz qual endereço a loja recebeu.

Abrir ticket Comunidade no Discord