/greenbox

Script for examining and sharing a player's loadout of skills and items in the Kingdom of Loathing

Primary LanguageTypeScriptApache License 2.0Apache-2.0

greenbox logo

greenbox is a script meant to examine a Kingdom of Loathing player's overall loadout and return a graphical interface showing the user what they own and do not own, among some of the coolest items, tattoos, and trophies in the kingdom.

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

git checkout loathers/greenbox release

Once installed, you can run greenbox at any time by running greenbox in the GCLI.

Development

We have constructed greenbox as a monorepo -- this means that there are three distinct scripts that live inside a single repo. To assist in the development of this script, we have added a series of readmes that should help walk through code structure and describe PRs that would touch each specific section.

  • For more information on the overall structure, click here.
  • For more information on the backend data of greenbox, click here.
  • For more information on the script run within KOLMafia to assess your greenboxen, click here.
  • For more information on the frontend of the script that ingests the aforementioned data, click here.

History

In KOL's community, green boxes are a reference to a profile snapshot script once owned by BumCheekCity and more recently owned by CheeseCookie. In the parlance of these snapshots, a green box means you own the thing that's in the box. Hence the name of this script. While this script was coded from scratch, the general structure (and the community impact of the script) owes a substantial amount to BumCheekCity and CheeseCookie, and we are thankful for their contributions to KOL.