Configuração do ResourcePackManager

Esta página cobre uma configuração de servidor único (standalone). Se você administra uma rede BungeeCord / Waterfall / Velocity, siga Redes com Proxy — você instala o mesmo ResourcePackManager.jar no proxy, mas ele gera sua própria config e desempenha um papel do lado do proxy.

O ResourcePackManager 2.x é distribuído como um único jar universal. O mesmíssimo ResourcePackManager.jar roda em backends Bukkit/Paper e em proxies Velocity / BungeeCord / Waterfall — ele detecta a plataforma automaticamente a partir do loader sob o qual está rodando. Não existem mais arquivos resourcepackmanager-velocity-*.jar / resourcepackmanager-bungee-*.jar separados para extrair. (Se o RSPM detectar que este backend está atrás de um proxy que nunca lhe deu uma chave, ele prepara uma cópia do próprio jar em plugins/ResourcePackManager/proxy-extension/ResourcePackManager.jar para você copiar para o proxy — o mesmo arquivo, apenas colocado em um lugar conveniente.)

O descritor do plugin de backend declara a API Bukkit 1.21.4, então o servidor Bukkit/Paper precisa ser Minecraft 1.21.4 ou mais recente. A extensão de entidades personalizadas do Geyser incluída tem como alvo o Geyser 2.11+.

Configuração Recomendada (Standalone)

1. Coloque o ResourcePackManager.jar na pasta plugins/ do seu servidor. (É o mesmo jar que você usaria em um proxy Velocity / BungeeCord — não há jars de proxy separados.)
2. Inicie o servidor uma vez para que as pastas de config, mixer, blueprint e output sejam geradas.
3. Decida se você quer:
   • self-hosting (padrão, ativado)
   • fallback de auto-host gratuito do MagmaGuy (padrão, ativado)
   • aceitação forçada pelo cliente
   • packs personalizados manuais na pasta do mixer
4. Execute /rspm reload após alterar a configuração ou após adicionar packs personalizados manualmente.

É isso para o caminho feliz. Com as configurações padrão, o RSPM tentará o self-hosting primeiro e recorrerá automaticamente à CDN do MagmaGuy se algo parecer errado.

Você saberá que funcionou por uma única linha no console:

[ResourcePackManager] Resource pack is live via self-hosting — http://play.example.com:25566/rspm.zip

O RSPM mantém o console silencioso de propósito — ele relata o resultado, não cada etapa, e não avisa sobre condições das quais ele mesmo se recupera (um probe de self-host que falha seguido de um fallback bem-sucedido é um sucesso, não uma falha). Se algo precisar de diagnóstico, execute /rspm verbose on (ou defina verboseLogging: true no config.yml) e recarregue. Veja Solução de Problemas.

Pastas que o RSPM Gera

Dentro de plugins/ResourcePackManager/:

Pasta	Para que serve
mixer/	Coloque aqui packs .zip prontos para que sejam mesclados. Referencie-os em priorityOrder pelo nome de arquivo exato, incluindo o .zip.
resource_pack/	Coloque aqui um pack descompactado (uma árvore de pastas com assets/, pack.mcmeta, ...). O RSPM o compacta e o mescla sob a entrada de prioridade ResourcePackManager, que fica no topo do priorityOrder padrão.
blueprint/	Contém o pack.png e o pack.mcmeta padrão com que o RSPM contribui para a mesclagem. Edite-os para mudar o ícone do pack unificado ou a descrição do seu pack.mcmeta; a pasta é recompactada em blueprint.zip a cada inicialização.
output/	Os artefatos finais: ResourcePackManager_RSP.zip, mais ResourcePackManager_Bedrock.zip e rspm_geyser_mappings.json quando a conversão Bedrock os produziu.
compatible_plugins/	Um YAML por integração de plugin suportada.
data_compliance/	Onde /rspm data_compliance_request grava o seu download.
proxy-extension/	Só aparece em um backend que está atrás de um proxy que nunca lhe deu uma chave. Contém uma cópia do ResourcePackManager.jar em execução para colocar no proxy.
geyser-extension/	Só aparece quando o Floodgate é local mas o Geyser é um processo externo. Contém uma cópia do jar para colocar na pasta extensions/ daquele Geyser.

Comandos Principais

• /rspm setup — abre um menu de configuração em GUI no jogo (status de atualização do plugin, plugins recomendados, um botão de alternância de atualizações automáticas e um botão de informações com links clicáveis para a wiki, o Discord e o token da sua conta Nightbreak)
• /rspm recommendedplugins — mostra o menu compartilhado de plugins recomendados da Nightbreak
• /rspm downloadpluginupdate — baixa uma atualização disponível do ResourcePackManager para o próximo restart
• /rspm downloadall — baixa todas as atualizações disponíveis expostas por este plugin (atualmente, a atualização do ResourcePackManager)
• /rspm reload — reconstrói e re-hospeda o pack unificado
• /rspm status — imprime um dump completo de diagnóstico: estado do pack, modo de hospedagem, fingerprint da chave da rede, integrações
• /rspm verbose [on|off] — liga ou desliga o log detalhado de diagnóstico sem abrir o config.yml. Sem argumento, ele alterna. A escolha é gravada de volta em verboseLogging no config.yml, então sobrevive a reinícios. Tem /rspm verboselogging como alias.
• /rspm itemsadder configure — configura automaticamente o ItemsAdder para hospedagem via RSPM (veja abaixo)
• /rspm itemsadder dismiss — descarta permanentemente o aviso do ItemsAdder para o UUID do seu jogador
• /rspm data_compliance_request — baixa todos os dados armazenados remotamente para este servidor

O comando raiz é /resourcepackmanager, tendo /rspm como alias. Os comandos de atualização e de plugins recomendados acima são comandos compartilhados do MagmaCore/Nightbreak registrados pelo RSPM.

Permissões:

• /rspm setup e /rspm recommendedplugins exigem resourcepackmanager.setup. O /rspm setup é exclusivo de jogadores porque abre uma GUI de inventário.
• /rspm downloadpluginupdate, /rspm downloadall, /rspm reload, /rspm status, /rspm verbose, /rspm itemsadder <configure|dismiss> e /rspm data_compliance_request exigem resourcepackmanager.*.

ItemsAdder

O caminho atual preferido para o ItemsAdder não é mais apenas manual.

Use:

/rspm itemsadder configure

Esse auxiliar atualiza as configurações relevantes do ItemsAdder, regenera o pack do ItemsAdder e em seguida recarrega o ResourcePackManager. Especificamente, ele:

• define resource-pack.hosting.no-host.enabled: true
• desabilita protection_1, protection_2 e protection_3 em resource-pack.zip.protect-file-from-unzip
• define resource-pack.zip.compress-json-files: false (o RSPM precisa de JSON de modelo descomprimido e analisável para o mixer e o conversor Bedrock)
• dispara /iareload, depois /iazip
• recarrega o ResourcePackManager cerca de 15 segundos depois, após o ItemsAdder ter tido tempo de recarregar e regenerar

Se o ItemsAdder já estiver configurado para hospedar o próprio pack (self-host, external-host ou lobfile), o auxiliar para e informa que você deve desativar a hospedagem do ItemsAdder manualmente antes.

Suporte a Bedrock / GeyserMC

O RSPM converte automaticamente o pack Java unificado em um pack Bedrock para o GeyserMC. A conversão lida com o pack de definição de itens 1.21.4+ de qualquer plugin — não apenas do FreeMinecraftModels — incluindo itens 3D segurados, armaduras personalizadas e equipamentos modelados.

bedrockConversionEnabled tem valor padrão true, então uma instalação nova em um servidor que tenha o GeyserMC simplesmente funcionará.

Para um servidor standalone, a conversão dispara quando qualquer uma destas condições é verdadeira: o Geyser-Spigot está instalado neste servidor, o Floodgate está instalado neste servidor, ou o RSPM detectou o modo de proxy (veja Redes com Proxy).

Se o Geyser-Spigot estiver instalado neste servidor, o RSPM também se instala em plugins/Geyser-Spigot/extensions/ como uma extensão do Geyser, que é o que faz entidades Bedrock personalizadas renderizarem em vez de armor stands. É o mesmo ResourcePackManager.jar — nada extra para baixar — mas é preciso reiniciar o servidor uma vez para que tenha efeito. Defina geyserExtensionAutoInstall: false no config.yml para impedir que o RSPM instale e prepare essa extensão. Veja Extensão do Geyser e entidades personalizadas.

Consulte Conversão Bedrock / Geyser para o pipeline completo, os caminhos de saída e o ajuste de offsets de exibição.

Verificando a Configuração

Execute /rspm status no console ou como op. A saída é dividida em seções:

• Plugin meta — versão + modo de deploy (standalone vs network-backend). Em um backend de rede, também imprime um curto fingerprint não secreto da chave da rede e a origem dessa chave (fornecida pelo proxy / salva neste servidor / adotada da chave do Floodgate / ainda não definida).
• Java Pack — mesclado sim/não, tamanho, prefixo do SHA1
• Bedrock Pack — convertido sim/não, mappings presentes, com dicas de diagnóstico caso a conversão tenha sido pulada
• Hosting — qual caminho de entrega está ativo (self-hosted / remoto / ainda não pronto), a URL que os clientes verão, o host externo resolvido, o IP público auto-detectado
• Proxy deployment — um lembrete de que o jar de proxy da rede é o mesmo ResourcePackManager.jar; em uma rede, copie-o para a pasta plugins/ do proxy
• Integrations — detecção de Floodgate / Geyser-Spigot, contagem de jogadores online

Se algo parecer errado, consulte Solução de Problemas.

Para Onde Ir Agora

• FAQ — perguntas comuns
• Conversão Bedrock / Geyser — detalhes do conversor e ajuste
• Extensão do Geyser e entidades personalizadas — instalação da extensão e requisitos de versão do Geyser
• Self-hosting — servidor HTTP integrado, resolução de portas
• Redes com Proxy — se você administra BungeeCord / Waterfall / Velocity
• API — registrando o pack do seu plugin via código