isaacscript-common 17.5.0 → 17.7.0

package/dist/index.d.ts

@@ -6965,7 +6965,16 @@ declare interface IsaacAPIClassTypeToType {
 }
 
 /**
- * Iterates over all inputs to determine if a particular button is pressed (i.e. held down).
+ * Helper function to check if a player is pressing a specific button (i.e. holding it down).
+ *
+ * This is a variadic version of `Input.IsActionPressed`, meaning that you can pass as many buttons
+ * as you want to check for. This function will return true if any of the buttons are pressed.
+ */
+export declare function isActionPressed(controllerIndex: ControllerIndex, ...buttonActions: ButtonAction[]): boolean;
+
+/**
+ * Helper function to iterate over all inputs to determine if a specific button is pressed (i.e.
+ * being held down).
  *
  * This function is variadic, meaning you can pass as many buttons as you want to check for. This
  * function will return true if any of the buttons are pressed.
@@ -6973,8 +6982,18 @@ declare interface IsaacAPIClassTypeToType {
 export declare function isActionPressedOnAnyInput(...buttonActions: ButtonAction[]): boolean;
 
 /**
- * Iterates over all inputs to determine if a particular button is triggered (i.e. held down and
- * then released).
+ * Helper function to check if a player is triggering a specific button (i.e. pressing and releasing
+ * it).
+ *
+ * This is a variadic version of `Input.IsActionTriggered`, meaning that you can pass as many
+ * buttons as you want to check for. This function will return true if any of the buttons are
+ * triggered.
+ */
+export declare function isActionTriggered(controllerIndex: ControllerIndex, ...buttonActions: ButtonAction[]): boolean;
+
+/**
+ * Iterates over all inputs to determine if a specific button is triggered (i.e. held down and then
+ * released).
  *
  * This function is variadic, meaning you can pass as many buttons as you want to check for. This
  * function will return true if any of the buttons are pressed.
@@ -7507,7 +7526,7 @@ export declare function isKeeper(player: EntityPlayer): boolean;
 export declare function isKey(pickup: EntityPickup): pickup is EntityPickupKey;
 
 /**
- * Helper function to see if a particular keyboard key is being pressed down by the player.
+ * Helper function to see if a specific keyboard key is being held down by the player.
  *
  * This function is variadic, meaning you can pass as many keyboard values as you want to check for.
  * This function will return true if any of the values are pressed.
@@ -10864,12 +10883,18 @@ declare class ModdedElementSets extends Feature {
      * - any runes
      * - any objects like Dice Shard
      *
+     * In order to use this function, you must upgrade your mod with `ISCFeature.MODDED_ELEMENT_SETS`.
+     *
      * @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided,
      *                  the `RNG.Next` method will be called. Default is `getRandomSeed()`.
      * @param exceptions Optional. An array of cards to not select.
      */
     getRandomCard(seedOrRNG?: Seed | RNG, exceptions?: CardType[]): CardType;
     /**
+     * Helper function to get a random card type that matches the provided `ItemConfigCardType`.
+     *
+     * In order to use this function, you must upgrade your mod with `ISCFeature.MODDED_ELEMENT_SETS`.
+     *
      * @param itemConfigCardType The item config card type that represents the pool of cards to select
      *                           from.
      * @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided,
@@ -10881,6 +10906,8 @@ declare class ModdedElementSets extends Feature {
      * Has an equal chance of returning any rune (e.g. Rune of Hagalaz, Blank Rune, Black Rune, Soul
      * of Isaac, etc.). This will never return a Rune Shard.
      *
+     * In order to use this function, you must upgrade your mod with `ISCFeature.MODDED_ELEMENT_SETS`.
+     *
      * @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided,
      *                  the `RNG.Next` method will be called. Default is `getRandomSeed()`.
      * @param exceptions Optional. An array of runes to not select.
@@ -11039,6 +11066,17 @@ declare class ModdedElementSets extends Feature {
  */
 export declare class ModFeature {
     private mod;
+    /**
+     * An optional function that allows for conditional callback execution. If specified, any class
+     * method that is annotated with a `@Callback` or `@CallbackCustom` decorator will only be fired
+     * if the executed conditional function returns true.
+     *
+     * This property is used to easily turn entire mod features on and off (rather than repeating
+     * conditional logic and early returning at the beginning of every callback function).
+     *
+     * By default, this is set to null. Override this property in your class if you need to use it.
+     */
+    private callbackConditionalFunc;
     /**
      * Whether or not the feature has registered its callbacks yet (and submitted its variables to the
      * save data manager, if any).

package/dist/isaacscript-common.lua

@@ -1,6 +1,6 @@
 --[[
 
-isaacscript-common 17.5.0
+isaacscript-common 17.7.0
 
 This is the "isaacscript-common" library, which was created with the IsaacScript tool.
 
@@ -34863,25 +34863,41 @@ end
 function ____exports.getShootActions(self)
     return ____exports.SHOOTING_ACTIONS_SET
 end
+function ____exports.isActionPressed(self, controllerIndex, ...)
+    local buttonActions = {...}
+    return __TS__ArraySome(
+        buttonActions,
+        function(____, buttonAction) return Input.IsActionPressed(buttonAction, controllerIndex) end
+    )
+end
 function ____exports.isActionPressedOnAnyInput(self, ...)
     local buttonActions = {...}
     local controllerIndexes = getEnumValues(nil, ControllerIndex)
     return __TS__ArraySome(
         controllerIndexes,
-        function(____, controllerIndex) return __TS__ArraySome(
-            buttonActions,
-            function(____, buttonAction) return Input.IsActionPressed(buttonAction, controllerIndex) end
+        function(____, controllerIndex) return ____exports.isActionPressed(
+            nil,
+            controllerIndex,
+            table.unpack(buttonActions)
         ) end
     )
 end
+function ____exports.isActionTriggered(self, controllerIndex, ...)
+    local buttonActions = {...}
+    return __TS__ArraySome(
+        buttonActions,
+        function(____, buttonAction) return Input.IsActionTriggered(buttonAction, controllerIndex) end
+    )
+end
 function ____exports.isActionTriggeredOnAnyInput(self, ...)
     local buttonActions = {...}
     local controllerIndexes = getEnumValues(nil, ControllerIndex)
     return __TS__ArraySome(
         controllerIndexes,
-        function(____, controllerIndex) return __TS__ArraySome(
-            buttonActions,
-            function(____, buttonAction) return Input.IsActionTriggered(buttonAction, controllerIndex) end
+        function(____, controllerIndex) return ____exports.isActionTriggered(
+            nil,
+            controllerIndex,
+            table.unpack(buttonActions)
         ) end
     )
 end
@@ -49196,6 +49212,13 @@ function initDecoratedCallbacks(self, modFeature, constructor, tstlClassName, va
 end
 function addCallback(self, modFeature, modFeatureConstructor, mod, modCallback, callback, parameters, vanilla)
     local function wrappedCallback(____, ...)
+        local conditionalFunc = modFeature.callbackConditionalFunc
+        if conditionalFunc ~= nil then
+            local shouldRun = conditionalFunc(nil)
+            if not shouldRun then
+                return nil
+            end
+        end
         local castedCallback = callback
         return castedCallback(modFeature, ...)
     end
@@ -49284,6 +49307,7 @@ function ModFeature.prototype.____constructor(self, mod, init)
     if init == nil then
         init = true
     end
+    self.callbackConditionalFunc = nil
     self.initialized = false
     self.mod = mod
     if init then

package/dist/src/classes/ModFeature.d.ts

@@ -36,6 +36,17 @@ export declare const ADD_CALLBACK_CUSTOM_ARGS_KEY = "__addCallbackCustomArgs";
  */
 export declare class ModFeature {
     private mod;
+    /**
+     * An optional function that allows for conditional callback execution. If specified, any class
+     * method that is annotated with a `@Callback` or `@CallbackCustom` decorator will only be fired
+     * if the executed conditional function returns true.
+     *
+     * This property is used to easily turn entire mod features on and off (rather than repeating
+     * conditional logic and early returning at the beginning of every callback function).
+     *
+     * By default, this is set to null. Override this property in your class if you need to use it.
+     */
+    private callbackConditionalFunc;
     /**
      * Whether or not the feature has registered its callbacks yet (and submitted its variables to the
      * save data manager, if any).

package/dist/src/classes/ModFeature.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ModFeature.d.ts","sourceRoot":"","sources":["../../../src/classes/ModFeature.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,eAAO,MAAM,qBAAqB,sBAAsB,CAAC;AACzD,eAAO,MAAM,4BAA4B,4BAA4B,CAAC;AAatE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,qBAAa,UAAU;IACrB,OAAO,CAAC,GAAG,CAAkB;IAE7B;;;;;;OAMG;IACI,WAAW,UAAS;gBAEf,GAAG,EAAE,eAAe,EAAE,IAAI,UAAO;IAQ7C;;;;;OAKG;IACI,IAAI,CAAC,IAAI,UAAO,GAAG,IAAI;IAqB9B;;;;;;OAMG;IACI,MAAM,IAAI,IAAI;CAGtB"}
+{"version":3,"file":"ModFeature.d.ts","sourceRoot":"","sources":["../../../src/classes/ModFeature.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,eAAO,MAAM,qBAAqB,sBAAsB,CAAC;AACzD,eAAO,MAAM,4BAA4B,4BAA4B,CAAC;AAatE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,qBAAa,UAAU;IACrB,OAAO,CAAC,GAAG,CAAkB;IAE7B;;;;;;;;;OASG;IACH,OAAO,CAAC,uBAAuB,CAAgC;IAE/D;;;;;;OAMG;IACI,WAAW,UAAS;gBAEf,GAAG,EAAE,eAAe,EAAE,IAAI,UAAO;IAQ7C;;;;;OAKG;IACI,IAAI,CAAC,IAAI,UAAO,GAAG,IAAI;IAqB9B;;;;;;OAMG;IACI,MAAM,IAAI,IAAI;CAGtB"}

package/dist/src/classes/ModFeature.lua

@@ -63,6 +63,13 @@ function initDecoratedCallbacks(self, modFeature, constructor, tstlClassName, va
 end
 function addCallback(self, modFeature, modFeatureConstructor, mod, modCallback, callback, parameters, vanilla)
     local function wrappedCallback(____, ...)
+        local conditionalFunc = modFeature.callbackConditionalFunc
+        if conditionalFunc ~= nil then
+            local shouldRun = conditionalFunc(nil)
+            if not shouldRun then
+                return nil
+            end
+        end
         local castedCallback = callback
         return castedCallback(modFeature, ...)
     end
@@ -182,6 +189,7 @@ function ModFeature.prototype.____constructor(self, mod, init)
     if init == nil then
         init = true
     end
+    self.callbackConditionalFunc = nil
     self.initialized = false
     self.mod = mod
     if init then

package/dist/src/classes/features/other/ModdedElementSets.d.ts

@@ -348,12 +348,18 @@ export declare class ModdedElementSets extends Feature {
      * - any runes
      * - any objects like Dice Shard
      *
+     * In order to use this function, you must upgrade your mod with `ISCFeature.MODDED_ELEMENT_SETS`.
+     *
      * @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided,
      *                  the `RNG.Next` method will be called. Default is `getRandomSeed()`.
      * @param exceptions Optional. An array of cards to not select.
      */
     getRandomCard(seedOrRNG?: Seed | RNG, exceptions?: CardType[]): CardType;
     /**
+     * Helper function to get a random card type that matches the provided `ItemConfigCardType`.
+     *
+     * In order to use this function, you must upgrade your mod with `ISCFeature.MODDED_ELEMENT_SETS`.
+     *
      * @param itemConfigCardType The item config card type that represents the pool of cards to select
      *                           from.
      * @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided,
@@ -365,6 +371,8 @@ export declare class ModdedElementSets extends Feature {
      * Has an equal chance of returning any rune (e.g. Rune of Hagalaz, Blank Rune, Black Rune, Soul
      * of Isaac, etc.). This will never return a Rune Shard.
      *
+     * In order to use this function, you must upgrade your mod with `ISCFeature.MODDED_ELEMENT_SETS`.
+     *
      * @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided,
      *                  the `RNG.Next` method will be called. Default is `getRandomSeed()`.
      * @param exceptions Optional. An array of runes to not select.

package/dist/src/classes/features/other/ModdedElementSets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ModdedElementSets.d.ts","sourceRoot":"","sources":["../../../../../src/classes/features/other/ModdedElementSets.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ModdedElementSets.d.ts","sourceRoot":"","sources":["../../../../../src/classes/features/other/ModdedElementSets.ts"],"names":[],"mappings":"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"}

package/dist/src/functions/decorators.d.ts

@@ -3,8 +3,8 @@
  * automatically register callbacks.
  *
  * Currently, there are two decorators:
- * - @Callback
- * - @CallbackCustom
+ * - `@Callback`
+ * - `@CallbackCustom`
  *
  * For example:
  *

package/dist/src/functions/decorators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../../src/functions/decorators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAGL,UAAU,EACX,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,2BAA2B,EAAE,MAAM,mDAAmD,CAAC;AAChG,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,WAAW,EAC5C,WAAW,EAAE,CAAC,EACd,GAAG,YAAY,EAAE,WAAW,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,kGAIvC,MAAM,+CAElB,IAAI,CA+BR;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,iBAAiB,EACxD,iBAAiB,EAAE,CAAC,EACpB,GAAG,YAAY,EAAE,WAAW,CAAC,2BAA2B,CAAC,CAAC,CAAC,CAAC,wGAO7C,MAAM,+CAElB,IAAI,CAiCR"}
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../../src/functions/decorators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAGL,UAAU,EACX,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,2BAA2B,EAAE,MAAM,mDAAmD,CAAC;AAChG,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnD;;;;;GAKG;AAEH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,WAAW,EAC5C,WAAW,EAAE,CAAC,EACd,GAAG,YAAY,EAAE,WAAW,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,kGAIvC,MAAM,+CAElB,IAAI,CA+BR;AAED;;;;;GAKG;AAEH,wBAAgB,cAAc,CAAC,CAAC,SAAS,iBAAiB,EACxD,iBAAiB,EAAE,CAAC,EACpB,GAAG,YAAY,EAAE,WAAW,CAAC,2BAA2B,CAAC,CAAC,CAAC,CAAC,wGAO7C,MAAM,+CAElB,IAAI,CAiCR"}

package/dist/src/functions/input.d.ts

@@ -1,4 +1,4 @@
-import { ButtonAction, Controller, Keyboard } from "isaac-typescript-definitions";
+import { ButtonAction, Controller, ControllerIndex, Keyboard } from "isaac-typescript-definitions";
 export declare const MOVEMENT_ACTIONS_SET: ReadonlySet<ButtonAction>;
 export declare const SHOOTING_ACTIONS_SET: ReadonlySet<ButtonAction>;
 /**
@@ -11,22 +11,39 @@ export declare function controllerToString(controller: Controller): string | und
 export declare function getMoveActions(): ReadonlySet<ButtonAction>;
 export declare function getShootActions(): ReadonlySet<ButtonAction>;
 /**
- * Iterates over all inputs to determine if a particular button is pressed (i.e. held down).
+ * Helper function to check if a player is pressing a specific button (i.e. holding it down).
+ *
+ * This is a variadic version of `Input.IsActionPressed`, meaning that you can pass as many buttons
+ * as you want to check for. This function will return true if any of the buttons are pressed.
+ */
+export declare function isActionPressed(controllerIndex: ControllerIndex, ...buttonActions: ButtonAction[]): boolean;
+/**
+ * Helper function to iterate over all inputs to determine if a specific button is pressed (i.e.
+ * being held down).
  *
  * This function is variadic, meaning you can pass as many buttons as you want to check for. This
  * function will return true if any of the buttons are pressed.
  */
 export declare function isActionPressedOnAnyInput(...buttonActions: ButtonAction[]): boolean;
 /**
- * Iterates over all inputs to determine if a particular button is triggered (i.e. held down and
- * then released).
+ * Helper function to check if a player is triggering a specific button (i.e. pressing and releasing
+ * it).
+ *
+ * This is a variadic version of `Input.IsActionTriggered`, meaning that you can pass as many
+ * buttons as you want to check for. This function will return true if any of the buttons are
+ * triggered.
+ */
+export declare function isActionTriggered(controllerIndex: ControllerIndex, ...buttonActions: ButtonAction[]): boolean;
+/**
+ * Iterates over all inputs to determine if a specific button is triggered (i.e. held down and then
+ * released).
  *
  * This function is variadic, meaning you can pass as many buttons as you want to check for. This
  * function will return true if any of the buttons are pressed.
  */
 export declare function isActionTriggeredOnAnyInput(...buttonActions: ButtonAction[]): boolean;
 /**
- * Helper function to see if a particular keyboard key is being pressed down by the player.
+ * Helper function to see if a specific keyboard key is being held down by the player.
  *
  * This function is variadic, meaning you can pass as many keyboard values as you want to check for.
  * This function will return true if any of the values are pressed.

package/dist/src/functions/input.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../../src/functions/input.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,UAAU,EAEV,QAAQ,EACT,MAAM,8BAA8B,CAAC;AAuBtC,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,YAAY,CAE1D,CAAC;AASF,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,YAAY,CAE1D,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAQ7E;AAED,wBAAgB,cAAc,IAAI,WAAW,CAAC,YAAY,CAAC,CAE1D;AAED,wBAAgB,eAAe,IAAI,WAAW,CAAC,YAAY,CAAC,CAE3D;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,aAAa,EAAE,YAAY,EAAE,GAC/B,OAAO,CAOT;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,GAAG,aAAa,EAAE,YAAY,EAAE,GAC/B,OAAO,CAOT;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,IAAI,EAAE,QAAQ,EAAE,GAAG,OAAO,CAI9D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED,wBAAgB,YAAY,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAEhE;AAED,wBAAgB,6BAA6B,IAAI,OAAO,CAIvD;AAED,wBAAgB,+BAA+B,IAAI,OAAO,CAIzD;AAED,wBAAgB,aAAa,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAEjE;AAED,wBAAgB,8BAA8B,IAAI,OAAO,CAIxD;AAED,wBAAgB,gCAAgC,IAAI,OAAO,CAI1D;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,OAAO,GACjB,MAAM,GAAG,SAAS,CAQpB"}
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../../src/functions/input.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,UAAU,EACV,eAAe,EACf,QAAQ,EACT,MAAM,8BAA8B,CAAC;AAuBtC,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,YAAY,CAE1D,CAAC;AASF,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,YAAY,CAE1D,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAQ7E;AAED,wBAAgB,cAAc,IAAI,WAAW,CAAC,YAAY,CAAC,CAE1D;AAED,wBAAgB,eAAe,IAAI,WAAW,CAAC,YAAY,CAAC,CAE3D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,eAAe,EAAE,eAAe,EAChC,GAAG,aAAa,EAAE,YAAY,EAAE,GAC/B,OAAO,CAIT;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,aAAa,EAAE,YAAY,EAAE,GAC/B,OAAO,CAKT;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,eAAe,EAAE,eAAe,EAChC,GAAG,aAAa,EAAE,YAAY,EAAE,GAC/B,OAAO,CAIT;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,GAAG,aAAa,EAAE,YAAY,EAAE,GAC/B,OAAO,CAKT;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,IAAI,EAAE,QAAQ,EAAE,GAAG,OAAO,CAI9D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED,wBAAgB,YAAY,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAEhE;AAED,wBAAgB,6BAA6B,IAAI,OAAO,CAIvD;AAED,wBAAgB,+BAA+B,IAAI,OAAO,CAIzD;AAED,wBAAgB,aAAa,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAEjE;AAED,wBAAgB,8BAA8B,IAAI,OAAO,CAIxD;AAED,wBAAgB,gCAAgC,IAAI,OAAO,CAI1D;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,OAAO,GACjB,MAAM,GAAG,SAAS,CAQpB"}

package/dist/src/functions/input.lua

@@ -45,7 +45,19 @@ end
 function ____exports.getShootActions(self)
     return ____exports.SHOOTING_ACTIONS_SET
 end
---- Iterates over all inputs to determine if a particular button is pressed (i.e. held down).
+--- Helper function to check if a player is pressing a specific button (i.e. holding it down).
+-- 
+-- This is a variadic version of `Input.IsActionPressed`, meaning that you can pass as many buttons
+-- as you want to check for. This function will return true if any of the buttons are pressed.
+function ____exports.isActionPressed(self, controllerIndex, ...)
+    local buttonActions = {...}
+    return __TS__ArraySome(
+        buttonActions,
+        function(____, buttonAction) return Input.IsActionPressed(buttonAction, controllerIndex) end
+    )
+end
+--- Helper function to iterate over all inputs to determine if a specific button is pressed (i.e.
+-- being held down).
 -- 
 -- This function is variadic, meaning you can pass as many buttons as you want to check for. This
 -- function will return true if any of the buttons are pressed.
@@ -54,14 +66,28 @@ function ____exports.isActionPressedOnAnyInput(self, ...)
     local controllerIndexes = getEnumValues(nil, ControllerIndex)
     return __TS__ArraySome(
         controllerIndexes,
-        function(____, controllerIndex) return __TS__ArraySome(
-            buttonActions,
-            function(____, buttonAction) return Input.IsActionPressed(buttonAction, controllerIndex) end
+        function(____, controllerIndex) return ____exports.isActionPressed(
+            nil,
+            controllerIndex,
+            table.unpack(buttonActions)
         ) end
     )
 end
---- Iterates over all inputs to determine if a particular button is triggered (i.e. held down and
--- then released).
+--- Helper function to check if a player is triggering a specific button (i.e. pressing and releasing
+-- it).
+-- 
+-- This is a variadic version of `Input.IsActionTriggered`, meaning that you can pass as many
+-- buttons as you want to check for. This function will return true if any of the buttons are
+-- triggered.
+function ____exports.isActionTriggered(self, controllerIndex, ...)
+    local buttonActions = {...}
+    return __TS__ArraySome(
+        buttonActions,
+        function(____, buttonAction) return Input.IsActionTriggered(buttonAction, controllerIndex) end
+    )
+end
+--- Iterates over all inputs to determine if a specific button is triggered (i.e. held down and then
+-- released).
 -- 
 -- This function is variadic, meaning you can pass as many buttons as you want to check for. This
 -- function will return true if any of the buttons are pressed.
@@ -70,13 +96,14 @@ function ____exports.isActionTriggeredOnAnyInput(self, ...)
     local controllerIndexes = getEnumValues(nil, ControllerIndex)
     return __TS__ArraySome(
         controllerIndexes,
-        function(____, controllerIndex) return __TS__ArraySome(
-            buttonActions,
-            function(____, buttonAction) return Input.IsActionTriggered(buttonAction, controllerIndex) end
+        function(____, controllerIndex) return ____exports.isActionTriggered(
+            nil,
+            controllerIndex,
+            table.unpack(buttonActions)
         ) end
     )
 end
---- Helper function to see if a particular keyboard key is being pressed down by the player.
+--- Helper function to see if a specific keyboard key is being held down by the player.
 -- 
 -- This function is variadic, meaning you can pass as many keyboard values as you want to check for.
 -- This function will return true if any of the values are pressed.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "17.5.0",
+  "version": "17.7.0",
   "description": "Helper functions and features for IsaacScript mods.",
   "keywords": [
     "isaac",

package/src/classes/ModFeature.ts

@@ -62,6 +62,18 @@ type ModFeatureConstructor = TSTLClassMetatable["constructor"] & {
 export class ModFeature {
   private mod: ModUpgradedBase;
 
+  /**
+   * An optional function that allows for conditional callback execution. If specified, any class
+   * method that is annotated with a `@Callback` or `@CallbackCustom` decorator will only be fired
+   * if the executed conditional function returns true.
+   *
+   * This property is used to easily turn entire mod features on and off (rather than repeating
+   * conditional logic and early returning at the beginning of every callback function).
+   *
+   * By default, this is set to null. Override this property in your class if you need to use it.
+   */
+  private callbackConditionalFunc: (() => boolean) | null = null;
+
   /**
    * Whether or not the feature has registered its callbacks yet (and submitted its variables to the
    * save data manager, if any).
@@ -195,6 +207,15 @@ function addCallback(
   // We need to wrap the callback in a new function so that we can explicitly pass the class as the
   // first argument. (Otherwise, the method will not be able to properly access `this`.
   const wrappedCallback = (...callbackArgs: unknown[]) => {
+    // eslint-disable-next-line @typescript-eslint/dot-notation
+    const conditionalFunc = modFeature["callbackConditionalFunc"];
+    if (conditionalFunc !== null) {
+      const shouldRun = conditionalFunc();
+      if (!shouldRun) {
+        return undefined;
+      }
+    }
+
     const castedCallback = callback as (
       this: void,
       ...args: unknown[]

package/src/classes/features/other/ModdedElementSets.ts

@@ -1007,6 +1007,8 @@ export class ModdedElementSets extends Feature {
    * - any runes
    * - any objects like Dice Shard
    *
+   * In order to use this function, you must upgrade your mod with `ISCFeature.MODDED_ELEMENT_SETS`.
+   *
    * @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided,
    *                  the `RNG.Next` method will be called. Default is `getRandomSeed()`.
    * @param exceptions Optional. An array of cards to not select.
@@ -1020,6 +1022,10 @@ export class ModdedElementSets extends Feature {
   }
 
   /**
+   * Helper function to get a random card type that matches the provided `ItemConfigCardType`.
+   *
+   * In order to use this function, you must upgrade your mod with `ISCFeature.MODDED_ELEMENT_SETS`.
+   *
    * @param itemConfigCardType The item config card type that represents the pool of cards to select
    *                           from.
    * @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided,
@@ -1040,6 +1046,8 @@ export class ModdedElementSets extends Feature {
    * Has an equal chance of returning any rune (e.g. Rune of Hagalaz, Blank Rune, Black Rune, Soul
    * of Isaac, etc.). This will never return a Rune Shard.
    *
+   * In order to use this function, you must upgrade your mod with `ISCFeature.MODDED_ELEMENT_SETS`.
+   *
    * @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided,
    *                  the `RNG.Next` method will be called. Default is `getRandomSeed()`.
    * @param exceptions Optional. An array of runes to not select.

package/src/functions/decorators.ts

@@ -3,8 +3,8 @@
  * automatically register callbacks.
  *
  * Currently, there are two decorators:
- * - @Callback
- * - @CallbackCustom
+ * - `@Callback`
+ * - `@CallbackCustom`
  *
  * For example:
  *
@@ -37,6 +37,7 @@ import { getTSTLClassName } from "./tstlClass";
  *
  * @ignore
  */
+// We tell TypeDoc to ignore this function because it generates a bunch of spam.
 export function Callback<T extends ModCallback>(
   modCallback: T,
   ...optionalArgs: AllButFirst<AddCallbackParameters[T]>
@@ -84,6 +85,7 @@ export function Callback<T extends ModCallback>(
  *
  * @ignore
  */
+// We tell TypeDoc to ignore this function because it generates a bunch of spam.
 export function CallbackCustom<T extends ModCallbackCustom>(
   modCallbackCustom: T,
   ...optionalArgs: AllButFirst<AddCallbackParametersCustom[T]>

package/src/functions/input.ts

@@ -66,7 +66,23 @@ export function getShootActions(): ReadonlySet<ButtonAction> {
 }
 
 /**
- * Iterates over all inputs to determine if a particular button is pressed (i.e. held down).
+ * Helper function to check if a player is pressing a specific button (i.e. holding it down).
+ *
+ * This is a variadic version of `Input.IsActionPressed`, meaning that you can pass as many buttons
+ * as you want to check for. This function will return true if any of the buttons are pressed.
+ */
+export function isActionPressed(
+  controllerIndex: ControllerIndex,
+  ...buttonActions: ButtonAction[]
+): boolean {
+  return buttonActions.some((buttonAction) =>
+    Input.IsActionPressed(buttonAction, controllerIndex),
+  );
+}
+
+/**
+ * Helper function to iterate over all inputs to determine if a specific button is pressed (i.e.
+ * being held down).
  *
  * This function is variadic, meaning you can pass as many buttons as you want to check for. This
  * function will return true if any of the buttons are pressed.
@@ -76,15 +92,30 @@ export function isActionPressedOnAnyInput(
 ): boolean {
   const controllerIndexes = getEnumValues(ControllerIndex);
   return controllerIndexes.some((controllerIndex) =>
-    buttonActions.some((buttonAction) =>
-      Input.IsActionPressed(buttonAction, controllerIndex),
-    ),
+    isActionPressed(controllerIndex, ...buttonActions),
+  );
+}
+
+/**
+ * Helper function to check if a player is triggering a specific button (i.e. pressing and releasing
+ * it).
+ *
+ * This is a variadic version of `Input.IsActionTriggered`, meaning that you can pass as many
+ * buttons as you want to check for. This function will return true if any of the buttons are
+ * triggered.
+ */
+export function isActionTriggered(
+  controllerIndex: ControllerIndex,
+  ...buttonActions: ButtonAction[]
+): boolean {
+  return buttonActions.some((buttonAction) =>
+    Input.IsActionTriggered(buttonAction, controllerIndex),
   );
 }
 
 /**
- * Iterates over all inputs to determine if a particular button is triggered (i.e. held down and
- * then released).
+ * Iterates over all inputs to determine if a specific button is triggered (i.e. held down and then
+ * released).
  *
  * This function is variadic, meaning you can pass as many buttons as you want to check for. This
  * function will return true if any of the buttons are pressed.
@@ -94,14 +125,12 @@ export function isActionTriggeredOnAnyInput(
 ): boolean {
   const controllerIndexes = getEnumValues(ControllerIndex);
   return controllerIndexes.some((controllerIndex) =>
-    buttonActions.some((buttonAction) =>
-      Input.IsActionTriggered(buttonAction, controllerIndex),
-    ),
+    isActionTriggered(controllerIndex, ...buttonActions),
   );
 }
 
 /**
- * Helper function to see if a particular keyboard key is being pressed down by the player.
+ * Helper function to see if a specific keyboard key is being held down by the player.
  *
  * This function is variadic, meaning you can pass as many keyboard values as you want to check for.
  * This function will return true if any of the values are pressed.