How to Build Runelite in IntelliJ IDEA

Introduction: Welcome to Sly Automation! In this step-by-step build runelite guide, we will walk you through the process of building Runelite in IntelliJ IDEA. Runelite is a customizable client for the popular online game RuneScape, and IntelliJ IDEA is an integrated development environment (IDE) and virtual environment for Java. By following the instructions in this guide, you’ll be able to set up RuneLight on your local machine and even add custom plugins. Let’s get started!

Step 1: Download JDK 11

The first step is to download JDK 11, which is the Oracle platform for the Java programming language. Here’s how to do it:

  1. Open your web browser and search for “JDK 11 download” on Google.

Link to JDK 11 =

  1. Locate the archive downloads on the official Oracle website.
  2. If you’re using Windows, choose the Windows download link. For Runelite it needs to be the jdk 11 version.
  1. Download the installer and run the executable file. You may need to create an account its free! Providing your username or creating a new account if necessary. Sign in then the download file will be able to be downloaded.
  1. Follow the installation wizard and select the default prompts.

Step 2: Download and Install IntelliJ IDEA

Next, you need to download and install IntelliJ IDEA, the IDE we’ll be using for building Runelite. Here’s what you should do:

Accessing the Community Version

  1. Download from Official JetBrains Website: Visit the JetBrains official website to access the Community Version download page for IntelliJ IDEA. The website provides the latest stable release for various operating systems.

Link to Jetbrains:

The free community edition is located scrolling down past the Ultimate version:

For this particular guide i’ll be going through the steps for windows:

  1. Selecting the Suitable Version: Ensure you choose the version compatible with your operating system (Windows, macOS, or Linux). The Community Version offers a robust set of features for Java development and is ideal for most projects.

Installation Procedure

  1. Initiate the Download: Click on the download link provided on the website to begin downloading the installation file for IntelliJ IDEA Community Edition.
  1. Run the Installation Package: Once the download is complete, locate the downloaded installation package (.exe for Windows, .dmg for macOS, or .tar.gz for Linux) and run it to begin the installation process.
  2. Follow Setup Wizard: The installation wizard will guide you through the setup process. Follow the on-screen prompts to configure the installation preferences, such as installation location and additional settings as needed.
  1. Select Components: During installation, you might be prompted to select optional components or configurations. Ensure to select components relevant to your development needs. The selected ones below are needed:

Anything else besides the default settings are fine and should cause no issues going forward.

  1. Agree to Terms and Conditions: Review and accept the terms and conditions presented during the installation process to proceed further.
  2. Completing Installation: Once the installation completes, verify if IntelliJ IDEA launches automatically. If not, locate the IntelliJ IDEA icon in your applications folder or desktop and open the IDE.

Post-Installation Configuration (Optional)

  1. Initial Setup: Upon launching IntelliJ IDEA for the first time, you might be prompted to perform initial setup configurations, such as setting up a JetBrains account or importing settings from a previous installation.
  2. Plugin Installation: Explore the available plugins within IntelliJ IDEA’s marketplace that can further enhance your development environment based on your specific requirements. Install plugins to extend the functionality of the IDE.

Step 3: Import the Runelite Project

Importing the Project

  1. Accessing the Runelite GitHub Repository:
    • Navigate to the RuneLite GitHub repository.
    • Clone or download the repository link provided in the tutorial.

Now that you have the necessary tools set up, let’s import the RuneLight project into IntelliJ IDEA. To initiate this setup, access the official RuneLite GitHub repository. This repository hosts the source code and essential files required for the RuneLite client.

Use this link:

Once you’ve reached the repository, clone or download the project by copying the repository URL.

Opening IntelliJ IDEA

Open and launch the newly installed IntelliJ IDEA on your system. With IntelliJ IDEA launched on your system, create or open a new project where the RuneLite repository will be imported.

Importing RuneLite into IntelliJ IDEA

Within IntelliJ IDEA, choose the option to import a project from version control. Select the Git option and input the URL obtained from the GitHub repository.

Follow the prompts to complete the import process, allowing IntelliJ IDEA to fetch the RuneLite project and establish its structural layout.

Your project should look like this:

Configuring Maven for RuneLite build

Maven serves as a robust build automation tool within IntelliJ IDEA, handling dependencies and orchestrating the project’s build process seamlessly. RuneLite relies on Maven as its primary build tool, serving a crucial role in managing dependencies, generating resources, conducting tests, and facilitating various essential functions necessary for a comprehensive build, run, and deployment process of the RuneLite application.

When launching RuneLite, the initial step involves engaging with Maven. Within the IntelliJ IDEA environment, Maven is accessible through a designated interface often positioned on the right-hand side of the screen. This interface resembles the following:

Locate the RuneLite project listed within the Maven tool window. Expand the project to reveal the available lifecycle options. Right-click on the ‘install’ lifecycle and choose ‘Run Maven Build.’

Maven will commence the ‘install’ lifecycle, initiating the compilation process, resolving dependencies, and setting up the necessary project configurations. This phase is crucial for compiling the RuneLite code and ensuring that all essential dependencies are in place.

You can view the progress of the code compiling building all the plugins and installing all the dependencies at the bottom of the app.

Build Runelite: Verification and Troubleshooting

Throughout the Maven build process, vigilantly monitor the IntelliJ IDEA console for any errors or warnings. Address any encountered issues promptly to ensure a smooth configuration process.

Verify the successful completion of the Maven ‘install’ lifecycle. Ensure that there are no critical errors and that all dependencies have been resolved accurately. This step guarantees that the project structure is correctly established and ready for further development or customization.

A successful build should have ‘BUILD SUCCESS’ in the description once completed.

In case of incomplete setup or errors during the Maven build, consider rerunning the ‘install’ lifecycle. Check for potential factors such as incorrect SDK settings or internet connectivity issues that might impede the Maven build process. This can occur if the runelite repo is down and fails to connect.

Common Issues: Ensure SDK 11 is Used in Project

Using the top banner, navigate to File then Projecture Structure and ensure SDK is using the Oracle 11 that we just installed earlier, use the drop down to select the 11.0 version.

There’s also a new feature which allows you to download a specifc version.

Redo the Maven configuration install steps.

By diligently following these steps and confirming each stage’s success, you can effectively set up RuneLite in IntelliJ IDEA, leveraging Maven’s capabilities to manage dependencies and create a stable environment for RuneScape plugin development.

Step 5: Run the Runelite Project

Once you’ve configured RuneLite in IntelliJ IDEA, it’s time to dive into its functionalities. Follow these steps:

‘Build Project’ action, the green hammer located in the top right of the page:

  1. Locate the RuneLite Directory: In the project structure, use the project explorer section and find the “Runelite” directory.
  1. Navigate to the Runelite Project: Go to “runelite-client” -> “src” -> “main” -> “java.”
  1. Launch RuneLite: Right-click on the “runelite” package and select “Run ‘Runelite.'” Wait for the build process to complete and for the RuneLite client to open.

Once the Run option has bee actioned, the runelite client will now load and connect to Runescape servers and validate the runelite build.

Error on loading the runelite client

If the client fails to load or the window is transparent and not displaying the runescape login, then follow these steps:

Update the runelite project by clicking on the blue arrow in the top right of the page.

Cannot find symbol ComponentID

If an error comes up or similar try the ‘Build Project’ action, the green hammer located in the top right of the page:

Run the clean install process located under Lifecycle

Redo the Maven configuration install steps.

If there are still errors, there could be ongoing development going on with the runelite developers, this can be found if any errors should up in the java files.

You may need to wait or get updates in the discord group:

As an example the below snapshot; this build has issues with the file and ComponentID not registering.

Runelite Client Load Successful

On a successful load the runescape login page will show!

Enhancing Functionality: Adding Plugins to RuneLite

To unlock more functionalities within the RuneLite build, you can add custom plugins. Here’s how you can do it:

  1. Find the Plugins Directory: Locate the “plugins” directory in the project structure.
  2. Download and Prepare Plugins: Ensure compatibility with your RuneLite version, download the desired plugin, and extract its files.
  3. Insert the Plugin: Copy the main folder of the plugin and navigate to “runelite-client” -> “src” -> “main” -> “java” -> “net.runelite.client.plugins.” Paste the plugin folder into the “plugins” directory.
  4. Verification and Reinstallation: Check that the plugin is correctly placed and doesn’t contain any unnecessary Kotlin files. Reinstall the RuneLite project by right-clicking, selecting “install,” and running the Maven build.


Congratulations! You’ve successfully built RuneLite in IntelliJ IDEA by following this comprehensive guide. Now, delve into its capabilities and explore the vast array of functionalities it offers.

This step-by-step tutorial ensures a seamless setup of RuneLite in IntelliJ IDEA, empowering you to navigate its features effortlessly while expanding its potential through custom plugins. Dive in and enjoy the enhanced RuneLite experience tailored to your preferences!

3 thoughts on “How to Build Runelite in IntelliJ IDEA

Leave a Reply

Your email address will not be published. Required fields are marked *