libram 0.9.5 → 0.9.7

package/dist/resources/2014/ConspiracyIsland.js

@@ -0,0 +1,128 @@
+import { visitUrl, runChoice, handlingChoice } from "kolmafia";
+import { questStep } from "../../lib.js";
+import { Requirement } from "../../maximize.js";
+import { get } from "../../property.js";
+import { $location, $item } from "../../template-string.js";
+class ConspiracyQuest {
+    prop;
+    reward;
+    complete;
+    /** Location in which quest is completed */
+    location;
+    /** Requirements to complete quest */
+    requirements;
+    constructor(prop, reward, complete, location, requirements) {
+        this.prop = prop;
+        this.reward = reward;
+        this.complete = complete;
+        this.location = location;
+        this.requirements = requirements ?? new Requirement([], {});
+    }
+    isOneTime() {
+        return this.reward !== 30;
+    }
+    isStarted() {
+        return questStep(this.prop) >= 0;
+    }
+    isFinished() {
+        return questStep(this.prop) === 999;
+    }
+    isActive() {
+        return this.isStarted() && !this.isFinished();
+    }
+    isReadyToTurnIn() {
+        return questStep(this.prop) === this.complete;
+    }
+}
+export const QUESTS = [
+    new ConspiracyQuest("questESpClipper", 20, 1, $location `The Mansion of Dr. Weirdeaux`),
+    new ConspiracyQuest("questESpEVE", 30, 1, $location `The Secret Government Laboratory`),
+    new ConspiracyQuest("questESpFakeMedium", 30, 1, $location `The Secret Government Laboratory`),
+    new ConspiracyQuest("questESpGore", 20, 2, $location `The Secret Government Laboratory`, new Requirement(["Meat Drop"], { forceEquip: [$item `gore bucket`] })),
+    new ConspiracyQuest("questESpJunglePun", 20, 2, $location `The Deep Dark Jungle`, new Requirement(["Mysticality"], {
+        forceEquip: [$item `encrypted micro-cassette recorder`],
+    })),
+    new ConspiracyQuest("questESpOutOfOrder", 30, 2, $location `The Deep Dark Jungle`, new Requirement(["Initiative"], {
+        forceEquip: [$item `GPS-tracking wristwatch`],
+    })),
+    new ConspiracyQuest("questESpSerum", 30, 1, $location `The Mansion of Dr. Weirdeaux`),
+    new ConspiracyQuest("questESpSmokes", 30, 1, $location `The Deep Dark Jungle`),
+];
+/**
+ * @returns Whether all one-time quests are completed
+ */
+export function completedOneTimeQuests() {
+    return QUESTS.filter((q) => q.isOneTime()).every((q) => q.isFinished());
+}
+/**
+ * Activate a protocol in the bunker
+ * @param protocol Protocol to activate
+ */
+export function activateProtocol(protocol) {
+    visitUrl("place.php?whichplace=airport_spooky_bunker&action=si_controlpanel");
+    runChoice(protocol);
+}
+/**
+ * @returns Current omega charge level
+ */
+export function getOmega() {
+    return get("controlPanelOmega");
+}
+/**
+ * Activate Omega Protocol
+ * @param completeAllQuests Abort if player has not completed all one-time quests
+ */
+export function activateOmega(completeAllQuests = false) {
+    if (get("_controlPanelUsed")) {
+        return;
+    }
+    for (let i = 1; i <= 9; i++) {
+        const active = get(`controlPanel${i}`, false);
+        if (!active) {
+            activateProtocol(i);
+            break;
+        }
+    }
+    if (getOmega() < 99 || (!completedOneTimeQuests() && completeAllQuests))
+        return;
+    activateProtocol(1);
+    activateProtocol(10);
+}
+function visitRadio() {
+    return visitUrl("place.php?whichplace=airport_spooky&action=airport2_radio");
+}
+/**
+ * @param accept Whether to accept a quest if one is not currently active
+ * @returns Returns the current quest or null if no quest is active
+ */
+export function getQuest(accept = false) {
+    const active = QUESTS.find((q) => q.isActive());
+    if (active)
+        return active;
+    if (!accept)
+        return null;
+    // Sometimes we need to hit the radio a few times to successfully parse the quest
+    for (let i = 0; i < 11; i++) {
+        const page = visitRadio();
+        if (!handlingChoice())
+            return null;
+        if (page.includes("try again tomorrow"))
+            return null;
+        const quest = get("_questESp");
+        if (quest !== "")
+            return QUESTS.find((q) => q.prop === quest) ?? null;
+    }
+    return null;
+}
+/**
+ * Turn in the current quest
+ * @returns Success of turning in the quest
+ */
+export function turnInQuest() {
+    const quest = getQuest();
+    if (!quest?.isReadyToTurnIn())
+        return false;
+    visitRadio();
+    runChoice(1);
+    return quest.isFinished();
+}

package/dist/resources/2015/Dinseylandfill.js

@@ -129,7 +129,7 @@ export function acceptQuest(priority) {
         jobs.push(quest.name);
     });
     const priorityNum = typeof priority === "string"
-        ? quests.find((q) => q.name === priority)?.priority ?? 7
+        ? (quests.find((q) => q.name === priority)?.priority ?? 7)
         : priority;
     const availableJobs = [];
     const jobChoices = [["none", 999]];

package/dist/resources/2017/AsdonMartin.js

@@ -162,8 +162,10 @@ export function fillTo(targetUnits) {
         }
         if (!canInteract())
             retrieveItem(count, bestFuel);
+        else if (ceiling)
+            buy(count, bestFuel, ceiling);
         else
-            ceiling ? buy(count, bestFuel, ceiling) : buy(count, bestFuel);
+            buy(count, bestFuel);
         if (!insertFuel(bestFuel, Math.min(itemAmount(bestFuel), count))) {
             throw new Error("Failed to fuel Asdon Martin.");
         }

package/dist/resources/2017/Spacegate.js

@@ -6,7 +6,6 @@ import { $item } from "../../template-string.js";
  */
 export function have() {
     return get("spacegateAlways");
-    ("");
 }
 /**
  * Refreshes the data from the Spacegate Terminal to determine current Spacegate Status

package/dist/resources/2019/PocketProfessor.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @returns Whether you `have` the Pocket Professor
+ */
+export declare function have(): boolean;
+/**
+ * @returns Whether or not you're currently able to `Deliver your Thesis`
+ */
+export declare function canThesis(): boolean;
+/**
+ * Calculate the total number of lectures available to you given a particular familiar weight and chip-equipped status
+ * @param weight The weight to calculate at--defaults to your current total familiar weight
+ * @param includeChip Whether or not to include the memory chip--defaults to whether or not it's currently equipped
+ * @returns The total number of lectures you're able to deliver, including ones you've already delivered today
+ */
+export declare function totalAvailableLectures(weight?: number, includeChip?: boolean): number;
+/**
+ * @returns The number of Pocket Professor lectures you've delivered today
+ */
+export declare function lecturesDelivered(): number;
+/**
+ * Calculate the number of unused lectures available to you given a particular familiar weight and chip-equipped status
+ * @param weight The weight to calculate at--defaults to your current total familiar weight
+ * @param includeChip Whether or not to include the memory chip--defaults to whether or not it's currently equipped
+ * @returns The number of lectures you're able to deliver, accounting for any you've already delivered today
+ */
+export declare function currentlyAvailableLectures(weight?: number, includeChip?: boolean): number;

package/dist/resources/2019/PocketProfessor.js

@@ -0,0 +1,41 @@
+import { haveEquipped } from "kolmafia";
+import { have as have_, totalFamiliarWeight } from "../../lib.js";
+import { get } from "../../property.js";
+import { $familiar, $item } from "../../template-string.js";
+const familiar = $familiar `Pocket Professor`;
+/**
+ * @returns Whether you `have` the Pocket Professor
+ */
+export function have() {
+    return have_(familiar);
+}
+/**
+ * @returns Whether or not you're currently able to `Deliver your Thesis`
+ */
+export function canThesis() {
+    return have() && familiar.experience >= 400 && !get("_thesisDelivered");
+}
+/**
+ * Calculate the total number of lectures available to you given a particular familiar weight and chip-equipped status
+ * @param weight The weight to calculate at--defaults to your current total familiar weight
+ * @param includeChip Whether or not to include the memory chip--defaults to whether or not it's currently equipped
+ * @returns The total number of lectures you're able to deliver, including ones you've already delivered today
+ */
+export function totalAvailableLectures(weight = totalFamiliarWeight(familiar), includeChip = haveEquipped($item `Pocket Professor memory chip`)) {
+    return (includeChip ? 2 : 0) + Math.floor(Math.sqrt(weight - 1));
+}
+/**
+ * @returns The number of Pocket Professor lectures you've delivered today
+ */
+export function lecturesDelivered() {
+    return get("_pocketProfessorLectures");
+}
+/**
+ * Calculate the number of unused lectures available to you given a particular familiar weight and chip-equipped status
+ * @param weight The weight to calculate at--defaults to your current total familiar weight
+ * @param includeChip Whether or not to include the memory chip--defaults to whether or not it's currently equipped
+ * @returns The number of lectures you're able to deliver, accounting for any you've already delivered today
+ */
+export function currentlyAvailableLectures(weight = totalFamiliarWeight(familiar), includeChip = haveEquipped($item `Pocket Professor memory chip`)) {
+    return totalAvailableLectures(weight, includeChip) - lecturesDelivered();
+}

package/dist/resources/2020/RetroCape.d.ts

@@ -23,7 +23,7 @@ declare const Heroes: {
 };
 type Hero = keyof typeof Heroes;
 type Mode = "hold" | "thrill" | "kiss" | "kill";
-export declare const currentHero: () => "vampire" | "heck" | "robot";
+export declare const currentHero: () => Hero;
 export declare const currentMode: () => Mode;
 /**
  * Tunes retro cape to a given setting

package/dist/resources/2021/DaylightShavings.d.ts

@@ -1,4 +1,5 @@
 import { Effect } from "kolmafia";
+import { Tuple } from "../../utils.js";
 /**
  * Returns whether the player owns an unpackaged Daylight Shavings Helmet, and it's available in either the inventory or other zones as determined by autoSatisfy settings.
  *
@@ -22,9 +23,9 @@ export declare function buffAvailable(): boolean;
  * Calculates and returns the cycle of buffs that the hat should cycle through.
  *
  * @param playerclass The class to generate a cycle for
- * @returns An ordered array consisting of the cycle for this class. The first element of the array will be the first buff a player should expect to get in a given ascension.
+ * @returns An ordered 11-tuple consisting of the cycle for this class. The first element of the array will be the first buff a player should expect to get in a given ascension.
  */
-export declare function buffCycle(playerclass?: import("kolmafia").Class): Effect[];
+export declare function buffCycle(playerclass?: import("kolmafia").Class): Tuple<Effect, 11>;
 /**
  * Returns the next buff we expect to get from the shaving hat.
  *

package/dist/resources/2021/DaylightShavings.js

@@ -1,7 +1,8 @@
-import { myClass, toEffect } from "kolmafia";
+import { Effect, myClass, toEffect } from "kolmafia";
 import { have as haveItem } from "../../lib.js";
 import { get } from "../../property.js";
 import { $effects, $item } from "../../template-string.js";
+import { tuple } from "../../utils.js";
 const helmet = $item `Daylight Shavings Helmet`;
 /**
  * Returns whether the player owns an unpackaged Daylight Shavings Helmet, and it's available in either the inventory or other zones as determined by autoSatisfy settings.
@@ -32,19 +33,19 @@ export function buffAvailable() {
  * Calculates and returns the cycle of buffs that the hat should cycle through.
  *
  * @param playerclass The class to generate a cycle for
- * @returns An ordered array consisting of the cycle for this class. The first element of the array will be the first buff a player should expect to get in a given ascension.
+ * @returns An ordered 11-tuple consisting of the cycle for this class. The first element of the array will be the first buff a player should expect to get in a given ascension.
  */
 export function buffCycle(playerclass = myClass()) {
+    const cycle = tuple(Effect.none, Effect.none, Effect.none, Effect.none, Effect.none, Effect.none, Effect.none, Effect.none, Effect.none, Effect.none, Effect.none);
     if (playerclass.id <= 0)
-        return [];
-    const returnValue = [];
+        return cycle;
     const id = playerclass.id;
     const seed = id > 6 ? (id % 6) + 1 : id;
     for (let i = 1; i < 12; i++) {
         const index = (i * seed) % 11;
-        returnValue.push(buffs[index]);
+        cycle[i - 1] = buffs[index];
     }
-    return returnValue;
+    return cycle;
 }
 /**
  * Returns the next buff we expect to get from the shaving hat.

package/dist/resources/2024/MayamCalendar.d.ts

@@ -61,7 +61,7 @@ export declare const RESONANCES: Readonly<{
     "chair yam2 yam3 clock": Effect;
     "yam1 yam2 cheese clock": Effect;
 }>;
-export declare const RESONANCE_KEYS: ("sword yam2 eyepatch explosion" | "yam1 meat cheese yam4" | "yam1 meat eyepatch yam4" | "yam1 lightning yam3 clock" | "yam1 yam2 yam3 explosion" | "yam1 yam2 cheese clock" | "eye yam2 eyepatch yam4" | "chair yam2 yam3 clock" | "fur lightning eyepatch yam4" | "fur yam2 wall yam4" | "vessel yam2 cheese explosion")[];
+export declare const RESONANCE_KEYS: (keyof typeof RESONANCES)[];
 /**
  * Find the combination needed to get a particular resonance
  * @param target The Item or Effect granted by the resonance

package/dist/resources/2024/TearawayPants.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @returns Whether you `have` the tearaway pants
+ */
+export declare function have(): boolean;
+/**
+ * Calculate the chance of getting adventures from a fight against plants
+ * @param advs The number of adventures to calculate the probability at; defaults to the current value
+ * @returns The likelihood of getting an adventure from ripping off your pants against plants
+ */
+export declare function plantsAdventureChance(advs?: number): number;
+/**
+ * Calculate the expected total number of pant-plant adventures you'll gain over a period
+ * @param turnsToSpend The total number of plant-combats you expect to spend
+ * @param startingAdvs The number of pant-plants adventures to start with--defaults to the current value
+ * @returns The expected total number of adventures to gain over the period
+ */
+export declare function expectedTotalAdventures(turnsToSpend: number, startingAdvs?: number): number;
+/**
+ * Attempt to unlock the moxie guild--for free--using these incredible pants
+ * @returns Whether we've successfully unlocked the moxie guild
+ */
+export declare function unlockGuild(): boolean;

package/dist/resources/2024/TearawayPants.js

@@ -0,0 +1,52 @@
+import { myClass, cliExecute, equip, visitUrl } from "kolmafia";
+import { have as have_, questStep } from "../../lib.js";
+import { get } from "../../property.js";
+import { $classes, $item, $slot } from "../../template-string.js";
+const item = $item `tearaway pants`;
+/**
+ * @returns Whether you `have` the tearaway pants
+ */
+export function have() {
+    return have_(item);
+}
+/**
+ * Calculate the chance of getting adventures from a fight against plants
+ * @param advs The number of adventures to calculate the probability at; defaults to the current value
+ * @returns The likelihood of getting an adventure from ripping off your pants against plants
+ */
+export function plantsAdventureChance(advs = get("_tearawayPantsAdvs")) {
+    return 1 / (2 + advs);
+}
+/**
+ * Calculate the expected total number of pant-plant adventures you'll gain over a period
+ * @param turnsToSpend The total number of plant-combats you expect to spend
+ * @param startingAdvs The number of pant-plants adventures to start with--defaults to the current value
+ * @returns The expected total number of adventures to gain over the period
+ */
+export function expectedTotalAdventures(turnsToSpend, startingAdvs = get("_tearawayPantsAdvs")) {
+    return ((1 -
+        2 * startingAdvs +
+        Math.sqrt(4 * startingAdvs ** 2 - 4 * startingAdvs + 1 + 8 * turnsToSpend)) /
+        2);
+}
+/**
+ * Attempt to unlock the moxie guild--for free--using these incredible pants
+ * @returns Whether we've successfully unlocked the moxie guild
+ */
+export function unlockGuild() {
+    if (!$classes `Disco Bandit, Accordion Thief`.includes(myClass()))
+        return false;
+    if (questStep("questG08Moxie") >= 999)
+        return true;
+    if (!have())
+        return false;
+    try {
+        cliExecute("checkpoint");
+        equip($slot `pants`, item);
+        visitUrl("guild.php?place=challenge");
+    }
+    finally {
+        cliExecute("outfit checkpoint");
+    }
+    return questStep("questG08Moxie") >= 999;
+}

package/dist/resources/index.d.ts

@@ -9,6 +9,7 @@ import * as RainDoh from "./2012/RainDoh.js";
 import * as ReagnimatedGnome from "./2012/ReagnimatedGnome.js";
 import * as FloristFriar from "./2013/Florist.js";
 import * as JungMan from "./2013/JungMan.js";
+import * as ConspiracyIsland from "./2014/ConspiracyIsland.js";
 import * as CrimboShrub from "./2014/CrimboShrub.js";
 import * as DNALab from "./2014/DNALab.js";
 import * as WinterGarden from "./2014/WinterGarden.js";
@@ -31,6 +32,7 @@ import * as Latte from "./2018/LatteLoversMembersMug.js";
 import * as SongBoom from "./2018/SongBoom.js";
 import * as BeachComb from "./2019/BeachComb.js";
 import * as CampAway from "./2019/CampAway.js";
+import * as PocketProfessor from "./2019/PocketProfessor.js";
 import * as Snapper from "./2019/Snapper.js";
 import * as Cartography from "./2020/Cartography.js";
 import * as Guzzlr from "./2020/Guzzlr.js";
@@ -50,6 +52,7 @@ import * as CursedMonkeyPaw from "./2023/CursedMonkeyPaw.js";
 import * as AprilingBandHelmet from "./2024/AprilingBandHelmet.js";
 import * as ChestMimic from "./2024/ChestMimic.js";
 import * as MayamCalendar from "./2024/MayamCalendar.js";
-export { AprilingBandHelmet, AugustScepter, AutumnAton, AsdonMartin, Bandersnatch, BarrelShrine, BeachComb, BurningLeaves, CampAway, Cartography, ChateauMantegna, ChestMimic, CinchoDeMayo, ClosedCircuitPayphone, CombatLoversLocket, CrimboShrub, CrownOfThrones, CrystalBall, CursedMonkeyPaw, DaylightShavings, DeckOfEveryCard, Dinseylandfill, DNALab, FloristFriar, GingerBread, GreyGoose, Guzzlr, Horsery, JuneCleaver, JungMan, Latte, LookingGlass, MayamCalendar, MayoClinic, MummingTrunk, ObtuseAngel, Pantogram, RainDoh, ReagnimatedGnome, RetroCape, Robortender, Snapper, SongBoom, SourceTerminal, Spacegate, SpookyPutty, Stickers, StompingBoots, TrainSet, TunnelOfLove, WinterGarden, Witchess, };
+import * as TearawayPants from "./2024/TearawayPants.js";
+export { AprilingBandHelmet, AugustScepter, AutumnAton, AsdonMartin, Bandersnatch, BarrelShrine, BeachComb, BurningLeaves, CampAway, Cartography, ChateauMantegna, ChestMimic, CinchoDeMayo, ClosedCircuitPayphone, CombatLoversLocket, ConspiracyIsland, CrimboShrub, CrownOfThrones, CrystalBall, CursedMonkeyPaw, DaylightShavings, DeckOfEveryCard, Dinseylandfill, DNALab, FloristFriar, GingerBread, GreyGoose, Guzzlr, Horsery, JuneCleaver, JungMan, Latte, LookingGlass, MayamCalendar, MayoClinic, MummingTrunk, ObtuseAngel, Pantogram, PocketProfessor, RainDoh, ReagnimatedGnome, RetroCape, Robortender, Snapper, SongBoom, SourceTerminal, Spacegate, SpookyPutty, Stickers, StompingBoots, TearawayPants, TrainSet, TunnelOfLove, WinterGarden, Witchess, };
 export * from "./putty-likes.js";
 export * from "./LibramSummon.js";

package/dist/resources/index.js

@@ -9,6 +9,7 @@ import * as RainDoh from "./2012/RainDoh.js";
 import * as ReagnimatedGnome from "./2012/ReagnimatedGnome.js";
 import * as FloristFriar from "./2013/Florist.js";
 import * as JungMan from "./2013/JungMan.js";
+import * as ConspiracyIsland from "./2014/ConspiracyIsland.js";
 import * as CrimboShrub from "./2014/CrimboShrub.js";
 import * as DNALab from "./2014/DNALab.js";
 import * as WinterGarden from "./2014/WinterGarden.js";
@@ -31,6 +32,7 @@ import * as Latte from "./2018/LatteLoversMembersMug.js";
 import * as SongBoom from "./2018/SongBoom.js";
 import * as BeachComb from "./2019/BeachComb.js";
 import * as CampAway from "./2019/CampAway.js";
+import * as PocketProfessor from "./2019/PocketProfessor.js";
 import * as Snapper from "./2019/Snapper.js";
 import * as Cartography from "./2020/Cartography.js";
 import * as Guzzlr from "./2020/Guzzlr.js";
@@ -50,6 +52,7 @@ import * as CursedMonkeyPaw from "./2023/CursedMonkeyPaw.js";
 import * as AprilingBandHelmet from "./2024/AprilingBandHelmet.js";
 import * as ChestMimic from "./2024/ChestMimic.js";
 import * as MayamCalendar from "./2024/MayamCalendar.js";
-export { AprilingBandHelmet, AugustScepter, AutumnAton, AsdonMartin, Bandersnatch, BarrelShrine, BeachComb, BurningLeaves, CampAway, Cartography, ChateauMantegna, ChestMimic, CinchoDeMayo, ClosedCircuitPayphone, CombatLoversLocket, CrimboShrub, CrownOfThrones, CrystalBall, CursedMonkeyPaw, DaylightShavings, DeckOfEveryCard, Dinseylandfill, DNALab, FloristFriar, GingerBread, GreyGoose, Guzzlr, Horsery, JuneCleaver, JungMan, Latte, LookingGlass, MayamCalendar, MayoClinic, MummingTrunk, ObtuseAngel, Pantogram, RainDoh, ReagnimatedGnome, RetroCape, Robortender, Snapper, SongBoom, SourceTerminal, Spacegate, SpookyPutty, Stickers, StompingBoots, TrainSet, TunnelOfLove, WinterGarden, Witchess, };
+import * as TearawayPants from "./2024/TearawayPants.js";
+export { AprilingBandHelmet, AugustScepter, AutumnAton, AsdonMartin, Bandersnatch, BarrelShrine, BeachComb, BurningLeaves, CampAway, Cartography, ChateauMantegna, ChestMimic, CinchoDeMayo, ClosedCircuitPayphone, CombatLoversLocket, ConspiracyIsland, CrimboShrub, CrownOfThrones, CrystalBall, CursedMonkeyPaw, DaylightShavings, DeckOfEveryCard, Dinseylandfill, DNALab, FloristFriar, GingerBread, GreyGoose, Guzzlr, Horsery, JuneCleaver, JungMan, Latte, LookingGlass, MayamCalendar, MayoClinic, MummingTrunk, ObtuseAngel, Pantogram, PocketProfessor, RainDoh, ReagnimatedGnome, RetroCape, Robortender, Snapper, SongBoom, SourceTerminal, Spacegate, SpookyPutty, Stickers, StompingBoots, TearawayPants, TrainSet, TunnelOfLove, WinterGarden, Witchess, };
 export * from "./putty-likes.js";
 export * from "./LibramSummon.js";

package/dist/template-string.d.ts

@@ -8,6 +8,7 @@ export declare const $bounty: {
     (literals: TemplateStringsArray, ...placeholders: string[]): Bounty;
     cls: typeof MafiaClass & (new () => Bounty);
     none: Bounty;
+    get(name: string): Bounty | null;
 };
 /**
  * A list of Bounties specified by a comma-separated list of names.
@@ -28,6 +29,7 @@ export declare const $class: {
     (literals: TemplateStringsArray, ...placeholders: string[]): Class;
     cls: typeof MafiaClass & (new () => Class);
     none: Class;
+    get(name: string): Class | null;
 };
 /**
  * A list of Classes specified by a comma-separated list of names.
@@ -48,6 +50,7 @@ export declare const $coinmaster: {
     (literals: TemplateStringsArray, ...placeholders: string[]): Coinmaster;
     cls: typeof MafiaClass & (new () => Coinmaster);
     none: Coinmaster;
+    get(name: string): Coinmaster | null;
 };
 /**
  * A list of Coinmasters specified by a comma-separated list of names.
@@ -68,6 +71,7 @@ export declare const $effect: {
     (literals: TemplateStringsArray, ...placeholders: string[]): Effect;
     cls: typeof MafiaClass & (new () => Effect);
     none: Effect;
+    get(name: string): Effect | null;
 };
 /**
  * A list of Effects specified by a comma-separated list of names.
@@ -88,6 +92,7 @@ export declare const $element: {
     (literals: TemplateStringsArray, ...placeholders: string[]): Element;
     cls: typeof MafiaClass & (new () => Element);
     none: Element;
+    get(name: string): Element | null;
 };
 /**
  * A list of Elements specified by a comma-separated list of names.
@@ -108,6 +113,7 @@ export declare const $familiar: {
     (literals: TemplateStringsArray, ...placeholders: string[]): Familiar;
     cls: typeof MafiaClass & (new () => Familiar);
     none: Familiar;
+    get(name: string): Familiar | null;
 };
 /**
  * A list of Familiars specified by a comma-separated list of names.
@@ -128,6 +134,7 @@ export declare const $item: {
     (literals: TemplateStringsArray, ...placeholders: string[]): Item;
     cls: typeof MafiaClass & (new () => Item);
     none: Item;
+    get(name: string): Item | null;
 };
 /**
  * A list of Items specified by a comma-separated list of names.
@@ -148,6 +155,7 @@ export declare const $location: {
     (literals: TemplateStringsArray, ...placeholders: string[]): Location;
     cls: typeof MafiaClass & (new () => Location);
     none: Location;
+    get(name: string): Location | null;
 };
 /**
  * A list of Locations specified by a comma-separated list of names.
@@ -168,6 +176,7 @@ export declare const $modifier: {
     (literals: TemplateStringsArray, ...placeholders: string[]): Modifier;
     cls: typeof MafiaClass & (new () => Modifier);
     none: Modifier;
+    get(name: string): Modifier | null;
 };
 /**
  * A list of Modifiers specified by a comma-separated list of names.
@@ -188,6 +197,7 @@ export declare const $monster: {
     (literals: TemplateStringsArray, ...placeholders: string[]): Monster;
     cls: typeof MafiaClass & (new () => Monster);
     none: Monster;
+    get(name: string): Monster | null;
 };
 /**
  * A list of Monsters specified by a comma-separated list of names.
@@ -199,6 +209,27 @@ export declare const $monsters: {
     (literals: TemplateStringsArray, ...placeholders: string[]): Monster[];
     all(): Monster[];
 };
+/**
+ * A Path specified by name.
+ *
+ * @category In-game constant
+ */
+export declare const $path: {
+    (literals: TemplateStringsArray, ...placeholders: string[]): Path;
+    cls: typeof MafiaClass & (new () => Path);
+    none: Path;
+    get(name: string): Path | null;
+};
+/**
+ * A list of Paths specified by a comma-separated list of names.
+ * For a list of all possible Paths, leave the template string blank.
+ *
+ * @category In-game constant
+ */
+export declare const $paths: {
+    (literals: TemplateStringsArray, ...placeholders: string[]): Path[];
+    all(): Path[];
+};
 /**
  * A Phylum specified by name.
  *
@@ -208,6 +239,7 @@ export declare const $phylum: {
     (literals: TemplateStringsArray, ...placeholders: string[]): Phylum;
     cls: typeof MafiaClass & (new () => Phylum);
     none: Phylum;
+    get(name: string): Phylum | null;
 };
 /**
  * A list of Phyla specified by a comma-separated list of names.
@@ -228,6 +260,7 @@ export declare const $servant: {
     (literals: TemplateStringsArray, ...placeholders: string[]): Servant;
     cls: typeof MafiaClass & (new () => Servant);
     none: Servant;
+    get(name: string): Servant | null;
 };
 /**
  * A list of Servants specified by a comma-separated list of names.
@@ -248,6 +281,7 @@ export declare const $skill: {
     (literals: TemplateStringsArray, ...placeholders: string[]): Skill;
     cls: typeof MafiaClass & (new () => Skill);
     none: Skill;
+    get(name: string): Skill | null;
 };
 /**
  * A list of Skills specified by a comma-separated list of names.
@@ -268,6 +302,7 @@ export declare const $slot: {
     (literals: TemplateStringsArray, ...placeholders: string[]): Slot;
     cls: typeof MafiaClass & (new () => Slot);
     none: Slot;
+    get(name: string): Slot | null;
 };
 /**
  * A list of Slots specified by a comma-separated list of names.
@@ -288,6 +323,7 @@ export declare const $stat: {
     (literals: TemplateStringsArray, ...placeholders: string[]): Stat;
     cls: typeof MafiaClass & (new () => Stat);
     none: Stat;
+    get(name: string): Stat | null;
 };
 /**
  * A list of Stats specified by a comma-separated list of names.
@@ -308,6 +344,7 @@ export declare const $thrall: {
     (literals: TemplateStringsArray, ...placeholders: string[]): Thrall;
     cls: typeof MafiaClass & (new () => Thrall);
     none: Thrall;
+    get(name: string): Thrall | null;
 };
 /**
  * A list of Thralls specified by a comma-separated list of names.
@@ -319,23 +356,3 @@ export declare const $thralls: {
     (literals: TemplateStringsArray, ...placeholders: string[]): Thrall[];
     all(): Thrall[];
 };
-/**
- * A Path specified by name.
- *
- * @category In-game constant
- */
-export declare const $path: {
-    (literals: TemplateStringsArray, ...placeholders: string[]): Path;
-    cls: typeof MafiaClass & (new () => Path);
-    none: Path;
-};
-/**
- * A list of Paths specified by a comma-separated list of names.
- * For a list of all possible Paths, leave the template string blank.
- *
- * @category In-game constant
- */
-export declare const $paths: {
-    (literals: TemplateStringsArray, ...placeholders: string[]): Path[];
-    all(): Path[];
-};