Pular para o conteúdo principal

Solução de problemas do Resource Pack Manager

Esta página cobre apenas comportamentos atualmente confirmados no código do ResourcePackManager.

Jogadores não estão recebendo o pacote de recursos​

Verifique primeiro:

  • autoHost deve estar habilitado se você quer que o ResourcePackManager envie seu pacote hospedado automaticamente
  • o pacote mesclado deve existir e ter sido enviado com sucesso
  • jogadores só recebem o pacote ao entrar, ou após um novo upload durante a execução atual

Se necessário:

  1. Execute /rspm reload.
  2. Observe a saída do console em busca de erros de upload ou do servidor remoto.
  3. Reconecte-se com um jogador de teste após a conclusão do reload.

Se você está auto-hospedando em vez de usar auto-hosting, o ResourcePackManager não envia sua URL personalizada para você. Nessa configuração, você ainda precisa do seu próprio fluxo de entrega de pacotes do lado do servidor.

ItemsAdder está instalado, mas seu conteúdo está ausente no pacote final​

Isso geralmente significa que o ItemsAdder ainda está configurado de uma forma que impede o ResourcePackManager de ler ou hospedar sua saída.

Use:

/rspm itemsadder configure

Esse comando atualmente:

  • habilita resource-pack.hosting.no-host.enabled
  • desabilita protection_1, protection_2 e protection_3
  • executa /iazip
  • recarrega o ResourcePackManager logo depois

Se o comando informar que o ItemsAdder já está hospedando seu próprio pacote, desabilite a hospedagem do ItemsAdder manualmente primeiro e execute o comando novamente.

O pacote mesclado é inválido ou falha no upload​

A integração de auto-host do ResourcePackManager lida explicitamente com estes tipos de erros do servidor:

  • arquivos necessários ausentes
  • arquivo muito grande
  • formato de arquivo inválido
  • sessão ausente
  • servidor remoto indisponível

Se você encontrar um destes:

  1. Execute /rspm reload para reconstruir o pacote.
  2. Verifique se um dos pacotes fonte está malformado, criptografado ou ilegível.
  3. Verifique se o pacote mesclado final ainda contém um pack.mcmeta e pack.png válidos na raiz.

O plugin ignora pacotes que não consegue extrair corretamente e registra avisos no console quando isso acontece.

Os assets de um plugin estão sobrescrevendo os assets de outro plugin​

Isso é controlado por priorityOrder em:

plugins/ResourcePackManager/config.yml

Entradas superiores prevalecem sobre as inferiores.

Para arquivos não mescláveis, o ResourcePackManager substitui o arquivo de menor prioridade. Para arquivos JSON mescláveis, ele mescla o conteúdo. As categorias JSON atualmente mescláveis são:

  • sounds.json
  • arquivos de idioma
  • JSON de modelos de itens vanilla em minecraft/models/item
  • arquivos de atlas
  • arquivos de fontes

Se você precisa inspecionar o que aconteceu durante a última mesclagem, verifique:

plugins/ResourcePackManager/collision_log.txt

Texto da GUI ou elementos baseados em fontes parecem errados​

Arquivos de fontes são uma das categorias JSON que o ResourcePackManager mescla, mas isso não garante que dois sistemas de fontes diferentes funcionem bem juntos no Minecraft.

Se um menu ou HUD baseado em fontes parecer errado:

  1. Altere priorityOrder para que o pacote que você quer que prevaleça fique mais acima.
  2. Execute /rspm reload.
  3. Verifique collision_log.txt para confirmar que as colisões ocorreram onde você esperava.

Mudanças no pacote de recursos não aparecem imediatamente​

O ResourcePackManager tem um watchdog para fontes de pacotes suportadas.

Ele espera até que um pacote alterado permaneça inalterado por 3 segundos, então uma vez que todos os pacotes monitorados estão estáveis, a remesclagem acontece imediatamente.

Se você está regenerando ativamente o pacote de outro plugin, aguarde alguns segundos após as escritas de arquivo pararem. Em caso de dúvida, execute /rspm reload após o plugin upstream terminar.

Auto-hosting não consegue alcançar o servidor remoto​

O host integrado do ResourcePackManager se comunica com:

https://magmaguy.com/rsp/

Se essa conexão falhar, o plugin registra avisos de comunicação e não pode auto-hospedar até se reconectar com sucesso.

Suas opções são:

  1. corrigir a conectividade HTTPS de saída do servidor
  2. aguardar o serviço remoto ficar acessível novamente
  3. desabilitar autoHost e auto-hospedar o zip gerado

Quero auto-hospedar o pacote mesclado​

A configuração suportada pelo código é:

  1. Defina autoHost: false.
  2. Defina resourcePackRerouting se quiser que o ResourcePackManager escreva uma cópia adicional em uma pasta existente.
  3. Hospede ResourcePackManager_RSP.zip você mesmo.

resourcePackRerouting é resolvido relativo ao diretório plugins, e a pasta de destino deve já existir.

Preciso inspecionar quais dados remotos estão armazenados para este servidor​

Use:

/rspm data_compliance_request

Se houver uma sessão de hospedagem remota ativa, o ResourcePackManager baixa a resposta em:

plugins/ResourcePackManager/data_compliance

Se não houver sessão remota, o comando informa que não há dados remotos para solicitar.