Pular para o conteúdo principal

Pacotes de Conteúdo do FreeMinecraftModels

O conteúdo oficial do FMM agora é exposto como pacotes gerenciados pelo Nightbreak.

Pacotes Oficiais Atuais​

O plugin atual define três pacotes oficiais pré-configurados:

  • Basic Furniture Pack
  • BetterStructures Prop Pack
  • EliteMobs Prop Pack

Cada pacote tem um nome de pasta local, um slug Nightbreak, um campo de versão e um estado de habilitado/desabilitado em content_packages.

O Que o Menu de Configuração Gerencia​

/fmm setup é a fonte atual de verdade para o estado dos pacotes. O menu pode distinguir entre:

  • pacotes instalados
  • pacotes baixados mas atualmente desabilitados
  • pacotes desatualizados
  • pacotes que requerem acesso ao Nightbreak

O menu de configuração também dispara atualizações em segundo plano para versões de pacotes e verificações de acesso, então o menu é o lugar certo para verificar o estado atual dos pacotes.

Comportamento de Pastas​

O plugin usa movimentação de pastas por estado de pacote para conteúdo habilitado e desabilitado:

  • pastas de modelos habilitados ficam em models/<folderName>
  • pastas de modelos desabilitados ficam em models_disabled/<folderName>
  • arquivos de script habilitados ficam em scripts/
  • arquivos de script desabilitados ficam em scripts_disabled/

Isso significa que um pacote pode estar totalmente baixado no disco sem estar ativo na lista de modelos em runtime. Quando um pacote é instalado ou desinstalado, tanto sua pasta de modelos quanto quaisquer arquivos de script correspondentes são movidos juntos.

Prefixos de Arquivo​

Cada configuração de pacote de conteúdo tem um campo contentFilePrefixes e um campo scriptFilePrefixes (ambos com padrão para o folderName do pacote). Arquivos de conteúdo cujos nomes começam com qualquer um dos contentFilePrefixes e arquivos de script na pasta scripts/ cujos nomes começam com qualquer um dos scriptFilePrefixes são considerados parte do pacote e são movidos com ele durante a instalação/desinstalação.

Ciclo de Vida de Download e Instalação​

Existem duas etapas distintas:

  1. Baixar o conteúdo do pacote. Downloads vão para plugins/FreeMinecraftModels/imports e então disparam uma passagem de reload/importação.
  2. Manter o pacote habilitado ou desabilitado. O menu de configuração instala e desinstala pacotes movendo suas pastas entre models e models_disabled.

Operações em massa seguem o mesmo modelo:

  • /fmm downloadall baixa todos os pacotes acessíveis que estão faltando ou desatualizados
  • /fmm updatecontent atualiza apenas pacotes desatualizados

Ambos os comandos em massa recarregam FreeMinecraftModels automaticamente após downloads bem-sucedidos para que o conteúdo recém-baixado fique disponível.

/fmm admin abre uma GUI de inventário no jogo que permite que admins naveguem todo o conteúdo instalado de relance. O navegador mostra:

  • todos os pacotes instalados (com contagens separadas de props e itens)
  • pastas de modelos não empacotados (com contagens separadas de props e itens)
  • props individuais (modelos sem material: na sua configuração YML)
  • itens customizados (modelos que têm material: definido na sua configuração YML)

Props e itens são exibidos de forma distinta: props usam estilo amarelo e um ícone de papel, enquanto itens customizados usam estilo roxo e mostram seu material configurado. Um modelo que tem material: definido na sua configuração YML aparece apenas como item customizado, nunca como prop e item ao mesmo tempo.

Clicar em qualquer entrada no navegador de admin dá ao jogador uma cópia daquele item. Para itens customizados, o item dado inclui o material configurado, encantamentos, lore e a tag PDC fmm_item_id. Esta é a forma mais rápida de obter props, itens customizados ou itens de modelo para testes e construção sem precisar saber o ID exato do modelo ou a sintaxe do comando.