loathers / TourGuide

Relay script for KoLmafia, for the web game Kingdom of Loathing. Gives advice on how to play.
The Unlicense
14 stars 17 forks source link
kingdom-of-loathing kolmafia
tourguide logo

TourGuide is a script meant to help Kingdom of Loathing players efficiently play through an ascension. It will give you advice on getting through your active quests, tips on how to efficiently use your resources, and reminders on using time-limited resources.

To install, run the following command on an up-to-date KolMafia version:

git checkout loathers/tourguide Release

To update, run git update or check the "Update installed Git projects on login" box within Mafia preferences.

Running TourGuide

Once TourGuide is installed, look at the top bar within your relay browser. In the upper right, underneath the moon state and the bug report button, there will be a drop-down menu. Select TourGuide from this menu, and the script will dock to the right side of your window.

image

Using TourGuide

At its core, TourGuide is like Clippy, Microsoft's wildly unsuccessful advice daemon from Microsoft Word 1997. You can use it as actively or as minimally as you want. TourGuide aims to inform you of the many resources a KoL player has -- things like free runaways, banishes, free kills, et cetera -- and give you ideas on what to use them on. TourGuide aims to give users a heads up on the many arcane speedster strats used to complete ascensions in the minimum possible turns. KoL is a complicated game, and TourGuide is the little parrot that sits on your shoulder and pecks at you to remind you not to lose track of your resources.

Some people use TourGuide on every quest, referring back to it like a treasured family accountant. Others open it at the end of a KoL day to see what resources they may have forgotten to use. Others still use it, but minimize every tab except for Guzzlr, because they love Guzzlr so much that the entire game is just endless Guzzlr parties. There are many ways to use TourGuide.

For samples of TourGuide output (and general notes on how to read and use the tool), please visit our TourGuide Usage Documentation page.

Development & History

TourGuide is open source and contributions are encouraged. This script, as well as its support scripts, are in the public domain.

For support, questions, and comments visit the Ascension Speed Society discord channel.