2D Support

Pixel Unit Size

The Pixel Unit Size is a project setting used to convert between PopcornFX units & pixels. The default value is 100, so a billboard of size of width 1 in the PopcornFX Editor will be 100 pixels wide in Godot.

Z-Index & CanvasLayer Management

Because of PopcornFX limitations we hope to remove in the coming versions, Z-Index for particles can only be managed per PKEffect and per PopcornFX "renderer" if the renderer is transparent.
The Z-Index of the PKEffect will be added to the Z-Index of the renderer to make the final Z-Index passed to Godot.
There is currently no way to change the CanvasLayer a PKEmitter2D/PKEmitterControl is added to. We hope to implement a similar per-effect & per-renderer solution quickly.

Per Effect

To change the Z-Index of a PKEffect, click on the .pkfx file in the FileSystem dock in Godot. Go to the Import dock, where you’ll find the Z Index import option.

Per Renderer

Inside the PopcornFX Editor, click on a renderer using a transparent material. The Global Sort Override option under the Transparent category will be passed to the Godot plugin as the Z-Index to use/add to the PKEffect Z-Index.

Mesh Renderers

Because Godot does not support rendering 3D meshes in the 2D renderer with 3D transforms, PopcornFX’s mesh renderers are limited in the same way MultiMeshInstance2D is.
Basically, only transforms that can be represented with a Transform2D can be applied to the meshes. This means that a plane mesh can be rotated perfectly, but meshes with depth will not rotate as expected.

Additionally, there is no depth buffer in Godot’s 2D renderer. Hence 3D meshes with textures may have rendering issues as the vertices aren’t sorted and some may appear in the wrong order.

Editor & Play Differences

Godot only enables the physics server on play, so particle collisions are only available when playing by default.
The PopcornFX sound renderers also only work in play mode, though this may change in the future.