﻿---
title: Getting started with Blender
description: Install the Blender plugin and drop a breakable sphere onto a floor in ten steps.
url: https://help.tangerina.io/deformable/v0.8.0/user-guides/blender/getting-started/
---

# Getting started with Blender – Blender Plugin – Deformable v0.8.0

The Blender plugin is the way to use the Tangerina Deformable engine in Blender. You turn meshes into deformable
objects, pick a material, and press Play. Objects bend, dent, bounce and break, and Blender caches every frame.

This page installs the plugin and walks you through a first simulation: a brick sphere that falls onto a floor and
breaks.

## Requirements

- Blender 5.2 or later.
- macOS (Apple silicon), Linux x64 or Windows x64.
- No account and no internet for Free. A Standalone subscription needs the internet to sign in, then at least once a
  day. A Standalone license needs the internet to activate, then at least once every 7 days.

## Install the plugin

1. Download the plugin from [tangerina.io/deformable](https://tangerina.io/deformable#download-blender), on the **Blender
   plugin** tab. Click **Download for** your system: the page detects it. To get another system's file (macOS Apple
   silicon, Linux x64 or Windows x64), pick it under **Other platforms**. Save the `.zip` file. Do not unzip it. Each
   `.zip` file works on its own system only, and Blender refuses one built for another system. The file is named for
   the version and the system, such as `deformable-blender-v0.1.0-macos-arm64.zip`.
2. In Blender, open **Edit > Preferences > Get Extensions > Install from Disk**.
3. Choose the `.zip` file. Blender installs the plugin and enables it.
4. The plugin runs as Free, with every feature and up to 2,500 tetrahedrons per scene. Its preferences show **Free:
   up to 2,500 tetrahedrons per scene**. If you already signed in with a Standalone subscription or
   activated a Standalone license in the Maya plugin or one of the SDKs on this device, they show **Standalone
   subscription** or **Standalone license** instead.

To check the install, open the **Object** menu in the 3D Viewport. It now ends with a **Deformable** submenu.

You can also install the plugin from a terminal. Replace the file name with the path of the file you downloaded:

```sh
blender --command extension install-file -r user_default -e deformable-blender-v0.1.0-macos-arm64.zip
```

Free, the Standalone subscription and the Standalone license are on
[License and preferences](https://help.tangerina.io/deformable/v0.8.0/user-guides/blender/license-and-preferences/).

## Where the plugin lives

The **Deformable** menu is at the end of the 3D Viewport's **Object** menu.

![The Deformable menu. Its items come in seven groups: creating objects, surface meshes and splinters, editing objects, materials, regions, checking meshes, and simulating, baking and extracting output shapes. Most items show an icon of what they do. An arrow marks each item that opens a submenu.](../../images/blender-deformable-menu.svg "Most work starts in the Deformable menu, at the end of the 3D Viewport's Object menu.")

The plugin adds three things to Blender:

| Where | What |
|---|---|
| 3D Viewport > **Object > Deformable** | Actions that create, edit, simulate and bake deformable objects. This is where most work starts. |
| Properties > Modifiers > **Add Modifier > Deformable** | Ready-made node trees, as Geometry Nodes modifiers, with their settings on the modifier panel. |
| Geometry Node Editor > **Add > Deformable** | The 13 Deformable nodes, for building or changing a tree by hand. |

Each action builds a Geometry Nodes modifier on the object. You change its settings on the modifier panel in the
Properties editor, like any other modifier. [How the engine works](https://help.tangerina.io/deformable/v0.8.0/user-guides/engine/how-the-engine-works/)
explains the ideas, and [How the plugin works](https://help.tangerina.io/deformable/v0.8.0/user-guides/blender/how-the-plugin-works/) the parts in
Blender.

## Your first simulation

The scene: a sphere 3 m above a floor. The sphere is made of brick, so it breaks when it lands.

![A sphere 3 m above a thin floor slab.](../../images/getting-started-first-scene.svg "The sphere is made of brick, so it breaks when it lands on the floor.")

### Make the sphere

1. Choose **File > New > General**. Select the cube, press **X** and choose **Delete**.
2. Choose **Add > Mesh > UV Sphere**.
3. Press **N** to open the Sidebar. On the **Item** tab, set **Location Z** to `3 m`.
4. Choose **Object > Deformable >**
   
   **Create Object with Autocage**.

The sphere gets the modifier
**Deformable Object
(Autocage)**.
The plugin wraps the sphere in a light cage, fills the cage with tetrahedrons, and keeps your sphere as the render
surface. While it computes, the status bar at the bottom of the window shows the running tools, such as
**Deformable: Tetrahedralize (Sphere) 0:42**.

The scene also gets a new object, **Deformable Scene**. It holds the simulation settings, such as gravity. It shows
a small gravity arrow in the viewport and nothing in renders.

5. Choose **Object > Deformable > Assign Material Preset > brick**.

### Make the floor

6. Choose **Add > Mesh > Plane**. In the **Adjust Last Operation** panel at the bottom left, set **Size** to `20 m`.
7. Choose **Object > Deformable >** 
   **Create Bare Object > From Non-Closed Polygon Mesh**. In the **Adjust Last Operation** panel, set **Thickness**
   to `0.2 m` and **Direction** to **Down**. The plane becomes a slab of tetrahedrons below its surface, drawn in
   see-through orange, the color of a bare object. Your plane is kept, hidden, as `Plane_original`.
8. Choose **Object > Deformable >**
   
   **Use Tetrahedral Mesh as Surface Mesh**. The orange goes, and the slab renders with the plane's materials. The
   plane has none, so it shows Blender's default grey.
9. Choose **Object > Deformable >** **Make Kinematic**.
   A Kinematic object does not fall. It stays where it is, or follows its animation.

### Play

10. Go to the first frame: press **Shift+Left Arrow**.
11. Press **Space** to play.

The sphere falls, hits the floor at about frame 17 and breaks. New faces appear on the cracks.

Blender caches each frame as it plays. Scrub the timeline back to replay the cache. To see the change of a setting,
return to the first frame and play again.

### Try a different material

1. Press **Esc** to stop, and go to the first frame.
2. Select the sphere and choose **Object > Deformable > Assign Material Preset > rubber**.
3. Play again. The rubber sphere bounces about 1 m high and does not break.

Try **glass** too: it cracks more than brick.

![The brick sphere lies broken in pieces on the floor, and the rubber sphere bounces about 1 m high.](../../images/getting-started-brick-and-rubber.svg "Only the material differs: the brick sphere breaks when it lands, and the rubber one bounces.")

## Stay inside the limit of Free

On Free, a Deformable Scene simulates up to 2,500 tetrahedrons. The sphere above uses 212, and the
floor 6. Select an object to see its count and the scene's total in the status bar, such as
**Deformable: Sphere: 212 tetrahedrons; scene total 218**. A scene over the limit says so there.

Some settings make many tetrahedrons. For example, **Create Primitive Object >**
**Sphere** makes about 650, three times as many as the sphere above.
To use fewer, see [Preparing meshes](https://help.tangerina.io/deformable/v0.8.0/user-guides/engine/preparing-meshes/).

## Next steps

- [How the engine works](https://help.tangerina.io/deformable/v0.8.0/user-guides/engine/how-the-engine-works/): objects, the scene, the tools and the
  start frame.
- [Materials](https://help.tangerina.io/deformable/v0.8.0/user-guides/engine/materials/): the ten material values and the 43 presets.
- [Fracture and splinters](https://help.tangerina.io/deformable/v0.8.0/user-guides/engine/fracture-and-splinters/): control how objects break.
- [How the plugin works](https://help.tangerina.io/deformable/v0.8.0/user-guides/blender/how-the-plugin-works/): the node trees, the modifiers and
  where each setting is.
- [Creating and editing objects](https://help.tangerina.io/deformable/v0.8.0/user-guides/blender/creating-objects/): every way to make a deformable
  object.
- [Playback, caching and baking](https://help.tangerina.io/deformable/v0.8.0/user-guides/blender/playback-and-baking/): cache, bake and render.
- [Troubleshooting](https://help.tangerina.io/deformable/v0.8.0/user-guides/blender/troubleshooting/): what to check when something goes wrong.
