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.

O plugin ou o servidor precisa de uma versão do Java mais recente (UnsupportedClassVersionError)

Assim aparece a mensagem:

[ModernPluginLoadingStrategy] Could not load plugin '<Plugin>.jar' in folder 'plugins'
org.bukkit.plugin.InvalidPluginException: java.lang.UnsupportedClassVersionError: <Class> has been compiled by a more recent version of the Java Runtime (class file version 69.0), this version of the Java Runtime only recognizes class file versions up to 65.0

O que está por trás: Os programas Java são compilados para uma determinada versão do Java. O ficheiro indicado na mensagem exige uma versão do Java mais recente do que a que o teu servidor está a usar neste momento. Os números revelam qual: número menos 44 dá a versão do Java, ou seja, 69 corresponde ao Java 25 e 65 ao Java 21. Se a mensagem mencionar um plugin, esse plugin não arranca. Se disser respeito ao próprio JAR do servidor, o servidor inteiro não arranca.

Como resolver:

  1. Lê o nome do ficheiro a seguir a Could not load plugin. Esse é o ficheiro que não é compatível.
  2. Na página do plugin, descarrega a versão que foi criada para a tua versão do Minecraft.
  3. Substitui o ficheiro antigo em Ficheiros, na pasta plugins/, e reinicia o servidor.
  4. Se precisares mesmo dessa versão do plugin, muda o servidor em Versão para a versão do Minecraft que ela exige. A versão do Java adequada é definida automaticamente por nós para cada versão do Minecraft. Cria antes uma cópia de segurança.

Bom saber: A pasta plugins/.paper-remapped é uma cópia de trabalho do Paper. Substitui sempre o ficheiro diretamente em plugins/.

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

O plugin foi criado para uma versão do Minecraft mais recente (Unsupported API version)

Assim aparece a mensagem:

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

O que está por trás: Cada plugin traz consigo um pequeno ficheiro de identificação, o plugin.yml. Nele consta em api-version para que versão do servidor foi escrito. Se essa versão for mais recente do que a do 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 falta por completo tudo o que o plugin deveria fazer: comandos, regras de proteção, menus.

Como resolver:

  1. Compara o número a seguir a Unsupported API version com a versão do Minecraft do teu servidor em Versão.
  2. No Modrinth ou no SpigotMC, filtra as transferências do plugin pela tua versão do Minecraft e descarrega a versão adequada.
  3. 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 a api-version tu mesmo no ficheiro do plugin. O plugin passa a carregar, mas usa funções que o teu servidor não tem e acaba por falhar mais tarde com outros erros.

Mais informações: Mudar a versão do Minecraft e o loader de mods 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?

O plugin indica: esta versão do servidor não é suportada

Assim aparece a mensagem:

[Essentials] You are running an unsupported server version!
[DecentHolograms] Plugin will now be disabled.
This plugin does not support Paper servers!

O que está por trás: O plugin verifica no arranque em que versão do Minecraft e em que software de servidor está a funcionar. Se nenhum dos dois constar da sua lista, 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 servidor em si continua a funcionar.

Como resolver:

  1. Na Consola, escreve plugins. Os plugins apresentados a verde estão ativos, os apresentados a vermelho estão desativados.
  2. Consulta na página do plugin quais as versões do Minecraft e o software de servidor suportados.
  3. Descarrega a versão adequada e substitui o ficheiro antigo em Ficheiros, na pasta plugins/.
  4. Se não existir nenhuma, escolhe em Versão uma versão do Minecraft que o plugin suporte. Se ele exigir outro software de servidor, usa Mudar software / loader. Cria antes uma cópia de segurança.

Bom saber: Se o plugin continuar a verde apesar do aviso, normalmente as funções básicas funcionam. Testa os comandos de que precisas e instala a atualização assim que sair.

O Paper não consegue adaptar um plugin mais antigo à versão do servidor (PluginRemapper)

Assim aparece a mensagem:

[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: As versões mais recentes do Paper reescrevem automaticamente, no arranque, os plugins mais antigos para a estrutura interna da versão atual do Minecraft. Esta reescrita chama-se remapping e o Paper guarda as cópias finalizadas 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 só 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. Se o nome contiver algo como (1), o ficheiro provavelmente está duplicado na pasta. Remove a cópia a mais em Ficheiros.
  3. Descarrega uma versão do plugin criada expressamente para a tua versão do Minecraft. Assim o Paper não tem de reescrever nada. Usa-a para substituir o ficheiro antigo em plugins/.
  4. Reinicia e verifica se a mensagem desapareceu.

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

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

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.

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.