FreeMinecraftModels

O FreeMinecraftModels gere modelos personalizados no jogo e disponibiliza uma API para programadores.

O plugin inclui:

• Instalação inicial com lembrete à entrada até ser marcada como concluída.
• Menu Nightbreak para instalar e atualizar pacotes oficiais de modelos.
• Pasta do pacote de recursos gerado em plugins/FreeMinecraftModels/output/FreeMinecraftModels.
• Pacote comprimido em plugins/FreeMinecraftModels/output/FreeMinecraftModels.zip.
• Comandos para instalação, atualizações, criação de entidades, disfarces, elementos decorativos e depuração.
• Ossos de pontos de montagem: os nomes começados por m_ criam assentos no modelo, permitindo aos jogadores montar entidades personalizadas.
• JSON de apresentação personalizado: um .json junto do .bbmodel, exportado pelo Blockbench como objeto de apresentação, substitui a aparência do objeto no jogo. Exige 1.21.4 ou posterior.
• Objetos personalizados e armas mágicas: modelos na mão com encantamentos identificados por espaço de nomes, além de varinhas e cajados definidos em conteúdo.
• Partículas do Blockbench: os fotogramas-chave de partículas nas animações de um modelo são reproduzidos em entidades personalizadas, elementos decorativos e objetos na mão, para jogadores Java e Bedrock. Consulte Partículas.
• Navegador administrativo de conteúdo, /fmm admin: menu com modelos carregados e objetos personalizados registados com sucesso, agrupados por pacote ativo ou pasta.
• Menu de objetos fabricáveis, /fmm: mostra as receitas de elementos decorativos registadas, com grelha 3x3 e resultado; não inclui entradas sem receita registada.
• Disfarces de jogadores: /fmm disguise <model> [player], /fmm undisguise [player] e /fmm disguiselist, com DisguiseAPI pública para outros plugins.
• Loja de mobília: /fmm shop, opcional e integrada com Vault, vende objetos de papel para colocar elementos decorativos, configurados por receita com shopEnabled e shopPrice; as entradas válidas podem continuar disponíveis com o registo de receitas desativado.
• API de interface do jogador: os scripts Lua podem apresentar barras de boss, barras de ação e títulos.
• LocationAPI: outros plugins podem registar detetores de masmorras e fornecedores de proteção usados por em.location.is_in_dungeon, em.location.is_protected e pela verificação de colocação em regiões protegidas.
• Notas de versão no jogo: os administradores são avisados à entrada quando existem notas por ler e podem consultá-las com /freeminecraftmodelschangelog.
• Reparação de conteúdo: /fmm forcereinstallcontent <package|all> transfere novamente conteúdo considerado atualizado, para recuperar ficheiros danificados ou ausentes.
• Atualizações do plugin sem reiniciar: /fmm applypluginupdate ou a opção nightbreak.applyPluginUpdatesWithoutRestart instalam um JAR descarregado com o servidor em funcionamento. Consulte Configuração.
• Modo fílmico: /fmm filmic on|off ou filmicMode envia a cada jogador todos os modelos carregados nos seus chunks carregados, mesmo fora do campo de visão, para gravações com o ReplayMod. Consulte Configuração.

O plugin declara api-version: 1.21.4. Minecraft 1.21.4 é a versão mínima de servidor suportada.

Comece aqui

• Instalação

• Pacotes de conteúdo

• Comandos

• Configuração

• Disfarces de jogadores

• Loja de mobília

• Pacote de recursos gerado

• Criação de modelos

• Animações

• API e guia para programadores

• Perguntas frequentes

• Lua: primeiros passos

• Lua: API de elementos decorativos

• Lua: exemplos

• Lua: resolução de problemas

Scripts Lua

O FreeMinecraftModels suporta scripts Lua para elementos decorativos, através do motor MagmaCore 2.0. Os scripts ficam em plugins/FreeMinecraftModels/scripts/.

Oito eventos ativos dos elementos decorativos

Os scripts podem responder a:

Evento	Momento
on_spawn	O elemento aparece no mundo ou volta a carregar com o seu chunk.
on_game_tick	Cada tick enquanto o elemento existe.
on_zone_enter	Um jogador entra numa zona monitorizada criada pelo script.
on_zone_leave	Um jogador sai dessa zona.
on_destroy	O elemento é removido definitivamente (não ao descarregar o chunk nem ao recarregar).
on_left_click	Um jogador clica com o botão esquerdo.
on_right_click	Um jogador clica com o botão direito.
on_projectile_hit	Um projétil atinge o elemento.

Os scripts recebem context.prop, com campos como model_id e current_location e métodos como play_animation(name) e stop_animation().

Efeitos dos objetos

Os scripts Lua de objetos equipados foram retirados. Os objetos na mão usam agora encantamentos definidos em conteúdo, e as varinhas e cajados usam definições de armas mágicas. Não acrescente scripts: a uma definição de objeto na mão.

Notas atuais

• Pacotes oficiais Nightbreak incluídos no catálogo do plugin: Basic Furniture Pack, BetterStructures Prop Pack, EliteMobs Prop Pack, Craftenmine's Weapons Item Pack e Craftenmine Tools Item Pack.
• Uma inicialização completa bem-sucedida reconstrói o pacote de recursos e agenda FmmReloadedEvent para 40 ticks depois, permitindo aos plugins dependentes voltar a associar os modelos. Uma recarga rejeitada durante a preparação mantém o sistema ativo.
• O ResourcePackManager pode distribuir automaticamente o pacote gerado. Verifique os ficheiros produzidos e a aceitação real pelo cliente; a marca de instalação concluída ou de pacote instalado não comprova a entrega.