﻿---
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.2.0/user-guides/blender/getting-started/
---

# Getting started with Blender – Blender Plugin – Deformable v0.2.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.
- An internet connection one time, to start the trial. After that it works offline between renewals; a license renews
  online at least once every 7 days of use.

## Install the plugin

1. Download the plugin from [tangerina.io/deformable](https://tangerina.io/deformable#download), 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. Make sure the computer is online, and that **Allow Online Access** is on in **Edit > Preferences > System >
   Network**. The plugin starts your 7-day trial and shows **Standard trial: 7 days left**. If you already started the
   trial with one of the SDKs on this computer, it shows the days that are left of it.

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
```

The trial and the license are on [License and preferences](https://help.tangerina.io/deformable/v0.2.0/user-guides/blender/license-and-preferences/).

## Where the plugin lives

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.2.0/user-guides/engine/how-the-engine-works/)
explains the ideas, and [How the plugin works](https://help.tangerina.io/deformable/v0.2.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.](https://help.tangerina.io/deformable/v0.2.0/images/getting-started-first-scene.svg)

### 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.](https://help.tangerina.io/deformable/v0.2.0/images/getting-started-brick-and-rubber.svg)

## Stay inside the trial limit

During the trial, a Deformable Scene can hold 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.2.0/user-guides/engine/preparing-meshes/).

## Next steps

- [How the engine works](https://help.tangerina.io/deformable/v0.2.0/user-guides/engine/how-the-engine-works/): objects, the scene, the tools and the
  start frame.
- [Materials](https://help.tangerina.io/deformable/v0.2.0/user-guides/engine/materials/): the ten material values and the 43 presets.
- [Fracture and splinters](https://help.tangerina.io/deformable/v0.2.0/user-guides/engine/fracture-and-splinters/): control how objects break.
- [How the plugin works](https://help.tangerina.io/deformable/v0.2.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.2.0/user-guides/blender/creating-objects/): every way to make a deformable
  object.
- [Playback, caching and baking](https://help.tangerina.io/deformable/v0.2.0/user-guides/blender/playback-and-baking/): cache, bake and render.
- [Troubleshooting](https://help.tangerina.io/deformable/v0.2.0/user-guides/blender/troubleshooting/): what to check when something goes wrong.
