Pacotes de conteúdo do FreeMinecraftModels

O conteúdo oficial do FMM está disponível através de pacotes geridos pelo Nightbreak.

Pacotes oficiais atuais

O plugin define cinco pacotes oficiais, com elementos decorativos e itens:

Pacote	Tipo	Nome do ficheiro de configuração	Nome da pasta	Identificador Nightbreak
Basic Furniture Pack	Elementos decorativos	basic_furniture_pack	Basic Furniture Pack	basic-furniture-pack
BetterStructures Prop Pack	Elementos decorativos	betterstructures_prop_pack	bs prop pack	betterstructures-prop-pack
EliteMobs Prop Pack	Elementos decorativos	elitemobs_prop_pack	em_dungeon_prop_pack	elitemobs-prop-pack
Craftenmine's Weapons Item Pack	Itens personalizados	craftenmines_weapons_item_pack	fmm_craftenmine_weapons_items_pack	craftenmines-weapons-item-pack
Craftenmine Tools Item Pack	Itens personalizados	craftenmine_tools_item_pack	fmm_craftenmine_tools_items_pack	craftenmine-tools-item-pack

O nome do ficheiro de configuração identifica o ficheiro .yml em plugins/FreeMinecraftModels/content_packages/. O nome da pasta identifica o diretório de modelos do pacote dentro de models/ ou models_disabled/. Os prefixos são configurados separadamente, como descrito abaixo.

Cada pacote tem um nome de pasta local, um identificador Nightbreak, um campo de versão e um estado ativo/inativo em content_packages. Os dois pacotes de itens Craftenmine incluem itens para segurar na mão, com definições material: e encantamentos com espaço de nomes. As cópias antigas com scripts: de itens equipados precisam de conteúdo atualizado; essas definições são ignoradas.

O que o menu de instalação gere

/fmm setup mostra o estado dos pacotes a partir da configuração local, dos ficheiros detetados e da informação Nightbreak em cache. O menu distingue entre:

• Pacotes instalados.
• Pacotes descarregados, mas desativados.
• Pacotes desatualizados.
• Pacotes que exigem acesso através do Nightbreak.

O menu inicia verificações de versão e acesso em segundo plano, com um intervalo mínimo de cinco minutos entre atualizações. As versões são verificadas nos pacotes detetados como instalados. O indicador de instalado significa que o pacote está ativo e existe uma entrada de modelo gerida; não prova que todos os modelos carregaram nem que os clientes receberam o pacote de recursos. Verifique também /fmm admin, a consola e a entrega aos clientes.

Organização das pastas

O plugin move as pastas consoante o estado do conteúdo:

• Os modelos ativos ficam em models/<folderName>.
• Os modelos desativados ficam em models_disabled/<folderName>.
• Os scripts ativos ficam em scripts/.
• Os scripts desativados ficam em scripts_disabled/.

O conteúdo descarregado pode existir no disco sem estar ativo. Instalar ou desinstalar move as entradas correspondentes de modelos, scripts e encantamentos, guarda o estado ativo e pede um recarregamento. Os movimentos são sequenciais, sem uma transação atómica: uma falha ao mover ou guardar o estado pode deixar uma alteração parcial. Verifique a consola e ambas as localizações antes de tentar novamente. As duas ações exigem uma entrada de modelo gerida na pasta de origem; ficheiros apenas de scripts ou encantamentos podem contar como descarregados sem tornar o pacote instalável por essa ação.

Instalações antigas podem usar Models ou Models_disabled. O caminho ativo prefere models em minúsculas, enquanto o desativado prefere uma pasta Models_disabled existente. Consulte as notas de criação de modelos antes de juntar diretórios que distingam maiúsculas de minúsculas.

Prefixos dos ficheiros

As configurações têm contentFilePrefixes e scriptFilePrefixes. As cinco definições integradas inicializam ambas as listas vazias; não usam automaticamente folderName como prefixo. Consulte os valores fornecidos na configuração instalada.

Para modelos e encantamentos, o FMM seleciona a entrada exata folderName e as entradas na raiz cujos nomes começam por um valor de contentFilePrefixes. Para scripts, seleciona entradas na raiz que correspondem a scriptFilePrefixes, sem uma correspondência adicional pelo nome da pasta. Os prefixos ignoram maiúsculas e minúsculas e podem selecionar ficheiros ou diretórios completos; não procuram recursivamente ficheiros em diretórios alheios. Use prefixos distintos e mantenha os ficheiros referenciados dentro das entradas selecionadas.

Descarregar e instalar conteúdo

Existem duas etapas distintas:

1. Descarregar o conteúdo do pacote. Os ficheiros vão para plugins/FreeMinecraftModels/imports. Uma transferência gerida bem-sucedida guarda o estado ativo antes de pedir um recarregamento com importação.
2. Ativar ou desativar o pacote. O menu instala e desinstala pacotes ao mover as respetivas pastas entre models e models_disabled.

As operações em lote seguem o mesmo modelo:

• /fmm downloadall descarrega a atualização do JAR do plugin e todos os pacotes acessíveis em falta ou desatualizados. O recarregamento seguinte do FMM pode aplicar o conteúdo; o JAR do plugin entra em vigor após um reinício ou /fmm applypluginupdate.
• /fmm downloadallcontent procura o mesmo conteúdo sem descarregar o JAR do plugin.
• /fmm updatecontent, também disponível como /fmm updateallcontent, renova a informação de versão e acesso e atualiza os pacotes marcados como desatualizados; as verificações de versão abrangem atualmente os pacotes instalados.

As operações em lote processam os pacotes sequencialmente e distinguem as transferências e preparações bem-sucedidas das falhas. Se pelo menos um pacote terminar com sucesso, agendam um recarregamento 20 ticks depois, mesmo que outros falhem. Sem sucessos, não há recarregamento; uma instalação vazia informa que não há conteúdo novo, enquanto uma atualização vazia informa que não há atualizações pendentes. Uma transferência bem-sucedida não prova que a importação posterior, o carregamento dos modelos ou a entrega aos clientes tenham resultado.

As operações de conteúdo em lote partilham uma proteção que bloqueia uma segunda execução até a primeira terminar ou iniciar o recarregamento seguinte. Exigem um token Nightbreak associado e param se a autenticação falhar. As falhas normais de pacotes são comunicadas e os restantes continuam. Se o jogador que iniciou a operação sair, o processamento continua com mensagens na consola. A desativação do plugin invalida a publicação de transferências pendentes e os callbacks desse ciclo de execução.

Reparar um pacote

A seleção normal usa os ficheiros detetados e o estado da versão, sem verificar a integridade dos ficheiros. Um pacote parcialmente danificado pode continuar a parecer atualizado e ser ignorado. /fmm forcereinstallcontent <package|all> volta a descarregar o conteúdo selecionado independentemente da versão e pede um recarregamento após transferências bem-sucedidas. Esta operação não força a ativação de um pacote desativado.

• A conclusão com Tab oferece all e os identificadores Nightbreak de todos os pacotes: basic-furniture-pack, betterstructures-prop-pack, elitemobs-prop-pack, craftenmines-weapons-item-pack e craftenmine-tools-item-pack.
• all seleciona pacotes detetados como descarregados, instalados ou marcados como desatualizados. Se nenhum corresponder, surge No downloaded content was detected. Specify a package slug directly if its files are completely missing. Indique diretamente o identificador de um pacote totalmente ausente.
• Um seletor desconhecido produz Unknown Nightbreak content package: <name>.
• Este comando partilha a proteção contra execuções simultâneas das restantes operações em lote e exige freeminecraftmodels.*.

Conteúdo de outros pacotes

Um pacote de conteúdo de qualquer plugin Nightbreak, como um pacote do EliteMobs ou do BetterStructures colocado na pasta imports desse plugin, pode trazer conteúdo do FreeMinecraftModels numa pasta freeminecraftmodels/ de nível superior, organizada como plugins/FreeMinecraftModels/. Por exemplo, freeminecraftmodels/enchantments/ fornece os encantamentos freeminecraftmodels: usados pelos itens do pacote, e freeminecraftmodels/models/ é fundida na pasta de modelos que o FMM lê (models em minúsculas, ou uma pasta antiga Models quando esta existe). As pastas models/ e scripts/ de nível superior de um pacote também vão para o FMM. Uma pasta enchantments/ de nível superior segue a plataforma do pacote, indicada por pack.meta (ou, na sua ausência, pelo plugin cuja pasta imports contém o pacote): um pacote do FreeMinecraftModels instala-a no FMM, enquanto os pacotes do EliteMobs e do BetterStructures a instalam no EliteMobs.

Quando a importação de outro plugin coloca ficheiros na pasta do FMM, o FMM executa depois o seu recarregamento de conteúdo importado. Esse recarregamento reconstrói modelos, itens, encantamentos, scripts de elementos decorativos, receitas e o pacote de recursos, mas não volta a ler config.yml nem shop_config.yml.

Catálogo de conteúdo para administradores

/fmm admin abre um catálogo no jogo com os modelos carregados e os itens personalizados registados. Mostra:

• Pacotes ativos com conteúdo carregado, com contagens separadas de elementos decorativos e itens.
• Pastas de modelos sem pacote, também com contagens separadas.
• Modelos individuais de elementos decorativos.
• Itens personalizados registados com sucesso.

Os elementos decorativos aparecem a amarelo, com um ícone de papel. Os itens personalizados usam o material e nome configurados, com um nome roxo como alternativa. A inclusão depende do registo bem-sucedido do item, não apenas da presença de material: num ficheiro; uma definição rejeitada não aparece como item personalizado funcional.

As entradas de pacotes e pastas abrem as respetivas listas de conteúdo. Clicar num elemento decorativo ou item individual adiciona uma cópia ao inventário. Os itens personalizados incluem o material, encantamentos, descrição e etiqueta fmm_item_id; os elementos decorativos dão itens de colocação em papel. Deixe espaço no inventário: estes controlos de administrador não deixam cair no chão o que não cabe. Os erros de criação são comunicados no chat. O registo e uma entrada visível no menu não provam uma apresentação correta no cliente.

Conteúdo de encantamentos

A ativação e desativação inclui YAML/Lua de encantamentos geridos, modelos e scripts de elementos decorativos. O conteúdo ativo fica em enchantments/; o desativado passa para enchantments_disabled/. A seleção segue as regras anteriores de nome da pasta e prefixos de conteúdo; mantenha as definições dos fornecedores e os scripts referenciados dentro das entradas selecionadas. O antigo sistema de scripts de itens não substitui um fornecedor de encantamentos ausente.