Pular para o conteúdo principal

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, nem uma "proxy extension" empacotada para extrair e copiar para algum lugar.

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.

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 reload — reconstrói e re-hospeda o pack unificado
  • /rspm status — imprime um dump completo de diagnóstico: estado do pack, modo de hospedagem, chave da rede, integrações
  • /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. O RSPM também herda alguns subcomandos compartilhados do MagmaCore/Nightbreak (por exemplo, /rspm recommendedplugins, /rspm downloadall) para os quais o menu de configuração tem links.

Permissões:

  • /rspm setup exige resourcepackmanager.setup e é exclusivo de jogadores (abre uma GUI de inventário, então não pode ser executado a partir do console).
  • /rspm reload, /rspm status, /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).

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)
  • 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​