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:
Open Installations - Navigate to the "Installations" tab in the launcher interface.
Select a profile - Locate the launch profile for which you want to set the Java executable.
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.
Show more options - Click on "More Options" to expand it and reveal additional settings.
Set Java executable - Locate the field labelled "Java executable" within the "More Options" section and paste the path of
javaw.execorresponding to your Java installation into the field.
Creating Scripts
- Raven scripts are coded in Java, which means your code must be in a
.javafile. - 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.