Os plugins guardam normalmente as suas definições em ficheiros YAML na pasta plugins/<Plugin>/. O YAML é um formato de texto que constrói a sua estrutura através da indentação com espaços. Basta um tabulador ou umas aspas em falta para um plugin deixar de conseguir ler um ficheiro. Cada secção abaixo trata de uma mensagem. Se chegaste aqui através de "Saber mais" na Saúde do servidor, já estás no sítio certo.

Podes encontrar o texto completo na Consola ou em Ficheiros, em logs/latest.log. Quase sempre indica o ficheiro e, muitas vezes, também a linha e a coluna. A seguir surge com frequência um stacktrace, uma lista de linhas at indentadas que mostra em que ponto do programa o erro ocorreu. Antes de qualquer alteração a ficheiros de configuração ou de mundo, cria uma cópia de segurança em Cópias de segurança. O melhor é editares os ficheiros com o servidor parado, pois alguns plugins sobrescrevem a configuração ao encerrar.

Erro de sintaxe YAML num ficheiro de plugin

Este é o aspeto da mensagem:

Cannot load plugins/<Plugin>/config.yml
org.bukkit.configuration.InvalidConfigurationException: sequence entries are not allowed here
 in 'reader', line <Line>, column <Column>:

O que está por trás: O plugin não conseguiu ler o ficheiro YAML indicado ao carregar. O YAML é um formato de texto que constrói a sua estrutura através da indentação com espaços. Os tabuladores são proibidos e alguns carateres têm um significado próprio no início de um valor. A mensagem indica o ficheiro, a linha e a coluna, e o carater ^ por baixo aponta para o local do erro. Consoante o plugin, faltam algumas definições ou o plugin inteiro.

Como resolver:

  1. Abre em Ficheiros o ficheiro indicado na primeira linha e vai à linha mencionada. O erro está aí ou na linha anterior.
  2. Coloca entre aspas os valores que começam por &, *, %, @, { ou [, por exemplo prefix: "&8[&aShop&8] ". Um backtick (`) não é de todo permitido no início de um valor.
  3. Substitui os tabuladores por espaços e indenta as entradas do mesmo nível com a mesma largura.
  4. Verifica o ficheiro com um validador de YAML no navegador e reinicia o servidor.

Bom saber: Se o erro estiver na linha 1, coluna 1, muitas vezes foi copiado texto com a moldura Markdown de um chat. Apaga então as linhas com os três backticks no início e no fim. As entradas de lista com - começam sempre numa linha própria por baixo da respetiva chave.

Item ou local guardado num ficheiro de plugin não é legível

Este é o aspeto da mensagem:

[org.bukkit.configuration.serialization.ConfigurationSerialization] Could not call method 'public static org.bukkit.Location org.bukkit.Location.deserialize(java.util.Map)' of class org.bukkit.Location for deserialization
java.lang.IllegalArgumentException: unknown world

O que está por trás: Os plugins guardam objetos (kits, artigos de lojas, itens de menus) e locais (homes, warps, pontos de spawn) como blocos de dados nos seus ficheiros YAML. Um item guardado numa versão mais antiga do Minecraft por vezes já não pode ser lido pelo formato de itens atual ("Could not deserialize found primitive"). Se abaixo da mensagem aparecer Location e unknown world, um local guardado aponta para um mundo que já não existe ou que ainda não estava carregado no momento da leitura. O servidor continua a funcionar, apenas faltam estas entradas.

Como resolver:

  1. Encontra o plugin afetado. As linhas imediatamente antes e depois da mensagem costumam indicar o plugin ou o seu ficheiro.
  2. Cria uma cópia de segurança, abre o ficheiro em Ficheiros e remove ou renova as entradas de itens afetadas.
  3. Depois, volta a criar os itens no jogo, por exemplo o kit ou o artigo da loja.
  4. Em caso de unknown world: elimina o local ou define-o novamente com os comandos do plugin. Se o mundo ainda existir, garante que está carregado.
  5. Reinicia o servidor e verifica a Consola.

Bom saber: Se eliminaste ou renomeaste um mundo, as homes e warps antigas apontam para o vazio. A mensagem só desaparece quando essas entradas forem removidas.

DeluxeMenus: dois menus usam o mesmo comando

Este é o aspeto da mensagem:

[DeluxeMenus] open_command specified for menu: <Menu> already exists for another menu!
Skipping menu: <Menu>

O que está por trás: No DeluxeMenus, cada menu pode ter um comando próprio com o qual os jogadores o abrem. Está no ficheiro do menu em open_command. Se dois ficheiros de menu tiverem o mesmo comando, o DeluxeMenus ignora o segundo menu e este fica inacessível no jogo. A linha "Skipping menu" indica o menu ignorado. Todos os outros menus e o servidor continuam a funcionar normalmente. Causa mais comum: um ficheiro de menu foi copiado como modelo e o comando não foi alterado.

Como resolver:

  1. Abre em Ficheiros a pasta plugins/DeluxeMenus/gui_menus.
  2. Procura o ficheiro do menu ignorado e o ficheiro que usa o mesmo open_command.
  3. Atribui ao menu ignorado um comando próprio que ainda esteja livre.
  4. Guarda e recarrega o DeluxeMenus com /dm reload, no jogo com barra, na Consola sem barra.
  5. Abre o menu, a título de teste, com o novo comando.

Bom saber: Se um menu só for aberto a partir de outro menu, normalmente não precisa de um comando próprio. Nesse caso, também podes omitir o open_command aí.

O Multiverse não consegue carregar um mundo

Este é o aspeto da mensagem:

[Multiverse-Core] Failed to autoload world '<World>': Failure{reason=WORLD_FOLDER_INVALID}
[Multiverse-Core] Failed to import world <World>: Failure{reason=WORLD_FOLDER_INVALID}

O que está por trás: O Multiverse-Core guarda os seus mundos em plugins/Multiverse-Core/worlds.yml e carrega-os no arranque. A mensagem aparece quando aí consta um mundo cuja pasta não existe ou não contém um mundo válido (WORLD_FOLDER_INVALID), quando o Nether ou o End já são carregados pelo próprio servidor ("already match a world that exists") ou quando um mundo foi importado, mas não carregado (WORLD_EXIST_UNLOADED). O mundo afetado fica inacessível. O servidor e os restantes mundos continuam a funcionar.

Como resolver:

  1. Verifica em Ficheiros se a pasta do mundo existe. Um mundo válido contém, entre outros, o ficheiro level.dat e a pasta region.
  2. Se o mundo já não existir, remove a entrada desatualizada com /mv remove <World>.
  3. Se existir, mas não estiver carregado, carrega-o com /mv load <World>.
  4. O Nether e o End são carregados pelo próprio servidor quando estão ativados em server.properties ou bukkit.yml. Nesse caso, não os adiciones também ao Multiverse.
  5. Reinicia o servidor.

Bom saber: Se a mensagem recomendar a ferramenta Chunkster para reparação, essa indicação vem dos tempos antigos do Bukkit. Em vez disso, restaura uma cópia de segurança do mundo, consulta Dados do mundo danificados, desatualizados ou impossíveis de guardar.

DeluxeMenus: o ficheiro de menu é inválido

Este é o aspeto da mensagem:

[DeluxeMenus] Detected invalid configuration in file: <Menu>.yml
org.bukkit.configuration.InvalidConfigurationException: while scanning a simple key
 in 'reader', line <Line>, column <Column>:

O que está por trás: O DeluxeMenus não consegue processar o ficheiro de menu indicado e não carrega esse menu. Os jogadores não veem nenhuma interface ao usar o comando correspondente, todos os outros menus continuam a funcionar. O motivo exato é indicado nas linhas imediatamente abaixo da mensagem, normalmente um erro de YAML com linha e coluna. Típico é a falta de um espaço depois dos dois pontos, ou seja, hide_attributes:true em vez de hide_attributes: true.

Como resolver:

  1. Lê as linhas abaixo da mensagem e anota a linha e a coluna.
  2. Abre o ficheiro de menu em Ficheiros, normalmente na pasta plugins/DeluxeMenus/gui_menus.
  3. Corrige o local: um espaço depois de cada dois pontos, apenas espaços para indentar, textos com & ou # entre aspas.
  4. Se não houver nenhum erro de YAML, verifica as opções com o guia do DeluxeMenus, por exemplo nomes de materiais ou a escrita das condições.
  5. Recarrega com /dm reload e abre o menu para testar.

Bom saber: Um # depois de um espaço inicia um comentário em YAML. Sem aspas, falta então o resto da linha, por exemplo nas cores hexadecimais.

O plugin não encontra um ficheiro esperado

Este é o aspeto da mensagem:

java.io.FileNotFoundException: plugins/<Plugin>/<File> (No such file or directory)

O que está por trás: O plugin quer ler um ficheiro da sua pasta em plugins/ que não existe. No primeiro arranque isto é normal, porque muitos plugins só criam os seus dados quando guardam algo pela primeira vez. Se a mensagem surgir mais tarde, o ficheiro foi eliminado ou a pasta do plugin foi renomeada. Consoante o plugin, este volta a criar o ficheiro ou desativa-se.

Como resolver:

  1. Reinicia o servidor uma vez. Se a mensagem desaparecer, o plugin criou o ficheiro por si próprio.
  2. Verifica em Ficheiros se a pasta em plugins/ tem exatamente o mesmo nome que no caminho da mensagem. As maiúsculas e minúsculas contam.
  3. Se o ficheiro continuar em falta, restaura-o a partir de uma cópia em Cópias de segurança.
  4. Se isso não ajudar, reinstala o plugin.

Bom saber: Se o ficheiro contiver dados de jogadores, como registos ou saldos, só os recuperas através de uma cópia de segurança. Um ficheiro acabado de criar começa vazio.

O gerador de mundo definido não está instalado

Este é o aspeto da mensagem:

Could not set generator for default world '<World>': Plugin '<Plugin>' does not exist

O que está por trás: Um gerador de mundo é o programa que cria paisagem nova. No bukkit.yml ou na configuração do mundo está indicado, para o mundo, um gerador de um plugin, mas esse plugin não está instalado ou não foi carregado. O servidor cria então novas áreas com o gerador normal. As zonas já exploradas mantêm-se como estão, mas nos limites a paisagem pode continuar de forma pouco coerente.

Como resolver:

  1. Em Ficheiros, abre o bukkit.yml e procura a secção worlds:. Por baixo do nome do mundo encontras generator: <Plugin>.
  2. Se quiseres manter o gerador, instala o plugin indicado em Plugins, numa versão compatível.
  3. Se já não precisares dele, remove a entrada generator.
  4. Reinicia o servidor e verifica na Consola se a mensagem desapareceu.

Bom saber: O nome a seguir a generator: tem de corresponder exatamente ao nome do plugin. Um erro de digitação provoca a mesma mensagem, mesmo que o plugin esteja instalado.

A configuração é mais recente do que o plugin ou o software do servidor

Este é o aspeto da mensagem:

[Configurations] Loading a newer configuration than is supported (<FileVersion> > <supported version>)! You may have to backup & delete your global config file to start the server.

O que está por trás: A configuração foi escrita por uma versão mais recente do que aquela que está agora em execução. É típico depois de um downgrade, ou seja, de uma mudança para uma versão mais antiga do plugin ou do Minecraft. O primeiro número entre parênteses é a versão do ficheiro, o segundo é a mais alta que o programa instalado conhece. As definições mais recentes são ignoradas. Se a mensagem falar do "global config file", provém do próprio Paper e refere-se normalmente a config/paper-global.yml.

Como resolver:

  1. Verifica se recentemente passaste um plugin ou, em Versão, a versão do servidor para uma versão anterior.
  2. Ou: atualiza novamente para a versão com a qual a configuração é compatível.
  3. Ou: em Cópias de segurança, repõe a configuração a partir de uma cópia do estado da versão antiga.
  4. Se não houver nenhuma cópia adequada, descarrega o ficheiro em Ficheiros, apaga-o e reinicia. É criado um ficheiro novo e as tuas personalizações transferes depois à mão.

Bom saber: Como mudar de versão em segurança está explicado em Mudar a versão do Minecraft e o modloader em segurança.

O MinecraftWarriors3 não encontra a pasta do mapa

Este é o aspeto da mensagem:

[MinecraftWarriors3] [Offizielle Map] Quell-Ordner der Map nicht gefunden: ./plugins/MinecraftWarriors3/maps/<Map-Folder>

O que está por trás: O MinecraftWarriors3 obtém o mapa oficial a partir de uma pasta de origem indicada na sua configuração. Essa pasta não existe. Por isso, o mapa não pode ser copiado nem iniciado e tudo o que depende dele deixa de funcionar. O servidor em si continua a funcionar.

Como resolver:

  1. Em Ficheiros, abre o caminho indicado na mensagem. O ponto no início (./) representa o diretório principal do servidor.
  2. Se a pasta não existir, envia o mapa para lá. Os ficheiros do mundo têm de estar diretamente na pasta, não numa subpasta adicional, como muitas vezes acontece ao extrair um arquivo.
  3. Se o mapa estiver noutro local ou a pasta tiver outro nome, corrige o caminho na configuração em plugins/MinecraftWarriors3/. Maiúsculas e minúsculas contam.
  4. Reinicia o servidor e verifica a Consola.

Bom saber: Como carregar um mundo por completo está explicado em Carregar um mundo do Minecraft e mudá-lo em segurança.

O plugin não consegue carregar um menu, holograma ou ficheiro de texto

Este é o aspeto da mensagem:

Failed to load hologram from file '<File>'
[YamlStorage] Failed to load npc file: <File>
Could not load messages.yml!

O que está por trás: Um plugin não conseguiu ler um dos seus ficheiros, por exemplo um menu, um ficheiro de idioma, um holograma ou um NPC (uma personagem controlada pelo servidor). Normalmente trata-se de um erro de formatação no ficheiro, de um nome duplicado ou de uma condição com a sintaxe errada. Nos plugins de menus, as condições são muitas vezes pequenas expressões JavaScript e a mensagem é então "Error in requirement javascript syntax". A parte afetada falta no jogo, o resto continua a funcionar.

Como resolver:

  1. Lê as linhas por baixo da mensagem. Muitas vezes indicam a linha e o motivo.
  2. Abre o ficheiro em Ficheiros e compara-o com o exemplo do manual do plugin.
  3. Se não encontrares o erro, em vez de apagares o ficheiro, muda-lhe o nome, por exemplo para messages.yml.alt. No caso de ficheiros de configuração e de idioma, o plugin cria um novo ao reiniciar.
  4. Transfere os teus textos e definições aos poucos a partir do ficheiro antigo e reinicia novamente.

Bom saber: Em ficheiros com hologramas, NPCs ou menus, um ficheiro novo faz perder as respetivas entradas. Nesse caso, é preferível recuperá-los a partir das Cópias de segurança.

Indentação ou dois pontos incorretos: ficheiro do plugin ilegível

Este é o aspeto da mensagem:

org.bukkit.configuration.InvalidConfigurationException: mapping values are not allowed here
Caused by: while parsing a block mapping
The file plugins/<Plugin>/<File>.yml is broken, it has been renamed …

O que está por trás: O YAML constrói a sua estrutura com indentação e dois pontos. "mapping values are not allowed here" significa normalmente que, num valor, há dois pontos seguidos de um espaço sem que o valor esteja entre aspas, ou que uma linha está mal indentada. "while parsing a block mapping" aponta para uma linha com mais ou menos indentação do que as vizinhas. O plugin deixa então de usar o ficheiro e recorre aos valores predefinidos ou nem sequer arranca. O EssentialsX muda o nome a um ficheiro danificado e cria um novo.

Como resolver:

  1. Abre o ficheiro indicado em Ficheiros e vai à linha da mensagem. Observa também a linha acima.
  2. Indenta apenas com espaços e as chaves do mesmo nível exatamente com a mesma largura.
  3. Coloca entre aspas os textos que tenham dois pontos, por exemplo message: "Achtung: Neustart".
  4. Um verificador de YAML no navegador mostra-te o local do erro. Depois, reinicia o servidor.

Bom saber: Se o EssentialsX mudou o nome ao ficheiro, a tua versão antiga fica ao lado. Transfere as tuas alterações para o ficheiro novo em vez de copiares o danificado de volta.

Fórmula de cálculo inválida na configuração de um plugin

Este é o aspeto da mensagem:

net.objecthunter.exp4j.tokenizer.UnknownFunctionOrVariableException: Unknown function or variable '<Expression>' …

O que está por trás: Alguns plugins calculam valores a partir de fórmulas na sua configuração, como preços, recompensas ou tempos de recarga. A biblioteca de cálculo usada para isso, a exp4j, só conhece números, operadores, funções integradas e as variáveis que o plugin disponibiliza. Se a fórmula contiver outra coisa, por exemplo "100t" em vez de "100", o cálculo é interrompido. A função correspondente do plugin não funciona como esperado. O servidor continua a funcionar.

Como resolver:

  1. Anota a expressão entre plicas que aparece na mensagem.
  2. Descobre o plugin através do stacktrace, as linhas at indentadas por baixo. Aí costuma aparecer o nome do ficheiro do plugin, por exemplo <Plugin>.jar//.
  3. Procura a expressão nos ficheiros de configuração desse plugin. Se houver muitos ficheiros, ajuda descarregar a pasta por SFTP e pesquisar no teu computador.
  4. Substitui-a por um número ou por uma fórmula válida. As variáveis permitidas constam do manual do plugin.
  5. Recarrega o plugin ou reinicia o servidor.

Bom saber: O acesso SFTP configura-se assim: Editar os ficheiros do servidor no painel e ligar por SFTP.

FancyNpcs: ação de NPC com intervalo aleatório vazio

É assim que a mensagem aparece:

Exception in thread "FancyNpcs-ActionExecutor" java.lang.IllegalArgumentException: bound must be positive

O que está por trás: Uma ação de um NPC do FancyNpcs deve escolher algo ao acaso, por exemplo uma de várias ações seguintes. Se a seleção estiver vazia ou o intervalo numérico for negativo, não é possível gerar um número aleatório e a ação é interrompida. Os jogadores notam isso porque, ao clicar no NPC, não acontece nada ou apenas parte do que devia acontecer. O servidor e os outros NPCs continuam a funcionar.

Como resolver:

  1. Atualiza o FancyNpcs para a versão mais recente compatível com a versão do teu servidor.
  2. Verifica as ações do NPC afetado. Cada seleção aleatória precisa de pelo menos uma entrada e os limites numéricos têm de ser positivos.
  3. Os dados dos NPCs encontram-se em Ficheiros, na pasta plugins/FancyNpcs. Antes de fazeres alterações, cria uma cópia de segurança e edita os ficheiros apenas com o servidor parado.
  4. Inicia o servidor e clica no NPC para testar.

Bom saber: A mensagem não indica qual é o NPC. Se tiveres vários NPCs com ações aleatórias, testa-os um a um e observa a Consola enquanto o fazes.

Texto com códigos de cor antigos num campo MiniMessage

É assim que a mensagem aparece:

Legacy formatting codes have been detected in a MiniMessage string …

O que está por trás: O MiniMessage é uma forma de escrever a formatação de texto com etiquetas entre chavetas angulares, como <red> ou <bold>. Muitos plugins atuais usam-no para o chat, títulos e menus. O MiniMessage não entende os códigos de cor antigos com & ou §. Se um destes códigos estiver num texto, este aparece mal formatado ou não aparece. O servidor continua a funcionar.

Como resolver:

  1. Descobre qual é o plugin. A linha antes da mensagem ou o stacktrace por baixo costuma indicá-lo.
  2. Em Ficheiros, abre o ficheiro de configuração ou de idioma do plugin e substitui os códigos antigos por etiquetas:
    • &c passa a <red>, &a passa a <green>, &e passa a <yellow>
    • &l passa a <bold>, &o passa a <italic>, &r passa a <reset>
    • &#37FF00 ou §x§3§7… passa a <#37FF00>
  3. Se o plugin oferecer nas suas definições um modo legacy para códigos antigos, podes ativá-lo em vez disso.
  4. Recarrega o plugin ou reinicia o servidor e verifica o texto no jogo.

Bom saber: Nunca mistures os dois estilos de escrita no mesmo texto. Basta um único & esquecido para a mensagem aparecer.

Paxel: falta um valor para um nível de ferramenta

É assim que a mensagem aparece:

[Paxel] Setting "<Definição>" for tier "<Nível>" is not defined in the config!

O que está por trás: Um Paxel é uma ferramenta que reúne picareta, machado e pá. O plugin Paxel oferece-o em vários níveis e cada nível precisa de determinados valores obrigatórios na configuração. Para o nível indicado, falta um deles. Esse Paxel não pode então ser criado nem entregue. Isto acontece frequentemente após uma atualização, quando a nova versão espera uma definição que ainda não existe no ficheiro antigo.

Como resolver:

  1. Em Ficheiros, abre a configuração na pasta plugins/Paxel.
  2. Procura o nível indicado na mensagem e acrescenta a definição referida. Um nível completo no mesmo ficheiro serve-te de modelo.
  3. Em alternativa, muda o nome do ficheiro e reinicia. O plugin escreve então a configuração padrão da versão atual e tu transferes as tuas personalizações.
  4. Reinicia o servidor e verifica a Consola.

Bom saber: Ao acrescentares valores, usa a mesma indentação dos restantes valores do nível, caso contrário ocorre um erro de YAML.

Permissão inválida no plugin.yml de um plugin

É assim que a mensagem aparece:

Permission node '<Plugin>.<Permissão>' in plugin description file for <Plugin> v<Versão> is invalid

O que está por trás: Cada plugin descreve no seu plugin.yml, um ficheiro dentro do JAR do plugin, as permissões que traz consigo. Uma destas descrições não pôde ser carregada. O nome indicado pode estar totalmente correto. Muitas vezes falta uma propriedade da descrição ou esta está mal formatada. Normalmente o plugin arranca na mesma, mas esta permissão não é criada com os seus valores padrão.

Como resolver:

  1. Lê na mensagem qual é o plugin afetado.
  2. Atualiza-o para uma build compatível com a versão do teu servidor. Para isso, substitui o JAR com o servidor parado.
  3. Se for um plugin teu, verifica todo o bloco permissions do plugin.yml face ao formato Bukkit, e não apenas o nome. Cada entrada é uma secção com propriedades como description, default (true, false, op ou not op) e children.
  4. Reinicia o servidor.

Bom saber: Se atribuis as permissões tu próprio com um plugin de permissões como o LuckPerms, a mensagem costuma ter pouco efeito nos teus jogadores.

SuntexSocial: proxy SOCKS5 sem endereço

É assim que a mensagem aparece:

[SuntexSocial] … SOCKS5 proxy is enabled, but telegram.proxy.host is empty

O que está por trás: O SuntexSocial liga o teu servidor a um bot do Telegram. Na configuração está definido que o bot acede à internet através de um proxy SOCKS5. Um proxy é um servidor intermediário por onde passa a ligação. No entanto, o endereço deste proxy (telegram.proxy.host) está vazio. Por isso, o bot do Telegram não arranca, mas o servidor de Minecraft continua a funcionar normalmente.

Como resolver:

  1. Em Ficheiros, abre a configuração na pasta plugins/SuntexSocial.
  2. Se precisares do proxy, em telegram e proxy, indica em host o nome do anfitrião e também a porta correspondente. Ambos são fornecidos pelo fornecedor do proxy.
  3. Se não precisares de proxy, desativa o proxy SOCKS5 na mesma configuração.
  4. Reinicia o servidor e verifica se o bot responde.

Bom saber: Só é necessário um proxy se o Telegram não estiver diretamente acessível a partir da rede do servidor. Sem essa razão, deixa-o desativado.

Plugin de gerador de mundo arranca demasiado tarde

É assim que a mensagem aparece:

Could not set generator for default world '<Mundo>': Plugin '<Plugin>' is not enabled yet

O que está por trás: Para o mundo principal está definido um gerador de um plugin, mas o plugin só arranca depois de o servidor ter carregado os mundos. O mundo usa então o gerador normal, pelo que as novas zonas ficam diferentes do planeado. Nas zonas já geradas nada muda. O servidor funciona normalmente.

Como resolver:

  1. Lê nas instruções do plugin de gerador como o configurar para o mundo principal.
  2. Normalmente, o gerador pertence ao bukkit.yml, em worlds:, junto ao nome do mundo principal.
  3. O plugin tem de carregar no arranque do servidor, ou seja, antes dos mundos. Isto é definido pelo programador no plugin.yml com load: STARTUP. Se a mensagem continuar a aparecer, verifica se a versão instalada é compatível com a versão do teu servidor.
  4. Reinicia o servidor e verifica a Consola.

Bom saber: As zonas que já foram criadas com o gerador normal mantêm-se assim. Se quiseres que o mundo inteiro seja criado com o novo gerador, precisas de um mundo novo. Faz antes uma cópia do antigo em Cópias de segurança.

O LuckPerms não consegue ler o ficheiro de importação

Este é o aspeto da mensagem:

[LuckPerms] Error whilst reading from the import file

O que está por trás disto: Com a importação, o LuckPerms assume grupos, permissões e dados de jogadores a partir de um ficheiro criado previamente com a exportação, por exemplo ao mudares de outro servidor. O LuckPerms não conseguiu ler o ficheiro escolhido ou processar o respetivo formato. A importação é interrompida. O servidor continua a funcionar.

Como resolver:

  1. Verifica em Ficheiros se o ficheiro está na pasta plugins/LuckPerms e se o nome corresponde exatamente ao indicado no comando.
  2. Carrega o ficheiro sem alterações, tal como a exportação o gerou, ou seja, sem o descompactar, renomear ou editar.
  3. Lê a mensagem de erro diretamente abaixo desta linha. Ela indica o ponto exato em que a leitura falhou.
  4. Depois, inicia novamente a importação com /lp import <Ficheiro>.

Bom saber: Como configurar e verificar grupos e permissões no LuckPerms, explica-o Configurar o LuckPerms: permissões e grupos.

A configuração do Paper contém um valor desconhecido

Este é o aspeto da mensagem:

Encountered an unexpected exception
org.spongepowered.configurate.serialize.SerializationException: [<Setting path>] <unknown value> …

O que está por trás disto: o Paper lê as suas definições a partir de config/paper-global.yml, config/paper-world-defaults.yml e, por mundo, a partir de paper-world.yml na pasta do mundo. Num destes ficheiros existe um valor que a versão do teu servidor não reconhece, por exemplo um item ou um componente de dados que só existe numa versão mais recente ou que foi renomeado. A definição não é aplicada. É algo típico depois de mudares para uma versão mais antiga ou quando se copiaram ficheiros de outro servidor.

Como resolver:

  1. Lê a mensagem: entre parênteses retos está o caminho da definição, ou seja, as chaves de fora para dentro, seguido do valor desconhecido.
  2. Abre o ficheiro correspondente em Ficheiros, na pasta config ou na pasta do mundo, e segue o caminho indicado.
  3. Corrige o valor para um nome que a tua versão reconheça, ou remove-o.
  4. Reinicia o servidor.

Bom saber: se removeres uma definição inteira, o Paper volta a inserir o valor predefinido no próximo arranque.

BMenu: o identificador do menu já está em uso („key already exists“)

Este é o aspeto da mensagem:

[BMenu] key already exists <Namespace>:<Menu>

O que está por detrás disto: o BMenu gere os menus através de identificadores únicos. Se um identificador já ocupado for registado novamente, o plugin descarta a nova entrada e mantém a existente. Por isso, podem faltar alterações da segunda definição do menu ou aparecer um menu diferente do esperado. O servidor continua a funcionar.

Como resolver:

  1. Em Cópias de segurança, cria uma cópia de segurança das tuas definições antes de editares os ficheiros dos menus.
  2. Lê o identificador completo na Consola. Em Ficheiros, compara os identificadores das definições de menu do BMenu e verifica também se há definições duplicadas nos menus importados.
  3. Remove uma cópia redundante ou atribui um identificador único ao segundo menu. Ajusta também as referências a um identificador alterado.
  4. Reinicia o servidor por completo e testa os menus afetados. Se a mensagem continuar a aparecer apesar de as definições serem únicas, comunica o sucedido ao autor do BMenu, juntamente com o registo de arranque completo.

Bom saber: a ordem de registo determina qual das entradas é mantida. Por isso, não contes com uma determinada ordem dos ficheiros.

A tua mensagem não está aqui?

Lê a mensagem completa na Consola ou em logs/latest.log, incluindo as linhas imediatamente anteriores. Muitas vezes aparece aí qual o plugin que está a carregar os seus ficheiros. No stacktrace abaixo, reconheces o plugin pelo nome do ficheiro JAR ou pela pasta plugins/<Plugin>/ no caminho. Se a mensagem indicar um ficheiro com linha e coluna, trata-se quase sempre de um erro de formato como nas secções acima. Cria uma cópia de segurança antes de qualquer alteração. Se não conseguires avançar, abre um ticket e indica a hora da mensagem.