Solução de Problemas do Resource Pack Manager

Solução de Problemas

Problema do lado do servidor: Falha ao Carregar (Erro 404)

Quando um jogador se conecta, o Minecraft tenta baixar o resource pack gerado pelo RSPM a partir do link auto-hospedado. Um erro 404 significa que o servidor de hospedagem respondeu com "arquivo não encontrado", então o resource pack não pode ser baixado.

Expandir para mais informações

Nota importante: Este serviço de hospedagem é interno do RSPM e não é configurável pelos administradores do servidor. O link de download é gerado automaticamente.

Causas comuns:

O serviço de hospedagem está temporariamente fora do ar ou inacessível.
O resource pack falhou ao fazer upload corretamente durante a geração.
O link está bloqueado por um firewall, ISP ou restrições de rede (comum em escolas ou locais de trabalho).

Como corrigir:

Peça ao jogador afetado para copiar a URL do resource pack do seu chat ou console do Minecraft e tentar abri-la em um navegador web.
Se carregar corretamente no navegador mas não no Minecraft, o jogador pode ter um problema de cache; reiniciar o Minecraft geralmente resolve isso.
Se o link não abrir no navegador, tente regenerar o resource pack executando /rspm reload no servidor e então reconecte.
Se todos os jogadores experimentarem este problema, pode indicar que o serviço de hospedagem está temporariamente indisponível, aguarde e tente novamente mais tarde.

Problema do lado do servidor: Erro no Console Tamanho do Resource Pack Excede o Limite

O resource pack gerado pelo RSPM excede o tamanho máximo permitido para auto-hospedagem no servidor, que atualmente está definido em 50 MB.

Expandir para mais informações

Causas comuns:

Adicionar muitos ou muito grandes resource packs para serem mesclados.
Incluir texturas de alta resolução ou modelos personalizados grandes que aumentam o tamanho do pack.

Como corrigir:

Remova ou reduza o tamanho de alguns resource packs ou recursos.
Otimize texturas e modelos para terem um tamanho de arquivo menor.
Considere desabilitar a auto-hospedagem no config.yml e hospedar o resource pack você mesmo usando um servidor web externo.

Nota: O limite de tamanho de 50 MB é definido para garantir downloads confiáveis e rápidos para os jogadores e está sujeito a mudanças com base nas políticas do provedor de hospedagem.

Problema do lado do cliente: Falha ao Carregar (Resource Pack Inválido)

O Minecraft baixou com sucesso o resource pack, mas o rejeitou porque o pack está corrompido, incompleto ou faltam arquivos essenciais.

Expandir para mais informações

Causas comuns:

O processo de mesclagem falhou devido a resource packs incompatíveis de diferentes plugins.
Um ou mais packs de origem contêm arquivos malformados, como arquivos JSON quebrados ou arquivos mcmeta inválidos.
Os caminhos de arquivos de recursos excedem a profundidade máxima de pasta permitida pelo Minecraft ou incluem caracteres ilegais.

Como corrigir:

Execute /rspm reload para forçar uma regeneração limpa do resource pack mesclado.
Remova temporariamente quaisquer plugins recentemente adicionados que adicionem resource packs, então tente novamente para ver se o problema é resolvido.
Adicione esses plugins de volta um por um, testando após cada um, para identificar qual resource pack está causando o problema.
Verifique os registros do servidor RSPM para avisos sobre conflitos de mesclagem ou arquivos ausentes, que podem ajudar a identificar a origem do problema.

Problema do lado do cliente: Texturas Roxas e Pretas ou Modelos de Cubos Roxos e Pretos

O padrão de tabuleiro de xadrez roxo e preto no Minecraft indica que o jogo não consegue encontrar a textura ou modelo necessário no resource pack carregado. Ver cubos roxos em vez de modelos personalizados significa que o JSON do modelo existe mas faz referência a uma textura ou arquivos de modelo ausentes ou inválidos.

Expandir para mais informações

Causas comuns:

A textura necessária não foi incluída no resource pack mesclado.
O arquivo JSON do modelo aponta para um caminho de textura incorreto ou desatualizado.
Conflitos entre múltiplos resource packs de plugins onde um pack sobrescreve os recursos de outro.

Como corrigir:

Use a lista priorityOrder no config.yml para garantir que o resource pack correto tenha precedência durante a mesclagem.
Verifique se o arquivo de textura ausente está presente no resource pack de origem original.
Verifique o arquivo JSON do modelo para confirmar que seu caminho de textura corresponde à localização real do arquivo no pack.
Após fazer correções, execute /rspm reload para regenerar o pack mesclado e teste novamente.

Problema do lado do cliente: Texturas de GUI para Menus estão Desalinhadas

Quando texturas de GUI aparecem desalinhadas—como ícones deslocados ou barras fora do lugar—geralmente é causado por conflitos em arquivos de fonte. O Minecraft suporta apenas um conjunto de fontes ativo por vez, então múltiplos packs sobrescrevendo fontes podem causar problemas de exibição.

Expandir para mais informações

Causas comuns:

Vários resource packs de plugins modificam font/default.json ou arquivos de fonte relacionados.
O RSPM os mescla sem uma prioridade clara definida para qual fonte usar.

Como corrigir:

Abra plugins/ResourcePackManager/config.yml e encontre a seção priorityOrder.
Mova o pack do plugin cujas fontes você deseja preservar para o topo da lista.
Execute /rspm reload para regenerar o resource pack mesclado.

Nota: Não é possível mesclar completamente múltiplos arquivos de fonte no Minecraft—apenas um conjunto de fontes terá efeito, então a prioridade deve ser escolhida.

Problema do lado do cliente: Carregado mas Alguns Elementos Não Funcionam

Alguns itens, texturas ou modelos carregam incorretamente ou não aparecem de forma alguma no jogo.

Expandir para mais informações

Causas comuns:

Incompatibilidade entre a versão do cliente Minecraft e a versão do servidor. Geralmente entre a versão 1.21.3 e 1.21.4.
Uso de ViaVersion ou plugins similares que permitem clientes com versões não suportadas se conectarem.
Resource packs usando formatos de modelo mais novos que clientes antigos não conseguem lidar, ou vice-versa.

Como corrigir:

Certifique-se de que todos os jogadores usem a mesma versão do Minecraft que o servidor.
Se você tem ViaVersion instalado, saiba que alguns recursos podem não funcionar corretamente até que a compatibilidade completa seja adicionada.
Mantenha tanto as funcionalidades do resource pack do cliente quanto do servidor dentro da mesma faixa de versão do Minecraft suportada para evitar conflitos.

Problema do lado do cliente: Carregado mas Recursos de um Plugin Sobrescrevem Outro

Dois ou mais resource packs de plugins contêm arquivos com os mesmos nomes e caminhos. Quando o RSPM os mescla, o pack mais baixo na ordem de prioridade sobrescreve os recursos do que está acima.

Expandir para mais informações

Como corrigir:

Abra plugins/ResourcePackManager/config.yml.
Na lista priorityOrder, mova o plugin cujos recursos você deseja manter mais acima, acima dos conflitantes.
Execute /rspm reload para regenerar o resource pack mesclado.

Nota: Em versões do Minecraft anteriores a 1.21.4, alguns conflitos não podem ser perfeitamente resolvidos apenas pela prioridade. Nesses casos, mesclagem manual ou edição dos resource packs de origem pode ser necessária.

Problema do lado do cliente: Download Lento do Resource Pack

Os jogadores podem experimentar downloads lentos ou atraso quando o resource pack está sendo enviado pelo servidor. Isso geralmente se deve ao resource pack estar hospedado em servidores remotos, o que significa que a velocidade de download depende da localização do jogador e da qualidade da internet.

Expandir para mais informações

Causas comuns:

O jogador está localizado geograficamente longe do servidor de hospedagem.
A conexão de internet do jogador é lenta ou instável.
Congestionamento temporário de rede entre o jogador e o servidor de hospedagem.

Como corrigir ou mitigar:

Incentive os jogadores a verificar a velocidade e estabilidade de sua conexão de internet.
Os jogadores podem tentar se conectar de uma rede ou localização diferente para ver se a velocidade melhora.
Se downloads lentos são um problema persistente, considere hospedar o resource pack em um serviço de hospedagem alternativo mais próximo de sua base de jogadores. Você pode desabilitar a auto-hospedagem do RSPM no config e fornecer uma URL direta do resource pack no server.properties.
Certifique-se de que o tamanho do resource pack está otimizado e não maior que o necessário para minimizar o tempo de download.

Nota: Infelizmente, devido à natureza da hospedagem remota, alguns jogadores experimentarão downloads mais lentos com base em fatores fora do controle do servidor.