Learn the basics!

Graphical Interface

Alchemist is equipped with a Java graphical interface, and here is how to use it.

Starting Alchemist in graphical mode


  • A working graphical environment
  • Java 8 with OpenJFX 8, Java 11, or a later Java version. Java 9 and Java 10 are not supported, although the Java 8 version of Alchemist might work, if OpenJFX or another JavaFX library is correctly installed

Download and installation

Alchemist does not require any installation procedure. It can be rerieved via Gradle or in the form of a runnable JAR file.


Retrieving Alchemist via Gradle is preferable and it can be done by cloning the empty project for Alchemist that is stored here using the command: git clone https://github.com/AlchemistSimulator/Empty-Alchemist-project-using-Gradle.git (or git clone git@github.com:AlchemistSimulator/Empty-Alchemist-project-using-Gradle.git, if you want to use SSH) in a Command Line Interface.

Then, you will be able to import the project inside Eclipse or IntelliJ IDEA and start the graphical interface from a Commang Line Interface using the Gradle Wrapper with the command gradlew.bat if you are on Windows, or ./gradlew if you are on *nix (Linux, MacOS, FreeBSD, Solaris).

For further information, you can find more specific tutorials here.


You can get Alchemist in the form of a runnable jar file, that can be retrieved from the Alchemist release page on Github. The file name should match alchemist-redist-VERSION.jar where VERSION is a SemVer version.

Once downloaded, if your Java environment is correctly setup, you should be able to launch it the same way you open any file (classically in most environments, by double clicking it). If Alchemist does not start this way, you can fall back to using a terminal.


The graphical interface that pops up when Alchemist is executed providing a YAML file on the command line is a stripped-down version of the one that shows when the simulator is invoked by java -jar or by double clicking.

In order to use such interface, consider the following command list:

Key bindingActiveEffect
Lalways(En/Dis)ables the painting of links between nodes
Malways(En/Dis)ables the painting of a marker on the closest node
Mouse panin normal modeMoves around
Mouse wheelin normal modeZooms in/out
Double clickin normal modeOpens a frame with the closest node information
Right clickin normal modeEnters screen rotation mode
PalwaysPlays/pauses the simulation
RalwaysEnables the real-time mode
Left arrowalwaysSpeeds the simulation down (more calls to the graphics)
Right arrowalwaysSpeeds the simulation up (less calls to the graphics)
SalwaysEnters / exits the select mode (nodes can be selected with the mouse)
Oin select modeSelected nodes can be moved by drag and drop
Ein select modeEnters edit mode (to manually change node contents)