Pacotes de Conteúdo do FreeMinecraftModels
O conteúdo oficial do FMM agora é exposto como pacotes Nightbreak gerenciados.
Pacotes Oficiais Atuais
O plugin atual define cinco pacotes oficiais pré-feitos, misturando conteúdo de prop e itens:
| Pack | Tipo | Nome do arquivo de config | Nome da pasta | Slug Nightbreak |
|---|---|---|---|---|
Basic Furniture Pack | Props | basic_furniture_pack | Basic Furniture Pack | basic-furniture-pack |
BetterStructures Prop Pack | Props | betterstructures_prop_pack | bs prop pack | betterstructures-prop-pack |
EliteMobs Prop Pack | Props | elitemobs_prop_pack | em_dungeon_prop_pack | elitemobs-prop-pack |
Craftenmine's Weapons Item Pack | Itens customizados | craftenmines_weapons_item_pack | fmm_craftenmine_weapons_items_pack | craftenmines-weapons-item-pack |
Craftenmine Tools Item Pack | Itens customizados | craftenmine_tools_item_pack | fmm_craftenmine_tools_items_pack | craftenmine-tools-item-pack |
O nome do arquivo de config é a entrada .yml em plugins/FreeMinecraftModels/content_packages/. O nome da pasta é o diretório onde os modelos do pack realmente residem dentro de models/ ou models_disabled/, e também é o prefixo padrão de arquivos de conteúdo/script.
Cada pacote tem um nome de pasta local, um slug Nightbreak, um campo de versão e um estado habilitado/desabilitado em content_packages. Os dois packs de itens Craftenmine trazem itens customizados (modelos com material: definido) que funcionam com toda a superfície de scripts Lua de item.
O Que o Menu de Configuração Gerencia
/fmm setup é atualmente a fonte de verdade para o estado dos pacotes. O menu consegue distinguir entre:
- pacotes instalados
- pacotes baixados mas atualmente desabilitados
- pacotes desatualizados
- pacotes que requerem acesso Nightbreak
O menu de configuração também aciona atualizações de fundo 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 baseada em estado para conteúdo habilitado e desabilitado:
- pastas de modelos habilitadas ficam em
models/<folderName> - pastas de modelos desabilitadas 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 em disco sem estar ativo na lista de modelos do 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 junto com ele durante a instalação/desinstalação.
Ciclo de Vida de Download e Instalação
Existem duas etapas distintas:
- Baixar o conteúdo do pacote.
Downloads vão para
plugins/FreeMinecraftModels/importse então acionam uma passagem de reload/import. - Manter o pacote habilitado ou desabilitado.
O menu de configuração instala e desinstala pacotes movendo suas pastas entre
modelsemodels_disabled.
Operações em massa seguem o mesmo modelo:
/fmm downloadallbaixa todo pacote acessível que esteja faltando ou desatualizado/fmm updatecontentatualiza apenas pacotes desatualizados
Ambos os comandos em massa recarregam o FreeMinecraftModels automaticamente após downloads bem-sucedidos para que o conteúdo recém-baixado fique disponível.
Navegador de Conteúdo para Admins
/fmm admin abre uma GUI de inventário no jogo que permite admins navegarem todo o conteúdo instalado de uma vez. O navegador mostra:
- todos os pacotes instalados (com contagens separadas de props e itens)
- pastas de modelos sem pacote (com contagens separadas de props e itens)
- props individuais (modelos sem
material:na configuração YML) - itens customizados (modelos que têm
material:definido na 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 em sua configuração YML aparece apenas como um item customizado, nunca como ambos prop e item.
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.