greenbox is a script 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, run greenbox in the GCLI and your profile will be updated at https://greenbox.loathers.net/?u=<your player id>. Whenever you re-run greenbox, these data will be updated automatically!
If you want to generate a non-public readout link, run greenbox --private. Similiarly, if you would like to remove your public profile just run greenbox --wipe.
To be reminded of usage instructions at any time, run greenbox --help.
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.
- ... data that powers greenbox, click here.
- ... script run within KoLMafia to calculate and update your greenboxen, click here.
- ... frontend of the script that displays the aforementioned data, click here.
- ... service that receives, stores, and serves the data, click here.
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.