Skip to content

Latest commit

 

History

History
131 lines (80 loc) · 14.7 KB

README.md

File metadata and controls

131 lines (80 loc) · 14.7 KB

FolgerCS - Seraphiii

FolgerCS is a softcore one-day Community Service script meant for looping in Kingdom of Loathing, and designed to work for mid-shiny accounts (i.e. accounts with more than a full standard set) with extra features for mid-to-high shiny accounts (i.e. accounts with a lot more than a full standard set). The user is expected to have a bunch of softcore-permed skills, and at least many IotMs in order to enable this (one of which is the Clan VIP Lounge key).

Update: Preferences are now done via the relay. If you previously set preferences for this script, they must be reset.

Installation

To install the script, use the following command in the KoLMafia CLI.

git checkout https://github.com/Ignose/FolgerCS.git release

Usage

For those who are interested in using FolgerCS as is, the following sections detail the prerequisites, choices in Valhalla, and required resources.

Before Ascending

In Valhalla

The astral six-pack is the only useful astral consumable. The pet sweater allows us to benefit from the Disgeist in the NC test, and the stat-appropriate Canadia sign gives us +11ML from the Mind Control Device.

Required IotMs

IotMs are incredibly expensive, and they tend to increase in price the longer they have existed due to the artificial supply limit. Unfortunately, they are incredibly powerful too, and so we will need to rely on them to enable a 1-day SCCS. There is a hard requirement on the Clan VIP Lounge key, as it is one of the few "IotMs" that are recurring (and thus are not gated by the same artificial supply limit as mentioned above), and it provides access to >= 30 Mr. A's-worth of IotMs.
One of the hardest tasks in CS is levelling, due to the limited resources we have access to to optimise for the stat tests (HP, Mus, Myst, Mox). The below therefore is strictly required, but will be insufficient to complete a run of FolgerCS.

IotM Use
Clan VIP Lounge key many things
model train set xp
cosmic bowling ball xp + banish
unbreakable umbrella many things
combat lover's locket many things
closed-circuit pay phone many things

Alternate Run Plan

For the alternative no borrowed time runplan, several things have been modified. This run plan requires:

  • A preconfigured trainset before ascension with coal followed by mainstat.
  • At least 4 free kills.
  • A minimum of 2 legendary pizzas.

For the Asdon Martin runplan, ensure that a borrowed time is available to use.

For any Muscle class, ensure that Prevent Scurvy and Sobriety has been permed.

For any Moxie class, ensure either a balancer potion or olive is available to pull, as the script will not acquire one in run.

FAQ

Does this work in HC?

This script is hardcoded to eat the 3x T4 cookbookbat foods (which are all pulled), and it is highly unlikely that you will be able to generate enough ingredients to cook all of them in HC (without any pulls). However, it can be (and has been) done, although this is strongly discouraged.

Does this script work for other classes?

Yes, with the following caveats:

  • For any non-Sauceror class, ensure that ALL CookBookBat foods are disabled before running.

  • For any Muscle class, ensure that Prevent Scurvy and Sobriety has been permed.

  • For any Moxie class, ensure either a balancer potion or olive is available to pull, as the script will not acquire one in run.

What IotMs are currently supported and how are they being used by the script?

FolgerCS supports a very large number of IotMs, but, as a generalist script, may not be able to eke out every last benefit from each IotM. For exact specifics, refer to this list.

I'm pretty shiny - can I get the script to save certain resources?

Run folgercs savedresources to see a list of preferences you can set to save specific resources. You may also explicitly exclude acquiring certain buffs by typing set instant_explicitlyExcludedBuffs=<comma-separated effect IDs> (and confirming that the correct buffs have been excluded in the savedresources printout).

Similarly, you may exclude using certain familiars during the leveling phase by typing set instant_explicitlyExcludedFamiliars=<comma-separated familiar IDs> (and confirming that the correct familiars have been excluded in the savedresources printout).

My settings are such that the script no longer uses all 5 softcore pulls. Can I make the script pull and use some other resources?

There is an experimental pull preference that will automatically pull certain items, if available. If not using this pref, pulls should be done manually. This generally should be equipments (e.g. Staff of the Roaring Hearth, repaid diaper, meteorite necklace etc), since they would automatically be equipped by the maximizer for various tasks/tests. You may also consider pulling potions (that you may not have access to at your shininess level) which the script uses (e.g. wasabi marble soda, tobiko marble soda, Yeg's Motel toothbrush etc).

I'm looking to improve my CS runs - what IotMs and skills should I go for next?

folgercs sim groups various resources by how impactful they are. You may also refer to this slightly more comprehensive list for suggestions.

I don't have a lot of the recommended skills. Will this script still work for me?

If you are decently shiny, probably. The list of skills is meant to give a rough gauge of what is required to prevent the script from failing in general, which could happen for various reasons, including

  • Running out of HP (cannelloni cocoon)
  • Running out of MP (inner sauce, curse of weaksauce, soul saucery)
  • Running out of turns, either from turngen or high turn-taking tests/leveling tasks (almost everything else)

The script might still work if you have enough IotMs to make up for the loss in turnsaves from lacking various skills (i.e. the skills are listed to indicate that if you have nothing else, you'll need these in order to be able to complete the run).

I can't survive the early fights! What do I do?

If you're scripting your own run, try eating the Deep Dish of Legend early (this is already done in the script above). It gives +100%hp and +300%mus, which should help you survive a few more hits from the monsters. However, this does come at the cost of possibly not carrying this buff over to the NC test to buff your Disgeist, thus losing you 5%NC (increasing your turncount by 3).

What range of shininess is this script suitable for?

This script supports runs from anywhere between 90-180 turns (assuming no manual pulls; correct as of September 2023). If you are able to cap all the stat tests without using any CBB foods (including the T4 ones) because you have access to a bunch of free fights, stat% and xp% buffs, the script now fully supports running without CBB and can be pretty close to optimal (you might even want to consider setting instant_skip<calzone|deepDish|pizza>OfLegend prior to running the script to save all 5 pulls for other manual turncutting pulls [or to run it in HC]).

However, you may also consider using one of these other scripts listed here instead to eke out that last bit of efficiency. For example, this personal script is able to achieve a ~1/91 HCCS with fewer resources and organs used as compared to the ~1/93 HCCS (yes, HC) that I get with InstantSCCS (with my preferences already set to largely optimize for profits).

Is there a way to automate the acquisition of the necessary T4 CBB foods/astral choices in Valhalla?

You may find a few community looping scripts/wrappers that would do so for you, such as here. At the present moment these are not natively shipped together with FolgerCS.

Does the script support switching between a clan for VIP Lounge items and a clan with Mother Slime set up for Inner Elf?

The script assumes you are already in the VIP clan. You will have to set instant_motherSlimeClan=<clan name> for FolgerCS to attempt grabbing Inner Elf - this may be the same clan as your VIP clan, or a different one altogether.