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.
| Animationsname | Loopt | Wann sie abgespielt wird |
|---|---|---|
spawn | nein | Einmal, wenn das Modell erzeugt wird. Am Ende wechselt das Modell zu walk, wenn sich seine Entity bewegt, sonst zu idle |
idle | ja | Solange die Entity keine horizontale Geschwindigkeit hat. Wird zu walk übergeblendet, sobald die X- oder Z-Geschwindigkeit ungleich null wird |
idle.long | nein | Einmal, 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 |
walk | ja | Solange die X- oder Z-Geschwindigkeit der Entity ungleich null ist. Wird zu idle übergeblendet, wenn beide null sind |
attack | nein | Wenn ausgelöst. Wird einmal über idle oder walk abgespielt und endet dann |
death | nein | Bei 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, spieltrideanstelle vonwalkab, solange es sich bewegt, undidle.rideanstelle vonidle, solange es steht. Eine Haustierdatei kann mitriding.animationundriding.idleAnimationandere Animationen benennen; siehe Reiten. Plugins rufengetAnimationComponent().setRiddenAnimation(name)undsetRiddenIdleAnimation(name)auf, wobeinulldie jeweilige Animation abschaltet. Ein Modell ohnerideläuft unter seinem Reiter mitwalk, und eines ohneidle.ridezeigtidle. - Schwimmen. Ein Modell, dessen Mob schwimmt, also im Wasser und nicht auf dem Boden ist, spielt
swimanstelle vonwalkab, solange es sich bewegt, undidle.swimanstelle vonidle, solange es stillhält. Eine Haustierdatei kann mitswimming.animationundswimming.idleAnimationandere Animationen benennen; siehe Schwimmen. Plugins rufengetAnimationComponent().setSwimAnimation(name)undsetIdleSwimAnimation(name)auf, wobeinulldie jeweilige Animation abschaltet. Ein Modell ohneswimläuft im Wasser mitwalk, und eines ohneidle.swimzeigtidle, 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 Bewegung | Im Stillstand | |
|---|---|---|
| An Land | walk | idle und ab und zu idle.long |
| Im Wasser | swim | idle.swim |
| Geritten | ride | idle.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, sonstidle. 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 ohneidle, 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.
jump-ZustandRegulä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.
| Ebene | Was darauf abgespielt wird |
|---|---|
| Basis | spawn, 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 |
| Aktion | attack 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 Wechsel | Sofort |
Ü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-Einstellung | Wirkung in FMM |
|---|---|
| Override an | Auf 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 Weight | Skaliert, 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,
damagedeingeschlossen, haben Vorrang vor eingebauten. Solange eine auf einer der beiden Ebenen läuft, werden Angriffsanfragen verworfen.deathunterbricht alles. - Eine neue Aktion ersetzt die laufende Aktion: Ein zweiter Angriff startet den Angriff neu, und eine benutzerdefinierte Animation, die mit
blendauftrueabgespielt wird, ersetzt einen laufenden Angriff. - Eine benutzerdefinierte Animation, die mit
blendauffalseabgespielt 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
spawnoderidle.long. Endet eine einmalige benutzerdefinierte Animation, springt das Modell zuidleoderwalk, je nachdem, was zu seiner Bewegung passt. Eine ausdrückliche Anfrage füridleoderwalkbeendet 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
spawnoderidle, 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 wederidlenochwalkhat, 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()
blendwählt die Ebene für eine benutzerdefinierte Animation.truespielt sie auf der Aktionsebene ab, überidleoderwalk, mit ihrem Blockbench-Override und Blend Weight.falsegibt 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.
loopgilt für benutzerdefinierte Animationen unddamaged. Eingebaute Namen ignorieren sowohlblendals auchloop:idleundwalkloopen immer,spawn,deathund 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).
hasAnimationfindet dieselben Namen, dieplayAnimationabspielt. Das Modell muss den kleingeschriebenen Namen enthalten, damit ein eingebauter Zustand funktioniert. damagedläuft immer auf der Aktionsebene, unabhängig vonblend.playAnimationgibtfalsezurück für einen Namen, den das Modell nicht hat, und für jede Anfrage, nachdemdeathangefordert wurde.truebedeutet, 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 zuidle, oder in die Ruhepose, wenn das Modell keinidlehat.- Der Tod ist endgültig: Sobald
deathangefordert wurde, geben neue Wiedergabeanfragenfalsezurück, eingereihte Anfragen werden ignoriert undstopCurrentAnimations()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 von0bisduration - 1abgetastet. 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-Modus | Bedrock-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:
- Ein
step-Keyframe hält seinen Wert bis zum nächsten Keyframe. - Ein
linear-Keyframe, auf den einlinear- oderstep-Keyframe folgt, wird geradlinig überblendet. - 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-Modusloopist, 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. - 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_version5 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, Translation0,0,0und Skalierung1,1,1zurückgesetzt; ein Bone, den die Aktion nicht belegt, behält die Basispose. - Keyframe-Datenpunkte dürfen in der
.bbmodelals Zeichenketten geschrieben sein. Eine Zeichenkette, die eine Zahl ist, wird als diese Zahl gelesen, und eine leere Zeichenkette wird zu1bei der Skalierung und sonst zu0. 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.:
| Query | Wert |
|---|---|
query.anim_time | Sekunden seit Beginn dieser Animation. Eine loopende Animation beginnt in jedem Durchlauf wieder bei 0 |
query.life_time | Sekunden seit der Erstellung des Modells |
query.modified_distance_moved | Blöcke, die sich die Entity horizontal bewegt hat |
query.is_moving | 1, solange sich die Entity horizontal bewegt, sonst 0 |
- Andere Queries und unbekannte Variablen werden als
0gelesen. Einev.-Variable behält ihren Wert auf dieser Entity zwischen den Auswertungen, und eintemp.-Wert (t.) gilt nur für einen Ausdruck. - Ausdrücke verwenden dieselben Operatoren und Mathematikfunktionen wie Partikel-MoLang.
- Ein Programm aus mehreren Anweisungen ohne
returnhat den Wert seiner letzten Zeile, so wie Blockbench es in der Vorschau zeigt.v.a = 10; v.b = v.a * 3; v.b + 5ergibt35. Eine letzte Zeile, die eine Zuweisung ist, ergibt0. Partikel-MoLang behält die Regel von Bedrock, nach der ein Programm ohnereturn0ergibt. - 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:
- Ein Null-Objekt mit
ik_source(Wurzel-Bone) undik_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. - 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.
- 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.
lock_ik_target_rotationwird 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_lengthist die Dauer in Sekunden, nach unten auf0.05begrenzt, 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-Bonesfmm_nametag_bone_*und Mountpointsm_aus; selbst erstelltetag_-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
returnvor 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 mitformat_version5 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_zundbody_offset. Ein Modell mit mehr als 672 Animationen, einschließlich der erzeugten Animationen, die einen Bonesaddleoderfishausblenden, 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 namensfishdanachfreeminecraftmodels_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": truegeschrieben, ein Blend Weight ungleich1als"blend_weight". Die Basisanimationenidle,walk,spawnunddeathstehen in der Animate-Liste der Entity an erster Stelle, sodass Aktionen darüber geschichtet werden. - Das
blend_transitionder Controller übernimmt die Java-Überblendzeiten:idleundwalkblenden überidleWalkBlendTicksein und aus,deathblendet überdeathBlendTicksein, und jede andere Animation wechselt sofort,idle.longund 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.
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_version5 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 demscale-Attribut des Mobs. Ein Modell ohnehitbox-Bone verwendet stattdessen die dritte Wurzel aus der eigenen Bounding Box des Mobs. Größen unter0.25zählen als0.25 - Die Höchstgeschwindigkeit ist
turnSpeedCapgeteilt durch die Quadratwurzel der Größe, aber nie mehr als 90 Grad pro Tick - Die Beschleunigung ist
turnAccelerationgeteilt durch die Größe
Mit den Standardwerten turnSpeedCap: 30 und turnAcceleration: 6:
| Hitbox | Größe | Höchstgeschwindigkeit (Grad pro Tick) | Beschleunigung (Grad pro Tick, in jedem 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 |
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.
| Stil | Neigung |
|---|---|
UPRIGHT | Keine. Das Modell blickt nur in Bewegungsrichtung |
TOP_FIRST | Seine 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_FIRST | Seine 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 |
| Einstellung | Standard | Bedeutung |
|---|---|---|
startSpeed | 0.6 | Blöcke pro Sekunde, unterhalb derer das Modell aufrecht bleibt, damit Treiben und Schaukeln im Leerlauf es nicht kippen |
fullSpeed | 4.0 | Blöcke pro Sekunde, bei denen es sich vollständig an seiner Bewegung ausrichtet. Dazwischen neigt es sich teilweise |
maxTilt | 180 | Stärkste Neigung in Grad, 0 bis 180 |
turnSpeed | 180 | Grad 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.orientationfest (siehe Schwimmen), Plugins mitDynamicEntity#setSwimOrientation(TravelOrientation), wobei sich das Modell beinullwie an Land neigt. Beim Schwimmen folgt die Neigung sofort der eigenen Geschwindigkeit des Mobs, nur durchturnSpeedgebremst, 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
| Aufrufer | Einstiegspunkt |
|---|---|
| Plugin (Java) | ModeledEntity#playAnimation(String, boolean blend, boolean loop) / #stopCurrentAnimations() / #hasAnimation(String) |
| Prop-Lua-Skript | context.prop:play_animation(name, blend, loop) / context.prop:stop_animation() |
| Beliebige Lua-Entitätstabelle | entity.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.