Pular para o conteúdo principal

Resource Pack Manager (RSPM)

Resource Pack Manager (RSPM) é um plugin projetado para simplificar como servidores Minecraft lidam com pacotes de recursos. Ele mescla, hospeda e distribui pacotes de recursos automaticamente, garantindo que jogadores sempre tenham o pacote correto com configuração mínima.

O Que Ele Faz?​

RSPM detecta pacotes de recursos de plugins suportados como EliteMobs, FreeMinecraftModels, ModelEngine e outros, então os mescla em um único pacote de recursos. Este pacote mesclado é automaticamente hospedado e entregue aos jogadores quando entram no seu servidor.

Você também pode adicionar manualmente seus próprios pacotes de recursos colocando-os na pasta plugins/ResourcePackManager/mixer/. Você pode adicionar arquivos ZIP ou diretórios de pacotes de recursos descompactados. Referencie o nome do arquivo (incluindo extensão .zip para pacotes zipados) na seção priorityOrder. O plugin mescla estes baseado na ordem que você define.

Isso significa que você não precisa mais se preocupar em mesclar manualmente arquivos zip ou fazer upload de pacotes para sites de terceiros. Apenas configure suas prioridades e RSPM cuida do resto.

Guia de Configuração​

  1. Baixe e coloque ResourcePackManager.jar na pasta plugins do seu servidor.
  2. Reinicie seu servidor.
  3. (Opcional) Adicione quaisquer pacotes de recursos personalizados à pasta mixer.
  4. (Opcional) Edite config.yml para ajustar prioridade ou desabilitar hospedagem automática.
  5. Execute /rspm reload se fizer mudanças.

Exemplo de Configuração​

priorityOrder:
  - ResourcePackManager
  - EliteMobs
  - FreeMinecraftModels
  - ModelEngine
  - Nova
  - ItemsAdder
  - Oraxen
  - BetterHUD
  - ValhallaMMO
  - MMOInventory
  - vane-core
  - RealisticSurvival

autoHost: true
forceResourcePack: false
resourcePackPrompt: Use recommended resource pack?
resourcePackRerouting: ''
  • priorityOrder: Controla qual pacote vence quando há conflito.
  • autoHost: Faz upload do pacote mesclado para serviço de hospedagem da Magma.
  • forceResourcePack: Força clientes a aceitar o pacote. Quando habilitado, jogadores devem aceitar o pacote de recursos para entrar no servidor. Quando desabilitado (padrão), jogadores podem recusar e ainda jogar.
  • resourcePackPrompt: Define a mensagem mostrada ao solicitar jogadores. Suporta códigos de cor usando § ou &. Limite de caracteres é aproximadamente 100 caracteres.
  • resourcePackRerouting: Caminho de diretório personalizado para saída do pacote de recursos mesclado. Use isso se estiver hospedando o pacote com um plugin alternativo ou solução de hospedagem manual. Deixe vazio para usar localização padrão ou hospedagem automática.

Plugins Suportados​

RSPM é compatível com a maioria dos principais plugins que geram seus próprios pacotes de recursos:

  • BackpackPlus
  • BetterHUD
  • EliteMobs
  • FreeMinecraftModels
  • InfiniteVehicles
  • ItemsAdder (criptografia deve estar desabilitada)
  • MegaBlockSurvivors
  • MMOInventory
  • ModelEngine
  • Nova
  • Oraxen
  • RealisticSurvival
  • ValhallaMMO
  • vane-core

Se seu plugin não está listado, você ainda pode adicionar seu pacote manualmente colocando o zip na pasta mixer e referenciando seu nome de arquivo (incluindo .zip) no priorityOrder.

Compatibilidade de Versão do Minecraft​

O comportamento do ResourcePackManager varia dependendo da versão do seu servidor Minecraft:

Minecraft 1.20.3 e Mais Recente​

RSPM usa a API moderna addResourcePack(), que permite que múltiplos pacotes de recursos coexistam no cliente. Isso significa que RSPM pode funcionar junto com outros plugins que fornecem seus próprios pacotes de recursos sem conflitos.

O pacote de recursos mesclado recebe um UUID consistente, garantindo que seja adequadamente reconhecido e atualizado quando mudanças ocorrem.

Minecraft 1.20.2 e Mais Antigo​

Em versões mais antigas, RSPM usa a API legada setResourcePack(), que substitui qualquer pacote de recursos previamente carregado. Isso significa:

  • Se outro plugin enviar um pacote de recursos depois do RSPM, o pacote do RSPM será substituído
  • Se RSPM enviar depois de outro plugin, substituirá o pacote daquele plugin
  • Você não pode ter múltiplos plugins de pacote de recursos ativos simultaneamente

Recomendação: Para a melhor experiência e compatibilidade com múltiplos provedores de pacotes de recursos, use Minecraft 1.20.3 ou mais recente.

Hospedagem Automática​

Por padrão, RSPM usa um serviço de hospedagem automática gratuito mantido pelo desenvolvedor do plugin. Isso remove a necessidade de configurar sua própria solução de hospedagem. Se preferir hospedar você mesmo, simplesmente desabilite autoHost no config.

Nota: A hospedagem automática é suportada através de contribuições da comunidade e pode não estar disponível para sempre.

Notificações de Atualização Automáticas​

ResourcePackManager verifica automaticamente por atualizações quando seu servidor inicia. Quando uma versão mais recente está disponível no SpigotMC, jogadores com a permissão elitemobs.versionnotification recebem uma notificação quando entram no servidor.

A notificação inclui um link direto para baixar a versão mais recente.

Nota: Versões snapshot não são listadas no SpigotMC. Se você estiver rodando uma build snapshot, jogadores serão direcionados a entrar no servidor Discord para atualizações.

Privacidade: A verificação de versão é uma simples requisição API para SpigotMC e não transmite nenhuma informação de servidor ou jogador.

Arquivos de Configuração​

ResourcePackManager usa dois arquivos de configuração:

config.yml​

Contém todas as configurações configuráveis pelo usuário:

  • priorityOrder: Prioridade de mesclagem de pacote de recursos
  • autoHost: Ativar/desativar hospedagem automática
  • forceResourcePack: Forçar clientes a usar o pacote
  • resourcePackPrompt: Mensagem de prompt personalizada
  • resourcePackRerouting: Diretório de saída alternativo

data.yml​

Gerenciado automaticamente pelo plugin. Não edite manualmente.

  • Armazena o UUID do pacote de recursos hospedado do seu servidor
  • Usado pelo serviço de hospedagem automática para identificar seu pacote
  • Automaticamente regenerado se deletado ou corrompido
  • Deletar este arquivo forçará re-upload do seu pacote de recursos

Nota: Se estiver tendo problemas com hospedagem automática, deletar data.yml e executar /rspm reload forçará o plugin a re-registrar com o serviço de hospedagem.

Atualizações Automáticas de Pacote de Recursos​

ResourcePackManager monitora continuamente arquivos de pacote de recursos de plugins suportados e detecta mudanças automaticamente. Isso significa que você nem sempre precisa executar /rspm reload manualmente.

Como Atualizações Automáticas Funcionam​

  1. Monitoramento de Arquivos: A cada segundo, RSPM verifica se quaisquer arquivos de pacote de recursos mudaram comparando hashes SHA1.

  2. Detecção de Estabilidade: Quando uma mudança é detectada, RSPM espera 10 segundos para garantir que os arquivos estão estáveis. Isso previne re-mesclagem enquanto plugins ainda estão gerando seus pacotes de recursos.

  3. Re-Mesclagem Automática: Após 10 segundos de estabilidade, RSPM automaticamente:

    • Re-mescla todos os pacotes de recursos
    • Faz upload do novo pacote para hospedagem automática (se habilitado)
    • Torna o pacote atualizado disponível para jogadores

  4. Distribuição de Jogadores: Novos jogadores receberão o pacote atualizado automaticamente. Jogadores existentes podem precisar reconectar ou recarregar manualmente seu pacote de recursos (F3 + T no Minecraft).

Quando Usar /rspm reload​

Recarga manual ainda é útil para:

  • Forçar uma re-mesclagem imediata sem esperar por estabilidade
  • Recarregar após mudar a própria configuração do RSPM
  • Solucionar problemas quando atualizações automáticas não parecem acionar
  • Testar novas adições de pacote de recursos

Personalizando Seu Pacote de Recursos​

ResourcePackManager permite que você personalize o ícone e metadados do seu pacote de recursos mesclado usando a pasta blueprint.

Localização da Pasta Blueprint​

plugins/ResourcePackManager/blueprint/

Esta pasta é criada automaticamente na primeira execução e contém dois arquivos:

pack.png​

O ícone exibido para seu pacote de recursos no cliente Minecraft.

  • Padrão: Ícone padrão de pacote de recursos do Minecraft
  • Tamanho Recomendado: 128x128 pixels (pode ser maior, mas pode não exibir corretamente)
  • Formato: PNG com suporte a transparência

Para personalizar:

  1. Substitua blueprint/pack.png com sua imagem personalizada
  2. Execute /rspm reload
  3. Seu ícone personalizado aparecerá no pacote de recursos mesclado

pack.mcmeta​

Arquivo de metadados que controla formato e descrição do pacote.

  • pack_format: Deve corresponder à sua versão Minecraft (NÃO MUDE)
  • description: Texto mostrado no menu de pacote de recursos

Exemplo pack.mcmeta:

{
  "pack": {
    "pack_format": 15,
    "description": "My Server's Custom Resources"
  }
}

Para personalizar:

  1. Edite blueprint/pack.mcmeta
  2. Mude a descrição para o nome do seu servidor ou mensagem personalizada
  3. Execute /rspm reload

Aviso: Não modifique pack_format a menos que saiba o que está fazendo. Usar o número de formato errado fará o pacote falhar ao carregar.

blueprint.zip​

Isso é gerado automaticamente pelo RSPM. Não modifique este arquivo diretamente. Sempre edite pack.png e pack.mcmeta, então recarregue o plugin.

Resolvendo Conflitos de Pacote de Recursos​

Embora Resource Pack Manager (RSPM) simplifique a mesclagem e distribuição de pacotes de recursos, ele não é projetado para resolver todos os conflitos possíveis entre eles.

RSPM mescla pacotes baseado no priorityOrder definido na configuração. Se dois pacotes contêm o mesmo arquivo (ex: mesmo ID de modelo ou elemento de GUI), aquele listado mais alto na lista de prioridade terá precedência. No entanto, isso não elimina todos os problemas de compatibilidade. Exemplos comuns de conflitos não resolvidos incluem:

  • IDs de dados de modelo personalizado (CMD) sobrepostos
  • Caminhos de textura conflitantes
  • Caracteres Unicode duplicados ou conflitantes (usados em GUIs personalizadas)
  • Sobrescritas ou seletores de modelo incompatíveis

Para gerenciar estes conflitos efetivamente:

  • Ajuste o priorityOrder para que seu plugin mais importante apareça no topo.
  • Resolva manualmente sobreposições editando os pacotes diretamente, se necessário.
  • Verifique duas vezes que todos os pacotes estão corretamente gerados e colocados em seus diretórios de plugin apropriados ou na pasta mixer.

Nota: Muitos problemas reportados com RSPM não são bugs no plugin, mas sim resultado de arquivos conflitantes entre pacotes de recursos. RSPM não pode corrigir automaticamente estes — simplesmente os mescla e serve baseado na sua configuração.

Se ainda estiver encontrando problemas após ajustar prioridades e verificar por conflitos, você pode precisar intervir manualmente ou contatar os desenvolvedores dos plugins conflitantes para orientação.

Detalhes Técnicos​

Limite de Tamanho de Pacote de Recursos​

O serviço de hospedagem automática tem tamanho máximo de pacote de recursos de 50MB. Se seu pacote mesclado exceder este limite, você precisará reduzir o número de plugins ou usar hospedagem personalizada com resourcePackRerouting.

Retenção de Dados e Mecanismo Keep-Alive​

ResourcePackManager envia pings periódicos de "keep-alive" para o servidor de hospedagem automática a cada 6 horas para prevenir expiração de sessão. Se o servidor estiver offline por mais de 24 horas, o pacote de recursos hospedado é automaticamente deletado.

Como Funciona:

  • Pings de keep-alive são enviados a cada 6 horas automaticamente
  • Confirma que o servidor ainda está ativo e usando o pacote hospedado
  • Se keep-alive falhar, UUID é limpo e pacote é re-enviado na próxima mesclagem
  • Política de retenção de 24 horas: pacotes deletados se nenhum keep-alive por 24 horas

O Que Acontece Se Seu Servidor Estiver Offline:

Downtime Curto (Menos de 24 Horas): Sem impacto. Pings de keep-alive retomam quando seu servidor reinicia.

Downtime Estendido (Mais de 24 Horas):

  • Seu pacote de recursos é deletado do serviço de hospedagem
  • O UUID de sessão em data.yml se torna inválido
  • Quando seu servidor reiniciar, RSPM detecta automaticamente a sessão inválida
  • O pacote é re-enviado e um novo UUID de sessão é gerado
  • Jogadores receberão o pacote normalmente

Permissões​

Permissões de Comando:

  • resourcepackmanager.* — Necessária para executar todos os comandos RSPM. Conceda isso a administradores que precisam recarregar ou solicitar informações de conformidade de dados.

Notificações de Atualização:

  • elitemobs.versionnotification — Jogadores com esta permissão recebem notificações quando uma nova versão do ResourcePackManager está disponível. Esta permissão é herdada do EliteMobs mas aplica a verificações de atualização do RSPM.

Mesclagem JSON​

Quando múltiplos pacotes de recursos contêm o mesmo arquivo JSON, RSPM os mescla recursivamente em vez de sobrescrever. Arrays são concatenados, e objetos são mesclados com valores de prioridade mais alta vencendo conflitos. Arquivos não-JSON seguem o sistema de sobrescrição de prioridade padrão.

Comandos​

  • /rspm reload — Recarrega o plugin e re-mescla todos os pacotes.
  • /rspm data_compliance_request — Opcional. Baixa dados de pacote de recursos hospedados.

Resumo​

RSPM ajuda proprietários de servidores a simplificar gerenciamento de pacotes de recursos. Automatiza o processo de mesclagem, lida com hospedagem e distribui o pacote final aos jogadores — tudo com configuração mínima. No entanto, ainda é sua responsabilidade gerenciar conflitos de plugin através do config ou editando os pacotes se necessário.

Se você precisar de ajuda ou encontrar problemas, o Discord oficial é um bom lugar para fazer perguntas e obter suporte.