Windows Install Manual (Simple)

1. Check to see if you have Java installed on your computer already by clicking here. If not, then click the "Download Java Now" button, or get it manually from the Java Downloads page.
2. After Java has finished downloading to your computer, install it.
3. Download the bot client from our Downloads page.
4. Unzip (extract) botclient.zip to a new folder such as C:\RuneScapeBots\ or some other location on your computer you see fit. You can do this by using the windows extract tool or some other program like WinRAR. (If your system is asking you to overwrite files then you need WinRAR to extract)
5. Click on install-windows.bat. NOTE: Make sure you run in administrator mode (right click and select run as admin).
6. Select the Windows 32bit option for 32 bit processors or the Windows 64bit option for 64 bit processors. Most users will have 32 bit processors.
7. Select the current version of the bot client you want to install.
8. Select the SQLite Universal option.
9. Click the Install button.
10. The bot client is now installed. Double click run.bat to start your bot client! NOTE: If you have 1 GB or less of ram, you may get errors when trying to launch from run.bat . You will need to launch from run-with-cmd-lowram.bat instead.
11. Wait a moment for the bot client to start up. Add your bot's auth code, and continue. (Bot startup delays may happen if the server is overloaded -- just wait)
12. NOTE: Do not press any keys while the bot client is starting up, even if prompted to do so by the cmd window.

Mac Install Manual

This manual is directed toward Mac users. Installation for Linux users is relatively the same with exception to a few filename differences. An intel mac is required to use on Mac OS systems.

1. Download the bot client from here.
2. Create a new folder and name it runescapebots
3. Unzip botclient.zip to the new folder you just made on your desktop.
4. Open the Mac Terminal by going to Applications > Utilities > Terminal.
5. Change to your runescapebots folder by using the cd command (i.e. cd Desktop/runescapebots). For more help on using the Mac Terminal, check out http://macapper.com/2007/03/08/the-terminal-an-introduction/ .
6. Next, in the Terminal type in sudo chmod a+x install-mac-linux.sh followed by your admin password when prompted to set the correct permissions to execute.
7. Type ./install-mac-linux.sh . This will launch the bot installer.
8. Select the MacOSX 64bit option for 64 bit processors or the MacOSX 32bit option for 32 bit processors. Most current Mac users will have 64 bit processors.
9. Select the current version of the bot client you want to install.
10. Select the SQLite Universal option.
11. Click the Install button.
12. The bot installer is now finished. Now type chmod a+x run.sh to set the correct permissions to execute.
13. Now type ./run.sh to start the bot client.
14. Add your bot's auth code, and continue.

Windows Install Manual (Advanced) "Black Screen Shutdown"

If you are one of the users experiencing the black screen shut down (after opening install-windows.bat you see a black screen and it closes very fast) you need to install the bot using our advanced method. What this means is that your system is not configured already to read java files.

After you setup your system you should go back and do the simple method and it should work if you followed directions correctly. The following guide is using a Windows 7 system but can be used to install on any system using subtle differences.

1. Right click my computer and select properties
2. Click Advanced System Settings
3. Clikc Advanced Tab> Click Environment Variables
4. Under System Variables Find "Path" and double click
5. Here is a sample of what the line should have in it already (depending on system)

%SystemRoot%\system32;%SystemRoot%;%SYSTEMROOT%\System32\QuickTime\QTSystem\

1. Now you need to install JDK by going here. (As of 1/3/2010 the JDK is version 6 update 17)
2. Download and install.
3. Now for you to run the bots your system needs to know where those java files are. To tell your system where it is you need to find the path and input it in the System Variables path we opened earlier. To find the path to the java files you just installed continue to step 4.
4. Open my computer > open your C: drive usually named local disk > open Program Files (x86) (just "program files" for other systems) > open java > open jdk(version_numbers) > open the bin folder.
5. Copy this whole path to the bin folder
6. Should look like this C:\Program Files (x86)\Java\JDK(version_numbers)\bin
7. Now go back to the window system variables path window and add that path at the end. DO NOT DELETE ANYTHING!
8. Now add a semicolon ";" without the quotes -- to the begining and end of the path we just put in! It is very important that you do this or the bots will not work!
   
9. So it should look something like this -- Take into account different paths and java version cause your computer is different

%SystemRoot%\system32;%SystemRoot%;%SYSTEMROOT%\System32\QuickTime\QTSystem\;C:\Program Files (x86)\Java\jdk0.0.0_00\bin;

1. Click ok > click ok on the next window > click ok on the next window
2. Open your runescapebot folder with the bot client is in
3. Click on install-windows.bat. NOTE: Make sure you run in administrator mode (right click and select run as admin).

If you the black screen comes up and shuts down again please stop and check over steps 1-4 and then 1-9 cause you didnt install correctly. If the black screen didnt quit you can continue.

1. Select the Windows 32bit option for 32 bit processors or the Windows 64bit option for 64 bit processors. Most users will have 32 bit processors.
2. Select the current version of the bot client you want to install.
3. Select the SQLite Universal option.
4. Click the Install button.
5. The bot client is now installed. Double click run.bat to start your bot client! NOTE: If you have 1 GB or less of ram, you may get errors when trying to launch from run.bat . You will need to launch from run-with-cmd-lowram.bat instead.
6. Wait a moment for the bot client to start up. Add your bot's auth code, and continue. (Bot startup delays may happen if the server is overloaded -- just wait)
7. NOTE: Do not press any keys while the bot client is starting up, even if prompted to do so by the cmd window.