Part 2: Simba & Runescape 3 (OUTDATED)
Note: The SRL for RS3 is not currently functional and needs to be updated. Once a functioning version is released, this post will be updated.
This post teaches you how to install and properly setup Simba to work with Runescape 3.
Introduction
Simba is the
open source program that we use to write, compile, and run all of the code used in the Runescape scripts found on the forum. This means that if you plan to write your own script or one that has been posted on the site, you will need to make sure Simba is installed correctly as well as the proper include (more on this later) to be able to have the script compile and run. The language used in Simba is called
Lape.
Now that you have a bit of an understanding of Simba, let's get started.
Setting up
Before we jump into it, you should know about the different types of includes that we have on the forums. In the case you do not already know, an include or library is a collection of code that is already written in such a way to allow the programmer to accomplish a specific task with ease by giving the programmer a collection of methods/functions/procedures to use. Below you will find the different types of includes that are available Runescape 3. Each is linked to their development threads or Github pages, as well as some tutorials to help you make up your mind on which one you feel is best for you. For this tutorial, I will show you how to install the Runescape 3
SRL-6 library.
Runescape 3 Includes
Installing Java
- Get the latest 32-Bit version of Java from Oracle's Java Download Page.
- After downloading the installer, run it and install to your computer. It is recommended that you install to the default location since there is a lower possibility that Simba cannot find the Java installation folder.
NOTE: You may be a little confused as to why we are needing to install Java since Runescape does not completely depend on it anymore. The primary reason we do this is that we use a program known as
S.M.A.R.T. which is a virtual environment that runs the Java version of Runescape and allows you to have multiple bots running concurrently. We do this in the case that you want to be able to use S.M.A.R.T. but it is not always necessary.
You can read here for more information about how to run multiple instances without S.M.A.R.T.
How to install/setup Simba for Runescape 3
- Download and install Simba from here.
- Open Simba.exe and select Script->Interpreter->Lape.
- Open up View->Extensions
- A window should appear with a list of red and green extensions. Make sure to enable the following (these lines should be green):
Code:
associate.sex
extension.sex
srl.sex
- Close the window and click on Extentions->Check for Updates.
- Restart Simba when the updates have finished.
- Click on SRL->Check for Updates
- Click on SPS->Check for Updates
- Click on Plugins->Check for Updates
- Restart Simba one last time.
- Paste the following program into Simba:
Simba Code:
program new;
{$define SMART} //If not using SMART, then comment this line out
{$i srl-6/srl.simba}
begin
clearDebug();
setupSRL();
end.
- Compile the program by selecting Script->Compile or by pressing Control Key + F9. After a couple of seconds you should see the output:
Code:
Compiled successfully in XXXX ms.
- Since we now know that there are no errors in the code, we can run it by selecting Script->Run, by pressing F9, or by pressing the Green Play Button
in the tool bar. This will cause SMART to load and will terminate the program. In the debug section in Simba, you should see:
Code:
SRL: Logfile = C:\Simba\Includes\SRL-6/logs/SRL log (XX-XX-XX at XX.XX.X XM).txt
-- setupSRL()
---- Setting up SRL...
---- attempting to spawn smart, attempt #: 1
---- initSmart():
------ Attempting to pair to a previously spawned client
------ smartPairToExistingClient():
-------- Found 1 free client(s), attempting to pair to one...
-------- Failed to pair to SMART[1424]
------ smartPairToExistingClient(): result = false
------ Attempting to spawn a new client..
------ smartCreateClient():
-------- getJavaPath():
---------- Attempting to search for your Java path
---------- Found your java path @ C:\Program Files (x86)\Java\jreX.X.X_XXX\bin\java.exe
-------- getJavaPath()
-------- Root: http://world1.runescape.com/
-------- Params: ,XX,XXXXXXXXXXXXXXXXXXXX
-------- Using plugins "OpenGL32.dll,d3d9.dll"
-------- Succesfully spawned a client, attempting to target
---------- smartSetAsTarget(): Succesfully set SMART[XXXX] as Simba's target
------ smartCreateClient(): result = true
------ Succesfully initialized via spawning a new client
---- initSmart() result = True
---- Waiting up to 5 minutes for RS to load...
------ __setInputBoxes(): Set username and password boxes
---- Client is ready.
---- Setup SRL in XX Seconds
-- setupSRL(): True
-- Succesfully freed SMART[XXXX]
Successfully executed.
NOTE: If you do not wish to have the console window visible, you can disable it by pressing the
Hide/Show Console 
button in the to
In-game Graphics
Congratulations! We are almost done! All we have to do now is worry about making sure our in-game interfaces are setup correctly. Each version of Runescape has to be setup a little differently, so be sure to pay close attention.
- Open up the in-game settings after you have logged in on your account and set Load Layout to Old School.
- Then click on the Settings button and enter the Interface tab.
- Set your Interface Settings to match:
- Click on Graphics and set detail to Low.
Now you are ready to get running with Runescape 3 scripts!