Take two, incorporating many of St.Doodle's suggestions,, with additional editing and ideas from me:
----
Welcome to the new KoLmafia thread. KoLmafia was holatuwol's creation and his
original thread, chock full of interesting historical info, is still available for your viewing pleasure. Unfortunately, due to its age, the original post of that thread can be edited only by forum mods and so, at the request of the the forum admins, we've rebooted. You made it!
This thread is supposed to be where you post any questions, comments, or concerns you have related to the KoLmafia project so as to keep this forum uncluttered with general KoLmafia questions. However, please keep in mind that this project is run completely by volunteers, from the developers writing code to the minions on the front line answering more basic questions. We strive to make sure the experience of using KoLmafia is as pleasant as possible for everyone and will do our best to respond to all polite correspondence as soon as we are able. None of us is getting paid to put up with attitude, and we certainly won't do it for free. Attitude may lead to mass /baleet, which could make it difficult to obtain further help.
If you've got more advanced questions which you think require a thread or two to explain, consider taking your question to the
KoLmafia forums. Or, if you think it might already be answered, check out either the
FAQ or SinginSally's
KoLmafia Guide (inspired by Aprocalypse's earlier guide). Both of these are hosted on the
KoLmafia Wiki, which also contains a great deal of additional information that you may find useful.
Can I have some quick links?
Will KoLmafia run on my system?
It has been tested in Windows 98/2000/XP/Vista/7, and has been shown to work on several flavors of Linux and on Mac OS X 10.3+. Compatibility may exist for Mac OS X 10.2+, because KoLmafia's JAR releases are compiled using Java 1.4.1, but no confirmation has been provided for this. For some instructions on how to get started, check out
Installation on the KoLmafia Wiki.
What features does KoLmafia provide?
- Coffee cup gameplay. Under the hood via the "relay browser" interface, KoLmafia aggregates some of the best browser script / helper ideas to present a slightly different click-reducing look to KoL that works in most major browsers, not just the one with the orange icon. Some general features include quick auto-restore links, quick use links, simplified combat handling, and tracking of most of KoL's "hidden" counters and timers.
- Session logging. Ever wanted to go back and see just what you did on this run? KoLmafia records every combat, every action, every familiar change or equipment swap, every skill usage. Other third-party tools recognize, parse, and analyze KoLmafia session logs for your easy perusal.
- Inventory management. Want to keep an inventory window open while you're buying from the mall or adventuring to see your totals? Want to speed up multi-step recipes? Want to buy from lots of stores at once? KoLmafia presents a way to streamline that to let you focus on the cooler, less repetitive aspects of KoL.
- Auto-adventure. Yes, this desktop client supports adventuring at all of the most popular areas accessible through the browser. If new content arrives that is not yet supported by KoLmafia, please do not post to this thread asking for it to be added. Instead, post a "New Content" request on the forums.
- Scripting. Kolmafia includes not just one, but, count 'em, two scripting languages. It incorporates a basic CLI, or "shell", in which you type commands to adventure, eat food, autosell junk, craft items, or perform any of the other tasks you want to do within KoL. These commands can be saved in a script file and executed at your command whenever you wish. Additionally, KoLmafia includes the ASH (Advanced Script Handler) language, a C or Java-like language, sufficient to implement your wildest KoL programming dreams.
- Not-So-Instant Messenger (NSIM) not to be confused with NetScape Instant Messenger (NSIM/AIM). Ever find yourself in far too many channels with some burning desire to have it all tabbed or in separate windows? Maybe your PMs, too? KoLmafia presents its own interface to KoL chat to help you manage all that, and it even logs all your chat sessions behind the scenes for later out of context quoting.
How can I help with the KoLmafia project?
I would love to be able to simplify KoLmafia a bit (following
this philosophy whenever possible). If you've got any suggestions on how to make KoLmafia easier to use, even if it involves removing an existing feature, I'm open to hearing them. If you have ideas about improvements or enhancements, I'm open to those as well, but I abide by
this philosophy in addition to the previous one (just a fair warning).
As a side note, there may be occasions where we miss your
bug report amidst all the other thread posts. If the bug persists after a release, and you haven't seen any explanation of why the bug might not be fixed, feel free to bump the thread.