﻿---
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.1.1/user-guides/maya/license-and-preferences/
---

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

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 |
|---|---|
| **Trial: 7 days left** | The trial runs. The number counts down each day, to **Trial: 1 day left**. The next line shows **Trial limit: 2,500 tetrahedrons**. |
| **Trial ended — Buy license** | The 7 days are over. The tools and the simulation stop until you activate a license. |
| **No trial on this device — Buy license** | This computer gives no device id, so it cannot have a trial. A license works. |
| **Licensed** | A license key is active on this computer. There is no limit. |
| **Go online once to start the trial** | The trial has not started yet. Connect to the internet and click **Check Now**. |
| **Go online once to renew the 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.1.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: 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 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 **Licensed** here too. The plans, prices and the buying steps are on [Licensing](https://help.tangerina.io/deformable/v0.1.1/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.1.1/user-guides/engine/preparing-meshes/#use-fewer-tetrahedrons).

On day 8, the status shows **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 **Licensed**, 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 license** and the tools stop until you connect and click
**Check Now**.

## Deactivate a license

A 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.1.1/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.1.1/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.1.1/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.1.1/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.1.1/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.1.1/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.1.1/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.1.1/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.
