Skip to content

Setup

Installing the Java Development Kit

WARNING

You must install the Java Development Kit to create and use scripts!

A Java Runtime Environment (JRE) can run Java applications but does not include the tools required to compile Java scripts. To compile Java scripts you need a Java Development Kit (JDK).

You may install the Adoptium Java 8 JDK here.


Setting the Java executable

INFO

On Windows, the Java executable is typically located at either:

C:\Program Files\Java\jdk <your-version> \bin\javaw.exe

C:\Program Files\Eclipse Adoptium\jdk <your-version> \bin\javaw.exe

To configure the Java executable in the default Minecraft Launcher, follow these steps:

  1. Open Installations - Navigate to the "Installations" tab in the launcher interface.

  2. Select a profile - Locate the launch profile for which you want to set the Java executable.

  3. Edit the profile - On the right-hand side of the launch profile, click the button faced with three dots and select "Edit" from the drop-down menu.

  4. Show more options - Click on "More Options" to expand it and reveal additional settings.

  5. Set Java executable - Locate the field labelled "Java executable" within the "More Options" section and paste the path of javaw.exe corresponding to your Java installation into the field.


Creating Scripts

  • Raven scripts are coded in Java, which means your code must be in a .java file.
  • The recommended approach is to utilise a code editor, such as Brackets or Visual Studio Code.
  • All scripts must be in the scripts folder in order to be used. If the file name begins with an underscore, it will not be recognised as a valid script file.

Using Scripts

  • The GUI has a category labelled Scripts. All scripts in your scripts folder will be displayed here.
  • To add scripts, click Open Folder within the Manager module and drag your scripts into the folder.
  • Whenever you introduce a new script or make modifications to an existing one, press the Load Scripts button to apply the changes.
  • If there is an error within a script, it will appear in red and cannot be enabled. An error message will be displayed in the chat window with details about the encountered issue.