﻿---
title: Troubleshooting
description: Where the Blender plugin shows its messages, what each status-bar line, warning and node error means, and the Blender steps that fix them.
url: https://help.tangerina.io/deformable/v0.1.0/user-guides/blender/troubleshooting/
---

# Troubleshooting – Blender Plugin – Deformable v0.1.0

Most problems show a message: in the status bar at the bottom of the window, as a warning after an action, or on a
node in the Geometry Node Editor. Start there. This page lists the Blender plugin's messages and the Blender steps that
fix them. What to check for each symptom, such as objects that pass through each other or a simulation that is slow,
is on [Troubleshooting](https://help.tangerina.io/deformable/v0.1.0/user-guides/engine/troubleshooting/).

Each new message of a node or of the status bar also goes, once, to Blender's Info log (the **Info** editor, in the
**Scripting** workspace) and to the terminal Blender runs in, such as
**Deformable: Sphere: Deformable Tetrahedralize: INVALID_CAGE: …** for a node, or
**Deformable: Scene: Play from the start frame** for the status bar. A playback that loops reports each one once.
So the log shows what went wrong even when the node is out of sight, and a render on another computer prints it.

## Nothing moves when I play

Look at the status bar at the start frame:

| Status bar | Fix |
|---|---|
| **Deformable: No Deformable Scene: choose Object > Deformable > Create Scene** | Nothing simulates without a Deformable Scene. Choose **Object > Deformable > Create Scene**. |
| **Deformable: Add to a Deformable Scene's Objects collection to simulate: Cube** | Every Deformable Scene has an **Objects** collection, and the named objects, five at most, are in none of them. Add them to one, or empty the Objects of one scene so it takes them. See [More than one Deformable Scene](https://help.tangerina.io/deformable/v0.1.0/user-guides/blender/how-the-plugin-works/#more-than-one-deformable-scene). |
| **Deformable: Play from the start frame** | Press **Shift+Left Arrow**, then **Space**. |
| **Deformable: Set Playback > Sync to Play Every Frame: a dropped frame is never simulated** | Playback may skip frames to keep up, and a skipped frame is not simulated. In the Timeline, open **Playback** and set **Sync** to **Play Every Frame**. Then play again from the start frame. A scene that plays its bake does not ask. |
| **Deformable: Return to the start frame to apply changes** | A setting changed during play. Go to the start frame and play again. |
| **Deformable: A substep would be longer than 0.04 s: raise Substeps** | Raise **Substeps** on the Deformable Scene: 2 or more at 24 frames per second. |

Then check these:

- **Is a tool still running?** The status bar lists running tools and how long each has run, such as
  **Deformable: Tetrahedralize (Sphere) 0:42**. Wait for them, or click **Cancel**. A node that shows **Waiting** has
  **Run** set to **Wait**, and one that shows **Cancelled** waits for a change: choose **Object > Deformable > Update
  Now**. The tools of an object with modifiers above its Deformable modifier update at the start frame: after a
  change at another frame, go to the start frame, or choose **Object > Deformable > Simulate Frame Range**.
- **Is the object held?** Check its Object panel: **Type** must be **Dynamic** and **Disabled** off. Check **Disable**
  on the Deformable Scene, and its keyframes.
- **Does the status bar say Left out of the simulation?** See
  [An object stays still at Play](https://help.tangerina.io/deformable/v0.1.0/user-guides/blender/troubleshooting/#an-object-stays-still-at-play).
  An object whose Deformable Object node has any other error is left out too. See
  [A node shows an error](https://help.tangerina.io/deformable/v0.1.0/user-guides/blender/troubleshooting/#a-node-shows-an-error).
- **Is it in the trial and too big?** The status bar says
  **Deformable: Trial limit: the scene simulates 3,120 tetrahedrons; the trial allows 2,500**, and the nodes of the
  objects that do not fit show the limit, such as **Trial limit: this would simulate 3,120 tetrahedrons; the trial
  allows 2,500**. See [The trial](https://help.tangerina.io/deformable/v0.1.0/user-guides/blender/license-and-preferences/#the-trial).
- **Did you delete its bake with Blender's own button?** The plugin cannot see that **Delete Bake** on the modifier
  removed a bake stored in the file, so it plays a bake that is gone instead of simulating. Choose **Object >
  Deformable > Free Simulation**, then play from the start frame.

## An object stays still at Play

At Play the status bar names each object left out, from every Deformable Scene, and says why, such as
**Deformable: Left out of the simulation: Bolt (its tetrahedrons are too small). See Troubleshooting.**, and its
Deformable Object node shows the fix. Each reason and its fix are on
[An object stays still at Play](https://help.tangerina.io/deformable/v0.1.0/user-guides/engine/troubleshooting/#an-object-stays-still-at-play).
In Blender:

- **its scale is negative or zero:** apply the scale with **Object > Apply > Scale**, or set it positive.
- **it has inside-out tetrahedrons:** lower **Thickness** on the Extrude panel.
- **its Deformable Object node says why:** see
  [A node shows an error](https://help.tangerina.io/deformable/v0.1.0/user-guides/blender/troubleshooting/#a-node-shows-an-error).

For tetrahedrons that are too small:

- **Use an autocage with fewer faces.** Choose **Create Object with Autocage**, and lower **Target Face Count** in
  the **Adjust Last Operation** panel, such as to 50 or 20. On an object that has an autocage already, change **Target
  Face Count** on its Autocage panel. Then play from the start frame.
- **Simplify the mesh.** Add a **Decimate** modifier, such as **Collapse** with **Ratio** 0.1, apply it, then create
  the object.

## The create action refuses my mesh

A create action checks each mesh first and names its problems:

| Warning | Fix |
|---|---|
| **Not verified: `<mesh>`: non closed boundary (12)** | The mesh has holes. Fill them, or use **Create Object with Autocage** with the preference off. |
| **Not verified: `<mesh>`: co located vertices (2)** | Vertices sit on top of each other. In Edit Mode, choose **Mesh > Clean Up > Merge by Distance**. |
| **Not verified: `<mesh>`: non planar (104)** | Some polygons are bent. Choose **Face > Triangulate Faces**. |
| **Not verified: `<mesh>`: the world matrix is mirrored or flat (determinant ≤ 0)** | The object has a negative or zero scale. Choose **Object > Apply > Scale**, or set the scale positive. |
| **Span Layers needs triangles: triangulate the mesh (Face > Triangulate Faces) before you copy it** | A layer has a face that is not a triangle. Choose **Face > Triangulate Faces** on the first mesh, delete the copy, copy the first mesh again with **Shift+D** and redo your change to the copy. |
| **Span Layers needs two meshes with the same vertices and faces, such as a mesh and a moved copy of it** | The second mesh is not a copy of the first. Triangulate the first mesh, delete the second, copy the first again with **Shift+D** and redo your change to the copy. |

To see every problem selected in Edit Mode, run **Object > Deformable > Verify Mesh**. See
[Verify Mesh](https://help.tangerina.io/deformable/v0.1.0/user-guides/blender/creating-objects/#verify-mesh).

For a model that is not meant to be closed, such as a character with separate eyes, wrap it in an autocage and turn
off **Verify Meshes Before Creating Objects**. See
[Preferences](https://help.tangerina.io/deformable/v0.1.0/user-guides/blender/license-and-preferences/#preferences).

An action that is greyed out says why when you hover it, such as **Select one or more deformable objects** or
**Switch to Object Mode**.

## A node shows an error

A node with an error shows it on the node, in the Geometry Node Editor, and its output is empty, so the object may
show nothing. The Info log and the terminal name the object and the node, as
**Deformable: `<object>`: `<node>`: `<message>`**. Nodes after it may show an error too: fix the first one in the
chain. The errors of the tools themselves are on
[A tool shows an error](https://help.tangerina.io/deformable/v0.1.0/user-guides/engine/troubleshooting/#a-tool-shows-an-error). The errors that come
from the node tree:

| Message | Where | Fix |
|---|---|---|
| **Span Layers needs triangle meshes** | Deformable Span Layers | A layer has a face that is not a triangle. Choose **Face > Triangulate Faces** on the first mesh, delete the copy and copy the first mesh again with **Shift+D**. |
| **The Tetrahedral Mesh input must be a tetrahedral mesh** | Deformable Object | The mesh is not 4 triangles per tetrahedron. Use **From Tetrahedral Mesh** only on an `_extracted_tetrahedral_mesh` mesh. |
| **Deformable Prepare: EMPTY_MESH: rest mesh has no tetrahedrons** | Deformable Object | A tool before it failed. Fix the first error in the chain. |
| **Tetrahedrons too small for the simulation: …**, **Flat tetrahedrons, …**, **Inside-out tetrahedrons, …**, **Three tetrahedrons share one face, …**, **No tetrahedrons to simulate: …** | Deformable Object | Play left the object out. The message names the fix. See [An object stays still at Play](https://help.tangerina.io/deformable/v0.1.0/user-guides/blender/troubleshooting/#an-object-stays-still-at-play). |
| **Prepared Surface Mesh must come from Deformable Prepare** | Deformable Object | Link the Prepared Surface Mesh input from a Deformable Prepare node, or unlink it for a bare object. |
| **Material must come from Deformable Material** | Deformable Object | Link the Material input from a Deformable Material node, or unlink it for the default material. |
| **Deformable Prepare and Deformable Object take different tetrahedrons** | Deformable Object | Feed both nodes' Tetrahedral Mesh inputs from the same node. |
| **The object already has a Deformable Object node; this one is ignored** | Deformable Object | Keep one Deformable Object node per object. |
| **Image Library is Custom and no Image is set** | Deformable Splinter | Pick an image in **Image**, or a bundled pattern. |
| **not a material region: `<name>`** | Deformable Object | Remove the object from the Material Regions collection. |
| **not a density region: `<name>`** | Deformable Tetrahedralize | Remove the object from the Density Regions collection. |

A field whose force is not a finite number writes **Deformable: `<scene>`: A field gives a force that is not a finite
number, so it pushes nothing: `<field>`** to the Info log, and that field pushes no vertex on that frame. Check the
field's values and keys. See [Force fields](https://help.tangerina.io/deformable/v0.1.0/user-guides/blender/creating-objects/#force-fields).

A node refused by the license computes again by itself once **Check Now** or **Activate** succeeds. See
[License status](https://help.tangerina.io/deformable/v0.1.0/user-guides/blender/license-and-preferences/#license-status).

## Raise the floor

To hide the small overlap of a resting object of about 10 cm and more, which rests 2 cm in, move the Kinematic floor
up 2 cm, turn off **Visibility > Renders** in its Object properties, and add a plain plane with **Add > Mesh > Plane**
where its top was, as the floor you render. See
[An object rests a little into the floor](https://help.tangerina.io/deformable/v0.1.0/user-guides/engine/troubleshooting/#an-object-rests-a-little-into-the-floor).

## The render shows the rest shape or the wrong frame

A render that starts where the simulation cannot reach says so in the Info log and in the terminal, such as
**Deformable: Scene: Frame 10 renders Cube without the simulation: render from frame 1, or bake first**. Past the
simulation's end frame, an object baked or simulated up to the end frame holds that frame, so it is not named. See
[Render](https://help.tangerina.io/deformable/v0.1.0/user-guides/blender/playback-and-baking/#render).

## Get help

If you are stuck, email [support@tangerina.io](mailto:support@tangerina.io). To report a bug, include what
[Report a bug](https://help.tangerina.io/deformable/v0.1.0/support/#report-a-bug) lists: the versions, your steps, the messages you see and a small
.blend file.

**Copy Support Info** in the plugin preferences copies the versions and the license status for you: paste them at the
top of your email. See [Help](https://help.tangerina.io/deformable/v0.1.0/user-guides/blender/license-and-preferences/#help).
