> For the complete documentation index, see [llms.txt](https://tkkoi-developer.gitbook.io/tkkoiassets/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tkkoi-developer.gitbook.io/tkkoiassets/mesh-animation/meshanimation.md).

# MeshAnimation

### Mesh Animation

**Mesh Animation** is a procedural vertex animation system for Unity that deforms mesh geometry in real time without keyframes or ScriptableObject assets. All animations are configured directly on the component and work both in Play Mode and in the Editor preview.

#### How It Works

The `MeshAnimation` component clones the original mesh on start and applies deformations by offsetting vertices. Each effect operates around a configurable pivot point and is driven by DOTween.

#### 13 Built-in Effects

| Category        | Effects                                                           |
| --------------- | ----------------------------------------------------------------- |
| **Ambient**     | Breathe                                                           |
| **Impact**      | JellyTap, HitSquash, DentImpact, ShockwaveRing                    |
| **StateChange** | MeltDroop, CrumpleCollapse, DeathBloat, VertexScatter, MorphNoise |
| **Directional** | Twist, StretchPull                                                |
| **Lifecycle**   | BuildingEmerge                                                    |

#### Key Features

* Real-time animation preview in the Editor (Edit Mode)
* Automatic collider synchronization (Mesh, Box, Sphere, Capsule) with the deformed mesh
* Pivot system with normalized coordinates and presets
* `MeshAnimationInteract` component - 6 trigger types: Hover, Hold, Proximity, Impact, Scroll, Spawn
* `MeshAnimationGroup` - batch control over multiple components
* The ability to save presets in Scriptable Objects

#### Dependencies

* [DOTween](https://assetstore.unity.com/packages/tools/animation/dotween-hotween-v2-27676)