SourceForge.net Logo     

Project Overview

Introduction

KoLmafia is a cross-platform desktop tool, written in Java (J2SE 1.8 compliant), which interfaces with the online adventure game, Kingdom of Loathing. Those who are looking to download the latest release: click here. More advanced users familiar with stand-alone Java applications are welcome to download an hourly build provided by the KoLmafia user script community: click here.

Is KoLmafia Safe?

To make things absolutely clear, open sourcing a program does not make it secure -- it strictly makes it easier to take advantage of work already done by other people, provided you are willing to act in accordance with the terms of the license under which the source code is provided. That said, I believe KoLmafia is safe. However, I'm the main developer of KoLmafia, and I only use a small fraction of its features, so my opinion of it should be taken with a grain of salt.

My personal belief is that running any program (including the web browser you are using to view this page) is about near-unconditional trust. If, for any reason, you don't trust the companies and individuals involved in the development of the program, I strongly suggest that you should never run the program, no matter what the promised benefits may be. I believe these same guidelines should be applied if you're thinking about using KoLmafia.

Getting Started

Kingdom of Loathing changes faster than the (very slow) official release cycle of KoLmafia. As such, you may want to download the latest unstable release from our build server.

In order to use KoLmafia, you (usually) must have a Java Runtime Environment (JRE) installed for your system.

If you are running Windows 2000/XP, Linux, or Solaris, you can use the version of Java provided by Oracle, usually referred to as the Sun JRE or the Oracle JRE. The latest version of the JRE is available here: Java SE Downloads. Please be sure to install the JRE after downloading it!

Uniquely to Windows, you can try running KoLmafia without Java at all by using a solution that tries to convert KoLmafia to native code. In theory, this makes everything faster as the code is no longer interpreted and may perform better in terms of memory usage. The solution is provided by leveraging a commercial Java to native code compiler called Excelsior JET, which is generously made available by the vendor at no cost for non-commercial use. The badge below is a small show of thanks for their generosity.

If you are running Mac OS X 10.4.x or higher, you do not need to download or install a separate JRE. If you are running an older version of Mac OS, unfortunately, KoLmafia will likely not run on your system because Java versions higher than Java 1.8 are not maintained for those versions of the Macintosh operating system.

If you are using any operating system not listed here, you are welcome to try your favorite search engine for details. The applicable keywords are "Java 1.8" or "Java 8" (they are synonymous) and the name of your operating system, though you may have more luck searching for "Java 1.8" (which is more generally known as Java 8).

Other helpful information related to getting started with KoLmafia is found (or will eventually be found) in the end-user manual and in the KoLmafia Guide on the KoLmafia user scripting wiki.

Mission and Scope

What problem does this project address?
Kingdom of Loathing is an online adventure game written in PHP. As players advance in level in this game, the tendency is for them to settle into routines where they repeat the same set of tasks over and over again, tasks which involve nothing more than senseless link-clicking. As these routines continue, players begin to grow bored and dissatisfied, causing them to depart from the game without having experienced the subtler details which make the game enjoyable.
What is the goal of this project?
The goal of this project is to create a cross-platform desktop tool, written in Java (J2SE 1.8 compliant), which interfaces with the online adventure game, Kingdom of Loathing. The project intends to provide all the user-friendliness of the KoLmelion graphical user interface while giving KoL CLI and other command-line users the scripting flexibility to which they have grown accustomed.
What is the scope of this project?
The project intends to eventually achieve all the goals listed above before the project closes.

Documentation


Copyright © 2003-2021 Jason Robbins. All rights reserved. License terms. Retain this copyright statement whenever this file is used as a template.