Skip to content
raeleus edited this page Dec 21, 2023 · 3 revisions

GDX Particle Editor

GDX Particle Editor is the modernized replacement for the official libGDX Particle Editor. The main goals are to enable M1 Mac capability, improve the workflow and attractiveness, and not require a special runtime to render the particle effects. All particles created with GDX Particle Editor are fully compatible with the base libGDX particle API.

What is a particle effect?

The particle effect system in libGDX uses a combination of sprites, OpenGL, and a basic physics model to create visual effects to be used in your games. These can range from flames and fireworks to cinematic rain drops and smoke.

How to run GDX Particle Editor

GDX Particle Editor is a JAR executable file. Download the latest version here.

  • Ensure that you have the latest version of Java installed on your computer. See the Bellsoft JDK.
  • From the commandline, you can call java -jar gdx-particle-editor.jar.
  • Alternatively, you may double click the jar file if you have your JAVA_HOME variable set correctly in your system settings.

Mac users may have difficulty saving/opening files because of security settings in the OS. If you are getting an error message "operation not permitted", please try the following:

  • Open the /usr/bin folder in Finder.
  • Locate java.
  • Open System Preferences >> Security & Privacy >> Full Disk Access.
  • Drag java from the Finder window and drop it on the App list.
  • See the Stackoverflow solution for more details.

How to create a particle effect

Particle effects are comprised of images and rules that dictate the behavior of the particle effect.

Creating your first particle

See the introductory wiki article on the particle editor.

Particles In-Depth

For a more thorough overview, see the In-Depth Guide to learn all the aspects of GDX Particle Editor