isaacscript-common 7.6.0 → 7.6.1

package/dist/features/customGridEntity.d.ts

@@ -28,8 +28,11 @@ export declare function customGridEntityInit(mod: ModUpgraded): void;
  * @param gridIndexOrPosition The grid index or position in the room that you want to spawn the grid
  *                            entity at. If a position is specified, the closest grid index will be
  *                            used.
- * @param gridCollisionClass The collision class that you want the custom grid entity to have.
- * @param anm2Path The path to the ANM2 file to use for the sprite.
+ * @param gridCollisionClass Optional. The collision class that you want the custom grid entity to
+ *                           have. If not specified, the grid collision class from the base grid
+ *                           entity will be used.
+ * @param anm2Path Optional. The path to the ANM2 file to use for the sprite. If not specified, the
+ *                 normal sprite from the base grid entity will be used.
  * @param defaultAnimation Optional. The name of the animation to play after the sprite is
  *                         initialized and after the player re-enters a room with this grid entity
  *                         in it. If not specified, the default animation in the anm2 will be used.
@@ -38,7 +41,7 @@ export declare function customGridEntityInit(mod: ModUpgraded): void;
  * @param baseGridEntityVariant Optional. The variant of the grid entity to use as a "base" for this
  *                              custom grid entity. Default is 0.
  */
-export declare function spawnCustomGridEntity(gridEntityTypeCustom: GridEntityType, gridIndexOrPosition: int | Vector, gridCollisionClass: GridCollisionClass, anm2Path: string, defaultAnimation?: string, baseGridEntityType?: GridEntityType, baseGridEntityVariant?: number): GridEntity;
+export declare function spawnCustomGridEntity(gridEntityTypeCustom: GridEntityType, gridIndexOrPosition: int | Vector, gridCollisionClass?: GridCollisionClass, anm2Path?: string, defaultAnimation?: string, baseGridEntityType?: GridEntityType, baseGridEntityVariant?: number): GridEntity;
 /**
  * Helper function to remove a custom grid entity created by the `spawnCustomGrid` function.
  *

package/dist/features/customGridEntity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"customGridEntity.d.ts","sourceRoot":"","sources":["../../src/features/customGridEntity.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,kBAAkB,EAClB,cAAc,EAGf,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAerD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAoB1E,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAmB3D;AAkID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,qBAAqB,CACnC,oBAAoB,EAAE,cAAc,EACpC,mBAAmB,EAAE,GAAG,GAAG,MAAM,EACjC,kBAAkB,EAAE,kBAAkB,EACtC,QAAQ,EAAE,MAAM,EAChB,gBAAgB,CAAC,EAAE,MAAM,EACzB,kBAAkB,iBAA4B,EAC9C,qBAAqB,SAAI,GACxB,UAAU,CAyCZ;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CACpC,+BAA+B,EAAE,GAAG,GAAG,MAAM,GAAG,UAAU,EAC1D,UAAU,UAAO,GAChB,UAAU,GAAG,SAAS,CAuCxB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,KAAK,CAC5C;IAAC,UAAU,EAAE,UAAU;IAAE,IAAI,EAAE,oBAAoB;CAAC,CACrD,CAqBA;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,qBAAqB,EAAE,UAAU,GAAG,GAAG,GACtC,cAAc,GAAG,SAAS,CAsB5B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,qBAAqB,EAAE,UAAU,GAAG,GAAG,GACtC,OAAO,CAOT"}
+{"version":3,"file":"customGridEntity.d.ts","sourceRoot":"","sources":["../../src/features/customGridEntity.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,kBAAkB,EAClB,cAAc,EAGf,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAerD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAoB1E,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAmB3D;AAoID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,qBAAqB,CACnC,oBAAoB,EAAE,cAAc,EACpC,mBAAmB,EAAE,GAAG,GAAG,MAAM,EACjC,kBAAkB,CAAC,EAAE,kBAAkB,EACvC,QAAQ,CAAC,EAAE,MAAM,EACjB,gBAAgB,CAAC,EAAE,MAAM,EACzB,kBAAkB,iBAA4B,EAC9C,qBAAqB,SAAI,GACxB,UAAU,CA8CZ;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CACpC,+BAA+B,EAAE,GAAG,GAAG,MAAM,GAAG,UAAU,EAC1D,UAAU,UAAO,GAChB,UAAU,GAAG,SAAS,CAuCxB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,KAAK,CAC5C;IAAC,UAAU,EAAE,UAAU;IAAE,IAAI,EAAE,oBAAoB;CAAC,CACrD,CAqBA;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,qBAAqB,EAAE,UAAU,GAAG,GAAG,GACtC,cAAc,GAAG,SAAS,CAsB5B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,qBAAqB,EAAE,UAAU,GAAG,GAAG,GACtC,OAAO,CAOT"}

package/dist/features/customGridEntity.lua

@@ -115,10 +115,12 @@ function postNewRoomReordered(self)
                 roomCustomGridEntities:delete(gridIndex)
                 goto __continue19
             end
-            local sprite = decoration:GetSprite()
-            sprite:Load(data.anm2Path, true)
-            local animationToPlay = data.defaultAnimation == nil and sprite:GetDefaultAnimation() or data.defaultAnimation
-            sprite:Play(animationToPlay, true)
+            if data.anm2Path ~= nil then
+                local sprite = decoration:GetSprite()
+                sprite:Load(data.anm2Path, true)
+                local animationToPlay = data.defaultAnimation == nil and sprite:GetDefaultAnimation() or data.defaultAnimation
+                sprite:Play(animationToPlay, true)
+            end
         end
         ::__continue19::
     end
@@ -165,8 +167,11 @@ end
 -- @param gridIndexOrPosition The grid index or position in the room that you want to spawn the grid
 -- entity at. If a position is specified, the closest grid index will be
 -- used.
--- @param gridCollisionClass The collision class that you want the custom grid entity to have.
--- @param anm2Path The path to the ANM2 file to use for the sprite.
+-- @param gridCollisionClass Optional. The collision class that you want the custom grid entity to
+-- have. If not specified, the grid collision class from the base grid
+-- entity will be used.
+-- @param anm2Path Optional. The path to the ANM2 file to use for the sprite. If not specified, the
+-- normal sprite from the base grid entity will be used.
 -- @param defaultAnimation Optional. The name of the animation to play after the sprite is
 -- initialized and after the player re-enters a room with this grid entity
 -- in it. If not specified, the default animation in the anm2 will be used.
@@ -189,11 +194,15 @@ function ____exports.spawnCustomGridEntity(self, gridEntityTypeCustom, gridIndex
     if customGridEntity == nil then
         error("Failed to spawn a custom grid entity.")
     end
-    customGridEntity.CollisionClass = gridCollisionClass
-    local sprite = customGridEntity:GetSprite()
-    sprite:Load(anm2Path, true)
-    local animationToPlay = defaultAnimation == nil and sprite:GetDefaultAnimation() or defaultAnimation
-    sprite:Play(animationToPlay, true)
+    if gridCollisionClass ~= nil then
+        customGridEntity.CollisionClass = gridCollisionClass
+    end
+    if anm2Path ~= nil then
+        local sprite = customGridEntity:GetSprite()
+        sprite:Load(anm2Path, true)
+        local animationToPlay = defaultAnimation == nil and sprite:GetDefaultAnimation() or defaultAnimation
+        sprite:Play(animationToPlay, true)
+    end
     local customGridEntityData = {
         gridEntityTypeCustom = gridEntityTypeCustom,
         roomListIndex = roomListIndex,

package/dist/features/customStage/customStageConstants.d.ts

@@ -1,4 +1,5 @@
 /// <reference types="isaac-typescript-definitions" />
+export declare const CUSTOM_STAGE_FEATURE_NAME = "customStage";
 export declare const ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH = "gfx/isaacscript-custom-stage";
 /** Corresponds to "ui_streak.anm2". */
 export declare enum UIStreakAnimation {

package/dist/features/customStage/customStageConstants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"customStageConstants.d.ts","sourceRoot":"","sources":["../../../src/features/customStage/customStageConstants.ts"],"names":[],"mappings":";AAAA,eAAO,MAAM,iCAAiC,iCAAiC,CAAC;AAEhF,uCAAuC;AACvC,oBAAY,iBAAiB;IAC3B,IAAI,IAAA;IACJ,IAAI,IAAA;IACJ,SAAS,IAAA;CACV;AAED,uCAAuC;AACvC,eAAO,MAAM,8BAA8B,EAAE;IAC3C,QAAQ,EAAE,GAAG,IAAI,iBAAiB,GAAG,GAAG;CAKhC,CAAC"}
+{"version":3,"file":"customStageConstants.d.ts","sourceRoot":"","sources":["../../../src/features/customStage/customStageConstants.ts"],"names":[],"mappings":";AAAA,eAAO,MAAM,yBAAyB,gBAAgB,CAAC;AAEvD,eAAO,MAAM,iCAAiC,iCAAiC,CAAC;AAEhF,uCAAuC;AACvC,oBAAY,iBAAiB;IAC3B,IAAI,IAAA;IACJ,IAAI,IAAA;IACJ,SAAS,IAAA;CACV;AAED,uCAAuC;AACvC,eAAO,MAAM,8BAA8B,EAAE;IAC3C,QAAQ,EAAE,GAAG,IAAI,iBAAiB,GAAG,GAAG;CAKhC,CAAC"}

package/dist/features/customStage/customStageConstants.lua

@@ -1,4 +1,5 @@
 local ____exports = {}
+____exports.CUSTOM_STAGE_FEATURE_NAME = "customStage"
 ____exports.ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH = "gfx/isaacscript-custom-stage"
 --- Corresponds to "ui_streak.anm2".
 ____exports.UIStreakAnimation = {}

package/dist/features/customStage/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/features/customStage/init.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AA6BxD,wBAAgB,eAAe,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CA0BtD"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/features/customStage/init.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AA8BxD,wBAAgB,eAAe,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CA0BtD"}

package/dist/features/customStage/init.lua

@@ -19,6 +19,8 @@ local ____exports = require("features.saveDataManager.exports")
 local saveDataManager = ____exports.saveDataManager
 local ____backdrop = require("features.customStage.backdrop")
 local setCustomStageBackdrop = ____backdrop.setCustomStageBackdrop
+local ____customStageConstants = require("features.customStage.customStageConstants")
+local CUSTOM_STAGE_FEATURE_NAME = ____customStageConstants.CUSTOM_STAGE_FEATURE_NAME
 local ____customStageGridEntities = require("features.customStage.customStageGridEntities")
 local convertVanillaTrapdoors = ____customStageGridEntities.convertVanillaTrapdoors
 local removeUrnRewards = ____customStageGridEntities.removeUrnRewards
@@ -133,7 +135,7 @@ function ____exports.customStageInit(self, mod)
     if customStagesMap.size == 0 then
         return
     end
-    saveDataManager(nil, "customStage", v)
+    saveDataManager(nil, CUSTOM_STAGE_FEATURE_NAME, v)
     versusScreenInit(nil)
     mod:AddCallback(ModCallback.POST_RENDER, postRender)
     mod:AddCallback(ModCallback.POST_CURSE_EVAL, postCurseEval)

package/dist/features/customStage/versusScreen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"versusScreen.d.ts","sourceRoot":"","sources":["../../../src/features/customStage/versusScreen.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AA2EnE;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAavC;AAED,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,CA2ExE;AAkGD,wBAAgB,sBAAsB,IAAI,IAAI,CAkC7C"}
+{"version":3,"file":"versusScreen.d.ts","sourceRoot":"","sources":["../../../src/features/customStage/versusScreen.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AA+EnE;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAavC;AAED,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,CA4ExE;AAmGD,wBAAgB,sBAAsB,IAAI,IAAI,CAkC7C"}

package/dist/features/customStage/versusScreen.lua

@@ -33,12 +33,16 @@ local ____versusScreenBackgroundColors = require("objects.versusScreenBackground
 local VERSUS_SCREEN_BACKGROUND_COLORS = ____versusScreenBackgroundColors.VERSUS_SCREEN_BACKGROUND_COLORS
 local ____versusScreenDirtSpotColors = require("objects.versusScreenDirtSpotColors")
 local VERSUS_SCREEN_DIRT_SPOT_COLORS = ____versusScreenDirtSpotColors.VERSUS_SCREEN_DIRT_SPOT_COLORS
+local ____disableAllSound = require("features.disableAllSound")
+local disableAllSound = ____disableAllSound.disableAllSound
+local enableAllSound = ____disableAllSound.enableAllSound
 local ____pause = require("features.pause")
 local pause = ____pause.pause
 local unpause = ____pause.unpause
 local ____runInNFrames = require("features.runInNFrames")
 local runNextGameFrame = ____runInNFrames.runNextGameFrame
 local ____customStageConstants = require("features.customStage.customStageConstants")
+local CUSTOM_STAGE_FEATURE_NAME = ____customStageConstants.CUSTOM_STAGE_FEATURE_NAME
 local ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH = ____customStageConstants.ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH
 local ____exports = require("features.customStage.exports")
 local DEFAULT_BASE_STAGE = ____exports.DEFAULT_BASE_STAGE
@@ -174,6 +178,7 @@ function ____exports.playVersusScreenAnimation(self, customStage)
     v.run.showingBossVersusScreen = true
     pause(nil)
     hud:SetVisible(false)
+    disableAllSound(nil, CUSTOM_STAGE_FEATURE_NAME)
     do
         local ____getPlayerPNGPaths_result_0 = getPlayerPNGPaths(nil)
         local namePNGPath = ____getPlayerPNGPaths_result_0.namePNGPath
@@ -226,6 +231,7 @@ local function finishVersusScreenAnimation(self)
     v.run.showingBossVersusScreen = false
     unpause(nil)
     hud:SetVisible(true)
+    enableAllSound(nil, CUSTOM_STAGE_FEATURE_NAME)
     sfxManager:Play(SoundEffect.CASTLE_PORTCULLIS)
 end
 function ____exports.versusScreenPostRender(self)

package/dist/features/customTrapdoor/spawn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../src/features/customTrapdoor/spawn.ts"],"names":[],"mappings":";;;AAMA,OAAO,EAAE,yBAAyB,EAAE,MAAM,oDAAoD,CAAC;AAM/F,wBAAgB,gCAAgC,CAC9C,mBAAmB,EAAE,GAAG,GAAG,MAAM,EACjC,WAAW,EAAE,yBAAyB,EACtC,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,OAAO,GAClB,UAAU,CAoCZ"}
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../src/features/customTrapdoor/spawn.ts"],"names":[],"mappings":";;;AAMA,OAAO,EAAE,yBAAyB,EAAE,MAAM,oDAAoD,CAAC;AAM/F,wBAAgB,gCAAgC,CAC9C,mBAAmB,EAAE,GAAG,GAAG,MAAM,EACjC,WAAW,EAAE,yBAAyB,EACtC,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,OAAO,GAClB,UAAU,CAmCZ"}

package/dist/features/customTrapdoor/spawn.lua

@@ -43,10 +43,9 @@ function ____exports.spawnCustomTrapdoorToDestination(self, gridIndexOrPosition,
     local roomTrapdoorMap = v.level.trapdoors:getAndSetDefault(roomListIndex)
     local customTrapdoorDescription = {open = open, destination = destination, firstSpawn = firstSpawn}
     roomTrapdoorMap:set(gridIndex, customTrapdoorDescription)
-    if not open then
-        local sprite = gridEntity:GetSprite()
-        sprite:Play(TrapdoorAnimation.CLOSED, true)
-    end
+    local sprite = gridEntity:GetSprite()
+    local animation = open and TrapdoorAnimation.OPENED or TrapdoorAnimation.CLOSED
+    sprite:Play(animation, true)
     return gridEntity
 end
 return ____exports

package/dist/interfaces/CustomStageTSConfig.d.ts

@@ -26,7 +26,7 @@ export interface CustomStageTSConfig {
      * https://isaacscript.github.io/main/custom-stages
      *
      * @minimum 101
-     * @maximum 109
+     * @maximum 999
      */
     roomVariantPrefix: number;
     /**

package/dist/interfaces/GridEntityCustomData.d.ts

@@ -13,8 +13,8 @@ export interface GridEntityCustomData {
     gridEntityTypeCustom: GridEntityType;
     roomListIndex: int;
     gridIndex: int;
-    anm2Path: string;
+    gridCollisionClass?: GridCollisionClass;
+    anm2Path?: string;
     defaultAnimation?: string;
-    gridCollisionClass: GridCollisionClass;
 }
 //# sourceMappingURL=GridEntityCustomData.d.ts.map

package/dist/interfaces/GridEntityCustomData.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GridEntityCustomData.d.ts","sourceRoot":"","sources":["../../src/interfaces/GridEntityCustomData.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,cAAc,EACf,MAAM,8BAA8B,CAAC;AAEtC;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,oBAAoB,EAAE,cAAc,CAAC;IAErC,aAAa,EAAE,GAAG,CAAC;IACnB,SAAS,EAAE,GAAG,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,kBAAkB,CAAC;CACxC"}
+{"version":3,"file":"GridEntityCustomData.d.ts","sourceRoot":"","sources":["../../src/interfaces/GridEntityCustomData.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,cAAc,EACf,MAAM,8BAA8B,CAAC;AAEtC;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,oBAAoB,EAAE,cAAc,CAAC;IAErC,aAAa,EAAE,GAAG,CAAC;IACnB,SAAS,EAAE,GAAG,CAAC;IACf,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B"}

package/package.json

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

package/src/features/customGridEntity.ts

@@ -184,13 +184,15 @@ function postNewRoomReordered() {
       continue;
     }
 
-    const sprite = decoration.GetSprite();
-    sprite.Load(data.anm2Path, true);
-    const animationToPlay =
-      data.defaultAnimation === undefined
-        ? sprite.GetDefaultAnimation()
-        : data.defaultAnimation;
-    sprite.Play(animationToPlay, true);
+    if (data.anm2Path !== undefined) {
+      const sprite = decoration.GetSprite();
+      sprite.Load(data.anm2Path, true);
+      const animationToPlay =
+        data.defaultAnimation === undefined
+          ? sprite.GetDefaultAnimation()
+          : data.defaultAnimation;
+      sprite.Play(animationToPlay, true);
+    }
   }
 }
 
@@ -220,8 +222,11 @@ function postNewRoomReordered() {
  * @param gridIndexOrPosition The grid index or position in the room that you want to spawn the grid
  *                            entity at. If a position is specified, the closest grid index will be
  *                            used.
- * @param gridCollisionClass The collision class that you want the custom grid entity to have.
- * @param anm2Path The path to the ANM2 file to use for the sprite.
+ * @param gridCollisionClass Optional. The collision class that you want the custom grid entity to
+ *                           have. If not specified, the grid collision class from the base grid
+ *                           entity will be used.
+ * @param anm2Path Optional. The path to the ANM2 file to use for the sprite. If not specified, the
+ *                 normal sprite from the base grid entity will be used.
  * @param defaultAnimation Optional. The name of the animation to play after the sprite is
  *                         initialized and after the player re-enters a room with this grid entity
  *                         in it. If not specified, the default animation in the anm2 will be used.
@@ -233,8 +238,8 @@ function postNewRoomReordered() {
 export function spawnCustomGridEntity(
   gridEntityTypeCustom: GridEntityType,
   gridIndexOrPosition: int | Vector,
-  gridCollisionClass: GridCollisionClass,
-  anm2Path: string,
+  gridCollisionClass?: GridCollisionClass,
+  anm2Path?: string,
   defaultAnimation?: string,
   baseGridEntityType = GridEntityType.DECORATION,
   baseGridEntityVariant = 0,
@@ -255,15 +260,20 @@ export function spawnCustomGridEntity(
   if (customGridEntity === undefined) {
     error("Failed to spawn a custom grid entity.");
   }
-  customGridEntity.CollisionClass = gridCollisionClass;
-
-  const sprite = customGridEntity.GetSprite();
-  sprite.Load(anm2Path, true);
-  const animationToPlay =
-    defaultAnimation === undefined
-      ? sprite.GetDefaultAnimation()
-      : defaultAnimation;
-  sprite.Play(animationToPlay, true);
+
+  if (gridCollisionClass !== undefined) {
+    customGridEntity.CollisionClass = gridCollisionClass;
+  }
+
+  if (anm2Path !== undefined) {
+    const sprite = customGridEntity.GetSprite();
+    sprite.Load(anm2Path, true);
+    const animationToPlay =
+      defaultAnimation === undefined
+        ? sprite.GetDefaultAnimation()
+        : defaultAnimation;
+    sprite.Play(animationToPlay, true);
+  }
 
   const customGridEntityData: GridEntityCustomData = {
     gridEntityTypeCustom,

package/src/features/customStage/customStageConstants.ts

@@ -1,3 +1,5 @@
+export const CUSTOM_STAGE_FEATURE_NAME = "customStage";
+
 export const ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH = "gfx/isaacscript-custom-stage";
 
 /** Corresponds to "ui_streak.anm2". */

package/src/features/customStage/init.ts

@@ -17,6 +17,7 @@ import {
 import { CustomStage, RoomTypeMap } from "../../interfaces/private/CustomStage";
 import { saveDataManager } from "../saveDataManager/exports";
 import { setCustomStageBackdrop } from "./backdrop";
+import { CUSTOM_STAGE_FEATURE_NAME } from "./customStageConstants";
 import {
   convertVanillaTrapdoors,
   removeUrnRewards,
@@ -42,7 +43,7 @@ export function customStageInit(mod: ModUpgraded): void {
     return;
   }
 
-  saveDataManager("customStage", v);
+  saveDataManager(CUSTOM_STAGE_FEATURE_NAME, v);
   versusScreenInit();
 
   mod.AddCallback(ModCallback.POST_RENDER, postRender); // 2

package/src/features/customStage/versusScreen.ts

@@ -18,9 +18,13 @@ import { PLAYER_NAME_PNG_FILE_NAMES } from "../../objects/playerNamePNGFileNames
 import { PLAYER_PORTRAIT_PNG_FILE_NAMES } from "../../objects/playerPortraitPNGFileNames";
 import { VERSUS_SCREEN_BACKGROUND_COLORS } from "../../objects/versusScreenBackgroundColors";
 import { VERSUS_SCREEN_DIRT_SPOT_COLORS } from "../../objects/versusScreenDirtSpotColors";
+import { disableAllSound, enableAllSound } from "../disableAllSound";
 import { pause, unpause } from "../pause";
 import { runNextGameFrame } from "../runInNFrames";
-import { ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH } from "./customStageConstants";
+import {
+  CUSTOM_STAGE_FEATURE_NAME,
+  ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH,
+} from "./customStageConstants";
 import {
   DEFAULT_BASE_STAGE,
   DEFAULT_BASE_STAGE_TYPE,
@@ -136,6 +140,7 @@ export function playVersusScreenAnimation(customStage: CustomStage): void {
 
   pause();
   hud.SetVisible(false);
+  disableAllSound(CUSTOM_STAGE_FEATURE_NAME);
 
   // Player
   {
@@ -273,6 +278,7 @@ function finishVersusScreenAnimation() {
 
   unpause();
   hud.SetVisible(true);
+  enableAllSound(CUSTOM_STAGE_FEATURE_NAME);
 
   // The sound effect only plays once the versus cutscene is over.
   sfxManager.Play(SoundEffect.CASTLE_PORTCULLIS);

package/src/features/customTrapdoor/spawn.ts

@@ -45,10 +45,9 @@ export function spawnCustomTrapdoorToDestination(
   };
   roomTrapdoorMap.set(gridIndex, customTrapdoorDescription);
 
-  if (!open) {
-    const sprite = gridEntity.GetSprite();
-    sprite.Play(TrapdoorAnimation.CLOSED, true);
-  }
+  const sprite = gridEntity.GetSprite();
+  const animation = open ? TrapdoorAnimation.OPENED : TrapdoorAnimation.CLOSED;
+  sprite.Play(animation, true);
 
   return gridEntity;
 }

package/src/interfaces/CustomStageTSConfig.ts

@@ -32,7 +32,7 @@ export interface CustomStageTSConfig {
    * https://isaacscript.github.io/main/custom-stages
    *
    * @minimum 101
-   * @maximum 109
+   * @maximum 999
    */
   roomVariantPrefix: number;
 

package/src/interfaces/GridEntityCustomData.ts

@@ -18,7 +18,7 @@ export interface GridEntityCustomData {
 
   roomListIndex: int;
   gridIndex: int;
-  anm2Path: string;
+  gridCollisionClass?: GridCollisionClass;
+  anm2Path?: string;
   defaultAnimation?: string;
-  gridCollisionClass: GridCollisionClass;
 }