You are viewing the documentation for Deformable v0.3.1, an older version. Read the latest, v0.9.0
Blender Plugin
Troubleshooting
Where the Blender plugin shows its messages, what each status-bar line, warning and node error means, and the Blender steps that fix them.
On this page
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.
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. |
| 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. An object whose Deformable Object node has any other error is left out too. See A node shows an error.
- Is it over the Free license’s limit? The status bar says Deformable: Free license: the scene would simulate 3,120 tetrahedrons; the limit is 2,500 per scene, and the nodes of the objects that do not fit show the limit, such as Free license: this would simulate 3,120 tetrahedrons; the limit is 2,500 per scene. See The Free license.
- 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. 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.
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.
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.
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. 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 _ 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. |
| 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.
An object held still by the Free license’s limit simulates again by itself once Check Now or Activate succeeds. See 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.
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.
Get help
If you are stuck, email support@tangerina.io. To report a bug, include what 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.