isaacscript-common 30.4.3 → 30.4.4

package/dist/index.rollup.d.ts

@@ -3415,8 +3415,10 @@ declare class DisableAllSound extends Feature {
      *
      * In order to use this function, you must upgrade your mod with `ISCFeature.DISABLE_ALL_SOUND`.
      *
-     * @param key The name of the mod feature that is requesting the enable/disable. This is needed so
-     *            that multiple mod features can work in tandem.
+     * @param key The name of the mod feature that is requesting the enable/disable. For example, if
+     *            this was part of the code for a custom enemy called "Super Gaper", then you could
+     *            use a key of "SuperGaper". The name is necessary so that multiple mod features can
+     *            work in tandem.
      */
     enableAllSound(key: string): void;
     /**
@@ -3426,8 +3428,10 @@ declare class DisableAllSound extends Feature {
      *
      * In order to use this function, you must upgrade your mod with `ISCFeature.DISABLE_ALL_SOUND`.
      *
-     * @param key The name of the mod feature that is requesting the enable/disable. This is needed so
-     *            that multiple mod features can work in tandem.
+     * @param key The name of the mod feature that is requesting the enable/disable. For example, if
+     *            this was part of the code for a custom enemy called "Super Gaper", then you could
+     *            use a key of "SuperGaper". The name is necessary so that multiple mod features can
+     *            work in tandem.
      */
     disableAllSound(key: string): void;
 }
@@ -3443,8 +3447,10 @@ declare class DisableInputs extends Feature {
      *
      * In order to use this function, you must upgrade your mod with `ISCFeature.DISABLE_INPUTS`.
      *
-     * @param key The name of the mod feature that is requesting the enable/disable. This is needed so
-     *            that multiple mod features can work in tandem.
+     * @param key The name of the mod feature that is requesting the enable/disable. For example, if
+     *            this was part of the code for a custom enemy called "Super Gaper", then you could
+     *            use a key of "SuperGaper". The name is necessary so that multiple mod features can
+     *            work in tandem.
      */
     enableAllInputs(key: string): void;
     /**
@@ -3457,8 +3463,10 @@ declare class DisableInputs extends Feature {
      *
      * In order to use this function, you must upgrade your mod with `ISCFeature.DISABLE_INPUTS`.
      *
-     * @param key The name of the mod feature that is requesting the enable/disable. This is needed so
-     *            that multiple mod features can work in tandem.
+     * @param key The name of the mod feature that is requesting the enable/disable. For example, if
+     *            this was part of the code for a custom enemy called "Super Gaper", then you could
+     *            use a key of "SuperGaper". The name is necessary so that multiple mod features can
+     *            work in tandem.
      * @param buttonActions An array of the actions to action.
      */
     disableInputs(key: string, ...buttonActions: ButtonAction[]): void;
@@ -3470,8 +3478,10 @@ declare class DisableInputs extends Feature {
      *
      * In order to use this function, you must upgrade your mod with `ISCFeature.DISABLE_INPUTS`.
      *
-     * @param key The name of the mod feature that is requesting the enable/disable. This is needed so
-     *            that multiple mod features can work in tandem.
+     * @param key The name of the mod feature that is requesting the enable/disable. For example, if
+     *            this was part of the code for a custom enemy called "Super Gaper", then you could
+     *            use a key of "SuperGaper". The name is necessary so that multiple mod features can
+     *            work in tandem.
      */
     disableAllInputs(key: string): void;
     /**
@@ -3482,8 +3492,10 @@ declare class DisableInputs extends Feature {
      *
      * In order to use this function, you must upgrade your mod with `ISCFeature.DISABLE_INPUTS`.
      *
-     * @param key The name of the mod feature that is requesting the enable/disable. This is needed so
-     *            that multiple mod features can work in tandem.
+     * @param key The name of the mod feature that is requesting the enable/disable. For example, if
+     *            this was part of the code for a custom enemy called "Super Gaper", then you could
+     *            use a key of "SuperGaper". The name is necessary so that multiple mod features can
+     *            work in tandem.
      * @param blacklist A set of ButtonActions to disallow.
      */
     enableAllInputsExceptFor(key: string, blacklist: Set<ButtonAction> | ReadonlySet<ButtonAction>): void;
@@ -3495,8 +3507,10 @@ declare class DisableInputs extends Feature {
      *
      * In order to use this function, you must upgrade your mod with `ISCFeature.DISABLE_INPUTS`.
      *
-     * @param key The name of the mod feature that is requesting the enable/disable. This is needed so
-     *            that multiple mod features can work in tandem.
+     * @param key The name of the mod feature that is requesting the enable/disable. For example, if
+     *            this was part of the code for a custom enemy called "Super Gaper", then you could
+     *            use a key of "SuperGaper". The name is necessary so that multiple mod features can
+     *            work in tandem.
      * @param whitelist A set of ButtonActions to allow.
      */
     disableAllInputsExceptFor(key: string, whitelist: Set<ButtonAction> | ReadonlySet<ButtonAction>): void;
@@ -3509,8 +3523,10 @@ declare class DisableInputs extends Feature {
      *
      * In order to use this function, you must upgrade your mod with `ISCFeature.DISABLE_INPUTS`.
      *
-     * @param key The name of the mod feature that is requesting the enable/disable. This is needed so
-     *            that multiple mod features can work in tandem.
+     * @param key The name of the mod feature that is requesting the enable/disable. For example, if
+     *            this was part of the code for a custom enemy called "Super Gaper", then you could
+     *            use a key of "SuperGaper". The name is necessary so that multiple mod features can
+     *            work in tandem.
      */
     disableMovementInputs(key: string): void;
     /**
@@ -3521,8 +3537,10 @@ declare class DisableInputs extends Feature {
      *
      * In order to use this function, you must upgrade your mod with `ISCFeature.DISABLE_INPUTS`.
      *
-     * @param key The name of the mod feature that is requesting the enable/disable. This is needed so
-     *            that multiple mod features can work in tandem.
+     * @param key The name of the mod feature that is requesting the enable/disable. For example, if
+     *            this was part of the code for a custom enemy called "Super Gaper", then you could
+     *            use a key of "SuperGaper". The name is necessary so that multiple mod features can
+     *            work in tandem.
      */
     disableShootingInputs(key: string): void;
 }

package/dist/isaacscript-common.lua

@@ -1,6 +1,6 @@
 --[[
 
-isaacscript-common 30.4.3
+isaacscript-common 30.4.4
 
 This is the "isaacscript-common" library, which was created with the IsaacScript tool.
 
@@ -44592,7 +44592,14 @@ function CustomStages.prototype.setCustomStage(self, name, firstFloor, streakTex
             topStreakTextStart(nil)
         end)
     end
-    local music = customStage.music == nil and getMusicForStage(nil, baseStage, baseStageType) or Isaac.GetMusicIdByName(customStage.music)
+    local customStageMusic
+    if customStage.music ~= nil then
+        customStageMusic = Isaac.GetMusicIdByName(customStage.music)
+        if customStageMusic == -1 then
+            logError("Failed to get the music ID associated with the name of: " .. customStage.music)
+        end
+    end
+    local music = (customStageMusic == nil or customStageMusic == -1) and getMusicForStage(nil, baseStage, baseStageType) or customStageMusic
     self.runInNFrames:runInNRenderFrames(
         function()
             musicManager:Enable()

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

@@ -1 +1 @@
-{"version":3,"file":"CustomStages.d.ts","sourceRoot":"","sources":["../../../../../src/classes/features/other/CustomStages.ts"],"names":[],"mappings":"AAuCA,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AA2ChD,qBAAa,YAAa,SAAQ,OAAO;IAIvC,oCAAoC;IACpC,OAAO,CAAC,eAAe,CAAkC;IAEzD,+BAA+B;IAC/B,OAAO,CAAC,yBAAyB,CAA8B;IAE/D,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,sBAAsB,CAAyB;IACvD,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,YAAY,CAAe;IAqDnC,OAAO,CAAC,uBAAuB;IAc/B,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,6BAA6B;IAOrC,OAAO,CAAC,eAAe,CAarB;IAGF,OAAO,CAAC,UAAU,CAQhB;IAGF,OAAO,CAAC,aAAa,CAcnB;IAGF,OAAO,CAAC,eAAe,CAUrB;IAIF,OAAO,CAAC,2BAA2B,CAejC;IAGF,OAAO,CAAC,kBAAkB,CAqBxB;IAGF,OAAO,CAAC,oBAAoB,CAc1B;IAEF,gDAAgD;IAChD,OAAO,CAAC,iBAAiB;IAgGzB;;;;;;;;;;;;;;;;OAgBG;IAEI,cAAc,CACnB,IAAI,EAAE,MAAM,EACZ,UAAU,UAAO,EACjB,UAAU,UAAO,EACjB,OAAO,UAAQ,GACd,IAAI;IAuFP;;;;;OAKG;IAEI,kBAAkB,IAAI,IAAI;CAGlC"}
+{"version":3,"file":"CustomStages.d.ts","sourceRoot":"","sources":["../../../../../src/classes/features/other/CustomStages.ts"],"names":[],"mappings":"AAwCA,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AA2ChD,qBAAa,YAAa,SAAQ,OAAO;IAIvC,oCAAoC;IACpC,OAAO,CAAC,eAAe,CAAkC;IAEzD,+BAA+B;IAC/B,OAAO,CAAC,yBAAyB,CAA8B;IAE/D,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,sBAAsB,CAAyB;IACvD,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,YAAY,CAAe;IAqDnC,OAAO,CAAC,uBAAuB;IAc/B,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,6BAA6B;IAOrC,OAAO,CAAC,eAAe,CAarB;IAGF,OAAO,CAAC,UAAU,CAQhB;IAGF,OAAO,CAAC,aAAa,CAcnB;IAGF,OAAO,CAAC,eAAe,CAUrB;IAIF,OAAO,CAAC,2BAA2B,CAejC;IAGF,OAAO,CAAC,kBAAkB,CAqBxB;IAGF,OAAO,CAAC,oBAAoB,CAc1B;IAEF,gDAAgD;IAChD,OAAO,CAAC,iBAAiB;IAgGzB;;;;;;;;;;;;;;;;OAgBG;IAEI,cAAc,CACnB,IAAI,EAAE,MAAM,EACZ,UAAU,UAAO,EACjB,UAAU,UAAO,EACjB,OAAO,UAAQ,GACd,IAAI;IAmGP;;;;;OAKG;IAEI,kBAAkB,IAAI,IAAI;CAGlC"}

package/dist/src/classes/features/other/CustomStages.lua

@@ -341,7 +341,14 @@ function CustomStages.prototype.setCustomStage(self, name, firstFloor, streakTex
             topStreakTextStart(nil)
         end)
     end
-    local music = customStage.music == nil and getMusicForStage(nil, baseStage, baseStageType) or Isaac.GetMusicIdByName(customStage.music)
+    local customStageMusic
+    if customStage.music ~= nil then
+        customStageMusic = Isaac.GetMusicIdByName(customStage.music)
+        if customStageMusic == -1 then
+            logError("Failed to get the music ID associated with the name of: " .. customStage.music)
+        end
+    end
+    local music = (customStageMusic == nil or customStageMusic == -1) and getMusicForStage(nil, baseStage, baseStageType) or customStageMusic
     self.runInNFrames:runInNRenderFrames(
         function()
             musicManager:Enable()

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

@@ -9,8 +9,10 @@ export declare class DisableAllSound extends Feature {
      *
      * In order to use this function, you must upgrade your mod with `ISCFeature.DISABLE_ALL_SOUND`.
      *
-     * @param key The name of the mod feature that is requesting the enable/disable. This is needed so
-     *            that multiple mod features can work in tandem.
+     * @param key The name of the mod feature that is requesting the enable/disable. For example, if
+     *            this was part of the code for a custom enemy called "Super Gaper", then you could
+     *            use a key of "SuperGaper". The name is necessary so that multiple mod features can
+     *            work in tandem.
      */
     enableAllSound(key: string): void;
     /**
@@ -20,8 +22,10 @@ export declare class DisableAllSound extends Feature {
      *
      * In order to use this function, you must upgrade your mod with `ISCFeature.DISABLE_ALL_SOUND`.
      *
-     * @param key The name of the mod feature that is requesting the enable/disable. This is needed so
-     *            that multiple mod features can work in tandem.
+     * @param key The name of the mod feature that is requesting the enable/disable. For example, if
+     *            this was part of the code for a custom enemy called "Super Gaper", then you could
+     *            use a key of "SuperGaper". The name is necessary so that multiple mod features can
+     *            work in tandem.
      */
     disableAllSound(key: string): void;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"DisableAllSound.d.ts","sourceRoot":"","sources":["../../../../../src/classes/features/other/DisableAllSound.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAQhD,qBAAa,eAAgB,SAAQ,OAAO;IAI1C,OAAO,CAAC,eAAe,CAAS;IAahC,OAAO,CAAC,UAAU,CAMhB;IAEF;;;;;;;;;OASG;IAEI,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAexC;;;;;;;;;OASG;IAEI,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;CAU1C"}
+{"version":3,"file":"DisableAllSound.d.ts","sourceRoot":"","sources":["../../../../../src/classes/features/other/DisableAllSound.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAQhD,qBAAa,eAAgB,SAAQ,OAAO;IAI1C,OAAO,CAAC,eAAe,CAAS;IAahC,OAAO,CAAC,UAAU,CAMhB;IAEF;;;;;;;;;;;OAWG;IAEI,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAexC;;;;;;;;;;;OAWG;IAEI,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;CAU1C"}

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

@@ -11,8 +11,10 @@ export declare class DisableInputs extends Feature {
      *
      * In order to use this function, you must upgrade your mod with `ISCFeature.DISABLE_INPUTS`.
      *
-     * @param key The name of the mod feature that is requesting the enable/disable. This is needed so
-     *            that multiple mod features can work in tandem.
+     * @param key The name of the mod feature that is requesting the enable/disable. For example, if
+     *            this was part of the code for a custom enemy called "Super Gaper", then you could
+     *            use a key of "SuperGaper". The name is necessary so that multiple mod features can
+     *            work in tandem.
      */
     enableAllInputs(key: string): void;
     /**
@@ -25,8 +27,10 @@ export declare class DisableInputs extends Feature {
      *
      * In order to use this function, you must upgrade your mod with `ISCFeature.DISABLE_INPUTS`.
      *
-     * @param key The name of the mod feature that is requesting the enable/disable. This is needed so
-     *            that multiple mod features can work in tandem.
+     * @param key The name of the mod feature that is requesting the enable/disable. For example, if
+     *            this was part of the code for a custom enemy called "Super Gaper", then you could
+     *            use a key of "SuperGaper". The name is necessary so that multiple mod features can
+     *            work in tandem.
      * @param buttonActions An array of the actions to action.
      */
     disableInputs(key: string, ...buttonActions: ButtonAction[]): void;
@@ -38,8 +42,10 @@ export declare class DisableInputs extends Feature {
      *
      * In order to use this function, you must upgrade your mod with `ISCFeature.DISABLE_INPUTS`.
      *
-     * @param key The name of the mod feature that is requesting the enable/disable. This is needed so
-     *            that multiple mod features can work in tandem.
+     * @param key The name of the mod feature that is requesting the enable/disable. For example, if
+     *            this was part of the code for a custom enemy called "Super Gaper", then you could
+     *            use a key of "SuperGaper". The name is necessary so that multiple mod features can
+     *            work in tandem.
      */
     disableAllInputs(key: string): void;
     /**
@@ -50,8 +56,10 @@ export declare class DisableInputs extends Feature {
      *
      * In order to use this function, you must upgrade your mod with `ISCFeature.DISABLE_INPUTS`.
      *
-     * @param key The name of the mod feature that is requesting the enable/disable. This is needed so
-     *            that multiple mod features can work in tandem.
+     * @param key The name of the mod feature that is requesting the enable/disable. For example, if
+     *            this was part of the code for a custom enemy called "Super Gaper", then you could
+     *            use a key of "SuperGaper". The name is necessary so that multiple mod features can
+     *            work in tandem.
      * @param blacklist A set of ButtonActions to disallow.
      */
     enableAllInputsExceptFor(key: string, blacklist: Set<ButtonAction> | ReadonlySet<ButtonAction>): void;
@@ -63,8 +71,10 @@ export declare class DisableInputs extends Feature {
      *
      * In order to use this function, you must upgrade your mod with `ISCFeature.DISABLE_INPUTS`.
      *
-     * @param key The name of the mod feature that is requesting the enable/disable. This is needed so
-     *            that multiple mod features can work in tandem.
+     * @param key The name of the mod feature that is requesting the enable/disable. For example, if
+     *            this was part of the code for a custom enemy called "Super Gaper", then you could
+     *            use a key of "SuperGaper". The name is necessary so that multiple mod features can
+     *            work in tandem.
      * @param whitelist A set of ButtonActions to allow.
      */
     disableAllInputsExceptFor(key: string, whitelist: Set<ButtonAction> | ReadonlySet<ButtonAction>): void;
@@ -77,8 +87,10 @@ export declare class DisableInputs extends Feature {
      *
      * In order to use this function, you must upgrade your mod with `ISCFeature.DISABLE_INPUTS`.
      *
-     * @param key The name of the mod feature that is requesting the enable/disable. This is needed so
-     *            that multiple mod features can work in tandem.
+     * @param key The name of the mod feature that is requesting the enable/disable. For example, if
+     *            this was part of the code for a custom enemy called "Super Gaper", then you could
+     *            use a key of "SuperGaper". The name is necessary so that multiple mod features can
+     *            work in tandem.
      */
     disableMovementInputs(key: string): void;
     /**
@@ -89,8 +101,10 @@ export declare class DisableInputs extends Feature {
      *
      * In order to use this function, you must upgrade your mod with `ISCFeature.DISABLE_INPUTS`.
      *
-     * @param key The name of the mod feature that is requesting the enable/disable. This is needed so
-     *            that multiple mod features can work in tandem.
+     * @param key The name of the mod feature that is requesting the enable/disable. For example, if
+     *            this was part of the code for a custom enemy called "Super Gaper", then you could
+     *            use a key of "SuperGaper". The name is necessary so that multiple mod features can
+     *            work in tandem.
      */
     disableShootingInputs(key: string): void;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"DisableInputs.d.ts","sourceRoot":"","sources":["../../../../../src/classes/features/other/DisableInputs.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EAGb,MAAM,8BAA8B,CAAC;AAItC,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AA4BhD,qBAAa,aAAc,SAAQ,OAAO;IAiCxC,OAAO,CAAC,eAAe,CAIsB;IAG7C,OAAO,CAAC,iBAAiB,CAIoB;IAG7C,OAAO,CAAC,cAAc,CAIwB;IAE9C,OAAO,CAAC,cAAc;IAwBtB;;;;;;;;OAQG;IAEI,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKzC;;;;;;;;;;;;;OAaG;IAEI,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,aAAa,EAAE,YAAY,EAAE,GAAG,IAAI;IAKzE;;;;;;;;;;OAUG;IAEI,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAK1C;;;;;;;;;;;OAWG;IAEI,wBAAwB,CAC7B,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,GAAG,CAAC,YAAY,CAAC,GAAG,WAAW,CAAC,YAAY,CAAC,GACvD,IAAI;IAKP;;;;;;;;;;;OAWG;IAEI,yBAAyB,CAC9B,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,GAAG,CAAC,YAAY,CAAC,GAAG,WAAW,CAAC,YAAY,CAAC,GACvD,IAAI;IAKP;;;;;;;;;;;OAWG;IAEI,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAK/C;;;;;;;;;;OAUG;IAEI,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;CAIhD"}
+{"version":3,"file":"DisableInputs.d.ts","sourceRoot":"","sources":["../../../../../src/classes/features/other/DisableInputs.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EAGb,MAAM,8BAA8B,CAAC;AAItC,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AA4BhD,qBAAa,aAAc,SAAQ,OAAO;IAiCxC,OAAO,CAAC,eAAe,CAIsB;IAG7C,OAAO,CAAC,iBAAiB,CAIoB;IAG7C,OAAO,CAAC,cAAc,CAIwB;IAE9C,OAAO,CAAC,cAAc;IAwBtB;;;;;;;;;;OAUG;IAEI,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKzC;;;;;;;;;;;;;;;OAeG;IAEI,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,aAAa,EAAE,YAAY,EAAE,GAAG,IAAI;IAKzE;;;;;;;;;;;;OAYG;IAEI,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAK1C;;;;;;;;;;;;;OAaG;IAEI,wBAAwB,CAC7B,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,GAAG,CAAC,YAAY,CAAC,GAAG,WAAW,CAAC,YAAY,CAAC,GACvD,IAAI;IAKP;;;;;;;;;;;;;OAaG;IAEI,yBAAyB,CAC9B,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,GAAG,CAAC,YAAY,CAAC,GAAG,WAAW,CAAC,YAAY,CAAC,GACvD,IAAI;IAKP;;;;;;;;;;;;;OAaG;IAEI,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAK/C;;;;;;;;;;;;OAYG;IAEI,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;CAIhD"}

package/package.json

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

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

@@ -4,6 +4,7 @@ import {
   LevelCurse,
   LevelStage,
   ModCallback,
+  Music,
   RoomShape,
   RoomType,
   StageType,
@@ -481,11 +482,23 @@ export class CustomStages extends Feature {
     }
 
     // The bugged stage will not have any music associated with it, so we must manually start to
-    // play a track.
+    // play a track. First, prefer the music that is explicitly assigned to this custom floor.
+    let customStageMusic: Music | -1 | undefined;
+    if (customStage.music !== undefined) {
+      customStageMusic = Isaac.GetMusicIdByName(customStage.music) as
+        | Music
+        | -1;
+      if (customStageMusic === -1) {
+        logError(
+          `Failed to get the music ID associated with the name of: ${customStage.music}`,
+        );
+      }
+    }
+
     const music =
-      customStage.music === undefined
+      customStageMusic === undefined || customStageMusic === -1
         ? getMusicForStage(baseStage, baseStageType)
-        : Isaac.GetMusicIdByName(customStage.music);
+        : customStageMusic;
 
     this.runInNFrames.runInNRenderFrames(() => {
       // By default, the `MusicManager.Play` method will play the music at max volume (1.0), which

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

@@ -42,8 +42,10 @@ export class DisableAllSound extends Feature {
    *
    * In order to use this function, you must upgrade your mod with `ISCFeature.DISABLE_ALL_SOUND`.
    *
-   * @param key The name of the mod feature that is requesting the enable/disable. This is needed so
-   *            that multiple mod features can work in tandem.
+   * @param key The name of the mod feature that is requesting the enable/disable. For example, if
+   *            this was part of the code for a custom enemy called "Super Gaper", then you could
+   *            use a key of "SuperGaper". The name is necessary so that multiple mod features can
+   *            work in tandem.
    */
   @Exported
   public enableAllSound(key: string): void {
@@ -68,8 +70,10 @@ export class DisableAllSound extends Feature {
    *
    * In order to use this function, you must upgrade your mod with `ISCFeature.DISABLE_ALL_SOUND`.
    *
-   * @param key The name of the mod feature that is requesting the enable/disable. This is needed so
-   *            that multiple mod features can work in tandem.
+   * @param key The name of the mod feature that is requesting the enable/disable. For example, if
+   *            this was part of the code for a custom enemy called "Super Gaper", then you could
+   *            use a key of "SuperGaper". The name is necessary so that multiple mod features can
+   *            work in tandem.
    */
   @Exported
   public disableAllSound(key: string): void {

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

@@ -117,8 +117,10 @@ export class DisableInputs extends Feature {
    *
    * In order to use this function, you must upgrade your mod with `ISCFeature.DISABLE_INPUTS`.
    *
-   * @param key The name of the mod feature that is requesting the enable/disable. This is needed so
-   *            that multiple mod features can work in tandem.
+   * @param key The name of the mod feature that is requesting the enable/disable. For example, if
+   *            this was part of the code for a custom enemy called "Super Gaper", then you could
+   *            use a key of "SuperGaper". The name is necessary so that multiple mod features can
+   *            work in tandem.
    */
   @Exported
   public enableAllInputs(key: string): void {
@@ -136,8 +138,10 @@ export class DisableInputs extends Feature {
    *
    * In order to use this function, you must upgrade your mod with `ISCFeature.DISABLE_INPUTS`.
    *
-   * @param key The name of the mod feature that is requesting the enable/disable. This is needed so
-   *            that multiple mod features can work in tandem.
+   * @param key The name of the mod feature that is requesting the enable/disable. For example, if
+   *            this was part of the code for a custom enemy called "Super Gaper", then you could
+   *            use a key of "SuperGaper". The name is necessary so that multiple mod features can
+   *            work in tandem.
    * @param buttonActions An array of the actions to action.
    */
   @Exported
@@ -154,8 +158,10 @@ export class DisableInputs extends Feature {
    *
    * In order to use this function, you must upgrade your mod with `ISCFeature.DISABLE_INPUTS`.
    *
-   * @param key The name of the mod feature that is requesting the enable/disable. This is needed so
-   *            that multiple mod features can work in tandem.
+   * @param key The name of the mod feature that is requesting the enable/disable. For example, if
+   *            this was part of the code for a custom enemy called "Super Gaper", then you could
+   *            use a key of "SuperGaper". The name is necessary so that multiple mod features can
+   *            work in tandem.
    */
   @Exported
   public disableAllInputs(key: string): void {
@@ -171,8 +177,10 @@ export class DisableInputs extends Feature {
    *
    * In order to use this function, you must upgrade your mod with `ISCFeature.DISABLE_INPUTS`.
    *
-   * @param key The name of the mod feature that is requesting the enable/disable. This is needed so
-   *            that multiple mod features can work in tandem.
+   * @param key The name of the mod feature that is requesting the enable/disable. For example, if
+   *            this was part of the code for a custom enemy called "Super Gaper", then you could
+   *            use a key of "SuperGaper". The name is necessary so that multiple mod features can
+   *            work in tandem.
    * @param blacklist A set of ButtonActions to disallow.
    */
   @Exported
@@ -192,8 +200,10 @@ export class DisableInputs extends Feature {
    *
    * In order to use this function, you must upgrade your mod with `ISCFeature.DISABLE_INPUTS`.
    *
-   * @param key The name of the mod feature that is requesting the enable/disable. This is needed so
-   *            that multiple mod features can work in tandem.
+   * @param key The name of the mod feature that is requesting the enable/disable. For example, if
+   *            this was part of the code for a custom enemy called "Super Gaper", then you could
+   *            use a key of "SuperGaper". The name is necessary so that multiple mod features can
+   *            work in tandem.
    * @param whitelist A set of ButtonActions to allow.
    */
   @Exported
@@ -214,8 +224,10 @@ export class DisableInputs extends Feature {
    *
    * In order to use this function, you must upgrade your mod with `ISCFeature.DISABLE_INPUTS`.
    *
-   * @param key The name of the mod feature that is requesting the enable/disable. This is needed so
-   *            that multiple mod features can work in tandem.
+   * @param key The name of the mod feature that is requesting the enable/disable. For example, if
+   *            this was part of the code for a custom enemy called "Super Gaper", then you could
+   *            use a key of "SuperGaper". The name is necessary so that multiple mod features can
+   *            work in tandem.
    */
   @Exported
   public disableMovementInputs(key: string): void {
@@ -231,8 +243,10 @@ export class DisableInputs extends Feature {
    *
    * In order to use this function, you must upgrade your mod with `ISCFeature.DISABLE_INPUTS`.
    *
-   * @param key The name of the mod feature that is requesting the enable/disable. This is needed so
-   *            that multiple mod features can work in tandem.
+   * @param key The name of the mod feature that is requesting the enable/disable. For example, if
+   *            this was part of the code for a custom enemy called "Super Gaper", then you could
+   *            use a key of "SuperGaper". The name is necessary so that multiple mod features can
+   *            work in tandem.
    */
   @Exported
   public disableShootingInputs(key: string): void {