megakoop/Game/ANIMATOR_SETUP.md

Third Person Animator Setup

Přehled

Animator systém je nyní plně integrován do ThirdPersonCharacterController.cs a má automatický generátor pro vytvoření Animator Controlleru z Kevin Iglesias animací.

⚠️ DŮLEŽITÉ - Pokud máte problémy s animacemi

Pokud animace pohybu trhají nebo jump animace nefungují:

1. Smažte starý controller (pokud jste ho už vytvořili)
2. Vytvořte nový controller s opraveným kódem (viz níže)
3. Zkontrolujte Console pro debug výpis všech nalezených animací

Oprava provedena:

• ✅ Opraveno načítání animací z FBX souborů
• ✅ Opraveno použití skutečné rychlosti z CharacterController
• ✅ Opraveny jump transitions (Begin → Fall → Land)
• ✅ Přidán debug výpis pro kontrolu načtených animací

Rychlý Start

1. Otevřete Auto Builder

V Unity menu: MegaKoop → Animator → Auto Build Controller

2. Vygenerujte Controller

• Okno automaticky najde všechny animace ve složce Kevin Iglesias
• Klikněte "Najít Animace" (nebo se načtou automaticky)
• Zkontrolujte Console - měli byste vidět "Načteno: [název animace] z [cesta]"
• Vyberte GameObject s ThirdPersonCharacterController v Hierarchy
• Zaškrtněte "Přiřadit na vybraný objekt"
• Klikněte na Vytvořit Animator Controller

3. Zkontrolujte Console

Měli byste vidět výpis všech načtených animací:

=== Vytváření Animator Controller ===
Idle: HumanM@Idle01
Walk Forward: HumanM@Walk01_Forward
Walk Backward: HumanM@Walk01_Backward
...
Jump Begin: HumanM@Jump01 - Begin
Jump Fall: HumanM@Fall01
Jump Land: HumanM@Jump01 - Land

4. Hotovo!

Controller je vytvořen a přiřazen. Animace budou fungovat automaticky.

Co je zahrnuto

Stavy Animatoru:

• Idle - Poklidový stav
• Move - 2D Blend Tree pro pohyb všemi směry (Forward/Backward/Left/Right + diagonály)
• Crouch - Dřep (stisknutím LeftControl)
• Jump Begin - Začátek skoku
• Jump Fall - Pád ve vzduchu
• Jump Land - Dopad
• Death - Smrt

Parametry:

• MoveX (float) - Lokální X pohyb
• MoveZ (float) - Lokální Z pohyb
• Speed (float) - Rychlost postavy
• IsGrounded (bool) - Je na zemi
• IsCrouching (bool) - Dřepí
• IsDead (bool) - Je mrtvý
• Jump (trigger) - Spustí skok

Použití v kódu

Nastavení smrti:

var controller = GetComponent<ThirdPersonCharacterController>();
controller.SetDead(true);

Změna crouch klávesy:

V Inspectoru na ThirdPersonCharacterController změňte "Crouch Key".

Nalezené animace

Idle

• HumanM@Idle01.fbx

Walk (všechny směry)

• HumanM@Walk01_Forward.fbx
• HumanM@Walk01_Backward.fbx
• HumanM@Walk01_Left.fbx
• HumanM@Walk01_Right.fbx
• HumanM@Walk01_ForwardLeft.fbx
• HumanM@Walk01_ForwardRight.fbx
• HumanM@Walk01_BackwardLeft.fbx
• HumanM@Walk01_BackwardRight.fbx

Crouch

• HumanM@Crouch01_Idle.fbx

Jump (3 fáze)

• HumanM@Jump01 - Begin.fbx
• HumanM@Fall01.fbx
• HumanM@Jump01 - Land.fbx

Death

• HumanM@Death01.fbx

Poznámky

• Animator je přímo v ThirdPersonCharacterController - není potřeba žádný driver
• Automatické hledání animací - stačí kliknout na tlačítko
• Plná integrace - funguje s existující movement logikou
• Skok má 3 fáze - Begin → Fall → Land pro realistický skok
• 2D Blend Movement - plynulý přechod mezi všemi směry pohybu

Řešení problémů

Animace pohybu se zastaví po 1 sekundě

✅ OPRAVENO - Použití CharacterController.velocity místo planarVelocity

Co dělat:

1. Smažte starý Animator Controller asset
2. Vytvořte nový controller přes Auto Builder
3. Ujistěte se, že používáte aktuální verzi ThirdPersonCharacterController.cs

Jump animace nefungují

✅ OPRAVENO - Přidány správné 3 fáze skoku a transitions

Co kontrolovat:

• V Animatoru musí být stavy: "Jump Begin", "Jump Fall", "Jump Land"
• Transitions: Begin → Fall (exit time 0.8) → Land (when IsGrounded)
• Zkontrolujte Console, že všechny 3 jump animace byly načteny

Animace nejsou nalezeny

Příznaky: V okně Auto Builder jsou prázdná pole nebo Console ukazuje "Nelze najít FBX"

Řešení:

1. Zkontrolujte, že složka Assets/Kevin Iglesias/Human Animations/Animations/Male existuje
2. Zkontrolujte, že FBX soubory jsou v této struktuře:
   • Idles/HumanM@Idle01.fbx
   • Movement/Walk/HumanM@Walk01_Forward.fbx
   • Movement/Jump/HumanM@Jump01 - Begin.fbx
   • atd.
3. Klikněte na "Najít Animace" v Auto Builder okně

Animace se nehrají vůbec

Řešení:

1. Vyberte GameObject v Hierarchy
2. V Inspectoru zkontrolujte:
   • Animator komponenta existuje a má přiřazený Controller
   • ThirdPersonCharacterController.animator není null (mělo by být auto-přiřazeno)
3. V Play mode otevřete Animator okno (Window → Animation → Animator)
4. Sledujte, jestli se mění parametry (MoveX, MoveZ, Speed)

Animace se hrají, ale postavy se netočí správně

• Animace z Kevin Iglesias mohou mít Root Motion
• Zkontrolujte FBX Import Settings:
  • Vyberte FBX soubor
  • V Inspectoru → Rig → Animation Type: Humanoid
  • Animation → Apply Root Motion (podle potřeby)

Debug kroky

1. Otevřete Console při vytváření controlleru - měli byste vidět:

   Načteno: HumanM@Idle01 z Assets/Kevin Iglesias/.../Idle01.fbx
   Načteno: HumanM@Walk01_Forward z Assets/Kevin Iglesias/.../Walk01_Forward.fbx
   ...
   

2. V Play mode sledujte Animator parametry:

   • Vyberte objekt
   • Otevřete Animator okno
   • Sledujte hodnoty MoveX, MoveZ, Speed při pohybu (WASD)

3. Zkontrolujte rychlost:

   • V Inspectoru na ThirdPersonCharacterController
   • Move Speed by měla být > 0 (default 5)
   • Animation Damping by měla být malá (default 0.075)