Animações do FreeMinecraftModels
O FreeMinecraftModels importa animações de ficheiros .bbmodel e .fmmodel. Esta página descreve os nomes reservados, como as animações se combinam, os tempos dos fotogramas, a interpolação, os modos de repetição, a cinemática inversa (IK) e a forma como os modelos rodam.
Para as regras dos nomes dos ossos e os restantes requisitos de importação, consulte Notas sobre criação de modelos.
Animações de estado
O FreeMinecraftModels associa estes seis nomes de animação em minúsculas, e os quatro de natação e de montada indicados abaixo, a estados automáticos. As restantes animações do modelo são personalizadas.
| Nome da animação | Repete | Quando é reproduzida |
|---|---|---|
spawn | Não | Uma vez, ao criar o modelo. Quando termina, o modelo passa para walk se a sua entidade se estiver a mover e, caso contrário, para idle |
idle | Sim | Enquanto a entidade não tem velocidade horizontal. Faz uma transição suave para walk quando a velocidade em X ou Z deixa de ser zero |
idle.long | Não | Uma vez, depois de o modelo ter mostrado idle sem mais nada a ser reproduzido durante um número aleatório de segundos entre longIdleMinSeconds e longIdleMaxSeconds (15 a 30 segundos por predefinição). Depois o modelo faz uma transição suave de volta para idle e a espera recomeça |
walk | Sim | Enquanto a velocidade da entidade em X ou Z não é zero. Faz uma transição suave para idle quando ambas são zero |
attack | Não | Quando ativada. É reproduzida uma vez por cima de idle ou walk e depois termina |
death | Não | Ao chamar removeWithDeathAnimation(). Surge gradualmente a partir da pose atual. Quando termina, o modelo encolhe durante 20 ticks e é removido |
O FMM só aciona attack por si próprio nos Evokers, quando as presas invocadas pelo Evoker surgem a menos de dois blocos dele. Os outros plugins acionam os ataques através da API. O EliteMobs reproduz attack.melee e attack.ranged. Todos os nomes que começam por attack. são ataques, reproduzidos como attack.
idle.long é reproduzida uma vez, qualquer que seja a definição de repetição no Blockbench. Mover-se, um ataque ou outra ação, uma animação personalizada na camada base e um jogador a conduzir o mob como montada recomeçam a espera, e as mesmas coisas interrompem um idle.long em curso. Um modelo sem idle.long nunca espera. idle.long exige o FreeMinecraftModels 2.15.0 ou mais recente; as versões anteriores tratam-na como uma animação personalizada.
Há mais quatro animações base, reproduzidas em vez de walk e idle enquanto o mob nada ou um jogador o monta, sempre que o modelo as tem:
- Montada. Um modelo num cavalo com sela que um jogador conduz, como uma mascote montada ou uma montada de
/fmm mount, reproduzrideem vez dewalkenquanto se move, eidle.rideem vez deidleenquanto está parado. Um ficheiro de mascote pode indicar outras animações comriding.animationeriding.idleAnimation; consulte Montar. Os plugins chamamgetAnimationComponent().setRiddenAnimation(name)esetRiddenIdleAnimation(name), em quenulldesativa uma delas. Um modelo semrideanda debaixo do cavaleiro, e um semidle.ridefica emidle. - Natação. Um modelo cujo mob nada, ou seja, está na água sem tocar no chão, reproduz
swimem vez dewalkenquanto se move, eidle.swimem vez deidleenquanto se mantém imóvel. Um ficheiro de mascote pode indicar outras animações comswimming.animationeswimming.idleAnimation; consulte Nadar. Os plugins chamamgetAnimationComponent().setSwimAnimation(name)esetIdleSwimAnimation(name), em quenulldesativa uma delas. Um modelo semswimanda na água, e um semidle.swimfica emidleenquanto se mantém imóvel. Uma montada conduzida por um jogador também reproduz as suas animações de montada na água.
As quatro exigem o FreeMinecraftModels 2.15.0 ou mais recente.
Nomenclatura
Os nomes das animações são em minúsculas. Um ponto separa um nome geral de um mais específico, e um sublinhado une as palavras dentro de uma parte: idle.long é um tipo de idle, e attack.melee um tipo de attack. Cada pose parada é idle. seguido do nome do movimento que interrompe:
| Em movimento | Parado | |
|---|---|---|
| Em terra | walk | idle, e idle.long de vez em quando |
| Na água | swim | idle.swim |
| Montado | ride | idle.ride |
Quando um modelo não tem um nome com ponto, o FMM reproduz em vez dele o nome até ao último ponto: attack para attack.melee, idle para idle.swim. O mesmo vale para os nomes que os scripts e os plugins reproduzem: playAnimation e hasAnimation seguem ambos esta regra.
Os modelos feitos antes disto usavam long_idle, attack_melee e attack_ranged. O FMM encontra-os pelos novos nomes, e os novos nomes pelos antigos, por isso os modelos e os plugins mais antigos continuam a funcionar sem alterações.
Os nomes com ponto, a alternativa e as grafias antigas exigem o FreeMinecraftModels 2.15.0 ou mais recente.
Da organização da máquina de estados resultam estas regras:
- O estado inicial é
spawn, se existir, ouidle. Um modelo sem ambos mostra a pose de repouso até começar a andar ou até algo reproduzir uma animação. - Só as animações existentes são usadas. Um modelo com
walk, mas semidle, continua a andar depois de parar de se mover. - A alternância entre
idleewalkusa a velocidade horizontal da entidade subjacente. O movimento apenas vertical não inicia a caminhada. As entidades estáticas e os disfarces não têm uma entidade subjacente para este efeito, e os elementos decorativos parados não têm movimento horizontal. As suas animações adicionais são controladas por scripts, pela API ou pelo controlador de disfarces do FMM.
jumpAs entidades modeladas normais não têm estado de salto. Uma animação chamada jump comporta-se como qualquer outra animação personalizada e tem de ser reproduzida pelo nome. Os disfarces de jogadores são a exceção: o seu controlador separado reproduz jump quando o jogador salta.
Combinação de animações
O FMM reproduz as animações de um modelo em duas camadas e mistura-as numa única pose a cada tick, em Java e em Bedrock.
| Camada | O que é reproduzido nela |
|---|---|
| Base | spawn, idle, idle.long, walk, as animações de montada e de natação, e death, ou uma animação personalizada reproduzida com blend definido como false, que assume toda a pose |
| Ação | attack e todos os nomes attack., como attack.melee e attack.ranged, damaged e animações personalizadas reproduzidas com blend definido como true. Uma ação é reproduzida por cima da camada base, por isso um modelo pode atacar enquanto anda |
Um osso que a animação base não anima volta à pose de repouso. Um osso que a ação não anima mantém a pose da base.
Transições
| Mudança | Transição |
|---|---|
Entre idle, idle.long, walk e as animações de montada e de natação | Transição cruzada ao longo de idleWalkBlendTicks, predefinição 5 ticks. As duas animações continuam a ser reproduzidas durante a transição |
Qualquer uma para death | Transição a partir da pose que o modelo mostrava no tick anterior, ação incluída, ao longo de deathBlendTicks, predefinição 4 ticks |
| Qualquer outra mudança | Instantânea |
As transições aceleram e abrandam em vez de avançarem a um ritmo constante. Quando uma nova mudança entre idle e walk interrompe uma transição, a transição seguinte parte da pose que o modelo estava a mostrar. As ações começam e terminam sem transição.
Substituição e peso de mistura
O FMM lê duas definições das propriedades de cada animação no Blockbench.
| Definição do Blockbench | Efeito no FMM |
|---|---|
| Override ativado | Na camada de ação, os ossos que a animação anima assumem a sua pose e abandonam a pose da base |
| Override desativado (predefinição) | Na camada de ação, a rotação e a posição da animação somam-se à pose base dos ossos que anima, e a sua escala multiplica a escala base |
| Blend Weight | Ajusta a intensidade com que a animação se aplica, em qualquer das camadas. 1 (predefinição) aplica os fotogramas-chave como foram criados. 0.5 aplica metade de cada rotação e posição e leva a escala metade do caminho entre 1 e o valor animado |
Ative o Override quando os ossos animados por um ataque tiverem de chegar exatamente à pose criada, seja qual for o ciclo de caminhada. Deixe-o desativado para somar o movimento do ataque ao da caminhada, por exemplo um balanço dos braços enquanto as pernas continuam a andar. Em Java, o Override não tem efeito nas animações da camada base, que substituem sempre a pose.
O FMM lê o Blend Weight apenas como um número simples. Uma expressão Molang regista Model <model>, animation <animation> has the blend weight '<value>'. FreeMinecraftModels only reads plain numbers and uses 1. O FMM não suporta o Start Delay, o Loop Delay nem o Anim Time Update do Blockbench. Uma animação que defina qualquer um deles regista um aviso e é reproduzida sem eles.
Que animação prevalece
- As animações personalizadas,
damagedincluída, prevalecem sobre as integradas. Enquanto uma delas é reproduzida em qualquer das camadas, os pedidos de ataque são descartados.deathinterrompe tudo. - Uma nova ação substitui a ação em curso, por isso um segundo ataque reinicia o ataque, e uma animação personalizada reproduzida com
blenddefinido comotruesubstitui um ataque em curso. - Uma animação personalizada reproduzida com
blenddefinido comofalsetermina a ação atual. - Enquanto uma animação personalizada ocupa a camada base, o FMM continua a acompanhar
idleewalkpor baixo. Assumir a camada base termina umspawnouidle.longem curso. Quando uma animação personalizada de execução única termina, o modelo salta paraidleouwalk, conforme o seu movimento. Um pedido explícito deidleouwalktermina de imediato uma animação personalizada em repetição, e só é mostrado depois de uma de execução única terminar. - Uma ação de execução única termina depois do último fotograma. Se a camada base não tiver nada para mostrar, por exemplo num elemento decorativo sem animação
spawnnemidle, a ação mantém o último fotograma, pelo que uma porta aberta assim fica aberta. Uma animação personalizada de execução única na camada base também mantém o último fotograma quando o modelo não temidlenemwalkpara onde regressar.
Os disfarces usam outro conjunto
Um disfarce de jogador acrescenta um controlador por tick que pede animações ao mesmo motor de reprodução. Os seus cinco nomes reservados são attack, jump, sneak, walk e idle, avaliados por essa ordem quando a contagem decrescente de uma animação de execução única está inativa. attack é reproduzida na camada de ação, jump e sneak assumem a camada base, e idle e walk selecionam os estados integrados. É registado um aviso na consola se faltar idle. Consulte Disfarces de jogadores para ver a tabela completa e a limitação de duração dessas animações.
Animações personalizadas
Qualquer animação cujo nome não seja um dos nomes de estado acima pode ser reproduzida explicitamente pelo nome:
modeledEntity.playAnimation("open", /* blend */ true, /* loop */ false);
modeledEntity.stopCurrentAnimations();
boolean exists = modeledEntity.hasAnimation("open");
context.prop:play_animation("open", true, false)
context.prop:stop_animation()
blendescolhe a camada de uma animação personalizada. Comtrue, é reproduzida na camada de ação, por cima deidleouwalk, com o Override e o peso de mistura do Blockbench. Comfalse, ocupa a camada base, pelo que substitui toda a pose e termina a ação atual. Consulte Combinação de animações.- Os pedidos ficam em fila e são aplicados por ordem no início do tick seguinte do modelo. Todos os pedidos são executados; um pedido posterior não cancela um anterior que esteja na fila.
loopaplica-se às animações personalizadas e adamaged. Os nomes integrados ignoramblendeloop:idleewalkrepetem sempre, enquantospawn,deathe os ataques são reproduzidos uma vez.idle.longreproduzida pelo nome é uma animação personalizada como qualquer outra.- Os nomes integrados e de ataque são reconhecidos independentemente de maiúsculas e minúsculas. Para os outros nomes, o FMM procura primeiro o nome exato, depois a sua forma em minúsculas, depois a grafia antiga de um nome que mudou e, por fim, a parte geral de um nome com ponto (consulte Nomenclatura).
hasAnimationencontra os mesmos nomes queplayAnimationreproduz. O modelo tem de conter o nome em minúsculas para um estado integrado funcionar. damagedé sempre reproduzida na camada de ação, seja qual for o valor deblend.playAnimationdevolvefalsepara um nome que o modelo não tem e para qualquer pedido depois dedeathter sido pedida.truesignifica que o pedido ficou em fila, não que já tenha sido apresentado um fotograma: um ataque ainda pode ser descartado por uma animação personalizada em curso.stopCurrentAnimations()termina todas as animações personalizadas e ações e leva o modelo paraidle, ou para a pose de repouso quando não temidle.- A morte é terminal: depois de
deathser pedida, os novos pedidos de reprodução devolvemfalse, os pedidos em fila são ignorados estopCurrentAnimations()não faz nada.
Tempo e duração
- O Blockbench guarda a duração em segundos. O FMM converte-a com
ceil(seconds x 20): a duração é sempre um número inteiro de ticks, arredondado para cima. - Um canal com fotogramas-chave apenas numéricos é convertido, na importação, num vetor de fotogramas, um por tick, e a reprodução lê um fotograma por tick. Um canal com um fotograma-chave MoLang é, em vez disso, amostrado a cada tick para cada entidade; consulte Fotogramas-chave MoLang.
- Cada animação em reprodução mantém o seu próprio contador de ticks, por isso a camada base, a camada de ação e uma animação em transição avançam de forma independente. As animações em repetição usam o índice
counter % duration; as restantes ficam no último fotograma. - Os tempos dos fotogramas-chave mantêm a posição fracionária em ticks (
20 x time, sem arredondamento), pelo que um fotograma-chave aos 0,37 segundos contribui para a interpolação entre ticks. Os fotogramas são amostrados em ticks inteiros de0aduration - 1. Um fotograma-chave exatamente no fim declarado influencia a interpolação, mas não é amostrado diretamente. Coloque a pose final antes desse limite se um fotograma apresentado tiver de a atingir. - Se dois fotogramas-chave do mesmo canal tiverem exatamente o mesmo tempo, prevalece o que aparece mais tarde no ficheiro.
- Um tempo não finito interrompe essa pista e produz um único aviso
Malformed animation timeline for model ...por animação. As outras animações do modelo continuam a ser convertidas.
Animações de duração zero são válidas
Uma animação de duração 0 ou negativa é tratada como uma pose estática intencional. É comum em mobília e outros elementos decorativos que precisam de uma entrada com nome para representar a ausência de animação. É ignorada sem aviso e não fornece fotogramas.
Modos de repetição
A opção de repetição do Blockbench controla a animação exportada para Bedrock:
| Modo do Blockbench | Exportação Bedrock |
|---|---|
loop | "loop": true |
once | "loop": false |
hold | "loop": "hold_on_last_frame" |
Em Java, a reprodução usa a regra do estado integrado ou o argumento loop da animação personalizada. Não escolhe a repetição a partir deste campo do Blockbench. Assim, Java e Bedrock podem reproduzir de forma diferente quando as opções não coincidem.
Tipos de interpolação
Cada fotograma-chave tem um de quatro tipos de interpolação: linear, catmullrom (Suave no Blockbench), bezier e step. Qualquer outro tipo falha na leitura e é comunicado como uma linha temporal inválida.
O FMM reproduz o segmento entre dois fotogramas-chave como o Blockbench o pré-visualiza, a partir dos tipos dos dois fotogramas-chave, verificados por esta ordem:
- Um fotograma-chave
stepmantém o seu valor até ao fotograma-chave seguinte. - Um fotograma-chave
linearseguido de umlinearoustepfaz uma interpolação em linha reta. - Quando um dos fotogramas-chave é
catmullrom, o segmento segue uma curva de Catmull-Rom através do fotograma-chave anterior ao segmento, dos dois fotogramas-chave do segmento e do fotograma-chave seguinte, para que o movimento flua através de cada fotograma-chave em vez de parar nele. Um vizinho em falta repete o próprio extremo do segmento. Numa animação cujo modo de repetição no Blockbench éloop, com pelo menos três fotogramas-chave no canal, a curva continua através da repetição, tratando o último fotograma-chave como o primeiro outra vez. - Caso contrário, um deles é
bezier, e o segmento segue o controlo direito do fotograma-chave de saída e o controlo esquerdo do fotograma-chave de chegada, em tempo e em valor. Um fotograma-chave guardado sem controlos tem-nos 0,1 segundos para cada lado, sem desvio de valor. O tempo de um controlo é mantido dentro do segmento.
Antes do seu primeiro fotograma-chave um canal mantém o valor desse fotograma-chave, e depois do último mantém o valor do último.
Um fotograma-chave com valores pré e pós separados é atingido com o valor pré e abandonado a partir do valor pós. Num segmento suave, um fotograma-chave assim também termina a curva do seu lado. Um valor pós que o FMM não consiga ler é ignorado.
Estas regras aplicam-se aos canais pré-calculados, aos canais MoLang em Java e às pistas pré-calculadas da exportação Bedrock. Exigem o FreeMinecraftModels 2.15.0 ou mais recente. Da 2.3.0 à 2.14.2, o FreeMinecraftModels misturava cada segmento apenas pelo tipo do fotograma-chave de chegada: catmullrom abrandava até parar em cada fotograma-chave, bezier usava pontos de controlo fixos 0.42 e 0.58 fossem quais fossem os seus controlos, o que resultava num movimento quase reto, e um fotograma-chave step saltava para o seu valor a meio do segmento que levava até ele. Os valores pré e pós separados colapsavam no valor pré. Os modelos com fotogramas-chave suaves, step ou Bézier movem-se por isso de forma diferente depois da atualização, mais perto do que o seu autor viu no Blockbench.
Canais animados
São preparados três canais por osso: rotação, posição e escala. Ao criar animações, tenha em conta que:
- Os valores de posição são divididos por 16, convertendo píxeis do Blockbench em blocos.
- Os valores de rotação são convertidos em radianos.
- O
format_version5 e posteriores do Blockbench inverte o sinal das rotações X e Y e da posição X. O FMM compensa automaticamente de acordo com a versão declarada. Não faça uma correção manual nem declare v5 para dados com a convenção v4. - Um osso sem fotogramas-chave num canal mantém o valor de repouso desse canal. Um osso que a animação da camada base não anima de todo é reposto para rotação
0,0,0, translação0,0,0e escala1,1,1; um osso que a ação não anima mantém a pose da base. - Os pontos de dados podem aparecer como cadeias de texto no
.bbmodel. Uma cadeia que seja um número é lida como esse número, e uma cadeia vazia passa a1na escala e a0nos restantes canais. Qualquer outra cadeia é uma expressão MoLang; consulte Fotogramas-chave MoLang. - Um fotograma-chave com dois pontos de dados, os valores pré e pós separados do Blockbench, é atingido com o primeiro e abandonado a partir do segundo. Consulte Tipos de interpolação.
Fotogramas-chave MoLang
Um valor de fotograma-chave escrito como expressão MoLang, como math.sin(query.anim_time * 360) * 10, é avaliado para cada entidade enquanto a animação é reproduzida.
- Um canal, isto é, a rotação, a posição ou a escala de um osso, ou a posição de um controlador IK, que tenha pelo menos um fotograma-chave MoLang não é pré-calculado. Cada entidade amostra-o a cada tick, com a mesma interpolação e a mesma conversão de unidades dos canais pré-calculados. Os fotogramas-chave numéricos desse canal mantêm os seus valores.
- Estas consultas estão disponíveis, também com o prefixo curto
q.:
| Consulta | Valor |
|---|---|
query.anim_time | Segundos decorridos nesta animação. Uma animação em repetição recomeça de 0 a cada repetição |
query.life_time | Segundos desde que o modelo foi criado |
query.modified_distance_moved | Blocos que a entidade percorreu na horizontal |
query.is_moving | 1 enquanto a entidade se move na horizontal, caso contrário 0 |
- As outras consultas e as variáveis desconhecidas são lidas como
0. Uma variávelv.mantém o seu valor nessa entidade entre avaliações, e um valortemp.(t.) dura uma expressão. - As expressões usam os mesmos operadores e funções matemáticas que o MoLang das partículas.
- Um programa de várias instruções sem
returnassume o valor da sua última linha, tal como o Blockbench o pré-visualiza.v.a = 10; v.b = v.a * 3; v.b + 5é reproduzido como35. Uma última linha que seja uma atribuição vale0. O MoLang das partículas mantém a regra do Bedrock, em que um programa semreturnvale0. - Uma expressão que o FMM não consiga interpretar regista uma vez, no carregamento,
Failed to parse the keyframe expression '<expression>' in animation <animation> for model <model>: <reason>. That value plays as 0. - Um resultado que não seja um número finito é reproduzido como
0. - Um segmento suave avalia também os fotogramas-chave de cada lado para dar forma à sua curva. Essas avaliações não guardam nenhuma das variáveis que atribuem, pelo que as atribuições de um fotograma-chave só têm efeito nos ticks dos segmentos que ele inicia ou termina.
Os jogadores Bedrock avaliam estes canais no seu próprio cliente: a exportação Bedrock escreve os fotogramas-chave do canal tal como foram criados; consulte Exportação Bedrock.
O que não é animado
- O osso
hitbox: as pistas dirigidas a ele são ignoradas. - Os fotogramas-chave de som e de instruções da linha temporal nas pistas de efeitos do Blockbench. O FMM importa apenas os fotogramas-chave de partículas de uma pista de efeitos; consulte Partículas. Para produzir sons, use um script Lua ou o seu próprio plugin.
- Ossos que não foram encontrados pelo nome. Uma pista dirigida a um osso inexistente gera
Failed to get bone <name> from model <model>!e é ignorada.
Cinemática inversa (IK)
Os objetos nulos do Blockbench funcionam como controladores de IK. O FMM resolve as cadeias durante a execução com FABRIK (Forward And Backward Reaching Inverse Kinematics), limitado a 10 iterações e com tolerância 0.001.
O funcionamento é o seguinte:
- Um objeto nulo com
ik_source, o osso raiz, eik_target, o osso final ou localizador, define uma cadeia. A deteção consulta a hierarquia e também permite pesquisas entre irmãos e nos descendentes; alvos irmãos no nível raiz produzem uma cadeia apenas com o osso de origem. - Só os fotogramas-chave de posição do objeto nulo controlam a IK. Tornam-se um deslocamento por fotograma somado à posição de repouso do osso ou localizador alvo. O solucionador não usa a posição de repouso guardada do controlador como base do objetivo. A rotação e a escala não controlam a IK.
- A cada tick, cada cadeia segue a animação em reprodução de maior prioridade que a controla: a ação, depois a animação base e depois uma animação que esteja a desaparecer. O deslocamento do objetivo dessa animação é aplicado e a cadeia é resolvida. Uma cadeia que nenhuma animação em reprodução controle é limpa, pelo que uma pose IK não passa para uma animação que não a usa.
lock_ik_target_rotationé lido e guardado, mas o solucionador atual não o aplica.
As cadeias que não puderem ser resolvidas são ignoradas, com um aviso identificável na consola. Consulte Notas sobre criação de modelos para as mensagens exatas e os requisitos de criação.
Exportação Bedrock
Cada modelo convertido escreve também um ficheiro Bedrock em animations/<model_id>.animation.json, dentro do conjunto de recursos gerado:
- Os identificadores seguem
animation.fmm.<model_id>.a_<hex>, em que<hex>são os bytes UTF-8 do nome da animação escritos em hexadecimal. Assim, dois nomes que só diferem em carateres que o Bedrock não permite recebem identificadores distintos. animation_lengthé a duração em segundos, com um mínimo de0.05, permitindo animações válidas de um tick.- O modo de repetição segue a tabela Modos de repetição.
- Um modelo sem animações recebe uma entrada
idlesem efeito, para manter válida a definição da entidade Bedrock. - A geometria exclui
hitbox, os ossos de etiquetas de nome geradosfmm_nametag_bone_*e os pontos de montadam_; mantém as âncorastag_criadas pelo autor. O exportador de animações escreve as pistas pré-calculadas sem aplicar esse mesmo filtro de ossos visuais. Não anime ossos de montada excluídos esperando ver a sua geometria. - A exportação Bedrock usa fotogramas pré-calculados de rotação, posição e escala dos ossos. Não incorpora nessas pistas as rotações produzidas pelo solucionador IK durante a execução; verifique separadamente no Bedrock os modelos que dependam de IK.
- Um canal de osso com um fotograma-chave MoLang é, em vez disso, escrito tal como foi criado, expressões e números por igual, e os clientes Bedrock avaliam-no. Um programa de várias instruções é escrito com
returnantes da última linha, para que o Bedrock reproduza o mesmo valor que o Java. A partir da 2.14.2, recebe também o;final que o Bedrock exige. Os seus fotogramas-chave são interpolados linearmente no Bedrock, qualquer que seja a interpolação definida, e só os seus valores pré são escritos. Num modelo comformat_version5 ou mais recente, a rotação X e Y e a posição X seguem com o sinal invertido, um número como o seu negativo e um programa com o que devolve negado, para que o Bedrock reproduza a mesma pose que o Java. - Um modelo exportado pende de um osso
freeminecraftmodels_leancom o pivô no meio dos seus cubos. Mostra aos jogadores Bedrock a inclinação da orientação de deslocação e o centramento através de quatro propriedades inteiras da entidade,freeminecraftmodels:lean_x,lean_y,lean_zebody_offset. Um modelo com mais de 672 animações, contando as geradas que escondem um ossosaddleoufish, não tem espaço para essas propriedades, não recebe osso de inclinação e permanece na vertical, sobre os pés, no Bedrock. - É gerado um controlador por animação, selecionado por uma propriedade da entidade. É assim que o FMM reproduz uma animação específica num cliente Bedrock. O FMM seleciona em conjunto a animação base e a ação, em linha com as camadas de Java.
- Um modelo com um osso chamado
saddle, independentemente de maiúsculas e minúsculas, recebe mais uma animação,freeminecraftmodels_hide_saddle, depois das suas, e um com um osso chamadofishrecebefreeminecraftmodels_hide_fisha seguir. Cada uma encolhe o seu osso e os ossos que estão sob ele até desaparecerem, e só é reproduzida enquanto o servidor esconde o osso: a sela de uma mascote montável até ter sela, e o peixe de uma mascote pescadora até levar uma captura para casa. Isto exige o FreeMinecraftModels 2.15.0 ou mais recente. - Uma animação com Override ativado é escrita com
"override_previous_animation": true, e um peso de mistura diferente de1como"blend_weight". As animações baseidle,walk,spawnedeathvêm primeiro na lista de animações da entidade, para que as ações se sobreponham a elas. - O
blend_transitiondos controladores transporta os tempos de transição de Java:idleewalkentram e saem gradualmente ao longo deidleWalkBlendTicks,deathsurge gradualmente ao longo dedeathBlendTicks, e todas as outras animações mudam instantaneamente, incluindoidle.longe as animações de montada e de natação. Os tempos são escritos quando o pacote é gerado, por isso uma alteração à configuração só chega aos jogadores Bedrock depois de o pacote ser gerado de novo. - Os fotogramas-chave de partículas passam a constituir a linha temporal
particle_effectsda animação, pelo que os clientes Bedrock os reproduzem nativamente. Consulte Partículas.
Estes precisam do FreeMinecraftModels 2.16.0:
- Um modelo não tem osso de inclinação acima de 532 animações, em vez de 672, continuando a contar as animações de ocultação geradas.
- A rotação X e Y e a posição X com fotogramas-chave são reproduzidas da mesma forma no Bedrock e no Java. Da 2.8.0 à 2.15.0, as pistas pré-calculadas de todos os modelos, e os canais MoLang de um modelo com
format_version5 ou mais recente, seguiam com esses eixos espelhados. O movimento que oscila por igual em torno de zero parecia igual, mas uma pose mantida para um lado dobrava para o outro no Bedrock, como um cotovelo dobrado para trás. Os jogadores Bedrock veem a correção quando o pacote é regenerado e o cliente aceita o pacote novo.
Consulte Pacote de recursos gerado para saber onde os ficheiros ficam no disco.
Inércia de rotação
Com weightedTurning ativado (a predefinição), um modelo num mob roda em direção à orientação do mob com inércia, em vez de saltar para ela. A cada tick, a sua velocidade de rotação muda, no máximo, o valor da aceleração, até ao limite de velocidade, e abranda com antecedência suficiente para parar exatamente na nova orientação. O próprio mob roda e anda como antes. Os ossos, a hitbox, os localizadores e a apresentação Bedrock do modelo usam todos a orientação do modelo.
Ambos os limites dependem do tamanho do modelo:
- O tamanho é a raiz cúbica do volume do osso
hitbox(largura x profundidade x altura, em blocos), multiplicada pelo atributoscaledo mob. Um modelo sem ossohitboxusa, em vez disso, a raiz cúbica da caixa de colisão do próprio mob. Os tamanhos abaixo de0.25contam como0.25 - A velocidade máxima é
turnSpeedCapa dividir pela raiz quadrada do tamanho, e nunca mais de 90 graus por tick - A aceleração é
turnAccelerationa dividir pelo tamanho
Com os valores predefinidos turnSpeedCap: 30 e turnAcceleration: 6:
| Hitbox | Tamanho | Velocidade máxima (graus por tick) | Aceleração (graus por tick, a cada tick) |
|---|---|---|---|
| 0.5 x 0.5 x 0.5 | 0.5 | 42.4 | 12 |
| 1 x 1 x 1 | 1 | 30 | 6 |
| 2 x 2 x 2 | 2 | 21.2 | 3 |
| 4 x 4 x 4 | 4 | 15 | 1.5 |
Outras regras:
- Um modelo roda instantaneamente enquanto um jogador monta diretamente o seu mob ou se senta num dos seus assentos
m_, para que a vista do passageiro e o modelo se mantenham juntos. - Um modelo num cavalo com sela que um jogador conduz, como um criado com
/fmm mount, fica virado para onde o cavaleiro está virado, e a sua cabeça mantém-se nivelada em vez de seguir o olhar do cavaleiro para cima e para baixo. - Os ossos de cabeça
h_seguem a cabeça do mob e podem adiantar-se ao corpo, mais lento, até 75 graus. - Um modelo a morrer mantém a orientação que tinha. Um modelo com a sincronização de movimento desativada mantém a sua própria orientação.
- As entidades estáticas, os elementos decorativos e os disfarces de jogadores não usam inércia de rotação.
Orientação de deslocação
Um modelo dinâmico pode inclinar-se com a sua deslocação, além de ficar virado para a direção em que segue. Os caminhantes mantêm-se nivelados, mas as criaturas voadoras e aquáticas normalmente não o devem fazer. As mascotes definem isto na secção orientation do seu ficheiro de mascote. Os plugins chamam DynamicEntity#setTravelOrientation(TravelOrientation). Os modelos são UPRIGHT por predefinição.
| Estilo | Inclinação |
|---|---|
UPRIGHT | Nenhuma. O modelo só fica virado para onde vai |
TOP_FIRST | O topo vai à frente, como uma alforreca: inclina-se para a deslocação, deita-se de lado em cruzeiro e vira-se ao contrário para mergulhar |
FRONT_FIRST | A frente vai à frente, como uma ave ou um peixe: inclina o nariz nas subidas e nos mergulhos e inclina-se lateralmente nas curvas, até 45 graus de inclinação lateral |
| Definição | Predefinição | Significado |
|---|---|---|
startSpeed | 0.6 | Blocos por segundo abaixo dos quais o modelo permanece na vertical, para que a deriva e o balanço em repouso não o inclinem |
fullSpeed | 4.0 | Blocos por segundo a que se alinha totalmente com a deslocação. Entre os dois valores, inclina-se parcialmente |
maxTilt | 180 | A inclinação máxima, em graus, de 0 a 180 |
turnSpeed | 180 | Graus por segundo a que a inclinação pode mudar |
- A inclinação roda o modelo inteiro em torno do meio dos seus cubos, depois da orientação e das animações, pelo que todos os ossos, localizadores e pontos de montada a acompanham.
- A velocidade provém do movimento da entidade, suavizado ao longo de alguns ticks. Um movimento superior a 2,5 blocos num tick conta como teletransporte e não inclina o modelo.
- Um modelo pode inclinar-se de outra forma enquanto o seu mob nada, ou seja, está na água sem tocar no chão. As mascotes definem isto com
swimming.orientation(consulte Nadar) e os plugins comDynamicEntity#setSwimOrientation(TravelOrientation), em quenullinclina como em terra. Enquanto nada, a inclinação segue de imediato a velocidade do próprio mob, travada apenas porturnSpeed, em vez da velocidade suavizada, pelo que o nariz de quem nada aponta para cima enquanto sobe e para baixo enquanto desce. Isto exige o FreeMinecraftModels 2.15.0 ou mais recente. - O modelo regressa suavemente à vertical quando deixa de se mover, enquanto morre, enquanto um jogador o monta e enquanto a sua sincronização de movimento está desativada.
- Os jogadores Bedrock veem a inclinação através do osso de inclinação exportado (consulte Exportação Bedrock). Avança ao ritmo de ticks do servidor, sem suavização no cliente. Depois de o pacote ser gerado de novo pela primeira vez com o osso de inclinação, reinicie o servidor uma vez para que a ponte Bedrock registe as novas propriedades da entidade.
Centrar no corpo
ModeledEntity#setCenteredOnBody(true) desenha o modelo com o meio dos seus cubos no meio da sua entidade, em vez de o colocar sobre os pés da entidade. Uma criatura voadora ou aquática cujo modelo seja muito maior do que o seu corpo oculto move-se, roda e inclina-se então em torno desse corpo. A etiqueta de nome alternativa, a caixa de clique e a hitbox movem-se com o modelo. Os ossos hitbox e de etiqueta de nome não contam para o centro.
Está desativado por predefinição. As mascotes ativam-no nas espécies FLYING e AQUATIC, e a sua chave centerOnBody substitui essa escolha. Os jogadores Bedrock também veem o modelo centrado, através do mesmo osso de inclinação. A caixa de colisão da própria entidade Bedrock continua a começar nos pés.
Reproduzir animações a partir de outros sistemas
| Origem | Ponto de entrada |
|---|---|
| Plugin Java | ModeledEntity#playAnimation(String, boolean blend, boolean loop) / #stopCurrentAnimations() / #hasAnimation(String) |
| Script Lua de elemento decorativo | context.prop:play_animation(name, blend, loop) / context.prop:stop_animation() |
| Qualquer tabela Lua de entidade | entity.model:play_animation(name, blend, loop) / entity.model:stop_animations(); disponível quando entity.is_modeled é true |
Consulte o Guia da API e desenvolvimento e a API Lua de elementos decorativos para conhecer as operações relacionadas.
Os valores predefinidos de Lua diferem: context.prop:play_animation(name) usa blend=true, loop=true, enquanto entity.model:play_animation(name) usa false, false. Passe ambos os booleanos explicitamente quando a diferença for relevante.
Resolução de problemas
A animação nunca é reproduzida automaticamente.
A máquina de estados partilhada reconhece spawn, idle, idle.long, walk, swim, idle.swim, ride, idle.ride, attack e death em minúsculas, e trata todos os nomes attack. e damaged como ações. O movimento controla as transições idle/walk, nadar e um cavaleiro que conduz trazem as animações de natação e de montada, e idle.long espera por um período calmo de inatividade; os ataques e a morte continuam a precisar do seu acionamento durante a execução. Consulte Animações de estado. Os restantes nomes exigem uma chamada explícita a playAnimation / play_animation, exceto os nomes adicionais escolhidos pelo controlador de disfarces.
O modelo não faz nada.
Provavelmente não tem spawn nem idle, pelo que mostra a pose de repouso até andar ou até algo reproduzir uma animação. Adicione idle.
O meu ataque parece errado enquanto o modelo anda. Com o Override desativado, o ataque soma-se à pose de caminhada de todos os ossos que anima. Ative o Override nas propriedades do ataque no Blockbench para que esses ossos assumam a pose do ataque, ou anime menos ossos. Consulte Substituição e peso de mistura.
O meu modelo alterna entre idle e walk devagar ou bruscamente de mais.
Altere idleWalkBlendTicks. 0 muda instantaneamente.
O meu idle.long é reproduzido com demasiada frequência, demasiado raramente ou nunca.
Altere longIdleMinSeconds e longIdleMaxSeconds. A espera só conta enquanto o modelo mostra idle simples: mover-se, ataques, animações personalizadas e cavaleiros recomeçam-na. longIdleMaxSeconds: 0 desativa o idle.long.
A minha animação suave, step ou Bézier move-se de forma diferente depois de uma atualização. As versões do FreeMinecraftModels a partir da 2.15.0 reproduzem estes fotogramas-chave como o Blockbench os pré-visualiza; consulte Tipos de interpolação. Verifique a animação na pré-visualização do Blockbench: esse é o movimento que o FMM reproduz agora.
O meu modelo grande roda devagar de mais.
A velocidade de rotação diminui com o tamanho; consulte Inércia de rotação. Aumente turnSpeedCap e turnAcceleration, verifique se o osso hitbox não é maior do que o pretendido, ou defina weightedTurning: false.
A consola mostra ... FreeMinecraftModels does not support these ... ou ... has the blend weight ....
O FMM reproduz essa animação sem o Start Delay, o Loop Delay e o Anim Time Update do Blockbench, e lê o Blend Weight apenas como um número simples. Limpe esses campos ou substitua a expressão Molang por um número.
A animação é reproduzida, mas nada se move. Verifique a duração. Uma animação de duração zero é tratada como pose estática e ignorada sem aviso.
No Bedrock, todas as animações de um modelo param, incluindo a de repouso, enquanto o Java as reproduz.
O Bedrock rejeita um programa MoLang com ; ou uma atribuição, a menos que termine em ;, e um único fotograma-chave rejeitado para todas as animações da entidade. O FreeMinecraftModels 2.13.0 a 2.14.1 escreve esses programas sem o ; final, e a 2.14.2 acrescenta-o. Atualize ou, nessas versões, termine você mesmo o programa do fotograma-chave com ; no Blockbench. O Java reproduz-o da mesma forma.
Um fotograma-chave MoLang fica parado em 0.
Verifique na consola se há Failed to parse the keyframe expression. Um programa cuja última linha seja uma atribuição vale 0; termine-o com o valor pretendido, ou com return. As consultas diferentes das quatro indicadas em Fotogramas-chave MoLang são lidas como 0.
As rotações estão espelhadas.
Verifique meta.format_version no .bbmodel. O FMM inverte o sinal das rotações X/Y para a versão de formato 5 e posteriores. Um ficheiro que declare uma versão, mas contenha dados da outra convenção, fica espelhado.
A consola apresenta Malformed animation timeline for model ....
Uma pista dessa animação não pôde ser lida ou interpolada. O aviso surge uma vez por animação e identifica o osso ou controlador IK. As restantes animações continuam a ser convertidas.
Os sons da linha temporal do Blockbench não funcionam. Os fotogramas-chave de som não são importados. Produza os sons através de um script Lua ou do seu próprio plugin. Os fotogramas-chave de partículas são importados; se não aparecerem, consulte Partículas.