Difference between pages "Quest Tracking Preferences" and "Equip"

From Kolmafia
(Difference between pages)
Jump to navigation Jump to search
imported>Paladinwhite
 
(add new overloads for equipping familiars directly and code example)
 
Line 1: Line 1:
{{TOCright}}
+
{{
KoLMafia internally tracks progress for a number of quests. These are stored as preferences in settings\[charactername]_prefs.
+
#vardefine:name|equip}}{{
 +
#vardefine:return_type|boolean}}{{
  
==Quests Granted by Familiars==
+
FunctionPage|
===questF01Primordial===
+
name={{#var:name}}|
=unstarted
 
===questF02Hyboria===
 
=unstarted
 
===questF03Future===
 
=unstarted
 
===questF04Elves===
 
=unstarted
 
===questF05Clancy===
 
=unstarted
 
  
==Guild Quests==
+
function1={{Function|
===questG01Meatcar===
+
name={{#var:name}}|
 +
aggregate={{#var:aggregate}}|
 +
return_type={{#var:return_type}}|
 +
return_also={{#var:return_also}}|
 +
parameter1={{Param|item|equip_me}}|
 +
}}|
  
===questG02Whitecastle===
+
function2={{Function|
=unstarted
+
name={{#var:name}}|
===questG03Ego===
+
aggregate={{#var:aggregate}}|
=started
+
return_type={{#var:return_type}}|
===questG04Nemesis===
+
return_also={{#var:return_also}}|
=started
+
parameter1={{Param|item|equip_me}}|
===questG05Dark===
+
parameter2={{Param|slot|where}}|
=unstarted
 
===questG06Delivery===
 
=unstarted
 
  
==Quests Granted by Items==
+
}}|
===questI01Scapegoat===
 
=unstarted
 
===questI02Beat===
 
=unstarted
 
  
==Council Quests==
+
function3={{Function|
===questL02Larva===
+
name={{#var:name}}|
questL02Larva tracks the player's progress in the {{kolwiki|Spooky_Forest_Quest|Spooky Forest quest}}.
+
aggregate={{#var:aggregate}}|
 +
return_type={{#var:return_type}}|
 +
return_also={{#var:return_also}}|
 +
parameter1={{Param|slot|where}}|
 +
parameter2={{Param|item|equip_me}}|
 +
p1desc={{Pspan|equip_me}} is the item to equip|
 +
p2desc={{Pspan|where}} is the slot to place the item in|
 +
}}|
  
*unstarted: quest not yet received
+
function4={{Function|
*started: quest received from the Council
+
name={{#var:name}}|
*step1: mosquito larva acquired
+
aggregate={{#var:aggregate}}|
*finished: mosquito larva returned to the Council
+
return_type={{#var:return_type}}|
 +
return_also={{#var:return_also}}|
 +
parameter1={{Param|item|equip_me}}|
 +
parameter2={{Param|familiar|fam}}|
  
===questL03Rat===
+
}}|
questL03Rat tracks the player's progress in the {{kolwiki|Typical_Tavern_Quest|Typical Tavern quest}}.
 
  
*unstarted: quest not yet received
+
function5={{Function|
*started: quest received from the Council
+
name={{#var:name}}|
*step1: spoke to Bart Ender in the Typical Tavern
+
aggregate={{#var:aggregate}}|
*step2: turned off the Rat Faucet
+
return_type={{#var:return_type}}|
*finished: told Bart about the Faucet
+
return_also={{#var:return_also}}|
 +
parameter1={{Param|familiar|fam}}|
 +
parameter2={{Param|item|equip_me}}|
 +
p1desc={{Pspan|equip_me}} is the item to equip|
 +
p2desc={{Pspan|where}} is the familiar to equip the item on|
 +
}}|
  
===questL04Bat===
+
function_description=Attempts to equip the item {{pspan|equip_me}} in the slot {{pspan|where}} if specified, and returns true if the operation was successful, and false if it was not. If parameter {{pspan|where}} is not specified, it defaults to the "standard" place for such an item (main-hand for 1-handed weapons, first open slot for accessories or acc1 if no slots are open).
questL04Bat tracks the player's progress in the {{kolwiki|Boss_Bat_Quest|Boss Bat quest}}.
+
*If {{pspan|where}} is specified and {{pspan|equip_me}} is set to $item[none], this function will unequip whatever is in slot {{pspan|where}} and return true.  
 
+
*If {{pspan|where}} is not specified and {{pspan|equip_me}} is set to $item[none], the function aborts and you get a funky error because that makes no sense.
*unstarted: quest not yet received
+
*If you cannot equip {{pspan|equip_me}}, or {{pspan|where}} is supplied and the item cannot be used in that slot, you will be given an error message and this function will return false.
*started: quest received from the Council
+
*The overload for equipping a familiar with {{pspan|equip_me}} can be used to equip familiars with familiar equipment without requiring the familiar to be your currently active familiar. This will return false if you don't have (or can't use) the familiar or if the familiar can't equip the item you are attempting to equip.
*step1-step3: demolished 1-3 walls in the Bat Hole
+
 |
*step4: Boss Bat defeated
 
*finished: returned to the Council to report success
 
 
 
===questL05Goblin===
 
questL05Goblin tracks the player's progress in the {{kolwiki|The_King_of_Cobb's_Knob_Quest|The King of Cobb's Knob quest}}.
 
 
 
*unstarted: quest not yet received
 
*started: quest received from the Council
 
*step1: Cobb's Knob map decrypted
 
*finished: Knob Goblin King defeated
 
 
 
===questL06Friar===
 
questL06Friar tracks the player's progress in the {{kolwiki|Deep_Fat_Friars'_Gate_Quest|Friars' quest}}.
 
 
 
*unstarted: quest not yet received
 
*started: quest received from the Council
 
*finished: cleansed the taint
 
 
 
===questL07Cyrptic===
 
questL07Cyrptic tracks the player's progress in the {{kolwiki|Undefile_the_Cyrpt_Quest|Undefile the Cyrpt quest}}.
 
 
 
*unstarted: quest not yet received
 
*started: quest received from the Council
 
*finished: Bonerdagon defeated
 
 
 
===questL08Trapper===
 
 
 
questL08Trapper tracks the player's progress in the {{kolwiki|Mt._McLargeHuge_Quest|Mt. McLargeHuge Quest}}.
 
 
 
* unstarted: quest not yet received from the Council
 
* started: quest received from the Council
 
* step1: cheese and ore requested by the Trapper
 
* step2: cheese and ore returned to the Trapper
 
* step3: discovered the stairs up to the Mist-Shrouded Peak (via either route)
 
* step4: fought at least one yeti
 
* step5: defeated the monster at the top of the Peak
 
* finished: returned the fur to the Trapper (quest complete)
 
 
 
===questL09Topping===
 
questL08Trapper tracks the player's progress in the {{kolwiki|Orc_Chasm_Quest|Orc Chasm Quest}}.
 
 
 
* unstarted: quest not yet received from the Council
 
* started: quest received from the Council
 
* step1: bridge built
 
* step2: like, totally got the deets from the Highland Lord
 
* finished: quest complete
 
 
 
====booPeakProgress====
 
booPeakProgress tracks the hauntedness level of {{kolwiki|A-boo Peak}}. A value of 18, for instance, indicates that A-boo Peak is 18% haunted.
 
 
 
Possible values: 0 - 100
 
 
 
====chasmBridgeProgress====
 
chasmBridgeProgress tracks the player's progress in building a bridge across the {{kolwiki|Orc Chasm}}. A value of 10, for instance, indicates that the bridge is 10 planks long.
 
 
 
Possible values: 0 - 30
 
 
 
====oilPeakProgress====
 
oilPeakProgress tracks the remaining pressure at {{kolwiki|Oil Peak}}. It decreases as the player reduces the pressure in the zone.
 
 
 
Possible values: 0.00 - 310.66
 
* 310.66: Pressure not yet reduced
 
* 0.00: Subquest completed
 
 
 
====twinPeakProgress====
 
twinPeakProgress is a nibble bitmask with least significant bit set for the first choice and the most significant for the fourth. You can parse this with bitwise operators. Here's some code that demonstrates how to use it.
 
  
 +
code1={{CodeSample|
 +
title=Code Sample|
 +
description=Equips the Swashbuckling Getup carefully to ensure that the parrot is in the second accessory slot.|
 +
code=
 
<syntaxhighlight>
 
<syntaxhighlight>
void comma(buffer b, string s) {
+
equip($item[eyepatch]);
if(length(b) > 0)
+
equip($item[swashbuckling pants]);
b.append(", ");
+
equip($slot[acc2], $item[stuffed shoulder parrot]);
b.append(s);
 
}
 
 
 
boolean mysterious(int progress, int c) {
 
return (progress & (1 << c)) == 0;
 
}
 
 
 
string twinPeak() {
 
int p = get_property("twinPeakProgress").to_int();
 
buffer need;
 
if(mysterious(p, 0)) need.comma("4 Stench Resistance");
 
if(mysterious(p, 1)) need.comma("+50% Item Drop");
 
if(mysterious(p, 2)) need.comma("Jar of Oil");
 
// Only check for final if first three complete
 
if(length(need) == 0) {
 
if(mysterious(p, 3))
 
return "Need +40% Initiative";
 
return "Twin Peak Completed";
 
}
 
return "Need " + need;
 
}
 
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
}}|
  
===questL10Garbage===
+
code2={{CodeSample|
 
+
title=Code Sample|
questL10Garbage tracks the player's progress in {{kolwiki|Giant_Trash_Quest|the Giant Trash Quest}}.
+
description=Equips the blue plate on the Shorter-Order Cook without switching to it first.|
 
+
code=
* unstarted: quest not yet received from the Council
 
* started: quest received from the Council
 
* step2: giant beanstalk grown
 
* step3 - step6: four Immateria acquired
 
* step7: S.O.C.K. acquired ({{kolwiki|The_Castle_in_the_Clouds_in_the_Sky_(Basement)|Castle Basement}} open)
 
* step8: {{kolwiki|The_Castle_in_the_Clouds_in_the_Sky_(Basement)|Castle Ground Floor}} open
 
* step9: {{kolwiki|The_Castle_in_the_Clouds_in_the_Sky_(Basement)|Castle Top Floor}} open
 
* step10: chore wheel turned
 
* finished: returned to the Council
 
 
 
===questL11MacGuffin===
 
questL11MacGuffin tracks the player's progress in the {{kolwiki|Quest_for_the_Holy_MacGuffin|Holy MacGuffin quest}}.
 
 
 
*unstarted:
 
*started: quest received from the Council
 
*step1: Black Market located (blackForestProgress == 5)
 
*step2: retrieved your father's MacGuffin diary
 
*finished: returned the MacGuffin to the Council
 
 
 
====questL11Black====
 
questL11Black tracks the player's progress in the {{kolwiki|Quest_for_the_Holy_MacGuffin|Black Market portion of the Holy MacGuffin quest}}.
 
 
 
*unstarted: quest not yet received
 
*started:  quest received from the Council
 
*step1: spent at least one turn in the Black Forest
 
*step2: Black Market found
 
*step3: forged identification documents purchased
 
*finished: MacGuffin diary acquired
 
 
 
=====blackForestProgress=====
 
blackForestProgress tracks the player's progress in [http://kolmafia.us/showthread.php?15995 discovering the Black Market].
 
 
 
*0: no progress in exploring the Forest
 
*1: blackberry bushes located
 
*2: black cottage located
 
*3: black mineshaft located
 
*4: black church located
 
*5: black market located
 
 
 
====questL11Manor====
 
questL11Manor tracks the player's progress in the {{kolwiki|Quest_for_the_Holy_MacGuffin#Spookyraven_quest_.28In_a_Manor_of_Spooking|Spookyraven Manor portion of the Holy Macguffin quest}}.
 
 
 
*unstarted: quest not yet received
 
*started: quest received, by reading your father's MacGuffin diary
 
*step1: Spookyraven Manor Cellar opened
 
*step2: recipe: mortar-dissolving solution read
 
*step3: Suspicious Masonry demolished
 
*finished: Lord Spookyraven defeated
 
 
 
=====spookyravenRecipeUsed=====
 
spookyravenRecipeUsed tracks whether and how the player has read recipe: mortar-dissolving solution
 
 
 
*none: recipe not yet read
 
*with_glasses: recipe read with Lord Spookyraven's spectacles
 
*no_glasses: recipe read without the spectacles
 
 
 
====questL11Desert====
 
Explore the Arid, Extra-Dry Desert to find the pyramid mentioned in your father's journal.
 
 
 
*unstarted:
 
*started: quest started by reading your father's MacGuffin diary
 
*finished: discovered the Small Pyramid
 
 
 
=====desertExploration=====
 
*0: haven't yet started exploring the Desert
 
*1-99: Desert exploration in progress
 
*100: Desert fully explored
 
 
 
====questL11Pyramid====
 
questL11Pyramid tracks the player's progress in the {{kolwiki|Quest_for_the_Holy_MacGuffin#A_Small_Pyramid|Pyramid portion of the Holy Macguffin quest}}.
 
 
 
* unstarted: Pyramid not yet discovered
 
* started: Pyramid discovered
 
* step1: Middle Chamber opened
 
* step2: The Lower Chambers opened
 
* step3: Control Room opened
 
* finished: MacGuffin retrieved (quest complete)
 
 
 
=====gnasirProgress=====
 
gnasirProgress is a nibble bitmask with one bit for each possible way you can advance {{kolwiki|Quest_for_the_Holy_MacGuffin|Gnasir's quest}}. You can parse this with bitwise operators. Here's some code that demonstrates how to use it.
 
 
<syntaxhighlight>
 
<syntaxhighlight>
int gnasirProgress = get_property("gnasirProgress").to_int();
+
equip($familiar[shorter-order cook], $item[blue plate]);
buffer gnasir;
 
if((gnasirProgress & 1) == 0)
 
print("Gnasir wants a stone rose");
 
if((gnasirProgress & 2) == 0)
 
print("Gnasir wants a can of black paint");
 
if((gnasirProgress & 4) == 0)
 
print("Gnasir wants a killing jar");
 
if((gnasirProgress & 8) == 0)
 
print("Gnasir wants a 15 worm-riding manual page");
 
if((gnasirProgress & 16) == 0)
 
print("You need to use a drum machine to ride the worm");
 
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
}}|
  
====questL11Ron====
+
see_also={{SeeAlso|can_equip|equipped_amount|equipped_item|have_equipped}}|
Ron Copperhead
+
cli_equiv=The CLI commands "equip" (and others, for specific slots) function similarly.|
 
+
}}
=====zeppelinProtestors=====
 
Tracks protesters removed
 
 
 
====questL11Shen====
 
Shen Copperhead
 
 
 
====questL11Palindome====
 
questL11Palindome tracks the player's progress in the {{kolwiki|Quest_for_the_Holy_MacGuffin#The_Palindome|Palindome portion of the Never Odd or Even quest}}.
 
 
 
* unstarted:
 
* started: spent at least one turn Inside the Palindome
 
* step1: arranged the photos in Dr. Awkward's office
 
* step2: read 2 Love Me, Vol. 2
 
* step3: met Mr. Alarm in his office (received the wet stunt nut stew quest)
 
* step4: cooked wet stunt nut stew
 
* step5: returned the stew to Mr. Alarm
 
* finished: defeated Dr. Awkward
 
 
 
====questL11Worship====
 
hiddenApartmentProgress tracks progress through the {{kolwiki|Quest_for_the_Holy_MacGuffin#Hidden_Temple_quest_.28Gotta_Worship_Them_All.29|Hidden Temple portion of the Quest for the Holy MacGuffin}}.
 
 
 
*unstarted: quest not yet received
 
*started: quest received, by reading your father's MacGuffin diary
 
*step1: (Hidden Temple opened?)
 
*step2: (Nostril of the Serpent acquired?)
 
*step3: Hidden City uncovered
 
*step4: four stone spheres acquired
 
*finished: ancient amulet acquired from the Protector Spectre
 
 
 
=====questL11Business=====
 
*unstarted:
 
*started: Hidden Office Building opened
 
*finished: crackling stone sphere acquired
 
 
 
======hiddenOfficeProgress======
 
hiddenOfficeProgress tracks progress through the {{kolwiki|Hidden Office Building}} during the Quest for the Holy MacGuffin.
 
 
 
Possible values: 0, 1, 6 - 8
 
* 0: Haven't opened the Hidden Office Building
 
* 1: Hidden Office Building is open for adventuring
 
* 6: Encountered the Protector Spirit
 
* 7: Found the stone sphere
 
* 8: Placed the stone sphere in the relevant overgrown shrine
 
 
 
=====questL11Curses=====
 
*unstarted:
 
*started: Hidden Apartment Building opened
 
*finished: moss-covered stone sphere acquired
 
 
 
======hiddenApartmentProgress======
 
hiddenApartmentProgress tracks progress through the {{kolwiki|Hidden Apartment Building}} during the Quest for the Holy MacGuffin.
 
 
 
Possible values: 0, 1, 6 - 8
 
* 0: Haven't opened the Hidden Apartment Building
 
* 1: Hidden Apartment Building is open for adventuring
 
* 6: Encountered the Protector Spirit
 
* 7: Found the stone sphere
 
* 8: Placed the stone sphere in the relevant overgrown shrine
 
 
 
=====questL11Doctor=====
 
*unstarted:
 
*started: Hidden Hospital opened
 
*finished: dripping stone sphere acquired
 
 
 
======hiddenHospitalProgress======
 
hiddenHospitalProgress tracks progress through the {{kolwiki|Hidden Hospital}} during the Quest for the Holy MacGuffin.
 
 
 
Possible values: 0 - 8
 
* 0: Haven't opened the Hidden Hospital
 
* 1: Hidden Hospital is open for adventuring, but haven't bowled.
 
* 6: Encountered the Protector Spirit
 
* 7: Found the stone sphere
 
* 8: Placed the stone sphere in the relevant overgrown shrine
 
 
 
=====questL11Spare=====
 
*unstarted:
 
*started: Hidden Bowling Alley opened
 
*finished: scorched stone sphere acquired
 
 
 
======hiddenBowlingAlleyProgress======
 
hiddenBowlingAlleyProgress tracks progress through the {{kolwiki|Hidden Bowling Alley}} during the Quest for the Holy MacGuffin.
 
 
 
* 0: Haven't opened the Hidden Bowling Alley
 
* 1: Hidden Bowling Alley is open for adventuring
 
* 2-5: Number of times bowled is 1 less than hiddenBowlingAlleyProgress
 
* 6: Encountered the Protector Spirit
 
* 7: Found the stone sphere
 
* 8: Placed the stone sphere in the relevant overgrown shrine
 
 
 
=====hiddenTavernUnlock=====
 
hiddenTavernUnlock tracks whether or not you have unlocked the {{kolwiki|Hidden Tavern}} during the Quest for the Holy MacGuffin.
 
 
 
* When the value is equal to your number of ascensions, the Tavern is unlocked
 
* When the value is any other number, the Tavern is locked
 
 
 
===questL12War===
 
questL12War tracks progress during the {{kolwiki|Mysterious Island Quest}}.
 
 
 
* unstarted: quest not yet received from the Council
 
* started: quest received
 
* step1: War started
 
* finished: War ended; boss defeated (quest complete)
 
 
 
====warProgress====
 
Possible values for the progress of the {{kolwiki|Mysterious Island Quest|Isle War}}:
 
*unstarted: We can still visit the small version of the Mysterious Island
 
*started: The war is in progress
 
*finished: The final boss or bosses were defeated
 
 
 
====sideDefeated====
 
Which side of the {{kolwiki|Mysterious Island Quest|Isle War}} was defeated during the Level 12 quest.
 
 
 
Possible values:
 
*neither
 
*hippies
 
*fratboys
 
*both
 
 
 
===questL13Final===
 
Progress for the {{kolwiki|Naughty Sorceress Quest}}.
 
 
 
*unstarted - Lair is closed
 
*started - Contest booth is available
 
*step1 - Coronation ceremony
 
*step2 - Hedge maze
 
*step3 - Tower door
 
*step4 - Wall of skin
 
*step5 - Wall of meat
 
*step6 - Wall of bone
 
*step7 - Mirror
 
*step8 - Your Shadow
 
*step9 - Naughty Sorceress
 
*step10 - Prism awaits breaking
 
*finished - Gash is available
 
 
 
===questL13Warehouse===
 
the final quest if you ascend as {{kolwiki|Actually Ed the Undying}} where you adventure in {{kolwiki|The Secret Council Warehouse}}.
 
*unstarted
 
*started
 
*finished
 
Current progress in the warehouse is tracked in warehouseProgress.
 
 
 
==Miscellaneous Quests==
 
===questM01Untinker===
 
=finished
 
===questM02Artist===
 
=unstarted
 
===questM03Bugbear===
 
=unstarted
 
===questM04Galaktic===
 
=started
 
===questM05Toot===
 
=unstarted
 
===questM06Gourd===
 
=unstarted
 
===questM07Hammer===
 
=unstarted
 
===questM08Baker===
 
=unstarted
 
===questM09Rocks===
 
=unstarted
 
===questM10Azazel===
 
questM10Azazel tracks the player's progress in the {{kolwiki|Azazel,_Ma_Belle|Azazel, Ma Belle quest}}.
 
 
 
*unstarted: quest not yet received
 
*started: received the quest, from Azazel or the stranger in Moaning Panda Square
 
*finished: returned Azazel's talismans to him
 
 
 
===questM11Postal===
 
=unstarted
 
===questM12Pirate===
 
questM12Pirate tracks the player's progress in the {{kolwiki|Cap'm Caronch Quest}}.
 
 
 
*unstarted:
 
*started: Cap'm Caronch's Map found
 
*step1: acquired Cap'm Caronch's nasty booty from the booty crab
 
*step2: received the Orcish Frat House blueprints
 
*step3: retrieved Cap'm Caronch's dentures from the Frat House
 
*step4: returned the dentures to the Cap'm and accepted the beer pong challenge
 
*step5: won a game of beer pong
 
*step6: acquired pirate fledges
 
*finished: unlocked Belowdecks
 
 
 
===questM13Escape===
 
=unstarted
 
===questM14Bounty===
 
=unstarted
 
===questM15Lol===
 
=started
 
===questM16Temple===
 
Dakota Fanning's quest to find the Hidden Temple
 
 
 
===questM17Babies===
 
Lady Spookyraven's Babies
 
 
 
===questM18Swamp===
 
Marty and His Swamp Problems
 
 
 
===questM19Hippy===
 
Hippy Give a Hippy a Boat...
 
 
 
===questM20Necklace===
 
questM20Necklace tracks the player's progress in {{kolwiki|Spookyraven_Manor_Quest#Lady_Spookyraven.27s_Necklace_.28First_Floor.29|retrieving Lady Spookyraven's necklace}}.
 
 
 
* unstarted: quest not yet received
 
* started: quest received from the telegram
 
* step1: billiards room key found
 
* step2: (pool skill increased at least once?)*
 
* step3: library key found
 
* step4: necklace found
 
* finished: necklace returned to Lady Spookyraven (quest complete)
 
 
 
<nowiki>*Needs spading.</nowiki>
 
 
 
===questM21Dance===
 
questM21Dance tracks the player's progress in the Second Floor portion of the {{kolwiki|Lady_spookyraven's_dance|Spookyraven Manor quest}}.
 
 
 
*unstarted:
 
*started: quest received, from Lady Spookyraven's ghostly telegram
 
*step1: spoken to Lady Spookyraven on the Second Floor
 
*step2: [apparently not used]
 
*step3: returned Lady Spookyraven's dancing things to her
 
*finished: danced with Lady Spookyraven in the Ballroom
 
 
 
===questM22Shirt===
 
The Shirt Off His Lack of Back
 
 
 
===questM23Meatsmith===
 
Helping Make Ends Meat
 
* unstarted
 
* started
 
* step1 - Got a {{kolwiki|check to the Meatsmith}}.
 
* finished - Returned {{kolwiki|check to the Meatsmith}} to the Meatsmith.
 
 
 
===questM24Doc===
 
What's Up, Doc?
 
* unstarted
 
* started
 
* step1 - Collected the Herbs and need to return them to Doc Galaktik
 
* finished
 
 
 
==Sea Quests==
 
===questS01OldGuy===
 
=finished
 
===questS02Monkee===
 
=unstarted
 
 
 
When Mom is rescued the Quest is completed
 
 
 
=finished
 
 
 
====merkinQuestPath====
 
merkinQuestPath indicates which path the player has chosen in the {{kolwiki|Mer-Kin Deepcity}}, during the {{kolwiki|Sea Monkees Quest}}.
 
 
 
Possible values:
 
* none: Player has not yet chosen a path
 
* gladiator: Player will fight Yog-Urt, Elder Goddess of Hatred
 
* scholar: Player will fight Shub-Jigguwatt, Elder God of Violence
 
* done: Player has completed the Sea Monkees Quest
 
 
 
====skateParkStatus====
 
 
 
==Bug Bear Invasion Properties==
 
 
 
===mothershipProgress===
 
mothershipProgress tracks progress of level completion in the {{kolwiki|Bugbear Mothership}}. It goes from 0 to 3 as that level is cleared.
 
 
 
Possible values: 0-3
 
 
 
===statusEngineering===
 
===statusGalley===
 
===statusMedbay===
 
===statusMorgue===
 
===statusNavigation===
 
===statusScienceLab===
 
===statusSonar===
 
===statusSpecialOps===
 
===statusWasteProcessing===
 
All of these work the same way.
 
*0-x (integers): insufficient bodata collected)
 
*open: all biodata collected and zone accessible
 
* unlocked: biodata collected but zone not yet accessible
 
* cleared: zone has been cleared
 
 
 
==Quests from the Elemental Planes==
 
===Spring Break Beach===
 
The Elemental Plane of Sleaze
 
=====questESlMushStash=====
 
Jimmy's Quest to collect receipts from the Fun-Guy Mansion.
 
=====questESlAudit=====
 
Taco Dan's Quest to collect receipts from the Fun-Guy Mansion.
 
=====questESlBacteria=====
 
Broden's Quest to collect bacteria from the Fun-Guy Mansion.
 
=====questESlCheeseburger=====
 
Jimmy's Quest to collect ingredients from the Sloppy Seconds Diner.
 
=====questESlSprinkles=====
 
Taco Dan's Quest to collect ingredients from the Sloppy Seconds Diner.
 
=====questESlCocktail=====
 
Broden's Quest to collect sprinkles from the Sloppy Seconds Diner.
 
=====questESlSalt=====
 
Jimmy's Quest to collect salt from the Sunken Yacht.
 
=====questESlFish=====
 
Taco Dan's Quest to collect fish meat from the Sunken Yacht.
 
=====questESlDebt=====
 
Broden's Quest to collect broupons from the Sunken Yacht.
 
  
===Conspiracy Island===
+
[[Category:Equipment]]
The Elemental Plane of Spooky
 
=====questESpOutOfOrder=====
 
Deep Dark Jungle - Out of Order
 
=====questESpJunglePun=====
 
Deep Dark Jungle - Pungle in the Jungle
 
=====questESpSmokes=====
 
Deep Dark Jungle - Everyone's Running Out of Smokes
 
=====questESpClipper=====
 
Mansion of Dr. Weirdeaux - The Big Clipper
 
=====questESpSerum=====
 
Mansion of Dr. Weirdeaux - Serum Sortie
 
=====questESpEVE=====
 
Secret Government Laboratory - Choking on the Rind
 
=====questESpFakeMedium=====
 
Secret Government Laboratory - Fake Medium at Large
 
=====questESpGore=====
 
Secret Government Laboratory - Gore Tipper
 

Latest revision as of 16:49, 12 April 2024

Function Syntax

boolean equip(item equip_me )

boolean equip(item equip_me ,slot where )

boolean equip(slot where ,item equip_me )

  • equip_me is the item to equip
  • where is the slot to place the item in

boolean equip(item equip_me ,familiar fam )

boolean equip(familiar fam ,item equip_me )

  • equip_me is the item to equip
  • where is the familiar to equip the item on

Attempts to equip the item equip_me in the slot where if specified, and returns true if the operation was successful, and false if it was not. If parameter where is not specified, it defaults to the "standard" place for such an item (main-hand for 1-handed weapons, first open slot for accessories or acc1 if no slots are open).

  • If where is specified and equip_me is set to $item[none], this function will unequip whatever is in slot where and return true.
  • If where is not specified and equip_me is set to $item[none], the function aborts and you get a funky error because that makes no sense.
  • If you cannot equip equip_me, or where is supplied and the item cannot be used in that slot, you will be given an error message and this function will return false.
  • The overload for equipping a familiar with equip_me can be used to equip familiars with familiar equipment without requiring the familiar to be your currently active familiar. This will return false if you don't have (or can't use) the familiar or if the familiar can't equip the item you are attempting to equip.

 

Code Sample

Equips the Swashbuckling Getup carefully to ensure that the parrot is in the second accessory slot.

equip($item[eyepatch]);
equip($item[swashbuckling pants]);
equip($slot[acc2], $item[stuffed shoulder parrot]);

Code Sample

Equips the blue plate on the Shorter-Order Cook without switching to it first.

equip($familiar[shorter-order cook], $item[blue plate]);

CLI Equivalent

The CLI commands "equip" (and others, for specific slots) function similarly.

See Also

can_equip() | equipped_amount() | equipped_item() | have_equipped()