﻿---
title: License and preferences
description: The Deformable Preferences window in Maya, the license status, the trial and its limit, activating and deactivating a license key, the mesh check and frame cache settings, the help items, and updating the plugin.
url: https://help.tangerina.io/deformable/v0.2.0/user-guides/maya/license-and-preferences/
---

# License and preferences – Maya Plugin – Deformable v0.2.0

The plugin keeps its settings in the **Deformable Preferences** window. There you see the state of your trial or
license, activate a license key, turn the mesh check on or off, set how much memory the frame cache takes, open this
guide, and copy what a support email needs.

To open it, choose **Deformable Scene > Preferences…** or **Deformable Help > License…**.

## License status

The window's **License** section starts with the status, beside an icon:

| Status | What it means |
|---|---|
| **Standard trial: 7 days left** | The trial runs. The number counts down each day, to **Standard trial: 1 day left**. The next line shows **Trial limit: 2,500 tetrahedrons**. |
| **Standard trial ended — Buy license** | The 7 days are over. The tools and the simulation stop until you activate a license. |
| **No Standard trial on this device — Buy license** | This computer gives no device id, so it cannot have a trial. A license works. |
| **Standard license** | A Standard license key is active on this computer. There is no limit. |
| **Go online once to start the Standard trial** | The trial has not started yet. Connect to the internet and click **Check Now**. |
| **Go online once to renew the Standard license** | The license went about 7 days without a renewal. Connect to the internet and click **Check Now**. |
| **The clock is behind: set the correct time** | The computer's clock was set back. Correct it. |

Below the status, the section shows:

- **Contacting the licensing service…** while the plugin starts the trial, renews, activates or deactivates. When that
  fails, the section shows why, such as **This license key does not exist**.
  [Status messages](https://help.tangerina.io/deformable/v0.2.0/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: it starts the
  trial or renews the license.
- **Buy License** while no key is active. It opens the pricing on
  [tangerina.io/deformable](https://tangerina.io/deformable#pricing).

The Maya plugin is always allowed online. Maya has no setting that keeps a plugin offline, so the plugin has none
either: it contacts our licensing service when it loads in Maya's window and whenever the license needs it, and only
then.

The trial and the license belong to the computer, not to the plugin: one Standard license covers the Blender plugin
and the Maya plugin, and the C, Rust and Python SDKs, on the same computer. A license activated in the Blender 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 plans, prices
and the buying steps are on [Licensing](https://help.tangerina.io/deformable/v0.2.0/licensing/).

## The trial

The trial starts the first time Deformable runs on the computer, in a plugin or in an SDK. The computer must be
online that one time: the plugin asks our licensing service to start the trial when Maya loads it. After that, the
trial also works offline.

During the trial, every feature works, and a Deformable Scene can hold up to 2,500 tetrahedrons. Every object in it
counts, floors included, but an object that is disabled: it takes no part in the simulation. Each create action names
its object with its count and the scene's total, disabled objects included, such as
**Deformable: Made pPlane1: 6 tetrahedrons; scene total 198**.

A bigger Deformable Scene says so, as a warning, when a create action makes it too big, at the start frame and when
you play, such as **Deformable: Made pSphere2: 836 tetrahedrons; scene total 3,120. Trial limit: the scene simulates
3,120 tetrahedrons; the trial allows 2,500**. When you play it, the plugin stops the playback and shows the limit in a
dialog, with **Buy License**, **Preferences** and **Close**. The objects that do not fit stay still, and the rest of
the scene runs. To simulate the whole scene, use fewer tetrahedrons, for example with a lower **Target Face Count** on
the object's Deformable Autocage or a simpler cage, split the objects between two Deformable Scenes, or buy a license.
See [Use fewer tetrahedrons](https://help.tangerina.io/deformable/v0.2.0/user-guides/engine/preparing-meshes/#use-fewer-tetrahedrons).

On day 8, the status shows **Standard trial ended — Buy license**, and the tools and the simulation stop: each tool node
shows the same message as its error. Reinstalling the plugin does not restart the trial: the start is kept in your user
folder, outside the plugin, which a reinstall leaves alone.

## Buy a license

Click **Buy License** in the Deformable Preferences window. Your browser opens the pricing on
[tangerina.io/deformable](https://tangerina.io/deformable#pricing). Click **Buy license** there to open the payment
page. After you pay, you get your license key by email.

The Standard license is $99 one time (USD), 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. Choose **Deformable Help > License…**.
2. Paste your license key into the key field of the **License** section.
3. Make sure the computer is online, and click **Activate**.

The section 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 section
shows why, such as **This license is active on another device: deactivate it there or remove that device in the license
portal**. With an empty field, **Activate** says **Paste the license key from the email first**.

The tools that the license refused before compute again by themselves.

After that, the plugin works offline between renewals. While you use it on a computer that is online, it renews the
license quietly, a few times a day at most, and checks each time Maya loads it. Each renewal lets it run about 7 days
offline. When it was not used for longer than that, the first tool or simulation step renews the license first. After
about 7 days offline, it shows **Go online once to renew the Standard license** and the tools stop until you connect and
click **Check Now**.

## Deactivate a license

A Standard license is 1 seat: one computer. A second computer needs the license moved to it, or a second license. To
move it to another computer, deactivate it on this one first:

1. Choose **Deformable Help > License…**.
2. Make sure the computer is online, and click **Deactivate**.
3. On the new computer, install the plugin, then
   [activate](https://help.tangerina.io/deformable/v0.2.0/user-guides/maya/license-and-preferences/#activate-a-license) the same key.

![The same license key moving from the old computer, where it is deactivated first, to the new computer, where it is activated.](https://help.tangerina.io/deformable/v0.2.0/images/license-move-to-new-computer.svg)

Deactivating here also deactivates the Blender plugin and the SDKs on this computer. Offline, the plugin keeps the
license and shows **Go online to deactivate, or remove this device in the license portal**.

If you no longer have the old computer, remove it in the license portal instead. The link is in the FAQ at
[tangerina.io/deformable](https://tangerina.io/deformable#faq). Lost keys and refunds are on
[Licensing](https://help.tangerina.io/deformable/v0.2.0/licensing/).

## Preferences

The **Settings** section of the window holds:

| 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. |
| Frame Cache Limit | 2 GB per scene | The memory each Deformable Scene keeps its simulated frames in. Past it, new frames are not kept. See [Frame Cache Limit](https://help.tangerina.io/deformable/v0.2.0/user-guides/maya/playback-and-baking/#frame-cache-limit). |

Maya keeps them in your preferences, between sessions.

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: pSphere1: 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.2.0/user-guides/maya/creating-objects/#verify-mesh).

With the preference off, the create actions do not check the object's transform either. An object with a mirrored or
flat transform, such as a negative scale, is then left out of the simulation, and Play names it with **its scale is
negative or zero**. See
[Mesh checks before creating](https://help.tangerina.io/deformable/v0.2.0/user-guides/maya/creating-objects/#mesh-checks-before-creating).

## Help

The bottom of the window has two buttons:

- **Documentation** opens this user guide in your browser.
- **Copy Support Info** copies the Maya 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
  says **Copied the support info: paste it into your email**.

The **Deformable Help** menu has the same and more:

| Item | What it does |
|---|---|
| User Guide | Opens this user guide. |
| Scripting Reference | Opens [Command line and scripting](https://help.tangerina.io/deformable/v0.2.0/user-guides/maya/command-line-and-scripting/). |
| Copy Support Info | As the button above. In `mayapy`, it prints the lines instead. |
| About Deformable | Shows the plugin, library and Maya versions and the system. |
| License… | Opens the Deformable Preferences window. |

The pages of this guide also open from the plugin's windows: an option window's **Help** menu opens the page of its
action, and the Attribute Editor's **Help** menu, on a Deformable node, opens the page of its node type.

## Update the plugin

To install a new version:

1. Download the `.zip` file for your system from [tangerina.io/deformable](https://tangerina.io/deformable#download).
2. Quit Maya.
3. In your modules folder, delete `deformable.mod` and the `deformable` folder, and unzip the new version in their
   place, as in [Install the plugin](https://help.tangerina.io/deformable/v0.2.0/user-guides/maya/getting-started/#install-the-plugin). On a Mac, clear
   the download's mark again.
4. Start Maya. The plugin loads by itself while **Auto load** is on.

A running Maya keeps the version it loaded, so always quit Maya first. The plugin rebuilds its shelf each time it
loads, so the shelf always matches the version.

To remove the plugin, choose **File > New Scene**, turn off **Loaded** and **Auto load** in **Windows >
Settings/Preferences > Plug-in Manager**, quit Maya, and delete `deformable.mod` and the `deformable` folder. Your trial
or license stays on the computer.
