Tutorial Setting up Eclipse Kepler for RuneMate

Installing Eclipse Kepler
Download "Eclipse IDE for Java Developers" and extract the archive to wherever you want. (image)

Installing the SVN plugin
Open Eclipse and edit your preferences, such as line numbering, save actions, automated formatting, etcetera.
Next, go to the Subversive website and drag the installation icon into Eclipse. The following screen will pop up: image, accept and continue everything and Eclipse will restart.

Creating a Java Project for RuneMate
Open the File menu and select New -> Java Project. Give the project a fitting name and change the location of the project if you want to change it. Finish without changing any other settings. (image)

You will now see your newly generated project in the Project Explorer. Download RuneMate and re-name the file to RuneMate.jar, then drag this jar onto the title of your project and select to copy the file (instead of linking to it).
Also create a file called Launch.bat, with the following content:

Code (Text):

1. java -jar RuneMate.jar -sdk
2. pause

Do the same for this file and you will now have two more files in your project's directory. (image)

Now there's two more things to do to get RuneMate running with Eclipse; first you will need to add RuneMate as a library. Right-click your project and select Properties. Go to the Java Build Path submenu and then select the Libraries tab. Click "Add JARs..." (not external jars!) and select RuneMate.jar, then press OK to save your changes.

Next open the Run menu and from the External Tools submenu, select External Tools Configurations (image). Create a new Program and call it RuneMate. The location should be your batch file (use the Browse Workspace button) and your working directory should be your project (use the Browse Workspace button). Apply changes and run. (image)

Having RuneMate run as external application will allow RuneMate to continue running after closing Eclipse, which would be a useful trait.

Linking the Javadocs to your project
Go back to the Libraries tab and expand RuneMate.jar. The Javadoc location has not yet been set, so we're going to do that now. (image) Click Edit and enter RuneMate's Javadoc url. Save your changes. (image)

Linking your project using Subversive
The final step to make the uploading of scripts bots as easy as possible. Right-click your project and select Team -> Share Project (not Share Projects), select SVN as versioning system and install the latest SVN kit (at my time of writing, 1.8.3). Eclipse will restart and you will have to click Share Project again, this time you will be asked to fill in a few details, which you can find here.

Enter your project url and fill in your credentials. It is perfectly safe to save your credentials. (image, image)
Click next and make sure to enter Simple Mode, then make sure the URL is the exact URL indicated by RuneMate! (image)

Finalizing Subversive
You do not want all files to be synchronized with RuneMate's repository, so you will be wanting to set Subversive to exclude certain files and/or directories. To get started go to the Window menu and from the Show View submenu, show the Navigator. (image)

You want to ignore all folders and files except source folders. Most of the times, "src" will be your only source folder. However, as my project is linked to a different project, I also have a source folder called "SJBijzitter". For all files you wish to ignore, right-click and select Team -> Add to svn:ignore. If the option to ignore a specific file is greyed out, it means Eclipse will be handling that file for you and you should not worry about it.

Go back to the Package Explorer and right-click your project. Select Team -> Commit and everything should work out. If an error is shown saying your project is outdated, select Team -> Update and then commit.

Updating RuneMate
If RuneMate updates, of course you'll need to let Eclipse know about it! Simply download the new RuneMate client and rename it to RuneMate.jar, then drag it onto your project and Eclipse will ask you if you want to overwrite the current file called RuneMate.jar, select yes and you're all done!

 

Wasn't aware that this is now required, I initially wrote this guide for Beta 3.
Thread updated!