Saltar para o conteúdo principal

Instalação do ResourcePackManager

Esta página cobre um servidor independente. Para redes BungeeCord ou Velocity, siga Redes com proxy. O proxy usa o mesmo ResourcePackManager.jar, mas gera a sua própria configuração e desempenha a função de proxy.

O ResourcePackManager 2.x é distribuído num único JAR universal. ResourcePackManager.jar funciona em backends Bukkit/Paper e proxies Velocity/BungeeCord, detetando a plataforma pelo carregador. Já não existem JARs separados resourcepackmanager-velocity-*.jar ou resourcepackmanager-bungee-*.jar para extrair. Se detetar um backend atrás de um proxy sem chave de rede guardada ou derivada inicialmente, prepara uma cópia do seu JAR em plugins/ResourcePackManager/proxy-extension/ResourcePackManager.jar para copiar para o proxy: o mesmo ficheiro num local conveniente.

O descritor do backend declara a API Bukkit 1.21.4, exigindo Minecraft 1.21.4 ou posterior no Bukkit/Paper. A extensão de entidades personalizadas incluída destina-se ao Geyser 2.11 ou posterior.

  1. Coloque ResourcePackManager.jar em plugins/. É o mesmo ficheiro usado num proxy Velocity ou BungeeCord.
  2. Inicie o servidor para gerar a configuração e as pastas do combinador, modelo base e resultados.
  3. Escolha as opções pretendidas: alojamento próprio e alojamento gratuito de recurso do MagmaGuy, ambos ativos por predefinição; aceitação obrigatória pelo cliente; e pacotes manuais na pasta do combinador.
  4. Execute /rspm reload após alterar a configuração ou acrescentar pacotes manualmente.

Com as predefinições, o RSPM tenta primeiro alojamento próprio verificado e recorre ao alojamento remoto através de magmaguy.com se a verificação falhar ou estiver indisponível. Se ambas as vias automáticas falharem, não pode anunciar um novo URL de entrega. Verifique o estado final e a transferência pelo cliente antes de dar a instalação por concluída.

Uma configuração de alojamento bem-sucedida produz uma linha como:

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

O RSPM regista sobretudo o resultado. Não avisa sobre condições das quais recupera sozinho: uma verificação local falhada seguida de alojamento remoto bem-sucedido conta como sucesso. Para diagnosticar problemas, execute /rspm verbose on ou defina verboseLogging: true em config.yml e recarregue. Consulte Resolução de problemas.

Pastas geradas pelo RSPM​

Dentro de plugins/ResourcePackManager/:

PastaFinalidade
mixer/Coloque pacotes .zip completos para os combinar. Use o nome exato, incluindo .zip, em priorityOrder.
resource_pack/Coloque um pacote descomprimido, com assets/, pack.mcmeta e restantes ficheiros. O RSPM comprime-o e combina-o sob a entrada ResourcePackManager, no topo de priorityOrder por predefinição.
blueprint/Contém pack.png e pack.mcmeta predefinidos, que o RSPM acrescenta à combinação. Edite-os para alterar o ícone ou a descrição em pack.mcmeta. A pasta é comprimida novamente em blueprint.zip em cada arranque.
output/Resultados: ResourcePackManager_RSP.zip e, quando a conversão Bedrock os produzir, ResourcePackManager_Bedrock.zip e rspm_geyser_mappings.json.
compatible_plugins/Um YAML por integração de plugin suportada.
data_compliance/Destino da transferência de /rspm data_compliance_request.
proxy-extension/Criada quando um backend atrás de um proxy não tem chave de rede guardada ou derivada inicialmente. Contém uma cópia do ResourcePackManager.jar em execução para instalar no proxy. Uma pasta que permaneça no disco não demonstra que o backend continue por associar.
geyser-extension/Exportada quando a instalação automática da extensão está ativa, o Floodgate é local e não há Geyser-Spigot. Siga o caminho exato da consola, que pode apontar para update/, ao copiar o JAR para extensions/ do Geyser externo. A exportação não configura a entrega externa do pacote.

Comandos principais​

  • /rspm setup: abre um menu de instalação no jogo com estado das atualizações, plugins recomendados, opção de atualizações automáticas e informações com ligações para a wiki, Discord e token da conta Nightbreak.
  • /rspm recommendedplugins: apresenta o menu partilhado de plugins recomendados do Nightbreak.
  • /rspm downloadpluginupdate: transfere uma atualização disponível do ResourcePackManager para o próximo reinício.
  • /rspm downloadall: transfere todas as atualizações disponibilizadas pelo plugin, atualmente a do próprio ResourcePackManager.
  • /rspm applypluginupdate: registado pelo conjunto partilhado de comandos Nightbreak, mas o RSPM recusa-o sempre: ResourcePackManager updates need a server restart: its Geyser extension only loads when Geyser starts. Reinicie o servidor para aplicar uma atualização transferida.
  • /rspm reload: reinicia a inicialização do plugin e agenda a preparação do pacote; um pacote sem alterações pode reutilizar o registo de alojamento existente.
  • /rspm status: apresenta um diagnóstico completo do pacote, alojamento, impressão digital da chave de rede e integrações.
  • /rspm verbose [on|off]: ativa ou desativa o registo detalhado sem abrir config.yml. Sem argumento, alterna. Guarda a escolha em verboseLogging, mantendo-a após reinícios. Também aceita /rspm verboselogging.
  • /rspm itemsadder configure: configura automaticamente o ItemsAdder para alojamento através do RSPM, conforme descrito abaixo.
  • /rspm itemsadder dismiss: oculta permanentemente o aviso do ItemsAdder para o UUID do jogador.
  • /rspm data_compliance_request: transfere todos os dados deste servidor guardados remotamente.

O comando principal é /resourcepackmanager, com /rspm como nome alternativo. Os comandos de atualização e plugins recomendados pertencem ao MagmaCore/Nightbreak e são registados pelo RSPM.

Permissões:

  • /rspm setup e /rspm recommendedplugins exigem resourcepackmanager.setup. /rspm setup só pode ser usado por jogadores, pois abre um inventário gráfico.
  • /rspm downloadpluginupdate, /rspm downloadall, /rspm applypluginupdate, /rspm reload, /rspm status, /rspm verbose, /rspm itemsadder <configure|dismiss> e /rspm data_compliance_request exigem resourcepackmanager.*.

ItemsAdder​

A configuração recomendada do ItemsAdder tem um assistente automático:

/rspm itemsadder configure

Este atualiza as definições relevantes do ItemsAdder, pede a regeneração do pacote e aguarda que o RSPM combine a nova exportação. Concretamente:

  • Define resource-pack.hosting.no-host.enabled: true.
  • Desativa protection_1, protection_2 e protection_3 em resource-pack.zip.protect-file-from-unzip.
  • Define resource-pack.zip.compress-json-files: false, pois o combinador e o conversor Bedrock precisam de JSON de modelos descomprimido e analisável.
  • Executa /iareload após 20 ticks do servidor e /iazip outros 100 ticks depois.
  • Aguarda que o monitor do RSPM detete a exportação regenerada do ItemsAdder e conclua a combinação, e depois indica RSPM merged the regenerated ItemsAdder export. Use /rspm status to check hosting. Se essa combinação falhar, indica que não foi possível combinar a exportação e o RSPM volta a tentar.

O assistente não recarrega o ResourcePackManager. Recusa-se a iniciar enquanto uma configuração anterior ainda estiver pendente e para sem guardar se o config.yml do ItemsAdder mudar durante a edição. Se o ItemsAdder recusar /iareload ou /iazip, execute esse comando manualmente. A mensagem de combinação confirma a combinação, não o alojamento: verifique depois /rspm status e uma transferência com um cliente real.

Se o ItemsAdder já alojar o seu próprio pacote através de self-host, external-host ou lobfile, o assistente para e pede que desative primeiro esse alojamento manualmente.

Suporte Bedrock/GeyserMC​

O RSPM pode converter recursos suportados do pacote Java combinado num pacote Bedrock para o GeyserMC. Analisa definições de objetos 1.21.4 ou posteriores de qualquer plugin, incluindo objetos 3D na mão e equipamento suportados. Isto não garante a conversão de todos os nós de modelo, predicados ou designs de armadura. Consulte os limites no guia de conversão abaixo.

bedrockConversionEnabled é true por predefinição. A conversão também exige um destino Bedrock detetado e recursos de origem suportados. O registo no arranque pode exigir o reinício do Geyser descrito abaixo.

Num servidor independente, a conversão é acionada se tiver Geyser-Spigot local, Floodgate local ou se o RSPM detetar modo de proxy. Consulte Redes com proxy.

Com Geyser-Spigot local e geyserExtensionAutoInstall: true, o RSPM instala ou prepara o seu JAR universal em plugins/Geyser-Spigot/extensions/. Reinicie o servidor para carregar uma extensão recém-instalada ou preparada. As entidades Bedrock personalizadas também exigem um produtor compatível que marque a entidade Java através da ponte, definições registadas e o pacote correto no cliente. geyserExtensionAutoInstall: false impede instalações e preparações futuras; não remove um JAR instalado nem cancela uma atualização já preparada. Consulte Extensão do Geyser e entidades personalizadas.

Consulte Conversão Bedrock/Geyser para o processo completo, caminhos de saída e poses dos objetos na mão.

Verificar a instalação​

Para um endereço público HTTPS, mantenha o alojamento automático ativo e defina selfHostExternalUrl com o URL completo do pacote no proxy inverso. Consulte as definições de escuta e encaminhamento em HTTPS e proxies inversos.

Execute /rspm status na consola ou como operador. A saída inclui:

  • Informações do plugin: versão e modo de instalação, independente ou backend de rede. Num backend, apresenta uma impressão digital curta e não secreta da chave de rede e a sua origem: fornecida pelo proxy, guardada no servidor, adotada do Floodgate ou ainda não definida.
  • Pacote Java: estado da combinação, tamanho e prefixo SHA1.
  • Pacote Bedrock: estado da conversão, presença de mapeamentos e pistas de diagnóstico se a conversão foi ignorada.
  • Alojamento: via de entrega ativa, local, remota ou ainda indisponível; URL apresentado aos clientes; endereço externo resolvido; IP público detetado; e o resultado da última verificação de alojamento próprio com o motivo da falha.
  • Instalação no proxy: lembrete de que se usa o mesmo ResourcePackManager.jar na pasta plugins/ do proxy.
  • Integrações: deteção de Floodgate e Geyser-Spigot e número de jogadores ligados.

Depois de aparecer um URL de entrega, entre com um cliente real, aceite o pacote e observe um objeto ou modelo personalizado conhecido. Em Bedrock, volte a ligar-se após reconstruir o pacote e reinicie o Geyser quando for necessário registar novos mapeamentos ou definições de entidades. O estado e os registos de alojamento descrevem a publicação, não a apresentação no cliente.

Se algo estiver errado, consulte Resolução de problemas.

Próximas páginas​