Um plugin de Minecraft existe como ficheiro JAR (um arquivo Java) na pasta plugins/ e é sempre criado para determinadas versões de Minecraft, uma determinada versão de Java e, na maioria dos casos, também para um determinado software de servidor, como Paper ou Spigot. Se algum destes não corresponder, o plugin não carrega, desliga-se sozinho ou algumas funções deixam de funcionar. Cada secção abaixo trata de uma mensagem concreta: o seu aspeto, o que está por trás dela e como a resolver.

Encontras a mensagem completa na Consola ou em Ficheiros, em logs/latest.log. Lê também as linhas anteriores, onde muitas vezes aparece o plugin afetado. A versão de Java é definida automaticamente por nós, de acordo com a versão de Minecraft. As versões que um plugin suporta estão indicadas na respetiva página de transferência. Antes de mudares a versão ou de alterares ficheiros de configuração e de mundo, cria uma cópia de segurança em Cópias de segurança.

UnsupportedClassVersionError: o plugin ou o servidor precisa de um Java mais recente

É assim que a mensagem aparece:

[ModernPluginLoadingStrategy] Could not load plugin '<Plugin>.jar' in folder 'plugins'
java.lang.UnsupportedClassVersionError: <Class> has been compiled by a more recent version of the Java Runtime …
org.bukkit.plugin.InvalidPluginException: java.lang.UnsupportedClassVersionError: <Class> …

O que está por trás disto: o ficheiro exige uma versão de Java mais recente do que a que o teu servidor utiliza. Na mensagem completa aparecem a versão de ficheiro de classe necessária e a mais alta suportada: 69.0 corresponde ao Java 25, 65.0 ao Java 21. Se a mensagem se referir a um plugin, este não arranca; se se referir ao JAR do servidor, o servidor inteiro não arranca.

Como resolver:

  1. Lê a mensagem completa em Ficheiros, em logs/latest.log, ou na Consola. Verifica o requisito de Java do ficheiro indicado na página do projeto.
  2. No caso de um plugin, descarrega uma versão para a tua versão de Minecraft que também funcione com a versão de Java utilizada. Pára o servidor, substitui o ficheiro antigo em plugins/ e reinicia.
  3. No caso de um JAR de servidor, verifica se o ficheiro corresponde à Versão selecionada. A versão de Java adequada é definida automaticamente por nós para cada versão de Minecraft.
  4. Se precisares de mudar de versão, faz antes uma cópia do servidor em Cópias de segurança. Se a atribuição já estiver correta e o erro persistir, abre um ticket e indica a hora da mensagem.

Em detalhe: Que versão de Java precisa o teu servidor de Minecraft?

„Unsupported API version …“: o plugin precisa de uma versão de Minecraft mais recente

É assim que a mensagem aparece:

[ModernPluginLoadingStrategy] Could not load plugin '<Plugin>.jar' in folder 'plugins/.paper-remapped'
org.bukkit.plugin.InvalidPluginException: Unsupported API version <Versão>

O que está por trás disto: cada plugin traz consigo um pequeno ficheiro de identificação, o plugin.yml. Nele, api-version indica a versão de API necessária, ou seja, a versão da interface de programação do servidor. Se esta versão for mais recente do que o teu servidor, o Paper não carrega o plugin de todo, por exemplo com Unsupported API version 26.1 num servidor com 1.21.11. O servidor arranca, mas tudo o que o plugin deveria fazer falta por completo: comandos, regras de proteção, menus.

Como resolver:

  1. Compara o número a seguir a Unsupported API version com a versão de Minecraft do teu servidor em Versão.
  2. No Modrinth ou no SpigotMC, filtra as transferências do plugin pela tua versão de Minecraft e descarrega a versão adequada.
  3. Pára o servidor, substitui o ficheiro antigo em Ficheiros, na pasta plugins/, e reinicia.
  4. Se não existir uma versão adequada, muda o servidor em Versão para a versão que o plugin exige. Cria antes uma cópia de segurança, pois o mundo é convertido para a nova versão.

Bom saber: não alteres tu próprio a api-version no ficheiro do plugin. Contornar a verificação não acrescenta as funções de servidor em falta; utiliza uma versão adequada do plugin.

Mais informações: Mudar de versão de Minecraft e de modloader em segurança

Um servidor Paper mais antigo não consegue converter um plugin novo (Fatal error trying to convert)

Assim aparece a mensagem:

Fatal error trying to convert Geyser-Spigot <Version>:org/geysermc/geyser/platform/spigot/GeyserSpigotPlugin.class
java.lang.IllegalArgumentException: Unsupported class file major version 65

O que está por trás: O Paper na versão 1.19.4 ou anterior converte os plugins ao carregá-los com um conversor integrado. Esse conversor não consegue ler classes compiladas para Java 21 ou mais recente (major version 65 corresponde ao Java 21, 69 ao Java 25). Por isso, o plugin não é carregado. Isto afeta com frequência o Geyser: nesse caso, os jogadores de Bedrock não conseguem entrar. O servidor em si arranca e os jogadores de Java continuam a conseguir entrar.

Como resolver:

  1. Lê o nome a seguir a trying to convert. Esse é o plugin afetado.
  2. Se quiseres manter a tua versão do Minecraft, descarrega uma versão mais antiga do plugin, criada exatamente para essa versão, e substitui-a em Ficheiros, na pasta plugins/.
  3. Em alternativa, muda o servidor em Versão para o Minecraft 1.20.5 ou mais recente. As builds mais recentes do Paper leem classes de Java 21. Cria antes uma cópia de segurança.
  4. Reinicia e verifica na Consola se o plugin carrega sem erros.

Bom saber: A mensagem aparece muitas vezes seguidas, uma por cada classe. Mesmo assim, só esse plugin é afetado.

Em detalhe: Que versão do Java precisa o teu servidor de Minecraft?

„Unsupported server version“: o plugin não suporta a versão do servidor

Este é o aspeto da mensagem:

[Essentials] You are running an unsupported server version!
[Shopkeepers] Incompatible server version: Shopkeepers cannot be enabled.
[voicechat] Could not load any compatibility for <Versão>

O que está por trás: O plugin verifica no arranque em que versão de Minecraft e em que software de servidor está a ser executado. Se não suportar a versão ou o software do servidor, avisa ou desativa-se total ou parcialmente. O motivo pode ser uma versão demasiado recente ou demasiado antiga, ou o software de servidor errado. O próprio servidor continua a funcionar.

Como resolver:

  1. Em servidores Bukkit/Paper, introduz plugins na Consola. Os plugins apresentados a verde estão ativos e os apresentados a vermelho estão desativados.
  2. Consulta a página do plugin para ver que versões de Minecraft e que software de servidor são suportados.
  3. Descarrega a versão adequada, para o servidor e substitui o ficheiro antigo em Ficheiros, na pasta plugins/. Depois, reinicia o servidor.
  4. Se não existir nenhuma, cria uma cópia de segurança em Cópias de segurança. Depois, escolhe uma versão de Minecraft suportada em Versão ou um software de servidor suportado através de Mudar software / loader. Para uma versão de Minecraft mais antiga, precisas de um mundo compatível; se necessário, usa uma cópia de segurança anterior à atualização.

Bom saber: Um plugin ativo pode ter algumas funções desativadas. Testa os comandos de que precisas.

„Failed to remap plugin jar …“: o Paper não consegue reescrever o plugin

É assim que a mensagem aparece:

[PluginRemapper] Encountered exception remapping plugins
java.util.concurrent.CompletionException: java.lang.RuntimeException: Failed to remap plugin jar 'plugins/<Plugin>.jar'

O que está por trás disto: as versões mais recentes do Paper reescrevem automaticamente, no arranque, os plugins mais antigos para a estrutura interna da versão atual de Minecraft. Esta reescrita chama-se remapping e o Paper guarda as cópias prontas em plugins/.paper-remapped. Em pelo menos um plugin, isto falhou. O servidor continua a arrancar, mas o plugin pode não funcionar de todo ou funcionar apenas parcialmente, muitas vezes sem qualquer outra mensagem de erro.

Como resolver:

  1. Lê o nome do ficheiro a seguir a Failed to remap plugin jar.
  2. Verifica em Ficheiros se existem vários ficheiros JAR do mesmo plugin em plugins/. Remove as cópias a mais confirmadas com o servidor parado.
  3. Descarrega uma versão do plugin expressamente compilada para a tua versão de Minecraft. Pára o servidor e substitui com ela o ficheiro antigo em Ficheiros, em plugins/, e não a cópia de trabalho em plugins/.paper-remapped.
  4. Reinicia e verifica se a mensagem desapareceu.

Bom saber: se não existir uma versão adequada, o plugin ainda não está preparado para a versão do teu servidor. Remove-o ou aguarda uma atualização.

Ficheiros duplicados: Ficheiro de plugin danificado, duplicado ou nenhum plugin

Nome de bloco ou item desconhecido na configuração de um plugin (Unsupported key)

Assim aparece a mensagem:

Unsupported key: minecraft:bed

O que está por trás: O Minecraft regista cada bloco e cada item sob um nome fixo na forma minecraft:<nome>, a chamada chave de registo (registry key). Um plugin ou a sua configuração indica um nome que a tua versão do Minecraft não conhece. Um exemplo típico é minecraft:bed: desde a 1.13, as camas têm o nome da sua cor, por exemplo red_bed. A entrada é ignorada, e o servidor e o resto do plugin continuam a funcionar.

Como resolver:

  1. Vê na Consola ou em logs/latest.log as linhas antes da mensagem. Aí consta qual o plugin que estava a carregar.
  2. Em Ficheiros, abre a configuração desse plugin na pasta plugins/<Plugin>/ e procura o nome indicado.
  3. Substitui-o pela designação atual, que encontras na wiki do Minecraft. As configurações em formato YAML (.yml) são sensíveis: não alteres a indentação nem as aspas.
  4. Reinicia o servidor. Se o nome não constar da tua configuração, mas sim do próprio plugin, só ajuda uma atualização do plugin.

Em caso de erros no ficheiro: O ficheiro de configuração de um plugin tem erros

O plugin precisa de uma biblioteca de texto (Adventure) mais recente do que a do teu servidor

Assim aparece a mensagem:

Caused by: java.lang.ExceptionInInitializerError: Exception java.lang.TypeNotPresentException: Type net.kyori.adventure.text.TranslationArgument not present

O que está por trás: o Adventure é a biblioteca com que o Paper cria textos de chat coloridos, títulos e textos de hover. Está integrada no servidor, por isso a sua versão depende da tua versão do Minecraft. O plugin foi compilado para uma versão mais recente do Adventure, e a classe indicada não existe no teu servidor. Por isso, partes do plugin não arrancam. O servidor continua a funcionar.

Como resolver:

  1. Descobre qual é o plugin afetado. No stacktrace, ou seja, na lista de linhas at … por baixo da mensagem, aparece muitas vezes o nome do ficheiro JAR. Caso contrário, as linhas anteriores ajudam.
  2. Descarrega uma versão mais antiga do plugin, compilada para a versão do teu servidor, e substitui o ficheiro em Ficheiros, na pasta plugins/.
  3. Ou muda o servidor em Versão para uma versão mais recente do Minecraft. Cria antes uma cópia de segurança.

Bom saber: um ficheiro Adventure adicional na pasta plugins/ não ajuda, porque o Paper usa a sua versão integrada.

O ProtocolLib não é compatível com a versão do servidor

Assim aparece a mensagem:

[ProtocolLib] INTERNAL ERROR: Cannot load ProtocolLib.
  If this problem hasn't already been reported, please open a ticket
  java.lang.IllegalArgumentException: Unable to find a field that matches …

O que está por trás: o ProtocolLib é uma biblioteca auxiliar através da qual outros plugins leem e alteram pacotes de rede. Para isso, mexe a fundo nos componentes internos do servidor, que mudam com quase todas as versões do Minecraft. Se o ProtocolLib não encontrar os campos de pacote esperados, não carrega. Todos os plugins que precisam do ProtocolLib também deixam de funcionar.

Como resolver:

  1. Descarrega a build mais recente do ProtocolLib para a tua versão atual do Minecraft. Para versões muito novas, as builds adequadas surgem muitas vezes primeiro como pré-lançamento na página do projeto.
  2. Substitui o ficheiro antigo em Ficheiros, na pasta plugins/. Mantém apenas um ficheiro do ProtocolLib.
  3. Reinicia o servidor por completo, ou seja, pára-o e volta a iniciá-lo, não com /reload.
  4. Escreve plugins na Consola e verifica se o ProtocolLib e os plugins dependentes aparecem a verde.

Bom saber: o pedido para abrir um ticket no ProtocolLib vem do próprio plugin. Normalmente, só falta a build adequada.

Plugins dependentes: O plugin precisa de outro plugin que está em falta

O Citizens desliga-se: a build não é compatível com a versão do Minecraft

Assim aparece a mensagem:

[Citizens] v<Version> (build <Number>) is not compatible with Minecraft <Version> - try upgrading or downgrading Citizens. Disabling.

O que está por trás: o Citizens é um plugin para NPCs, ou seja, personagens controladas pelo computador, como mercadores ou quem dá missões. Cada build do Citizens suporta apenas determinadas versões do Minecraft e builds de servidor. Se não for compatível com o teu servidor, o Citizens desativa-se no arranque. Os teus NPCs não aparecem e os plugins que dependem do Citizens perdem essa funcionalidade. O servidor em si continua a funcionar.

Como resolver:

  1. Verifica em Versão que versão do Minecraft o teu servidor tem.
  2. Descarrega a build do Citizens para essa versão exata. Muitas builds do Citizens têm SNAPSHOT no nome; o que conta é a versão do Minecraft indicada na página de descarga.
  3. Substitui o ficheiro antigo em Ficheiros, na pasta plugins/, e reinicia.
  4. Se não existir uma build adequada, ajusta a versão do servidor em Versão. Cria antes uma cópia de segurança.

Bom saber: try upgrading or downgrading significa que o Citizens pode ser demasiado antigo ou demasiado recente. Por isso, o ficheiro mais recente não é automaticamente o certo.

O plugin indica: não é compatível com a tua versão do Minecraft

Assim aparece a mensagem:

[Citizens] v<Version> (build <Number>) is not compatible with your version of Minecraft. Disabling...
[<Plugin>] Plugin will be disabled!
Your MC version isn't supported

O que está por trás: o plugin foi compilado para outra versão do Minecraft ou outro software de servidor e indica-o ele próprio. Formulações semelhantes são This plugin only supports Spigot-API … ou Unable to load Adventure, chat components will not work. Consoante o plugin, desativa-se por completo ou algumas funções falham, como os textos de chat coloridos. O servidor continua a funcionar.

Como resolver:

  1. Lê o nome do plugin entre parênteses retos no início da linha. Se não estiver lá, aparece nas linhas anteriores.
  2. Consulta na página do plugin quais as versões do Minecraft e o software de servidor que suporta.
  3. Descarrega a versão adequada e substitui o ficheiro antigo em Ficheiros, na pasta plugins/.
  4. Se não existir nenhuma, muda o servidor em Versão para a versão que o plugin exige. Cria antes uma cópia de segurança.
  5. Depois de reiniciar, escreve plugins na Consola e verifica se o plugin aparece a verde.

Bom saber: mudar para uma versão mais recente do Minecraft converte o mundo. Só é possível voltar atrás de forma fiável através da cópia de segurança.

O plugin precisa de uma build do Paper mais recente para a tua versão do Minecraft

Assim aparece a mensagem:

[EntrypointUtil] Class io.papermc.paper.plugin.loader.library.impl.MavenLibraryResolver does not have member field 'java.lang.String MAVEN_CENTRAL_DEFAULT_MIRROR'
java.lang.NoSuchFieldError: …

O que está por trás: o Paper continua a ser desenvolvido mesmo dentro de uma versão do Minecraft, e cada lançamento chama-se build. O plugin acede a um campo da API do Paper, mais precisamente na parte que, no arranque, descarrega bibliotecas adicionais para plugins. Esse campo (MAVEN_CENTRAL_DEFAULT_MIRROR) só existe em builds mais recentes. Na tua build não existe, por isso o plugin não carrega. O servidor em si continua a funcionar.

Como resolver:

  1. Abre Versão no painel e atualiza para a build mais recente do Paper da tua versão do Minecraft.
  2. Reinicia e verifica na Consola se o plugin carrega agora sem erros.
  3. Se não quiseres mudar de build, usa uma versão mais antiga do plugin e substitui o ficheiro em Ficheiros, na pasta plugins/.

Bom saber: uma build mais recente da mesma versão do Minecraft é um passo pequeno. O mundo mantém-se na mesma versão do Minecraft. Mesmo assim, não custa nada fazer uma cópia de segurança antes.

O plugin não encontra componentes internos do servidor (Failed to init reflection)

Assim aparece a mensagem:

Failed to init reflection: Index 3 out of bounds for length 3

O que está por trás: alguns plugins não usam apenas a interface oficial do servidor, mas leem classes internas diretamente pelo nome. Chama-se a isto reflection. Estes componentes internos mudam com quase todas as versões do Minecraft. Se o plugin não encontrar o que espera, foi compilado para outra versão do servidor e as funções que dependem disso falham. O servidor continua a funcionar.

Como resolver:

  1. A mensagem em si não indica nenhum plugin. Consulta na Consola ou em logs/latest.log as linhas imediatamente anteriores. Aí aparece qual o plugin que estava a ser carregado.
  2. Atualiza esse plugin para uma versão adequada à tua versão do servidor e substitui o ficheiro em Ficheiros, na pasta plugins/.
  3. Reinicia e verifica se a mensagem desapareceu.

Bom saber: se não existir uma versão mais recente, o plugin provavelmente já não é mantido. Nesse caso, vale a pena procurar um plugin substituto atual com a mesma função.

Os efeitos de brilho de um plugin estão desativados (GlowingEntities)

Este é o aspeto da mensagem:

[GlowingEntities] [GlowingEntities] Glowing Entities reflection failed to initialize. The util is disabled. Please ensure your version (<Version>) is supported.
java.lang.NoSuchFieldException: MARKER

O que está por trás disto: o GlowingEntities não é um plugin autónomo, mas sim um componente que outros plugins trazem consigo para fazer jogadores, mobs ou objetos brilhar. O componente não encontra um campo interno da build do teu servidor. Por isso, os efeitos de brilho do plugin em causa ficam desativados. O servidor continua a funcionar e, na maioria dos casos, o plugin também continua a funcionar sem os efeitos.

Como resolver:

  1. Descobre qual é o plugin que traz o GlowingEntities. Nas linhas at … por baixo da mensagem aparece uma entrada no formato <Plugin>.jar//….
  2. Descarrega esse plugin numa versão para a tua build do Paper.
  3. Substitui o ficheiro antigo em Ficheiros, na pasta plugins/, e reinicia.

Bom saber: não podes atualizar o GlowingEntities em separado. Isso cabe ao programador do plugin em que o componente está incluído. Se não precisares dos efeitos de brilho, podes ignorar a mensagem até à próxima atualização.

Simple_RTP: as cabeças no menu não são apresentadas

Este é o aspeto da mensagem:

[Simple_RTP] Failed to apply GUI head texture: IllegalArgumentException: Can not set net.minecraft.world.item.component.ResolvableProfile field org.bukkit.craftbukkit.inventory.CraftMetaSkull.profile to com.mojang.authlib.GameProfile

O que está por trás disto: o Simple_RTP é um plugin de teletransportes aleatórios. Para as cabeças do seu menu, define um perfil de jogador no formato antigo (GameProfile). No entanto, a tua versão de Minecraft espera aqui um formato mais recente (ResolvableProfile). As duas coisas não são compatíveis, por isso as cabeças no menu não funcionam. O servidor continua a funcionar.

Como resolver:

  1. Em Versão, verifica que versão de Minecraft o teu servidor tem.
  2. Descarrega o Simple_RTP na versão para essa versão de Minecraft.
  3. Substitui o ficheiro antigo em Ficheiros, na pasta plugins/, e reinicia.
  4. Abre o menu no jogo e verifica se as cabeças já aparecem.

Bom saber: a mensagem pode repetir-se sempre que o menu é aberto. Não causa mais nenhum dano, apenas indica que a versão do plugin está desatualizada.

ZNPCs: os NPCs guardados não são compatíveis com a versão do plugin

Este é o aspeto da mensagem:

io.github.gonalez.znpcs.commands.CommandExecuteException
No enum constant io.github.gonalez.znpcs.npc.<…>.PLAYER

O que está por trás disto: o ZNPCs guarda os teus NPCs, incluindo o tipo e as ações, num ficheiro. Nesse ficheiro consta um tipo ou uma ação que a versão do ZNPCs instalada não conhece, por exemplo ActionType.PLAYER. Isto acontece geralmente quando os NPCs foram criados com outra versão do ZNPCs. O comando executado é interrompido, mas o servidor continua a funcionar.

Como resolver:

  1. Cria uma cópia de segurança em Cópias de segurança.
  2. Instala a versão do ZNPCs com a qual os NPCs foram criados e reinicia.
  3. Se isso não for possível, pára o servidor, abre em Ficheiros o ficheiro plugins/ZNPCs/data.json e remove a entrada do NPC afetado. JSON é um formato de texto com chavetas e vírgulas: uma vírgula em falta torna o ficheiro inteiro ilegível.
  4. Inicia o servidor e testa o comando novamente.

Bom saber: edita o ficheiro apenas com o servidor parado. Se estiver a funcionar, o ZNPCs pode voltar a substituir a tua alteração ao encerrar.

O plugin precisa de Paper ou de uma versão mais recente (failed to register events)

Este é o aspeto da mensagem:

Plugin <Plugin> v<Version> has failed to register events for class <Class> because io/papermc/paper/event/<Event> does not exist.

O que está por trás disto: os plugins reagem a eventos do jogo, por exemplo quando um jogador parte um bloco. Este plugin quer escutar um evento que o software do teu servidor não conhece. Na maioria dos casos, o plugin foi escrito para Paper, mas o servidor está a funcionar com Spigot. Ou então o evento só existe numa versão mais recente de Minecraft. A parte afetada do plugin não funciona, mas o servidor continua a funcionar.

Como resolver:

  1. Lê o nome a seguir a because. Se começar por io/papermc/paper ou com/destroystokyo/paper, o plugin precisa de Paper.
  2. Se o teu servidor funciona com Spigot, muda-o para Paper em Mudar software / loader. Os plugins para Spigot funcionam, em regra, também no Paper. Cria antes uma cópia de segurança.
  3. Se já funciona com Paper, o evento é mais recente do que a tua versão. Usa uma versão do plugin para a tua versão de Minecraft ou altera o servidor em Versão.
  4. Reinicia e verifica se a mensagem desapareceu.

Saber mais: Mudar o software e a versão do servidor no painel

O ficheiro foi compilado para uma versão mais recente do Java (Unsupported class file major version)

Este é o aspeto da mensagem:

java.lang.IllegalArgumentException: Unsupported class file major version 69

O que está por trás disto: os plugins, mods e bibliotecas são compilados para uma determinada versão do Java. O número a seguir a major version indica qual: número menos 44 dá a versão do Java, ou seja, 65 corresponde ao Java 21 e 69 ao Java 25. As ferramentas do teu servidor que leem ou reescrevem plugins e mods ao carregá-los não compreendem esta versão mais recente. A parte afetada não é carregada.

Como resolver:

  1. Nas linhas anteriores, descobre qual o plugin ou mod que estava a ser carregado.
  2. Descarrega uma versão compilada para a tua versão de Minecraft e substitui o ficheiro antigo em Ficheiros, na pasta plugins/ ou mods/, respetivamente.
  3. Em alternativa, atualiza o servidor em Versão para uma versão de Minecraft mais recente, que funcione com Java 21 ou superior. A versão do Java adequada é definida automaticamente por nós. Cria antes uma cópia de segurança.

Bom saber: se imediatamente antes aparecer Fatal error trying to convert, aplica-se a secção sobre servidores Paper mais antigos acima.

Em detalhe: Que versão do Java precisa o teu servidor de Minecraft?

Um plugin antigo procura uma função de chunk removida (IDs legacy)

Este é o aspeto da mensagem:

java.lang.NoSuchMethodException: net.minecraft.world.level.chunk.Chunk.k(net.minecraft.core.BlockPosition)

O que está por trás disto: até ao Minecraft 1.12, os blocos tinham IDs numéricos; a pedra, por exemplo, era o 1. Alguns plugins antigos ainda trabalham internamente com estes IDs legacy e, para isso, acedem diretamente a funções internas do jogo, as classes em net.minecraft. A função de chunk procurada já não existe na tua versão. Por isso, a função de IDs legacy do plugin não arranca. Consoante o plugin, deixam de funcionar algumas ou muitas funcionalidades.

Como resolver:

  1. Consulta o stacktrace por baixo da mensagem, ou seja, as linhas at …. Aí aparece o nome do plugin ou do respetivo ficheiro JAR.
  2. Atualiza esse plugin para uma versão para a tua versão de Minecraft e substitui o ficheiro em Ficheiros, na pasta plugins/.
  3. Se não existir nenhuma, o plugin deixou de ser mantido para versões modernas. Procura um plugin substituto atual.

Bom saber: o nome curto k é um nome interno ofuscado. Esses nomes mudam a cada versão de Minecraft. Por isso, os plugins que os usam diretamente deixam de funcionar em quase todas as atualizações.

O plugin usa uma função de perfil da Mojang obsoleta (cabeças de jogadores)

Este é o aspeto da mensagem:

java.lang.NoSuchMethodException: com.mojang.authlib.GameProfile.getProperties()

O que está por trás: o authlib é a biblioteca da Mojang através da qual o servidor gere os perfis dos jogadores com nome e skin. O plugin lê estes perfis através de um método (GameProfile.getProperties) que já não existe na tua versão do Minecraft. A funcionalidade afetada deixa de funcionar, geralmente as cabeças dos jogadores nos menus. O servidor continua a funcionar.

Como resolver:

  1. Identifica o plugin: o nome dele ou o nome do ficheiro JAR aparece nas linhas at … por baixo da mensagem ou nas linhas anteriores.
  2. Descarrega uma versão deste plugin para a tua versão do Minecraft.
  3. Substitui o ficheiro antigo em Ficheiros, na pasta plugins/, e reinicia.
  4. Abre o menu afetado no jogo e verifica se as cabeças voltam a aparecer.

Bom saber: esta alteração afeta muitos plugins de menus e de cabeças ao mesmo tempo. Se vários plugins deixarem de mostrar cabeças, a causa costuma ser a mesma e cada um precisa da sua própria atualização.

O plugin procura blocos, partículas ou atributos que não existem na tua versão

Este é o aspeto da mensagem:

java.lang.IllegalArgumentException: No enum constant org.bukkit.Material.<NAME>
Unknown material '<NAME>' for button
java.lang.NoSuchFieldError: Class org.bukkit.<Classe> does not have member field '<Campo>'

O que está por trás: cada versão do Minecraft traz novos blocos, partículas e atributos e muda o nome de alguns. O plugin foi criado para outra versão e acede a algo que aqui não existe ou que tem outro nome. Consoante o plugin, o erro aparece a cada ação ou apenas algumas funcionalidades deixam de funcionar. Também Could not initialize Brigadier mappings se enquadra aqui. O Brigadier é o sistema de comandos do Minecraft, que fornece, entre outras coisas, o preenchimento automático com Tab.

Como resolver:

  1. Lê o nome do plugin nas linhas anteriores ou nas linhas at … por baixo.
  2. Descarrega a versão do plugin que corresponde à tua versão do Minecraft e substitui o ficheiro em Ficheiros, na pasta plugins/.
  3. Ou muda o servidor, em Versão, para a versão do Minecraft que o plugin exige. Cria antes uma cópia de segurança.
  4. Se o nome desconhecido estiver num ficheiro de configuração do plugin, por exemplo nos botões de menu, podes substituí-lo aí pela designação atual.

O plugin Marriage não é compatível com a versão do Minecraft

Este é o aspeto da mensagem:

[Marriage] Marriage is not compatible with the version of minecraft you are using
Marriage kissing will be disabled!

O que está por trás: o Marriage permite que os jogadores se casem no jogo e inclui funcionalidades como beijar. O plugin não suporta a tua versão do Minecraft. Por isso, desativa pelo menos a funcionalidade de beijar, e outras partes também podem ser afetadas. O servidor continua a funcionar normalmente.

Como resolver:

  1. Consulta a página do plugin para ver se existe uma versão do Marriage para a tua versão do Minecraft. Podes ver a tua versão em Versão.
  2. Se existir, substitui o ficheiro antigo em Ficheiros, na pasta plugins/, e reinicia.
  3. Se não existir, substitui o plugin por um atual com uma função semelhante. Conta com o facto de que outro plugin não aproveita os dados guardados pelo Marriage e cria antes uma cópia de segurança.

Bom saber: se só te incomoda a falta da funcionalidade de beijar e o resto funciona, podes ignorar a mensagem até sair uma atualização.

O plugin de anticheat ou de pacotes ainda não conhece totalmente a tua versão do Minecraft

Este é o aspeto da mensagem:

java.lang.IllegalStateException: Unknown entity metadata type id: <Número> version V_<Versão>

O que está por trás: alguns plugins leem os pacotes de rede entre o jogo e o servidor, por exemplo o anticheat GrimAC através da biblioteca PacketEvents. Com as novas versões do Minecraft surgem novos tipos de dados para criaturas e objetos, os metadados de entidades. O plugin ainda não conhece um deles, normalmente por ser mais antigo do que a versão do teu servidor. Os pacotes afetados são processados incorretamente. Isto pode causar falsos alarmes do anticheat ou problemas de ligação.

Como resolver:

  1. Atualiza o plugin e, se estiver instalado como ficheiro próprio, também o PacketEvents para uma versão que suporte expressamente a tua versão do Minecraft.
  2. Reinicia o servidor por completo.
  3. Se ainda não existir uma versão adequada, desativa o plugin temporariamente: renomeia o ficheiro dele em Ficheiros, por exemplo para <Plugin>.jar.off. O servidor só carrega ficheiros com a extensão .jar.
  4. Em alternativa, usa em Versão uma versão do Minecraft que o plugin suporte. Cria antes uma cópia de segurança.

Um plugin adicional do WorldEdit usa uma interface removida

Este é o aspeto da mensagem:

[WorldEdit] Got request to set EditSessionFactory <…> EditSessionFactories have been removed …

O que está por trás: o WorldEdit removeu uma interface mais antiga, a EditSessionFactory. Através dela, plugins adicionais conseguiam intercetar cada alteração do WorldEdit. Um plugin adicional, por exemplo para registos de blocos ou proteção de áreas, ainda tenta usá-la. O próprio WorldEdit funciona normalmente. No entanto, a função de registo ou de proteção do plugin adicional não atua sobre as alterações do WorldEdit: o que construíres ou apagares com o WorldEdit não é registado nem bloqueado por ele.

Como resolver:

  1. Descobre qual o plugin que faz o pedido. O nome costuma estar na própria mensagem ou nas linhas anteriores.
  2. Atualiza esse plugin adicional para uma versão que funcione com o teu WorldEdit ou FastAsyncWorldEdit (FAWE, uma variante mais rápida do WorldEdit).
  3. Se não existir, desativa a ligação ao WorldEdit na configuração do plugin adicional, caso exista uma definição para isso.
  4. Reinicia e verifica se a mensagem desapareceu.

Bom saber: até isto ser resolvido, não podes contar com o registo das alterações do WorldEdit nem com a possibilidade de as reverter através dele.

Braslety: a receita não é registada

Este é o aspeto da mensagem:

[Braslety] … java.lang.IllegalAccessException: class com.example.braslety.BraceletsPlugin cannot access …

O que está por trás: o Braslety acede por reflection a classes internas do CraftBukkit. Reflection significa que o plugin lê partes do servidor diretamente, em vez de usar a interface oficial. Na versão do teu servidor, essas partes não estão acessíveis e o Java recusa o acesso. Por isso, a receita afetada não é registada e o item correspondente não pode ser fabricado. O servidor continua a funcionar.

Como resolver:

  1. Verifica se existe uma versão do Braslety para a tua build atual do Paper. Podes ver a tua versão em Versão.
  2. Se existir, substitui o ficheiro antigo em Ficheiros, na pasta plugins/, e reinicia.
  3. Se não existir, substitui o plugin por um mantido ativamente com uma função semelhante.
  4. Verifica no jogo se a receita funciona.

Bom saber: o nome de pacote com.example indica um plugin feito à medida ou pouco difundido. Nesse caso, só o respetivo criador pode fornecer uma atualização.

O ViaVersion não consegue carregar um módulo de tradução

Assim aparece a mensagem:

[ViaVersion] Error during loading of Protocol<Version>To<Version>

O que está por trás: o ViaVersion traduz entre versões do jogo, para que também jogadores com clientes mais recentes ou mais antigos possam entrar. Extensões como o ViaBackwards complementam isto para clientes mais antigos. Cada tradução está num módulo próprio, cujo nome começa por Protocol. Um deles não pôde ser carregado, normalmente porque o ViaVersion e as suas extensões não são compatíveis entre si ou com a versão do servidor. Os jogadores com as versões de cliente afetadas não conseguem entrar. Quem joga exatamente na versão do servidor não é afetado.

Como resolver:

  1. Descarrega as versões mais recentes do ViaVersion e de todas as extensões Via que utilizas.
  2. Substitui todas em conjunto em Ficheiros, na pasta plugins/. Não mistures ficheiros Via antigos e novos.
  3. Reinicia o servidor por completo.
  4. Testa a entrada com a versão de cliente que antes não funcionava.

Para mais detalhes: Configurar o ViaVersion: ligar clientes mais antigos e mais recentes

O LibreLogin não funciona no Spigot

Assim aparece a mensagem:

[LibreLogin] Detected an unsupported server distribution. Please use Paper or its forks. SPIGOT IS NOT SUPPORTED!

O que está por trás: o LibreLogin é um plugin de início de sessão: os jogadores autenticam-se com uma palavra-passe. Isto é especialmente importante em servidores em modo offline. O LibreLogin precisa de Paper ou de um fork compatível, ou seja, uma variante do Paper como o Purpur, e desativa-se no Spigot. Se o teu servidor estiver em modo offline, fica sem proteção por palavra-passe: os jogadores podem ligar-se com nomes de outras pessoas.

Como resolver:

  1. Cria uma cópia de segurança em Cópias de segurança.
  2. Em Mudar software / loader, muda o servidor para Paper ou Purpur. Os plugins para Spigot continuam, em regra, a funcionar aí.
  3. Reinicia e verifica na Consola se o LibreLogin carrega sem esta mensagem.
  4. Se quiseres continuar no Spigot, utiliza um plugin de início de sessão que suporte expressamente o Spigot.

Bom saber: se o teu servidor estiver em modo offline, resolve isto antes de os jogadores entrarem.

Saber mais: Mudar o software e a versão do servidor no painel

Falta ao Nova um parâmetro de arranque do Java (-javaagent)

Assim aparece a mensagem:

[Nova] Missing required JVM argument: -javaagent:plugins/Nova-<Version>.jar

O que está por trás: o Nova é um plugin abrangente que permite blocos e itens próprios em servidores Paper. Para parte das suas funcionalidades, o Java tem de carregar no arranque um chamado Java Agent. É um complemento que fica ativo antes do próprio servidor e é incluído através de um parâmetro de arranque. O teu servidor arranca sem este parâmetro. Por isso, o Nova não funciona na totalidade, mas o servidor em si funciona.

Como resolver:

  1. Lê na mensagem o parâmetro exato, incluindo o nome do ficheiro JAR do Nova.
  2. Não podes alterar tu próprio o comando de arranque do teu servidor Minecraft no painel. Por isso, abre um ticket, copia para lá o parâmetro da mensagem e indica a hora em que a mensagem apareceu.
  3. Se não precisares mesmo do Nova, remove o plugin em Plugins e reinicia o servidor. A mensagem deixa então de aparecer.

Bom saber: com cada nova versão do Nova, o nome do ficheiro no parâmetro costuma mudar também. Por isso, a mensagem volta muitas vezes a aparecer após uma atualização do Nova.

AngelChest: integração com o WorldGuard desativada devido a conflito de versões

É assim que a mensagem aparece:

[AngelChest] WorldGuard integration is disabled.

O que está por detrás: o AngelChest deteta que o WorldGuard não suporta totalmente a tua versão do Minecraft. Por isso, desativa a ligação a esse plugin. As funções do AngelChest que dependem dela deixam de estar disponíveis, enquanto o servidor continua a funcionar. Verifica o comportamento em áreas protegidas antes de voltares a contar com a interação entre os dois.

Como resolver:

  1. Em Versão, anota a versão do Minecraft e, na Consola, verifica as versões dos plugins carregados.
  2. Em Cópias de segurança, cria uma cópia de segurança das tuas definições.
  3. Em Plugins, instala versões do WorldGuard e do AngelChest que suportem a tua versão do Minecraft.
  4. Reinicia o servidor por completo. Verifica se a mensagem desapareceu e testa o AngelChest nas áreas afetadas.

EssentialsSpawn: o teletransporte de novos jogadores falha devido a um método em falta

Assim se apresenta a mensagem:

[EssentialsSpawn] <Player> Failed to teleport new player!
java.util.concurrent.CompletionException: java.lang.AbstractMethodError: Receiver class com.earth2me.essentials.OfflinePlayerStub <Details>

O que está por trás disto: o EssentialsSpawn chama a interface de teletransporte do Paper para um novo jogador. O erro AbstractMethodError significa que a classe do Essentials utilizada não disponibiliza o método esperado. Os componentes instalados não são compatíveis neste ponto; o teletransporte automático falha, enquanto o servidor continua a funcionar.

Como resolver:

  1. Faz uma cópia de segurança da configuração do plugin e consulta na Consola a mensagem de erro completa, bem como as versões dos plugins carregados.
  2. Atualiza o EssentialsX e o EssentialsSpawn em conjunto em Plugins para uma versão compatível com a tua versão do Paper. No caso de ficheiros carregados por ti, usa Ficheiros.
  3. Remove os ficheiros antigos duplicados destes plugins em Ficheiros e reinicia o servidor por completo.
  4. Testa o teletransporte de um jogador que entre pela primeira vez. Se o erro persistir, comunica-o ao projeto EssentialsX com o rasto de erro limpo e todas as versões envolvidas.

Plugin rejeitado pelo Folia por falta de suporte

Este é o aspeto da mensagem:

Could not load plugin '<Plugin> <Versão>' as it is not marked as supporting Folia!

O que está por trás: O Folia processa áreas do mundo em paralelo e, para isso, precisa de plugins adaptados. O plugin em causa não declara este suporte e é rejeitado ao carregar. As suas funções ficam em falta, enquanto outros plugins compatíveis podem continuar a ser carregados.

Como resolver:

  1. Na Consola, vê qual é o ficheiro de plugin afetado e verifica as indicações do autor sobre o Folia.
  2. Em Plugins ou Ficheiros, instala uma versão expressamente suportada e reinicia o servidor por completo.
  3. Se não existir uma versão para Folia, escolhe uma alternativa. Para mudar o software do servidor, cria primeiro uma cópia de segurança em Cópias de segurança e verifica os requisitos de todos os plugins.

Bom saber: Uma declaração de suporte acrescentada por ti não torna o plugin compatível com o Folia.

A tua mensagem não está aqui?

Lê a mensagem completa na Consola ou em logs/latest.log, incluindo as linhas anteriores. Reconheces o plugin afetado pelo nome entre parênteses retos no início da linha ou no stacktrace, a lista de linhas at …: aí aparecem nomes de JAR de plugins/ ou mods/ e nomes de pacotes, que muitas vezes contêm o nome do plugin. Compara depois, na página do plugin, as versões suportadas com o teu servidor. Cria uma cópia de segurança antes de qualquer mudança de versão. Se não conseguires avançar, abre um ticket e indica a hora da mensagem.