Yet Another Shield Generating Script

nworbetan

Member
lunar.ash - Now With Features!

The purpose of lunar.ash is to complete the Repair The Elves' Shield Generator quest for you, while also allowing you to have 100% control over how the quest is done. If you think this sounds like "having your cake and eating it too", then you're right. That's exactly what this script aims to do. But first you, the user, will need to decide exactly how you want the quest to be done. This is a KoLmafia script, not a psychic hotline. :p

How to use lunar.ash, if you've never used lunar.ash before:
  1. Please don't take these step-by-step instructions more seriously than I'm not. We both know that you already know 90% of this stuff. But the thing is, the 10% you don't know yet is probably different than the 10% the next person who reads it doesn't know. Feel free to skim, or even jump ahead to the advanced section a little lower.
  2. Download the newest version (lunar-v101.ash currently) and put it in your script folder. I recommend removing the version number from the name and just calling it lunar.ash too.
  3. Put on a set of +item% equipment and grab your favorite fairy familiar. The quest eventually requires you to equip Axel in your off-hand, but if you can't, the script will abort when that time comes. Also, keep in mind that you're going to be killing scaling monsters, so maybe try not to use equipment that will stop you from doing that.
  4. Double-check your HP/MP Usage and Custom Combat settings in KoLmafia's Adventure tab, or maybe set your /autoattack how you want it. This script will not presume that it can automate combat on your character better than you can, and will not interfere with any of your current settings.
  5. Go to mafia's GCLI and type:
    lunar.ash quest
    or in the KoL chat in the relay browser:
    /run lunar.ash quest
    If you want the script to stop after a certain number of turns, include that number either before or after quest.
  6. Chat with your friends, or play your X-Box, or something. It doesn't take long, about 30-40 adventures when I run it. Or it could go faster pretty easily if you use better item% gear and buffs than I do.
  7. If anything unusual happens, the script will stop and complain. It's usually pretty easy to tell what went wrong. After you fix it, go back to step 5. The script can tell what you've done so far, and it won't waste a single adventure trying to redo things that don't need to be redone.
  8. Now that you're a lunar.ash veteran, try running:
    lunar.ash help
    and see what happens!
How to use lunar.ash, the advanced way:

If you've ran the script already, you may have noticed the list of available options. It may be more accurate to call these options "stop conditions", because, well, that's what they do. The script always knows where to start, but with these options, you can tell it where to stop. If you tell the script to do something you've already finished, it will abort and (hopefully) tell you what you you need to do next.

Most of these stop conditions seem pretty straight-forward to me, but there are a few that I'll explain in more detail:

"q" or "quest" - This does all four of the steps above it on the helpful list, in the order that they're listed, (i.e. getmaps, usemaps, axel, and escort) and then does some fancy falling to finish the quest.

"y" or "yellow" - If you still need any maps to finish the quest, it will get one of them for you. If your he-bo isn't your current familiar, the script will change familiars for you.

"yg" or "yellowgrimace" or "yr" or "yellowronald" - These are what you want to use to yellow ray if you're not in the process of doing the quest, or if you're following the path of the Way of the Surprising Fist.

"d" or "distention" - When using this option, the script considers a) how many adventures you have, b) how many Grimace maps you have, and c) the N used at run-time, and uses the smallest of these 3 numbers to get some pills. If N = 0, or if you didn't bother to type N at all, it only considers a) and b). This option still works if you are following the path of the Way of the Surprising Fist.

"s" or "synthetic" - Ditto.

How to use lunar.ash optimally:

You're good with aliases and other CLI commands, right? Have fun. ;)

changelog:
  • 08-31-2011 - lunar-v101.ash - improved yellow ray flexibility, fixed check_stasis_item(), added hardtack & squeeze options
  • 08-23-2011 - lunar-v100.ash - added yellow ray functionality, pill acquisition, various other stop conditions, wandering monster detection, (etc?)
  • 07-30-2011 - nworbetan-shieldgen.ash - initial bare-bones version
 

Attachments

  • nworbetan-shieldgen.ash
    6.5 KB · Views: 87
  • lunar-v100.ash
    17.7 KB · Views: 77
  • lunar-v101.ash
    19.6 KB · Views: 161
Last edited:

Xande1

Member
Since lunar.ash is my favorite script for completing the Spaaace quest, I did a quick update on it. I only brought it in line with changes to mafia and KoL so it will function properly again, I didn't modernize the script otherwise (support for automatic Nanorhino YR and stuff like that). The update is currently very lightly tested, but as the updates were trivial, everything should be fine. (If it's not, I shall put a bag over my head.)

Everything good about this script is because of nworbetan; anything broken or dumb is probably something I introduced.

Here's what changed:
  • Updated uses of item numbers that were generating warnings to explicit item names, so the script runs without generating a page full of warnings now.
  • Changed the final visit_url() when doing the quest to visit the new place.php page, so you get your isotopes automatically again. (No idea how many isotopes I lost to this before I noticed. :( )
  • Now prints messages if you have any maps left after completing the quest, reminding you to use them. (You should only ever end up with spare Grimace maps, but there are messages for both kinds, just in case.)

2014-09-29: lunar.ash v1.02
 

Attachments

  • lunar.ash
    21.3 KB · Views: 78
Top