There are two ways to install Chunky. You may download the installer for your OS1, or you may download the Universal JAR (Chunky Launcher).
Universal JAR - Chunky Launcher
You must install Java 17 for your platform.
Download the OpenJFX 17.0.1 |LTS| x64 SDK and extract the
Download the Universal JAR / Chunky Launcher (ChunkyLauncher.jar) and keep it in a safe place (you will use this to start Chunky).
Launch ChunkyLauncher.jar. You may need to launch via command line/script using
java -jar path\to\ChunkyLauncher.jar --launcher.
Chunky First-Time Setup
The first time you start Chunky, you will be asked to pick a settings directory for Chunky:
The recommended directory is usually the best option. Click "Use Selected Directory" to continue.
Next, you will see the Chunky Launcher:
If you downloaded the Universal JAR (only Chunky Launcher) then you will have to update Chunky, otherwise can click "Launch" to start Chunky.
In the launcher, hitting the "Check for Update" button will make the launcher check for an update to Chunky online. This must be done the first time you start Chunky if you only downloaded the launcher.
If an update to Chunky was is available you will soon see the "Update Available!" window:
Click the "Update to New Version" button to start downloading the required files. When the download process has completed you can either click on "Launch Chunky" or "Close". If you click on "Close" you would need to click on "Launch" in the main Chunky Launcher window to launch Chunky.
By default, the launcher will download stable releases of Chunky. If you want to get the latest features and bug fixes (and maybe some new bugs or incomplete features), you can enable the "Download snapshots" option in the "Advanced Settings" panel. The next time you check for updates, the launcher will download the latest Chunky snapshot.
The snapshots are automatically built every day from the master branch. Some plugins may not work with Chunky snapshots while some plugins may even require a certain snapshot (or later versions).
If the launcher does not download the latest version or new snapshots, check the "Update Site" in the "Advanced Settings" panel. The URL changed with Chunky 2.1, so make sure it is set to
https://chunkyupdate.lemaik.de/. If you have used Chunky 1.x, it may still be set to llbit's update site. You can keep using that if you want to use Chunky 1.4.52.
If you get an
unchecked exception caused by
java.lang.NoClassDefFoundError: javafx/application/Application when launching Chunky Launcher use
java --module-path path\to\javafx\lib --add-modules javafx.controls,javafx.fxml -jar path\to\ChunkyLauncher.jar to launch Chunky Launcher. If you get this exception when clicking "Launch" in the Chunky Launcher, double check the
Java Options field under
Advanced is populated by
--module-path path\to\javafx\lib --add-modules javafx.controls,javafx.fxml. This field should automatically be populated.