SkinsRestorer: gerenciando skins no seu servidor

O que é o SkinsRestorer

O SkinsRestorer é um plugin gratuito e de código aberto que dá aos jogadores controle sobre a própria skin direto no servidor. No Minecraft padrão, trocar de skin significa entrar no minecraft.net, enviar um arquivo PNG e reconectar ao servidor. O SkinsRestorer reduz tudo isso a um único comando.

O plugin é mais importante em servidores offline-mode (online-mode: false), onde as skins dos jogadores não estão ligadas a uma conta da Mojang. O SkinsRestorer permite que eles escolham qualquer skin e a mantém entre as sessões.

O SkinsRestorer está instalado em milhares de servidores e tem mais de 3 milhões de downloads. Você pode baixá-lo no site oficial, no SpigotMC ou no Modrinth.

Comandos de skin

O comando /skin set permite usar a skin de qualquer jogador com conta paga. Você digita o nome de usuário de um jogador famoso (por exemplo Technoblade, Dream) e o SkinsRestorer busca a skin dele na API da Mojang. A troca é instantânea: não precisa reconectar.

Instalação

Em um servidor único, instalar significa colocar o arquivo .jar em plugins/ e reiniciar. Em uma rede com vários servidores, a configuração é um pouco mais elaborada:

1. Instale o SkinsRestorer no proxy (Velocity ou BungeeCord)
2. Instale o SkinsRestorer em todos os servidores backend
3. Configure o SkinsRestorer no modo proxy nos servidores backend

No plugins/SkinsRestorer/config.yml dos backends, defina:

# Nos servidores backend atrás de um proxy
api:
  enabled: true

# Não permitir comandos de skin nos backends, só no proxy
commands:
  disable-skin-command-on-backend: true

Assim o proxy cuida dos comandos de skin, e os backends só exibem as skins sincronizadas a partir do proxy.

Configuração em rede

Em uma rede de servidores, o SkinsRestorer sincroniza as skins por plugin messaging (o canal do BungeeCord/Velocity). Quando um jogador troca de skin no proxy, a mudança é propagada automaticamente para todos os servidores backend.

Configurações importantes em rede:

• Modo proxy - instale a instância principal no proxy e apenas o módulo de sincronização nos backends
• Armazenamento - o SkinsRestorer guarda as skins em arquivos ou em MySQL. Em rede, recomenda-se o MySQL para acesso compartilhado
• Cache - o plugin guarda em cache as skins já obtidas para não consultar a API da Mojang a cada login
• Cooldown - defina um cooldown para as trocas de skin (por exemplo 30 segundos) para evitar spam na API

Skins customizadas

O SkinsRestorer suporta várias fontes de skin:

• Nome de usuário de uma conta paga - /skin set Notch busca a skin atual da conta da Mojang
• URL de um arquivo PNG - /skin url https://example.com/skin.png converte a imagem em uma skin
• GUI de skins - /skins abre um menu com skins predefinidas (você configura a lista no config)
• Skins padrão - o admin pode definir uma skin padrão para jogadores novos no lugar do Steve/Alex

Você configura as skins predefinidas da GUI no skins.yml. Isso é útil em servidores de RPG, onde você quer oferecer skins que combinem com o tema do servidor (cavaleiros, magos, ladrões e assim por diante).

Dicas

• Bloqueie skins inadequadas - o SkinsRestorer permite bloquear skins e nomes de usuário específicos (por exemplo skins com imagens ofensivas). Use a blocklist no config
• Limite de requisições da API da Mojang - a API da Mojang limita as requisições. O SkinsRestorer guarda as skins em cache, mas com centenas de jogadores entrando ao mesmo tempo pode haver atrasos
• Funciona com o FastLogin - os dois plugins trabalham juntos em servidores que usam a configuração "semi-premium" do FastLogin. O FastLogin autentica os jogadores com conta paga e o SkinsRestorer gerencia as skins
• Skins pelo console - o admin pode trocar a skin de outros jogadores com /skin set [jogador] [nick] no console do servidor

Relacionados: como trocar de skin, FastLogin, Velocity.