Zum Hauptinhalt springen

FreeMinecraftModels Animationen

FreeMinecraftModels importiert Animationsdaten aus .bbmodel- und .fmmodel-Dateien. Diese Seite beschreibt reservierte Namen, das Überblenden von Animationen, Frame-Zeiten, Interpolation, Loop-Modi, inverse Kinematik (IK) und das Drehen von Modellen.

Für Bone-Namensregeln und den Rest des Import-Vertrags siehe Hinweise zur Modellerstellung.

Zustandsanimationen​

FreeMinecraftModels bindet diese sechs kleingeschriebenen Animationsnamen und die vier Schwimm- und Reit-Namen weiter unten an automatische Laufzeitzustände. Alles andere im Modell ist eine benutzerdefinierte Animation.

AnimationsnameLooptWann sie abgespielt wird
spawnneinEinmal, wenn das Modell erzeugt wird. Am Ende wechselt das Modell zu walk, wenn sich seine Entity bewegt, sonst zu idle
idlejaSolange die Entity keine horizontale Geschwindigkeit hat. Wird zu walk übergeblendet, sobald die X- oder Z-Geschwindigkeit ungleich null wird
idle.longneinEinmal, nachdem das Modell eine zufällige Zeit von longIdleMinSeconds bis longIdleMaxSeconds (standardmäßig 15 bis 30 Sekunden) lang idle gezeigt hat, ohne dass etwas anderes lief. Danach wird das Modell zu idle zurückgeblendet, und das Warten beginnt von vorn
walkjaSolange die X- oder Z-Geschwindigkeit der Entity ungleich null ist. Wird zu idle übergeblendet, wenn beide null sind
attackneinWenn ausgelöst. Wird einmal über idle oder walk abgespielt und endet dann
deathneinBei removeWithDeathAnimation(). Blendet aus der aktuellen Pose ein. Am Ende schrumpft das Modell über 20 Ticks und wird entfernt

FMM löst attack selbst nur bei Magiern (Evokern) aus, wenn vom Magier beschworene Fangzähne innerhalb von zwei Blöcken um ihn erscheinen. Andere Plugins lösen Angriffe über die API aus. EliteMobs spielt attack.melee und attack.ranged ab. Jeder Name, der mit attack. beginnt, ist ein Angriff und wird wie attack abgespielt.

idle.long wird einmal abgespielt, unabhängig von seiner Blockbench-Loop-Einstellung. Bewegung, ein Angriff oder eine andere Aktion, eine benutzerdefinierte Animation auf der Basisebene und ein Spieler, der den Mob als Reittier steuert, starten das Warten neu, und dieselben Dinge brechen ein laufendes idle.long ab. Ein Modell ohne idle.long wartet nie. idle.long benötigt FreeMinecraftModels 2.15.0 oder neuer; frühere Versionen behandeln es als benutzerdefinierte Animation.

Vier weitere Basisanimationen laufen anstelle von walk und idle, solange der Mob schwimmt oder ein Spieler ihn reitet, sofern das Modell sie hat:

  • Reiten. Ein Modell auf einem gesattelten Pferd, das ein Spieler steuert, etwa ein gerittenes Haustier oder ein Reittier von /fmm mount, spielt ride anstelle von walk ab, solange es sich bewegt, und idle.ride anstelle von idle, solange es steht. Eine Haustierdatei kann mit riding.animation und riding.idleAnimation andere Animationen benennen; siehe Reiten. Plugins rufen getAnimationComponent().setRiddenAnimation(name) und setRiddenIdleAnimation(name) auf, wobei null die jeweilige Animation abschaltet. Ein Modell ohne ride läuft unter seinem Reiter mit walk, und eines ohne idle.ride zeigt idle.
  • Schwimmen. Ein Modell, dessen Mob schwimmt, also im Wasser und nicht auf dem Boden ist, spielt swim anstelle von walk ab, solange es sich bewegt, und idle.swim anstelle von idle, solange es stillhält. Eine Haustierdatei kann mit swimming.animation und swimming.idleAnimation andere Animationen benennen; siehe Schwimmen. Plugins rufen getAnimationComponent().setSwimAnimation(name) und setIdleSwimAnimation(name) auf, wobei null die jeweilige Animation abschaltet. Ein Modell ohne swim läuft im Wasser mit walk, und eines ohne idle.swim zeigt idle, solange es stillhält. Ein Reittier, das ein Spieler steuert, spielt auch im Wasser seine Reit-Animationen ab.

Alle vier benötigen FreeMinecraftModels 2.15.0 oder neuer.

Benennung​

Animationsnamen sind kleingeschrieben. Ein Punkt trennt einen allgemeinen Namen von einem spezielleren, und ein Unterstrich verbindet Wörter innerhalb eines Teils: idle.long ist eine Art von idle und attack.melee eine Art von attack. Jede Animation für den Stillstand heißt idle., gefolgt vom Namen der Bewegung, die sie pausiert:

In BewegungIm Stillstand
An Landwalkidle und ab und zu idle.long
Im Wasserswimidle.swim
Gerittenrideidle.ride

Fehlt einem Modell ein Name mit Punkt, spielt FMM stattdessen den Namen bis zu seinem letzten Punkt ab: attack für attack.melee, idle für idle.swim. Dasselbe gilt für Namen, die Skripte und Plugins abspielen: playAnimation und hasAnimation folgen beide dieser Regel.

Ältere Modelle verwendeten long_idle, attack_melee und attack_ranged. FMM findet sie unter den neuen Namen und die neuen Namen unter den alten, sodass ältere Modelle und ältere Plugins ohne Änderungen weiter funktionieren.

Die Namen mit Punkt, der Rückgriff auf den allgemeinen Teil und die älteren Schreibweisen benötigen FreeMinecraftModels 2.15.0 oder neuer.

Regeln, die sich aus dem Aufbau der Zustandsmaschine ergeben:

  • Der Startzustand ist spawn, sofern das Modell eine solche Animation besitzt, sonst idle. Ein Modell mit keiner von beiden zeigt seine Ruhepose, bis es zu laufen beginnt oder etwas eine Animation abspielt.
  • Nur Animationen, die im Modell vorhanden sind, werden verwendet. Ein Modell mit walk, aber ohne idle, läuft weiter, nachdem es sich nicht mehr bewegt.
  • Der Wechsel zwischen Idle und Walk liest die horizontale Geschwindigkeit der zugrunde liegenden Entity; reine Vertikalbewegung startet keine Laufanimation. Statische Entities und Spieler-Verkleidungen haben für diesen Zweck keine zugrunde liegende Entity; stationäre Props bewegen sich nicht horizontal. Ihre zusätzlichen Animationen werden durch Skripte, die API oder FMMs Verkleidungs-Controller gesteuert.
Kein jump-Zustand

Regulär modellierte Entities haben keinen Jump-Zustand. Eine Animation namens jump verhält sich wie jede andere benutzerdefinierte Animation und muss namentlich abgespielt werden. Spieler-Verkleidungen sind die Ausnahme: Ihr separater Controller spielt jump ab, wenn der Spieler springt.

Animationen überblenden​

FMM spielt die Animationen eines Modells auf zwei Ebenen ab und mischt sie in jedem Tick zu einer einzigen Pose, auf Java wie auf Bedrock.

EbeneWas darauf abgespielt wird
Basisspawn, idle, idle.long, walk, die Reit- und Schwimm-Animationen und death oder eine benutzerdefinierte Animation, die mit blend auf false abgespielt wird und die gesamte Pose übernimmt
Aktionattack und jeder attack.-Name, etwa attack.melee und attack.ranged, damaged und benutzerdefinierte Animationen, die mit blend auf true abgespielt werden. Eine Aktion läuft über der Basisebene, sodass ein Modell angreifen kann, während es läuft

Ein Bone, den die Basisanimation nicht mit Keyframes belegt, kehrt in seine Ruhepose zurück. Ein Bone, den die Aktion nicht mit Keyframes belegt, behält seine Basispose.

Überblendungen​

WechselÜberblendung
Zwischen idle, idle.long, walk und den Reit- und Schwimm-AnimationenÜberblendung über idleWalkBlendTicks, standardmäßig 5 Ticks. Beide Animationen laufen während der Überblendung weiter
Beliebig zu deathÜberblendung aus der Pose, die das Modell im vorherigen Tick zeigte, Aktion eingeschlossen, über deathBlendTicks, standardmäßig 4 Ticks
Jeder andere WechselSofort

Überblendungen beginnen und enden weich, statt sich mit konstanter Rate zu bewegen. Unterbricht ein neuer Wechsel zwischen idle und walk eine Überblendung, beginnt die nächste bei der Pose, die das Modell gerade zeigte. Aktionen beginnen und enden ohne Überblendung.

Override und Blend Weight​

FMM liest zwei Einstellungen aus den Eigenschaften jeder Animation in Blockbench.

Blockbench-EinstellungWirkung in FMM
Override anAuf der Aktionsebene übernehmen die Bones, die die Animation mit Keyframes belegt, deren Pose und verwerfen die Basispose
Override aus (Standard)Auf der Aktionsebene werden Rotation und Position der Animation zur Basispose der von ihr belegten Bones addiert, und ihre Skalierung multipliziert die Basisskalierung
Blend WeightSkaliert, wie stark die Animation wirkt, auf beiden Ebenen. 1 (Standard) wendet die Keyframes wie erstellt an. 0.5 wendet die Hälfte jeder Rotation und Position an und bewegt die Skalierung auf halbem Weg von 1 zum Keyframe-Wert

Schalte Override an, wenn die Bones, die ein Angriff belegt, unabhängig vom Laufzyklus exakt die erstellte Pose erreichen müssen. Lass es aus, um die Bewegung des Angriffs zum Laufen hinzuzufügen, zum Beispiel einen Armschwung, während die Beine weiterlaufen. Auf Java hat Override keine Wirkung auf Animationen der Basisebene, die die Pose immer ersetzen.

FMM liest Blend Weight nur als einfache Zahl. Ein Molang-Ausdruck protokolliert Model <model>, animation <animation> has the blend weight '<value>'. FreeMinecraftModels only reads plain numbers and uses 1. FMM unterstützt Blockbenchs Start Delay, Loop Delay und Anim Time Update nicht. Eine Animation, die eines davon setzt, protokolliert eine Warnung und läuft ohne sie.

Welche Animation gewinnt​

  • Benutzerdefinierte Animationen, damaged eingeschlossen, haben Vorrang vor eingebauten. Solange eine auf einer der beiden Ebenen läuft, werden Angriffsanfragen verworfen. death unterbricht alles.
  • Eine neue Aktion ersetzt die laufende Aktion: Ein zweiter Angriff startet den Angriff neu, und eine benutzerdefinierte Animation, die mit blend auf true abgespielt wird, ersetzt einen laufenden Angriff.
  • Eine benutzerdefinierte Animation, die mit blend auf false abgespielt wird, beendet die aktuelle Aktion.
  • Hält eine benutzerdefinierte Animation die Basisebene, verfolgt FMM darunter weiter idle und walk. Übernimmt eine Animation die Basisebene, endet ein laufendes spawn oder idle.long. Endet eine einmalige benutzerdefinierte Animation, springt das Modell zu idle oder walk, je nachdem, was zu seiner Bewegung passt. Eine ausdrückliche Anfrage für idle oder walk beendet eine loopende benutzerdefinierte Animation sofort und wird nach dem Ende einer einmaligen angezeigt.
  • Eine einmalige Aktion endet nach ihrem letzten Frame. Hat die Basisebene nichts zu zeigen, etwa bei einem Prop ohne Animation spawn oder idle, hält die Aktion stattdessen ihren letzten Frame, sodass eine so geöffnete Tür offen bleibt. Eine einmalige benutzerdefinierte Animation auf der Basisebene hält ebenfalls ihren letzten Frame, wenn das Modell weder idle noch walk hat, zu dem es zurückkehren könnte.

Spieler-Verkleidungen verwenden einen anderen Satz​

Eine Spieler-Verkleidung ergänzt einen Controller pro Tick, der Animationen über dieselbe Wiedergabe-Engine anfordert. Seine fünf reservierten Namen sind attack, jump, sneak, walk und idle. Er prüft sie in dieser Reihenfolge, solange der Countdown einer einmaligen Animation nicht aktiv ist. attack läuft auf der Aktionsebene, jump und sneak übernehmen die Basisebene, und idle und walk wählen die eingebauten Zustände. Fehlt idle, warnt er in der Konsole. Die vollständige Tabelle und die zeitliche Einschränkung dieser Animationen stehen unter Spieler-Verkleidungen.

Benutzerdefinierte Animationen​

Jede Animation, deren Name keiner der obigen Zustandsnamen ist, kann trotzdem namentlich abgespielt werden:

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()
  • blend wählt die Ebene für eine benutzerdefinierte Animation. true spielt sie auf der Aktionsebene ab, über idle oder walk, mit ihrem Blockbench-Override und Blend Weight. false gibt ihr die Basisebene, sodass sie die gesamte Pose ersetzt und die aktuelle Aktion beendet. Siehe Animationen überblenden.
  • Anfragen werden eingereiht und der Reihe nach zu Beginn des nächsten Ticks des Modells angewendet. Jede Anfrage wird ausgeführt; eine spätere hebt eine frühere in der Warteschlange nicht auf.
  • loop gilt für benutzerdefinierte Animationen und damaged. Eingebaute Namen ignorieren sowohl blend als auch loop: idle und walk loopen immer, spawn, death und die Angriffe laufen einmal. idle.long, namentlich abgespielt, ist eine benutzerdefinierte Animation wie jede andere.
  • Eingebaute Namen und Angriffsnamen werden unabhängig von der Groß- und Kleinschreibung erkannt. Bei anderen Namen sucht FMM zuerst den exakten Namen, dann seine kleingeschriebene Form, dann die ältere Schreibweise eines umbenannten Namens, dann den allgemeinen Teil eines Namens mit Punkt (siehe Benennung). hasAnimation findet dieselben Namen, die playAnimation abspielt. Das Modell muss den kleingeschriebenen Namen enthalten, damit ein eingebauter Zustand funktioniert.
  • damaged läuft immer auf der Aktionsebene, unabhängig von blend.
  • playAnimation gibt false zurück für einen Namen, den das Modell nicht hat, und für jede Anfrage, nachdem death angefordert wurde. true bedeutet, dass die Anfrage eingereiht wurde, nicht dass ein Frame abgespielt wurde: Ein Angriff kann von einer laufenden benutzerdefinierten Animation trotzdem noch verworfen werden.
  • stopCurrentAnimations() beendet jede benutzerdefinierte Animation und Aktion und springt zu idle, oder in die Ruhepose, wenn das Modell kein idle hat.
  • Der Tod ist endgültig: Sobald death angefordert wurde, geben neue Wiedergabeanfragen false zurück, eingereihte Anfragen werden ignoriert und stopCurrentAnimations() tut nichts.

Timing und Dauer​

  • Blockbench speichert die Animationslänge in Sekunden. FMM rechnet sie mit ceil(seconds x 20) um, die Dauer ist also immer eine ganze Anzahl Ticks und kurze Animationen werden auf- statt abgerundet.
  • Ein Kanal, der nur mit Zahlen mit Keyframes belegt ist, wird beim Import in ein flaches Frame-Array pro Tick gebacken, und die Wiedergabe liest einen Frame pro Tick. Ein Kanal mit einem MoLang-Keyframe wird stattdessen pro Tick für jede Entity abgetastet; siehe MoLang-Keyframes.
  • Jede laufende Animation führt ihren eigenen Tick-Zähler, sodass die Basisebene, die Aktionsebene und eine auslaufende Animation unabhängig voneinander voranschreiten. Loopende Animationen indexieren mit counter % duration; nicht loopende werden auf ihren letzten Frame begrenzt.
  • Keyframe-Zeiten behalten ihre gebrochene Tick-Position (20 x time, nicht gerundet). Ein Keyframe bei 0,37 s trägt damit zur Interpolation zwischen Ticks bei. Frames werden bei ganzen Ticks von 0 bis duration - 1 abgetastet. Ein Keyframe genau am deklarierten Ende beeinflusst die Interpolation, wird aber nicht selbst abgetastet. Platziere eine Endpose vor dieser Grenze, wenn ein dargestellter Frame sie erreichen muss.
  • Wenn zwei Keyframes desselben Kanals auf exakt derselben Zeit landen, gewinnt der in der Dateireihenfolge spätere.
  • Ein Keyframe mit einer nicht endlichen Zeit bricht diesen Track ab und erzeugt eine einzelne Warnung Malformed animation timeline for model ... pro Animation, während die übrigen Animationen des Modells weiter konvertiert werden.

Animationen der Länge null sind gültig​

Eine Animation mit der Länge 0 (oder negativ) wird als absichtliche statische Pose behandelt — eine gängige Wahl bei Möbeln und anderen Props, die einen benannten Eintrag „keine Animation“ brauchen. Sie wird stillschweigend und ohne Warnung übersprungen und trägt keine Frames bei.

Loop-Modi​

Blockbenchs Loop-Einstellung steuert die exportierte Bedrock-Animation:

Blockbench-Loop-ModusBedrock-Export
loop"loop": true
once"loop": false
hold"loop": "hold_on_last_frame"

Die Java-Wiedergabe verwendet die Wiederholungsregel des eingebauten Zustands beziehungsweise das loop-Argument einer benutzerdefinierten Animation. Sie übernimmt die Wiederholungsregel nicht aus diesem Blockbench-Feld. Daher können sich Java- und Bedrock-Wiedergabe unterscheiden, wenn diese Einstellungen voneinander abweichen.

Interpolationstypen​

Jeder Keyframe trägt einen von vier Interpolationstypen: linear, catmullrom (in Blockbench Smooth), bezier und step. Alles außerhalb dieses Satzes kann nicht geparst werden und wird als fehlerhafte Timeline gemeldet.

FMM spielt das Segment zwischen zwei Keyframes so ab, wie Blockbench es in der Vorschau zeigt, anhand der Typen beider Keyframes, in dieser Reihenfolge geprüft:

  1. Ein step-Keyframe hält seinen Wert bis zum nächsten Keyframe.
  2. Ein linear-Keyframe, auf den ein linear- oder step-Keyframe folgt, wird geradlinig überblendet.
  3. Ist einer der beiden Keyframes catmullrom, folgt das Segment einer Catmull-Rom-Kurve durch den Keyframe vor dem Segment, die beiden Keyframes des Segments und den Keyframe danach, sodass die Bewegung durch jeden Keyframe fließt, statt an ihm anzuhalten. Ein fehlender Nachbar wiederholt das eigene Ende des Segments. In einer Animation, deren Blockbench-Loop-Modus loop ist, mit mindestens drei Keyframes auf dem Kanal, läuft die Kurve über den Loop hinweg weiter und behandelt den letzten Keyframe wieder als den ersten.
  4. Andernfalls ist einer von ihnen bezier, und das Segment folgt dem rechten Anfasser des abgehenden und dem linken Anfasser des ankommenden Keyframes, in Zeit und Wert. Ein Keyframe, der ohne Anfasser gespeichert wurde, hat sie 0,1 Sekunden zu beiden Seiten ohne Wertversatz. Die Zeit eines Anfassers bleibt innerhalb des Segments.

Vor seinem ersten Keyframe hält ein Kanal den Wert dieses Keyframes, und nach seinem letzten Keyframe hält er den des letzten.

Ein Keyframe mit getrennten Vorher- und Nachher-Werten wird mit seinem Vorher-Wert erreicht und mit seinem Nachher-Wert verlassen. Bei einem geglätteten Segment beendet ein solcher Keyframe außerdem die Kurve auf seiner Seite. Ein Nachher-Wert, den FMM nicht lesen kann, wird ignoriert.

Diese Regeln gelten für gebackene Kanäle, für MoLang-Kanäle auf Java und für die gebackenen Spuren des Bedrock-Exports. Sie benötigen FreeMinecraftModels 2.15.0 oder neuer. FreeMinecraftModels 2.3.0 bis 2.14.2 überblendete jedes Segment allein nach dem Typ des ankommenden Keyframes: catmullrom kam an jedem Keyframe sanft zum Stillstand, bezier verwendete unabhängig von seinen Anfassern feste Kontrollpunkte 0.42 und 0.58 und spielte fast geradlinig, und ein step-Keyframe sprang zur Hälfte des Segments, das in ihn hineinführte, auf seinen Wert. Getrennte Vorher- und Nachher-Werte fielen auf den Vorher-Wert zusammen. Modelle mit Smooth-, Step- oder Bezier-Keyframes bewegen sich nach dem Update daher anders, näher an dem, was ihr Autor in Blockbench sah.

Animierte Kanäle​

Pro Bone werden drei Kanäle gebacken: Rotation, Position und Skalierung. Wichtige Hinweise für die Erstellung:

  • Positionswerte werden durch 16 geteilt (Blockbench-Pixel zu Blöcken).
  • Rotationswerte werden in Radiant umgerechnet.
  • Blockbench format_version 5 und neuer dreht das Vorzeichen der X- und Y-Rotation sowie der X-Position um. FMM gleicht das anhand der deklarierten Formatversion automatisch aus, korrigiere also nicht von Hand — mische aber auch keine v5-Deklaration mit v4-förmigen Daten.
  • Ein Bone ohne Keyframes auf einem Kanal behält für diesen Kanal seinen Ruhewert. Ein Bone, den die Animation der Basisebene gar nicht mit Keyframes belegt, wird auf Rotation 0,0,0, Translation 0,0,0 und Skalierung 1,1,1 zurückgesetzt; ein Bone, den die Aktion nicht belegt, behält die Basispose.
  • Keyframe-Datenpunkte dürfen in der .bbmodel als Zeichenketten geschrieben sein. Eine Zeichenkette, die eine Zahl ist, wird als diese Zahl gelesen, und eine leere Zeichenkette wird zu 1 bei der Skalierung und sonst zu 0. Jede andere Zeichenkette ist ein MoLang-Ausdruck; siehe MoLang-Keyframes.
  • Ein Keyframe mit zwei Datenpunkten, also Blockbenchs getrennten Vorher- und Nachher-Werten, wird mit dem ersten erreicht und mit dem zweiten verlassen. Siehe Interpolationstypen.

MoLang-Keyframes​

Ein Keyframe-Wert, der als MoLang-Ausdruck geschrieben ist, etwa math.sin(query.anim_time * 360) * 10, wird für jede Entity ausgewertet, während die Animation läuft.

  • Ein Kanal mit mindestens einem MoLang-Keyframe wird nicht gebacken; ein Kanal ist dabei die Rotation, Position oder Skalierung eines Bones oder die Position eines IK-Controllers. Jede Entity tastet ihn in jedem Tick ab, mit derselben Interpolation und derselben Einheitenumrechnung wie bei gebackenen Kanälen. Zahlen-Keyframes auf diesem Kanal behalten ihre Werte.
  • Diese Queries sind verfügbar, auch mit dem kurzen Präfix q.:
QueryWert
query.anim_timeSekunden seit Beginn dieser Animation. Eine loopende Animation beginnt in jedem Durchlauf wieder bei 0
query.life_timeSekunden seit der Erstellung des Modells
query.modified_distance_movedBlöcke, die sich die Entity horizontal bewegt hat
query.is_moving1, solange sich die Entity horizontal bewegt, sonst 0
  • Andere Queries und unbekannte Variablen werden als 0 gelesen. Eine v.-Variable behält ihren Wert auf dieser Entity zwischen den Auswertungen, und ein temp.-Wert (t.) gilt nur für einen Ausdruck.
  • Ausdrücke verwenden dieselben Operatoren und Mathematikfunktionen wie Partikel-MoLang.
  • Ein Programm aus mehreren Anweisungen ohne return hat den Wert seiner letzten Zeile, so wie Blockbench es in der Vorschau zeigt. v.a = 10; v.b = v.a * 3; v.b + 5 ergibt 35. Eine letzte Zeile, die eine Zuweisung ist, ergibt 0. Partikel-MoLang behält die Regel von Bedrock, nach der ein Programm ohne return 0 ergibt.
  • Ein Ausdruck, den FMM nicht parsen kann, protokolliert einmal beim Laden Failed to parse the keyframe expression '<expression>' in animation <animation> for model <model>: <reason>. That value plays as 0.
  • Ein Ergebnis, das keine endliche Zahl ist, ergibt 0.
  • Ein geglättetes Segment wertet außerdem die Keyframes zu beiden Seiten aus, um seine Kurve zu formen. Diese Auswertungen behalten keine der Variablen, die sie zuweisen, sodass die Zuweisungen eines Keyframes nur in den Ticks der Segmente wirken, die er beginnt oder beendet.

Bedrock-Spieler werten diese Kanäle auf ihrem eigenen Client aus: Der Bedrock-Export schreibt die Keyframes des Kanals wie erstellt, siehe Bedrock-Export.

Was nicht animiert wird​

  • Der hitbox-Bone. Animationsspuren, die auf ihn zielen, werden vollständig übersprungen.
  • Sound- und Timeline-Instruction-Keyframes in Blockbench-Effektspuren. FMM importiert aus einer Effektspur nur die Partikel-Keyframes; siehe Partikel. Spiele Sounds stattdessen über ein Lua-Skript oder dein eigenes Plugin ab.
  • Bones, die nicht per Name aufgelöst werden konnten. Eine Spur, die auf einen fehlenden Bone zeigt, protokolliert Failed to get bone <name> from model <model>! und wird übersprungen.

Inverse Kinematik (IK)​

Blockbench-Null-Objekte fungieren als IK-Controller. FMM löst Ketten zur Laufzeit mit FABRIK (Forward And Backward Reaching Inverse Kinematics) auf, begrenzt auf 10 Iterationen mit einer Toleranz von 0.001.

Wie das zusammenspielt:

  1. Ein Null-Objekt mit ik_source (Wurzel-Bone) und ik_target (End-Bone oder Locator) definiert eine Kette. Die Erkennung prüft die Hierarchie und unterstützt auch Suchen unter Geschwistern und nach unten; Geschwisterziele auf der Wurzelebene ergeben eine Kette nur mit dem Quell-Bone.
  2. Nur die Positions-Keyframes des Null-Objekts steuern IK. Sie ergeben pro Frame einen Versatz, der zur Ruheposition des Ziel-Bones oder Locators addiert wird. Der Solver verwendet die gespeicherte Ruheposition des Controllers nicht als Zielbasis. Rotation und Skalierung steuern IK nicht.
  3. In jedem Tick folgt jede Kette der obersten laufenden Animation, die sie steuert: zuerst der Aktion, dann der Basisanimation, dann einer auslaufenden Animation. Deren Zielversatz wird angewendet und die Kette gelöst. Eine Kette, die keine laufende Animation steuert, wird zurückgesetzt, sodass eine IK-Pose nicht in eine Animation übernommen wird, die sie nicht verwendet.
  4. lock_ik_target_rotation wird gelesen und gespeichert, vom aktuellen Solver aber nicht angewendet.

Ketten, die nicht aufgelöst werden können, werden mit einer benannten Konsolenwarnung übersprungen — siehe Hinweise zur Modellerstellung für die genauen Meldungen und die Erstellungsbeschränkungen.

Bedrock-Export​

Jedes konvertierte Modell schreibt zusätzlich eine Bedrock-Animationsdatei unter animations/<model_id>.animation.json im erzeugten Bundle:

  • Animationsbezeichner lauten animation.fmm.<model_id>.a_<hex>, wobei <hex> die UTF-8-Bytes des Animationsnamens in hexadezimaler Schreibweise sind. Zwei Namen, die sich nur in Zeichen unterscheiden, die Bedrock nicht erlaubt, erhalten dadurch getrennte Bezeichner.
  • animation_length ist die Dauer in Sekunden, nach unten auf 0.05 begrenzt, damit eine Ein-Tick-Animation weiterhin gültig ist.
  • Der Loop-Modus wird wie in der Tabelle Loop-Modi gezeigt abgebildet.
  • Ein Modell ohne Animationen erhält trotzdem einen einzelnen No-Op-idle-Eintrag, damit die Bedrock-Entitätsdefinition gültig bleibt.
  • Die Geometrie schließt hitbox, generierte Namensschild-Bones fmm_nametag_bone_* und Mountpoints m_ aus; selbst erstellte tag_-Anker bleiben enthalten. Der Animationsexport schreibt vorberechnete Bone-Spuren ohne denselben Filter für sichtbare Bones. Animiere daher keine ausgeschlossenen Mount-Bones in der Erwartung sichtbarer Geometrie.
  • Der Bedrock-Animationsexport verwendet vorberechnete Frames für Rotation, Position und Skalierung. Er übernimmt nicht die zur Laufzeit berechneten IK-Rotationen in diese Spuren; prüfe IK-abhängige Modelle gesondert auf Bedrock.
  • Ein Bone-Kanal mit einem MoLang-Keyframe wird stattdessen wie erstellt geschrieben, Ausdrücke und Zahlen gleichermaßen, und Bedrock-Clients werten ihn aus. Ein Programm aus mehreren Anweisungen wird mit return vor seiner letzten Zeile geschrieben, sodass Bedrock denselben Wert abspielt wie Java. Ab 2.14.2 erhält es außerdem das abschließende ;, das Bedrock verlangt. Seine Keyframes werden auf Bedrock linear überblendet, unabhängig von der erstellten Interpolation, und nur ihre Vorher-Werte werden geschrieben. Bei einem Modell mit format_version 5 oder neuer werden X- und Y-Rotation sowie X-Position negiert ausgegeben, eine Zahl als ihr Negativ und ein Programm mit negiertem Rückgabewert, sodass Bedrock dieselbe Pose abspielt wie Java.
  • Ein exportiertes Modell hängt an einem Bone freeminecraftmodels_lean, dessen Pivot in der Mitte seiner Würfel liegt. Er zeigt Bedrock-Spielern die Neigung der Bewegungsausrichtung und die Zentrierung über vier ganzzahlige Entity-Eigenschaften: freeminecraftmodels:lean_x, lean_y, lean_z und body_offset. Ein Modell mit mehr als 672 Animationen, einschließlich der erzeugten Animationen, die einen Bone saddle oder fish ausblenden, hat für diese Eigenschaften keinen Platz, erhält keinen Lean-Bone und bleibt auf Bedrock aufrecht auf seinen Füßen stehen.
  • Pro Animation wird ein Animations-Controller erzeugt, umgeschaltet über eine Entitätseigenschaft — so spielt FMM eine bestimmte Animation auf einem Bedrock-Client ab. FMM schaltet dabei Basisanimation und Aktion gemeinsam um, passend zu den Java-Ebenen.
  • Ein Modell mit einem Bone namens saddle, in beliebiger Groß- und Kleinschreibung, erhält nach seinen eigenen eine weitere Animation, freeminecraftmodels_hide_saddle, und eines mit einem Bone namens fish danach freeminecraftmodels_hide_fish. Jede schrumpft ihren Bone und die Bones darunter auf nichts und spielt nur, solange der Server den Bone ausblendet: den Sattel eines reitbaren Haustiers, bis es gesattelt wird, und den Fisch eines Angel-Haustiers, bis es einen Fang nach Hause trägt. Dies benötigt FreeMinecraftModels 2.15.0 oder neuer.
  • Eine Animation mit Override an wird mit "override_previous_animation": true geschrieben, ein Blend Weight ungleich 1 als "blend_weight". Die Basisanimationen idle, walk, spawn und death stehen in der Animate-Liste der Entity an erster Stelle, sodass Aktionen darüber geschichtet werden.
  • Das blend_transition der Controller übernimmt die Java-Überblendzeiten: idle und walk blenden über idleWalkBlendTicks ein und aus, death blendet über deathBlendTicks ein, und jede andere Animation wechselt sofort, idle.long und die Reit- und Schwimm-Animationen eingeschlossen. Die Zeiten werden beim Erzeugen des Ressourcenpakets geschrieben, eine Konfigurationsänderung erreicht Bedrock-Spieler daher erst, nachdem das Ressourcenpaket neu erzeugt wurde.
  • Partikel-Keyframes werden zur particle_effects-Timeline der Animation, sodass Bedrock-Clients sie nativ abspielen. Siehe Partikel.
Verfügbarkeit nach Version

Diese benötigen FreeMinecraftModels 2.16.0:

  • Ein Modell hat schon bei mehr als 532 statt 672 Animationen keinen Lean-Bone, wobei die erzeugten Ausblend-Animationen weiterhin mitgezählt werden.
  • Keyframes für X- und Y-Rotation sowie X-Position werden auf Bedrock genauso abgespielt wie auf Java. Von 2.8.0 bis 2.15.0 wurden die vorberechneten Tracks jedes Modells und die MoLang-Kanäle eines Modells mit format_version 5 oder neuer mit gespiegelten Achsen ausgegeben. Bewegungen, die gleichmäßig um null schwingen, sahen gleich aus, aber eine zu einer Seite gehaltene Pose knickte auf Bedrock in die andere Richtung, etwa ein nach hinten gebeugter Ellbogen. Bedrock-Spieler sehen die Korrektur, sobald das Paket neu erzeugt wurde und ihr Client das neue Paket übernimmt.

Siehe Ressourcenpaket-Ausgabe dafür, wo das Bundle auf der Festplatte landet.

Drehträgheit​

Ist weightedTurning an (Standard), dreht sich ein Modell auf einem Mob mit Trägheit in die Blickrichtung des Mobs, statt auf sie zu springen. In jedem Tick ändert sich seine Drehgeschwindigkeit höchstens um die Beschleunigung, bis zur Geschwindigkeitsobergrenze, und es bremst früh genug ab, um genau auf der neuen Blickrichtung anzuhalten. Der Mob selbst dreht sich und läuft wie zuvor. Die Bones, die Hitbox, die Locators und die Bedrock-Darstellung des Modells verwenden alle die Blickrichtung des Modells.

Beide Grenzen hängen von der Größe des Modells ab:

  • Die Größe ist die dritte Wurzel aus dem Volumen des hitbox-Bones (Breite x Tiefe x Höhe, in Blöcken), multipliziert mit dem scale-Attribut des Mobs. Ein Modell ohne hitbox-Bone verwendet stattdessen die dritte Wurzel aus der eigenen Bounding Box des Mobs. Größen unter 0.25 zählen als 0.25
  • Die Höchstgeschwindigkeit ist turnSpeedCap geteilt durch die Quadratwurzel der Größe, aber nie mehr als 90 Grad pro Tick
  • Die Beschleunigung ist turnAcceleration geteilt durch die Größe

Mit den Standardwerten turnSpeedCap: 30 und turnAcceleration: 6:

HitboxGrößeHöchstgeschwindigkeit (Grad pro Tick)Beschleunigung (Grad pro Tick, in jedem Tick)
0.5 x 0.5 x 0.50.542.412
1 x 1 x 11306
2 x 2 x 2221.23
4 x 4 x 44151.5

Weitere Regeln:

  • Ein Modell dreht sich sofort, solange ein Spieler seinen Mob direkt reitet oder auf einem seiner m_-Sitze sitzt, damit die Sicht des Reiters und das Modell zusammenbleiben.
  • Ein Modell, das von einem gesattelten, von einem Spieler gelenkten Pferd getragen wird, etwa eines aus /fmm mount, blickt dorthin, wohin der Reiter blickt, und sein Kopf bleibt waagerecht, statt dem Blick des Reiters nach oben und unten zu folgen.
  • h_-Kopf-Bones folgen dem Kopf des Mobs und können dem langsameren Körper um bis zu 75 Grad vorauseilen.
  • Ein sterbendes Modell behält die Blickrichtung, die es hatte. Ein Modell mit ausgeschalteter Bewegungssynchronisierung behält seine eigene Blickrichtung.
  • Statische Entities, Props und Spieler-Verkleidungen verwenden keine Drehträgheit.

Bewegungsausrichtung​

Ein dynamisches Modell kann sich mit seiner Bewegung neigen und nicht nur in seine Fahrtrichtung blicken. Läufer bleiben waagerecht, fliegende und schwimmende Kreaturen sollten das meist nicht. Haustiere legen das im Abschnitt orientation ihrer Haustierdatei fest. Plugins rufen DynamicEntity#setTravelOrientation(TravelOrientation) auf. Modelle sind standardmäßig UPRIGHT.

StilNeigung
UPRIGHTKeine. Das Modell blickt nur in Bewegungsrichtung
TOP_FIRSTSeine Oberseite führt, wie bei einer Qualle: Es neigt sich in seine Bewegung, liegt beim Gleiten auf der Seite und dreht sich zum Abtauchen auf den Kopf
FRONT_FIRSTSeine Vorderseite führt, wie bei einem Vogel oder Fisch: Es neigt die Nase in Steig- und Sturzflüge und legt sich in Kurven bis zu 45 Grad in die Schräglage
EinstellungStandardBedeutung
startSpeed0.6Blöcke pro Sekunde, unterhalb derer das Modell aufrecht bleibt, damit Treiben und Schaukeln im Leerlauf es nicht kippen
fullSpeed4.0Blöcke pro Sekunde, bei denen es sich vollständig an seiner Bewegung ausrichtet. Dazwischen neigt es sich teilweise
maxTilt180Stärkste Neigung in Grad, 0 bis 180
turnSpeed180Grad pro Sekunde, um die sich seine Neigung ändern kann
  • Die Neigung dreht das gesamte Modell um die Mitte seiner Würfel, nach seiner Blickrichtung und seinen Animationen, sodass jeder Bone, Locator und Mountpoint ihr folgt.
  • Die Geschwindigkeit stammt aus der Bewegung der Entity, über einige Ticks geglättet. Eine Bewegung von mehr als 2,5 Blöcken in einem Tick zählt als Teleport und neigt das Modell nicht.
  • Ein Modell kann sich anders neigen, solange sein Mob schwimmt, also im Wasser und nicht auf dem Boden ist. Haustiere legen das mit swimming.orientation fest (siehe Schwimmen), Plugins mit DynamicEntity#setSwimOrientation(TravelOrientation), wobei sich das Modell bei null wie an Land neigt. Beim Schwimmen folgt die Neigung sofort der eigenen Geschwindigkeit des Mobs, nur durch turnSpeed gebremst, statt der geglätteten Geschwindigkeit, sodass die Nase eines Schwimmers nach oben zeigt, solange er steigt, und nach unten, solange er abtaucht. Dies benötigt FreeMinecraftModels 2.15.0 oder neuer.
  • Das Modell richtet sich wieder auf, wenn es stoppt, während es stirbt, solange ein Spieler es reitet und solange seine Bewegungssynchronisierung aus ist.
  • Bedrock-Spieler sehen die Neigung über den exportierten Lean-Bone (siehe Bedrock-Export). Sie springt im Tick-Takt des Servers, ohne Glättung auf dem Client. Starte den Server nach der ersten Neuerzeugung des Pakets mit dem Lean-Bone einmal neu, damit die Bedrock-Brücke die neuen Entity-Eigenschaften registriert.

Zentrierung auf den Körper​

ModeledEntity#setCenteredOnBody(true) zeichnet ein Modell mit der Mitte seiner Würfel auf der Mitte seiner Entity, statt es auf die Füße der Entity zu stellen. Eine fliegende oder schwimmende Kreatur, deren Modell viel größer ist als ihr verborgener Körper, bewegt, dreht und neigt sich dann um diesen Körper. Das Fallback-Namensschild, die Klickbox und die Hitbox wandern mit dem Modell. Die Bones hitbox und Namensschild zählen nicht zur Mitte.

Standardmäßig ist es aus. Haustiere schalten es für die Arten FLYING und AQUATIC ein, und ihr Schlüssel centerOnBody überschreibt das. Bedrock-Spieler sehen das Modell ebenfalls zentriert, über denselben Lean-Bone. Die eigene Kollisionsbox der Bedrock-Entity beginnt weiterhin an ihren Füßen.

Animationen aus anderen Systemen abspielen​

AufruferEinstiegspunkt
Plugin (Java)ModeledEntity#playAnimation(String, boolean blend, boolean loop) / #stopCurrentAnimations() / #hasAnimation(String)
Prop-Lua-Skriptcontext.prop:play_animation(name, blend, loop) / context.prop:stop_animation()
Beliebige Lua-Entitätstabelleentity.model:play_animation(name, blend, loop) / entity.model:stop_animations() (verfügbar, wenn entity.is_modeled true ist)

Die zugehörigen Schnittstellen beschreiben der API- und Entwicklerleitfaden und Lua: Prop-API.

Die Lua-Standardwerte unterscheiden sich: context.prop:play_animation(name) verwendet blend=true, loop=true, während entity.model:play_animation(name) die Werte false, false verwendet. Übergib beide booleschen Werte ausdrücklich, wenn der Unterschied wichtig ist.

Fehlerbehebung​

Meine Animation läuft nie automatisch. Die gemeinsame Zustandsmaschine erkennt die kleingeschriebenen Namen spawn, idle, idle.long, walk, swim, idle.swim, ride, idle.ride, attack und death und behandelt jeden attack.-Namen und damaged als Aktionen. Bewegung steuert die Übergänge zwischen idle und walk, Schwimmen und ein steuernder Reiter bringen die Schwimm- und Reit-Animationen ins Spiel, und idle.long wartet auf eine ruhige Phase des Leerlaufs; Angriff und Tod benötigen weiterhin ihren Laufzeitauslöser. Siehe Zustandsanimationen. Andere Namen brauchen einen expliziten Aufruf von playAnimation / play_animation, außer den zusätzlichen Namen, die der Verkleidungs-Controller auswählt.

Mein Modell tut überhaupt nichts. Wahrscheinlich hat es weder eine spawn- noch eine idle-Animation, sodass es seine Ruhepose zeigt, bis es läuft oder etwas eine Animation abspielt. Füge eine idle hinzu.

Mein Angriff sieht seltsam aus, während das Modell läuft. Bei ausgeschaltetem Override wird der Angriff zur Laufpose jedes Bones addiert, den er mit Keyframes belegt. Schalte Override in den Blockbench-Eigenschaften des Angriffs an, damit diese Bones die Pose des Angriffs übernehmen, oder belege weniger Bones. Siehe Override und Blend Weight.

Mein Modell wechselt zu langsam oder zu abrupt zwischen idle und walk. Ändere idleWalkBlendTicks. 0 wechselt sofort.

Mein idle.long spielt zu oft, zu selten oder nie. Ändere longIdleMinSeconds und longIdleMaxSeconds. Das Warten zählt nur, solange das Modell reines idle zeigt: Bewegung, Angriffe, benutzerdefinierte Animationen und Reiter starten es neu. longIdleMaxSeconds: 0 schaltet idle.long ab.

Meine Smooth-, Step- oder Bezier-Animation bewegt sich nach einem Update anders. FreeMinecraftModels 2.15.0 und neuer spielen diese Keyframes so ab, wie Blockbench sie in der Vorschau zeigt; siehe Interpolationstypen. Prüfe die Animation in der Blockbench-Vorschau: Das ist die Bewegung, die FMM jetzt abspielt.

Mein großes Modell dreht sich zu langsam. Die Drehgeschwindigkeit sinkt mit der Größe; siehe Drehträgheit. Erhöhe turnSpeedCap und turnAcceleration, prüfe, dass der hitbox-Bone nicht größer ist als beabsichtigt, oder setze weightedTurning: false.

Die Konsole meldet ... FreeMinecraftModels does not support these ... oder ... has the blend weight .... FMM spielt diese Animation ohne Blockbenchs Start Delay, Loop Delay und Anim Time Update ab und liest Blend Weight nur als einfache Zahl. Leere diese Felder oder ersetze den Molang-Ausdruck durch eine Zahl.

Meine Animation läuft, aber nichts bewegt sich. Prüfe die Animationslänge. Eine Animation der Länge null wird als statische Pose behandelt und absichtlich stillschweigend übersprungen.

Auf Bedrock stehen alle Animationen eines Modells still, auch die Leerlaufanimation, während Java sie abspielt. Bedrock lehnt ein MoLang-Programm mit einem ; oder einer Zuweisung ab, wenn es nicht mit ; endet, und ein abgelehnter Keyframe stoppt jede Animation der Entity. FreeMinecraftModels 2.13.0 bis 2.14.1 schreiben solche Programme ohne das abschließende ;, und 2.14.2 fügt es hinzu. Aktualisiere, oder beende das Keyframe-Programm auf diesen Versionen in Blockbench selbst mit ;. Java spielt es genauso ab.

Ein MoLang-Keyframe bleibt bei 0 stehen. Prüfe die Konsole auf Failed to parse the keyframe expression. Ein Programm, dessen letzte Zeile eine Zuweisung ist, ergibt 0; beende es mit dem gewünschten Wert oder mit return. Andere Queries als die vier unter MoLang-Keyframes aufgeführten werden als 0 gelesen.

Rotationen sind gespiegelt. Prüfe meta.format_version in der .bbmodel. FMM dreht das Vorzeichen der X-/Y-Rotation ab Formatversion 5 um; eine Datei, die die eine Version deklariert, aber die Daten der anderen enthält, kommt gespiegelt heraus.

Die Konsole meldet Malformed animation timeline for model .... Eine Spur in dieser Animation konnte nicht gelesen oder interpoliert werden. Die Warnung erscheint einmal pro Animation und benennt den beteiligten Bone bzw. IK-Controller; die übrigen Animationen des Modells werden weiterhin konvertiert.

Sounds in meiner Blockbench-Timeline tun nichts. Sound-Keyframes werden nicht importiert. Löse Sounds über ein Lua-Skript oder dein eigenes Plugin aus. Partikel-Keyframes werden importiert; falls sie nicht erscheinen, siehe Partikel.