Grafiekeditor toestandsmachines

Een toestandsmachine combineert animatienodes in benoemde toestanden, zoals Idle, Walk, Run en Jump. Het speelt de actieve toestand en mengt naar een andere toestand wanneer een overgangsvoorwaarde evalueert naar true. Gebruik een toestandsmachine om te definiëren welke animaties elkaar kunnen opvolgen zonder overgangslogica in Luau te schrijven.

Elke toestand is verbonden met een invoer op de toestandsmachine. Een toestand kan een clip, een blendnode of een andere toestandsmachine zijn. De toestandsmachine geeft de actieve animatiepose of een mengsel tussen twee poses weer als er een overgang plaatsvindt, die je verbindt met de volgende node in de grafiek.

Vereisten

Voordat je een toestandsmachine maakt, maak je jezelf vertrouwd met de Animatie Grafiekeditor, inclusief hoe je deze opent en een animatiegrafiek maakt.

Maak een toestandsmachine

Het volgende voorbeeld gebruikt drie toestanden van JumpFallLandRunExample: Locomotion, Fall en LandIdle. Het personage beweegt normaal, schakelt over naar een vallende animatie wanneer het in de lucht is, en speelt een landinganimatie voordat het terugkeert naar locomotie. Deze stappen richten zich op de toestandsmachine; begin met animatienodes voor locomotie, vallen en landen.

1. In de Grafiekeditor, klik met de rechtermuisknop en selecteer Node Invoegen ⟩ Toestandsmachine.

   

2. Klik op de toestandsmachinenode op Openen. In de Toestandsmachine-weergave, gebruik Toestand Maken om drie toestanden toe te voegen met de namen Locomotion, Fall en LandIdle.

   

3. Klik op Terug naar Grafiek en verbind je animatienodes met de bijbehorende invoeren van de toestandsmachine:

   • Locomotion: Verbind je locomotie-animatie. De referentiegrafiek gebruikt een Blend1DNode genaamd IdleRunBlend om idle- en loopanimaties te mengen op basis van Speed.
   • Fall: Verbind een vallende ClipNode en stel Afspeelmodus in op Enum.AnimationNodePlayMode|OnceAndHold, zodat het zijn laatste pose vasthoudt totdat het personage landt.
   • LandIdle: Verbind een landingclip en stel Afspeelmodus in op Enum.AnimationNodePlayMode|OnceAndHold, zodat het kan eindigen en terug kan overgaan naar locomotie.

   Verbind de uitvoer van de toestandsmachine met de Pose-invoer van Grafiekuitvoer.

   

4. Open de Toestandsmachine-weergave opnieuw en sleep een overgang van (Entry) naar Locomotion. De toestandsmachine begint in deze toestand wanneer de grafiek start.

   

5. Voeg een Booleaanse grafiekparameter toe met de naam Grounded en stel deze in op true. Deze parameter geeft aan of het personage op de grond staat.

6. Voeg de volgende overgangen toe door een verbinding van de brontoestand naar de bestemmingsstaat te slepen en configureer elke overgang:

   • Locomotion naar Fall: Stel Wacht Op in op Expressie, Expressie op not Grounded, en Lengte op 0.2 seconden. De vallende animatie begint wanneer het personage de grond verlaat.
   • Fall naar LandIdle: Stel Wacht Op in op Expressie, Expressie op Grounded, en Lengte op 0.1 seconden. De landinganimatie begint wanneer het personage de grond raakt.
   • LandIdle naar Locomotion: Stel Wacht Op in op Voltooid, Wanneer op Enum.AnimationNodeTransitionWhen|BeforeFinished, en Lengte op 0.2 seconden. De toestandsmachine begint terug te mengen naar locomotie tijdens de laatste 0.2 seconden van de landinganimatie.

   

7. Laat Curve als standaard (Linear) voor alle drie de overgangen. Bekijk de grafiek en wijzig Grounded naar false om Fall in te gaan, en vervolgens terug naar true om LandIdle af te spelen en terug te keren naar Locomotion.

8. Werk Grounded bij vanuit je gameplaycode terwijl het personage de grond verlaat en raakt. Als je locomotieblend Speed gebruikt, werk dan die parameter bij terwijl het personage beweegt. Voor de parameterworkflow, zie API-integratie.

9. Breid de toestandsmachine uit met springen en extra landingsstaten om de volledige bewegingsgrafiek te creëren. JumpFallLandRunExample bevat aparte sprongen voor staan en rennen, plus verschillende landingen op basis van beweging en val snelheid.

Toestandsmachine-eigenschappen

Eigenschappen van de toestandsmachinenode

Invoeren

• State1...StateN: De animatienodes die elke toestand definiëren. De naam van de toestand moet overeenkomen met de naam van de invoer naar de toestandsmachinenode.

Eigenschappen

Eigenschap	Type	Beschrijving
EntryState	ObjectValue	Een ObjectValue waarvan de Value verwijst naar de AnimationNodeDefinition voor de toestand die actief is wanneer de grafiek start.

Evenementgegevens

• Evenementverwerking: Evenementen van de actieve toestand gaan door met hun gewicht onveranderd.
• Evenementuitstoot: Laat alleen evenementen van de actieve toestand door. Tijdens een overgang volgt de evenementuitstoot de globale evenementregels.

Overgangseigenschappen

Een overgang heeft een of meer brontoestanden, een bestemmingsstaat en een voorwaarde. Wanneer de actieve toestand overeenkomt met een brontoestand, controleert de toestandsmachine de voorwaarde. Het mengt naar de bestemmingsstaat wanneer de voorwaarde evalueert naar true.

Wacht Op bepaalt de overgangsvoorwaarde UI. Selecteer Expressie (Enum.AnimationNodeWaitFor|Trigger) om een Expressie-vak weer te geven. Een Expressie kan een Booleaanse grafiekparameter rechtstreeks verwijzen, zoals ShouldJump, of een voorwaarde evalueren, zoals Speed >= 12. Selecteer Voltooid (Enum.AnimationNodeWaitFor|Finished) om de Wanneer dropdown weer te geven.

Als meer dan één overgang een ware Expressie heeft, evalueert de toestandsmachine eerst de overgang met de hoogste Prioriteit waarde. Wanneer prioriteiten gelijk zijn, selecteert het willekeurig een overgang. Ken verschillende prioriteiten toe aan concurrerende overgangen om het resultaat voorspelbaar te maken.