﻿---
title: License and preferences
description: The plugin's preferences in Blender, the license status, the Free license and its limit, activating and deactivating a license key, the mesh check setting, and the Documentation and Copy Support Info buttons.
url: https://help.tangerina.io/deformable/v0.4.1/user-guides/blender/license-and-preferences/
---

# License and preferences – Blender Plugin – Deformable v0.4.1

The plugin keeps its settings in Blender's preferences. There you see your license, activate a license key, turn the
mesh check on or off, open this guide, and copy what a support email needs.

To open them, choose **Edit > Preferences > Add-ons** and expand **Deformable**.

## License status

The **License** box at the top of the plugin preferences starts with the status, beside an icon:

| Status | What it means |
|---|---|
| **Free license: up to 2,500 tetrahedrons per scene — Buy license** | No license key is active. Every feature works, and a Deformable Scene simulates up to 2,500 tetrahedrons. |
| **Standard license** | A Standard license key is active on this device. There is no limit. |
| **Connect to the internet to renew your Standard license** | The license went 7 days without a renewal, or the clock was set back. The next line shows **Until then, the Free license: up to 2,500 tetrahedrons per scene**. Connect to the internet and click **Check Now**. |

Below the status, the box shows:

- **Online access is off in Blender's preferences (System > Network)** while Blender's **Allow Online Access** is
  off. The plugin then contacts nothing: **Activate** and **Check Now** are greyed out, and a license runs only as
  long as it runs offline. **Deactivate** still works, but cannot free the seat. Turn **Allow Online Access** on in
  **Edit > Preferences > System > Network** to use them all.

- **Contacting the licensing service…** while the plugin renews, activates or deactivates. When that fails, the box
  shows why, such as **This license key does not exist**.
  [Status messages](https://help.tangerina.io/deformable/v0.4.1/licensing/#status-messages) lists every message and what to do.
- The **License Key** field and **Activate** when no key is active, or **Deactivate** when one is.
- **Check Now** while the status asks you to go online. It contacts our licensing service right away and renews the
  license.
- **Buy License** while no key is active. It opens **Buy Standard license** on the Licenses page.
- **Manage Licenses**. It opens the [Licenses page](https://platform.tangerina.io/licenses), where you open a license
  to copy its key and see the devices that use its seats.

The license belongs to the device, not to the plugin: the Maya plugin and the C, Rust and Python SDKs on the same
device share it. A license activated in the Maya plugin or from an SDK shows **Standard license** here too. A
Developer license key does not work in the plugin: **Activate** refuses it with **Developer licenses work in the SDKs
only: the plugins need a Standard license**. The licenses, prices and the buying steps are on
[Licensing](https://help.tangerina.io/deformable/v0.4.1/licensing/).

## The Free license

Without a license key, the plugin runs under the Free license, forever: every feature works, and a Deformable Scene
simulates up to 2,500 tetrahedrons. It needs no account and no internet, and the plugin sends nothing.

Every object in the scene counts, floors included, but an object with **Disabled** on: it takes no part in the
simulation. The status bar shows how many the active object and its scene hold, disabled objects included, such as
**Deformable: Sphere: 212 tetrahedrons; scene total 218**.

A bigger Deformable Scene says so in the status bar, at the start frame and when you play, such as
**Deformable: Free license: the scene would simulate 3,120 tetrahedrons; the limit is 2,500 per scene**. It also
shows as soon as a create action makes the scene too big. When you play, the objects that do not fit stay still and
the rest of the scene runs. Each Deformable Object node that does not fit shows the limit, such as **Free license:
this would simulate 3,120 tetrahedrons; the limit is 2,500 per scene**. To simulate the whole scene, use fewer
tetrahedrons, for example with a lower **Target Face Count** on the Autocage panel or a simpler cage, or buy a
license. See [Use fewer tetrahedrons](https://help.tangerina.io/deformable/v0.4.1/user-guides/engine/preparing-meshes/#use-fewer-tetrahedrons).

## Buy a license

Click **Buy License** in the plugin preferences. Your browser opens **Buy Standard license** on the
[Licenses page](https://platform.tangerina.io/licenses): sign in, or create an account first. Choose the number of
seats, one per device, and pay. The license page then shows your key: copy it.

The Standard license is $99 per seat, one time, with no subscription. It is perpetual, covers all future versions
(every update is included), covers the Blender and Maya plugins and the C, Rust and Python SDKs, and includes email
support at [support@tangerina.io](mailto:support@tangerina.io).

## Activate a license

1. Open **Edit > Preferences > Add-ons** and expand **Deformable**.
2. Paste your license key into the **License Key** field.
3. Make sure the device is online, and click **Activate**.

The box shows **Contacting the licensing service…**, then **Standard license**, and the tetrahedron limit is gone. The
plugin clears the field: the engine keeps the key. Activation needs internet one time. If it fails, the box shows why,
such as **Every seat of this license is in use: remove a device on the Licenses page, or buy another license**. With
an empty field, **Activate** says **Paste the license key from the Licenses page first**.

After that, the plugin works offline between renewals. While you use it on a device that is online, it renews the
license quietly, a few times a day at most, and checks each time Blender starts. Each renewal lets it run 7 days
offline. After 7 days offline, it shows **Connect to the internet to renew your Standard license** and the Free
license runs, with its limit, until you connect and click **Check Now**.

## Deactivate a license

A Standard license runs on 1 device per seat. To move a seat to another device, deactivate it on this one first:

1. Open the plugin preferences.
2. Click **Deactivate**.
3. On the new device, install the plugin, then [activate](https://help.tangerina.io/deformable/v0.4.1/user-guides/blender/license-and-preferences/#activate-a-license)
   the same key.

![The same license key moving from the old device, where it is deactivated first, to the new device, where it is activated.](../../images/license-move-to-new-device.svg "Deactivate the license on the old device first, then activate the same key on the new device.")

Deactivating here also deactivates the Maya plugin and the SDKs on this device. The plugin forgets the license at
once, even offline, and the Free license runs. Offline, the seat stays taken, and the box shows **Deactivated on this
device, but its seat could not be freed: remove this device on the Licenses page**.

If you no longer have the old device, click **Manage Licenses**, open the license, click **Remove** beside the old
device, then **Remove device**. Lost keys and refunds are on [Licensing](https://help.tangerina.io/deformable/v0.4.1/licensing/).

## Preferences

| Preference | Default | What it does |
|---|---|---|
| Verify Meshes Before Creating Objects | On | Refuse a mesh that is not clean and closed when you create a deformable object. |

With **Verify Meshes Before Creating Objects** on, every create action checks each mesh first, and so does
**Add Surface Mesh to Object** with
**Breakable** on. A mesh with problems is refused, and the warning names them, such as **Not verified: Suzanne: non
closed boundary (84), co located vertices (2), non planar (104)**.

Turn it off to create objects from meshes with small problems that do not matter for your shot, such as a model with
separate eyes. The tools may then still fail on the mesh, and the node shows why. To find and fix the problems
instead, see [Verify Mesh](https://help.tangerina.io/deformable/v0.4.1/user-guides/blender/creating-objects/#verify-mesh).

With the preference off, the create actions still refuse an object with a mirrored or flat transform, such as a
negative scale. See
[Mesh checks before creating](https://help.tangerina.io/deformable/v0.4.1/user-guides/blender/creating-objects/#mesh-checks-before-creating).

## Help

Below the preferences are two buttons:

- **Documentation** opens this user guide in your browser.
- **Copy Support Info** copies the Blender version, the operating system, the plugin and library versions and the
  license status. Paste it into your email to [support@tangerina.io](mailto:support@tangerina.io). The plugin then
  shows **Copied the support info: paste it into your email**.

The pages of this guide also open from the plugin's menus. Hover over an item of **Object > Deformable**, or a button
of the **License** box, and press **F1**. Or right-click it and choose **Online Manual**.

## Update the plugin

To install a new version, download the `.zip` file for your system from
[tangerina.io/deformable](https://tangerina.io/deformable#download-blender) and install it the same way as the first one: **Edit > Preferences > Get
Extensions > Install from Disk**. Then restart Blender: a running Blender keeps the version it loaded.
