isaacscript-common 8.8.1 → 8.9.1

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

@@ -8,7 +8,17 @@
 import { LevelStage, StageType } from "isaac-typescript-definitions";
 export declare const DEFAULT_BASE_STAGE = LevelStage.BASEMENT_2;
 export declare const DEFAULT_BASE_STAGE_TYPE = StageType.ORIGINAL;
-export declare const INVALID_STAGE_VALUE: LevelStage;
+/**
+ * Equal to -1. Setting the stage to an invalid stage value is useful in that it prevents backdrops
+ * and shadows from loading.
+ */
+export declare const CUSTOM_FLOOR_STAGE: LevelStage;
+/**
+ * We must use `StageType.WRATH_OF_THE_LAMB` instead of `StageType.ORIGINAL` or else the walls will
+ * not render properly. DeadInfinity suspects that this might be because it is trying to use the
+ * Dark Room's backdrop (instead of The Chest).
+ */
+export declare const CUSTOM_FLOOR_STAGE_TYPE = StageType.WRATH_OF_THE_LAMB;
 /**
  * Helper function to warp to a custom stage/level.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../../../src/features/customStage/exports.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AAEH,OAAO,EAEL,UAAU,EAGV,SAAS,EACV,MAAM,8BAA8B,CAAC;AAoBtC,eAAO,MAAM,kBAAkB,wBAAwB,CAAC;AACxD,eAAO,MAAM,uBAAuB,qBAAqB,CAAC;AAE1D,eAAO,MAAM,mBAAmB,YAAmB,CAAC;AAEpD;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,UAAU,UAAO,EACjB,OAAO,UAAQ,GACd,IAAI,CAwDN;AAkGD;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}
+{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../../../src/features/customStage/exports.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AAEH,OAAO,EAEL,UAAU,EAGV,SAAS,EACV,MAAM,8BAA8B,CAAC;AAoBtC,eAAO,MAAM,kBAAkB,wBAAwB,CAAC;AACxD,eAAO,MAAM,uBAAuB,qBAAqB,CAAC;AAE1D;;;GAGG;AACH,eAAO,MAAM,kBAAkB,YAAmB,CAAC;AAEnD;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,8BAA8B,CAAC;AAEnE;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,UAAU,UAAO,EACjB,OAAO,UAAQ,GACd,IAAI,CAqDN;AAkGD;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}

package/dist/features/customStage/exports.lua

@@ -103,7 +103,13 @@ function setStageRoomsData(self, customStage, rng, verbose)
 end
 ____exports.DEFAULT_BASE_STAGE = LevelStage.BASEMENT_2
 ____exports.DEFAULT_BASE_STAGE_TYPE = StageType.ORIGINAL
-____exports.INVALID_STAGE_VALUE = -1
+--- Equal to -1. Setting the stage to an invalid stage value is useful in that it prevents backdrops
+-- and shadows from loading.
+____exports.CUSTOM_FLOOR_STAGE = -1
+--- We must use `StageType.WRATH_OF_THE_LAMB` instead of `StageType.ORIGINAL` or else the walls will
+-- not render properly. DeadInfinity suspects that this might be because it is trying to use the
+-- Dark Room's backdrop (instead of The Chest).
+____exports.CUSTOM_FLOOR_STAGE_TYPE = StageType.WRATH_OF_THE_LAMB
 --- Helper function to warp to a custom stage/level.
 -- 
 -- Custom stages/levels must first be defined in the "tsconfig.json" file. See the documentation for
@@ -133,7 +139,7 @@ function ____exports.setCustomStage(self, name, firstFloor, verbose)
     local rng = newRNG(nil, startSeed)
     v.run.currentCustomStage = customStage
     v.run.firstFloor = firstFloor
-    if stage == ____exports.INVALID_STAGE_VALUE then
+    if stage == ____exports.CUSTOM_FLOOR_STAGE then
         level:SetStage(LevelStage.BASEMENT_1, StageType.ORIGINAL)
     end
     local baseStage = customStage.baseStage == nil and ____exports.DEFAULT_BASE_STAGE or customStage.baseStage
@@ -144,8 +150,8 @@ function ____exports.setCustomStage(self, name, firstFloor, verbose)
     local reseed = asNumber(nil, stage) >= baseStage
     setStage(nil, baseStage, baseStageType, reseed)
     setStageRoomsData(nil, customStage, rng, verbose)
-    local targetStage = ____exports.INVALID_STAGE_VALUE
-    local targetStageType = StageType.WRATH_OF_THE_LAMB
+    local targetStage = ____exports.CUSTOM_FLOOR_STAGE
+    local targetStageType = ____exports.CUSTOM_FLOOR_STAGE_TYPE
     level:SetStage(targetStage, targetStageType)
     reorderedCallbacksSetStageInternal(nil, targetStage, targetStageType)
 end

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":"AAcA,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,CAoFxE;AAmGD,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;AAgFnE;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAavC;AAED,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,CAoFxE;AAmGD,wBAAgB,sBAAsB,IAAI,IAAI,CAkC7C"}

package/dist/features/customStage/versusScreen.lua

@@ -9,7 +9,6 @@ local PlayerType = ____isaac_2Dtypescript_2Ddefinitions.PlayerType
 local RoomType = ____isaac_2Dtypescript_2Ddefinitions.RoomType
 local SoundEffect = ____isaac_2Dtypescript_2Ddefinitions.SoundEffect
 local StageID = ____isaac_2Dtypescript_2Ddefinitions.StageID
-local StageType = ____isaac_2Dtypescript_2Ddefinitions.StageType
 local ____cachedClasses = require("core.cachedClasses")
 local game = ____cachedClasses.game
 local sfxManager = ____cachedClasses.sfxManager
@@ -47,9 +46,10 @@ local ____customStageConstants = require("features.customStage.customStageConsta
 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 CUSTOM_FLOOR_STAGE = ____exports.CUSTOM_FLOOR_STAGE
+local CUSTOM_FLOOR_STAGE_TYPE = ____exports.CUSTOM_FLOOR_STAGE_TYPE
 local DEFAULT_BASE_STAGE = ____exports.DEFAULT_BASE_STAGE
 local DEFAULT_BASE_STAGE_TYPE = ____exports.DEFAULT_BASE_STAGE_TYPE
-local INVALID_STAGE_VALUE = ____exports.INVALID_STAGE_VALUE
 local ____v = require("features.customStage.v")
 local v = ____v.default
 function willVanillaVersusScreenPlay(self)
@@ -172,7 +172,7 @@ function ____exports.playVersusScreenAnimation(self, customStage)
             nil,
             function()
                 local futureLevel = game:GetLevel()
-                futureLevel:SetStage(INVALID_STAGE_VALUE, StageType.ORIGINAL)
+                futureLevel:SetStage(CUSTOM_FLOOR_STAGE, CUSTOM_FLOOR_STAGE_TYPE)
             end
         )
         return

package/dist/functions/gridEntities.d.ts

@@ -1,4 +1,4 @@
-import { CrawlSpaceVariant, GridEntityType, GridEntityXMLType, TrapdoorVariant } from "isaac-typescript-definitions";
+import { GridEntityType, GridEntityXMLType } from "isaac-typescript-definitions";
 import { AnyGridEntity } from "../types/AnyGridEntity";
 /**
  * Helper function to convert the grid entity type found in a room XML file to the corresponding
@@ -20,13 +20,6 @@ export declare function getAllGridIndexes(): int[];
  * not have collision yet in that callback.
  */
 export declare function getCollidingEntitiesWithGridEntity(gridEntity: GridEntity): Entity[];
-/**
- * Helper function to get all of the crawl spaces in the room.
- *
- * @param crawlSpaceVariant Optional. If specified, will only get the crawl spaces that match the
- *                          variant. Default is -1, which matches every variant.
- */
-export declare function getCrawlSpaces(crawlSpaceVariant?: CrawlSpaceVariant): GridEntity[];
 /**
  * Helper function to get every grid entity in the current room.
  *
@@ -88,11 +81,6 @@ export declare function getTopLeftWall(): GridEntity | undefined;
  * room shape is.)
  */
 export declare function getTopLeftWallGridIndex(): int;
-/**
- * Helper function to get all of the grid entities of type `GridEntityType.TRAPDOOR` in the room.
- * Specify a specific trapdoor variant to select only trapdoors of that variant.
- */
-export declare function getTrapdoors(trapdoorVariant?: TrapdoorVariant): GridEntity[];
 /**
  * Helper function to see if the provided gridEntity is in its respective broken state. See the
  * `GRID_ENTITY_TYPE_TO_BROKEN_STATE_MAP` constant for more details.

package/dist/functions/gridEntities.d.ts.map

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

package/dist/functions/gridEntities.lua

@@ -49,43 +49,6 @@ function ____exports.getAllGridIndexes(self)
     local gridSize = room:GetGridSize()
     return erange(nil, gridSize)
 end
---- Helper function to get every grid entity in the current room.
--- 
--- Use this function with no arguments to get every grid entity, or specify a variadic amount of
--- arguments to match specific grid entity types.
--- 
--- For example:
--- 
--- ```ts
--- for (const gridEntity of getGridEntities()) {
---   print(gridEntity.GetType())
--- }
--- ```
--- 
--- For example:
--- 
--- ```ts
--- const rocks = getGridEntities(
---   GridEntityType.ROCK,
---   GridEntityType.BLOCK,
---   GridEntityType.ROCK_TINTED,
--- );
--- ```
-function ____exports.getGridEntities(self, ...)
-    local gridEntityTypes = {...}
-    local gridEntities = getAllGridEntities(nil)
-    if #gridEntityTypes == 0 then
-        return gridEntities
-    end
-    local gridEntityTypesSet = __TS__New(Set, gridEntityTypes)
-    return __TS__ArrayFilter(
-        gridEntities,
-        function(____, gridEntity)
-            local gridEntityType = gridEntity:GetType()
-            return gridEntityTypesSet:has(gridEntityType)
-        end
-    )
-end
 function getAllGridEntities(self)
     local room = game:GetRoom()
     local gridEntities = {}
@@ -97,17 +60,6 @@ function getAllGridEntities(self)
     end
     return gridEntities
 end
---- Helper function to get all of the grid entities in the room that specifically match the type and
--- variant provided.
--- 
--- If you want to match every variant, use the `getGridEntities` function instead.
-function ____exports.getMatchingGridEntities(self, gridEntityType, variant)
-    local gridEntities = ____exports.getGridEntities(nil, gridEntityType)
-    return __TS__ArrayFilter(
-        gridEntities,
-        function(____, gridEntity) return gridEntity:GetVariant() == variant end
-    )
-end
 --- Helper function to get the grid index of the top left wall. (This will depend on what the current
 -- room shape is.)
 function ____exports.getTopLeftWallGridIndex(self)
@@ -243,18 +195,42 @@ function ____exports.getCollidingEntitiesWithGridEntity(self, gridEntity)
         ) end
     )
 end
---- Helper function to get all of the crawl spaces in the room.
+--- Helper function to get every grid entity in the current room.
 -- 
--- @param crawlSpaceVariant Optional. If specified, will only get the crawl spaces that match the
--- variant. Default is -1, which matches every variant.
-function ____exports.getCrawlSpaces(self, crawlSpaceVariant)
-    if crawlSpaceVariant == nil then
-        crawlSpaceVariant = -1
-    end
-    if asNumber(nil, crawlSpaceVariant) == -1 then
-        return ____exports.getGridEntities(nil, GridEntityType.CRAWL_SPACE)
+-- Use this function with no arguments to get every grid entity, or specify a variadic amount of
+-- arguments to match specific grid entity types.
+-- 
+-- For example:
+-- 
+-- ```ts
+-- for (const gridEntity of getGridEntities()) {
+--   print(gridEntity.GetType())
+-- }
+-- ```
+-- 
+-- For example:
+-- 
+-- ```ts
+-- const rocks = getGridEntities(
+--   GridEntityType.ROCK,
+--   GridEntityType.BLOCK,
+--   GridEntityType.ROCK_TINTED,
+-- );
+-- ```
+function ____exports.getGridEntities(self, ...)
+    local gridEntityTypes = {...}
+    local gridEntities = getAllGridEntities(nil)
+    if #gridEntityTypes == 0 then
+        return gridEntities
     end
-    return ____exports.getMatchingGridEntities(nil, GridEntityType.CRAWL_SPACE, crawlSpaceVariant)
+    local gridEntityTypesSet = __TS__New(Set, gridEntityTypes)
+    return __TS__ArrayFilter(
+        gridEntities,
+        function(____, gridEntity)
+            local gridEntityType = gridEntity:GetType()
+            return gridEntityTypesSet:has(gridEntityType)
+        end
+    )
 end
 --- Helper function to get every grid entity in the current room except for certain specific types.
 -- 
@@ -300,6 +276,17 @@ end
 function ____exports.getGridEntityIDFromConstituents(self, gridEntityType, variant)
     return (tostring(gridEntityType) .. ".") .. tostring(variant)
 end
+--- Helper function to get all of the grid entities in the room that specifically match the type and
+-- variant provided.
+-- 
+-- If you want to match every variant, use the `getGridEntities` function instead.
+function ____exports.getMatchingGridEntities(self, gridEntityType, variant)
+    local gridEntities = ____exports.getGridEntities(nil, gridEntityType)
+    return __TS__ArrayFilter(
+        gridEntities,
+        function(____, gridEntity) return gridEntity:GetVariant() == variant end
+    )
+end
 function ____exports.getSurroundingGridEntities(self, gridEntity)
     local room = game:GetRoom()
     local gridWidth = room:GetGridWidth()
@@ -328,14 +315,6 @@ function ____exports.getTopLeftWall(self)
     local topLeftWallGridIndex = ____exports.getTopLeftWallGridIndex(nil)
     return room:GetGridEntity(topLeftWallGridIndex)
 end
---- Helper function to get all of the grid entities of type `GridEntityType.TRAPDOOR` in the room.
--- Specify a specific trapdoor variant to select only trapdoors of that variant.
-function ____exports.getTrapdoors(self, trapdoorVariant)
-    if trapdoorVariant == nil then
-        return ____exports.getGridEntities(nil, GridEntityType.TRAPDOOR)
-    end
-    return ____exports.getMatchingGridEntities(nil, GridEntityType.TRAPDOOR, trapdoorVariant)
-end
 --- Helper function to see if the provided gridEntity is in its respective broken state. See the
 -- `GRID_ENTITY_TYPE_TO_BROKEN_STATE_MAP` constant for more details.
 -- 

package/dist/functions/gridEntitiesSpecific.d.ts

@@ -1,4 +1,12 @@
-import { DoorVariant, PitVariant, PoopGridEntityVariant, PressurePlateVariant, RockVariant } from "isaac-typescript-definitions";
+import { CrawlSpaceVariant, DoorVariant, PitVariant, PoopGridEntityVariant, PressurePlateVariant, RockVariant, TrapdoorVariant } from "isaac-typescript-definitions";
+/**
+ * Helper function to get all of the grid entities of type `GridEntityType.CRAWL_SPACE` (18) in the
+ * room.
+ *
+ * @param crawlSpaceVariant Optional. If specified, will only get the crawl spaces that match the
+ *                          variant. Default is -1, which matches every variant.
+ */
+export declare function getCrawlSpaces(crawlSpaceVariant?: CrawlSpaceVariant): GridEntity[];
 /**
  * Helper function to get all of the `GridEntityPit` in the room.
  *
@@ -33,6 +41,23 @@ export declare function getRocks(variant?: number): GridEntityRock[];
 export declare function getSpikes(variant?: number): GridEntitySpikes[];
 /** Helper function to get all of the `GridEntityTNT` in the room. */
 export declare function getTNT(variant?: number): GridEntityTNT[];
+/**
+ * Helper function to get all of the grid entities of type `GridEntityType.TRAPDOOR` (17) in the
+ * room. Specify a specific trapdoor variant to select only trapdoors of that variant.
+ */
+export declare function getTrapdoors(trapdoorVariant?: TrapdoorVariant): GridEntity[];
+/**
+ * Helper function to remove all of the `GridEntityType.CRAWL_SPACE` (18) in the room.
+ *
+ * @param crawlSpaceVariant Optional. If specified, will only remove the crawl spaces that match
+ *                          this variant. Default is -1, which matches every variant.
+ * @param updateRoom Optional. Whether or not to update the room after the crawl spaces are removed.
+ *                   Default is false. For more information, see the description of the
+ *                   `removeGridEntities` helper function.
+ * @param cap Optional. If specified, will only remove the given amount of crawl spaces.
+ * @returns The crawl spaces that were removed.
+ */
+export declare function removeAllCrawlSpaces(crawlSpaceVariant?: CrawlSpaceVariant, updateRoom?: boolean, cap?: int): GridEntity[];
 /**
  * Helper function to remove all of the `GridEntityPit` in the room.
  *
@@ -110,11 +135,27 @@ export declare function removeAllSpikes(variant?: number, updateRoom?: boolean,
  * @returns The TNTs that were removed.
  */
 export declare function removeAllTNT(variant?: number, updateRoom?: boolean, cap?: int): GridEntityTNT[];
-/** Helper function to spawn a `GridEntityType.DOOR` (16). */
+/**
+ * Helper function to remove all of the `GridEntityType.TRAPDOOR` (17) in the room.
+ *
+ * @param trapdoorVariant Optional. If specified, will only remove the trapdoors that match this
+ *                        variant. Default is -1, which matches every variant.
+ * @param updateRoom Optional. Whether or not to update the room after the trapdoors are removed.
+ *                   Default is false. For more information, see the description of the
+ *                   `removeGridEntities` helper function.
+ * @param cap Optional. If specified, will only remove the given amount of trapdoors.
+ * @returns The trapdoors that were removed.
+ */
+export declare function removeAllTrapdoors(trapdoorVariant?: TrapdoorVariant, updateRoom?: boolean, cap?: int): GridEntity[];
+/** Helper function to spawn a `GridEntityType.CRAWL_SPACE` (18). */
+export declare function spawnCrawlSpace(gridIndexOrPosition: int | Vector): GridEntity | undefined;
+/** Helper function to spawn a `GridEntityType.CRAWL_SPACE` (18) with a specific variant. */
+export declare function spawnCrawlSpaceWithVariant(crawlSpaceVariant: CrawlSpaceVariant, gridIndexOrPosition: int | Vector): GridEntity | undefined;
+/** Helper function to spawn a `GridEntityType.PIT` (7) with a specific variant. */
 export declare function spawnDoor(gridIndexOrPosition: int | Vector): GridEntityDoor | undefined;
-/** Helper function to spawn a `GridEntityType.DOOR` (16) with a specific variant. */
+/** Helper function to spawn a `GridEntityType.DOOR` (16). */
 export declare function spawnDoorWithVariant(doorVariant: DoorVariant, gridIndexOrPosition: int | Vector): GridEntityDoor | undefined;
-/** Helper function to spawn a `GridEntityType.PIT` (7). */
+/** Helper function to spawn a `GridEntityType.DOOR` (16) with a specific variant. */
 export declare function spawnPit(gridIndexOrPosition: int | Vector): GridEntityPit | undefined;
 /** Helper function to spawn a `GridEntityType.PIT` (7) with a specific variant. */
 export declare function spawnPitWithVariant(pitVariant: PitVariant, gridIndexOrPosition: int | Vector): GridEntityPit | undefined;
@@ -138,4 +179,8 @@ export declare function spawnSpikesWithVariant(variant: int, gridIndexOrPosition
 export declare function spawnTNT(gridIndexOrPosition: int | Vector): GridEntityTNT | undefined;
 /** Helper function to spawn a `GridEntityType.TNT` (12) with a specific variant. */
 export declare function spawnTNTWithVariant(variant: int, gridIndexOrPosition: int | Vector): GridEntityTNT | undefined;
+/** Helper function to spawn a `GridEntityType.TRAPDOOR` (17). */
+export declare function spawnTrapdoor(gridIndexOrPosition: int | Vector): GridEntity | undefined;
+/** Helper function to spawn a `GridEntityType.TRAPDOOR` (17) with a specific variant. */
+export declare function spawnTrapdoorWithVariant(trapdoorVariant: TrapdoorVariant, gridIndexOrPosition: int | Vector): GridEntity | undefined;
 //# sourceMappingURL=gridEntitiesSpecific.d.ts.map

package/dist/functions/gridEntitiesSpecific.d.ts.map

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

package/dist/functions/gridEntitiesSpecific.lua

@@ -1,5 +1,6 @@
 local ____exports = {}
 local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local CrawlSpaceVariant = ____isaac_2Dtypescript_2Ddefinitions.CrawlSpaceVariant
 local DoorVariant = ____isaac_2Dtypescript_2Ddefinitions.DoorVariant
 local GridEntityType = ____isaac_2Dtypescript_2Ddefinitions.GridEntityType
 local PitVariant = ____isaac_2Dtypescript_2Ddefinitions.PitVariant
@@ -8,11 +9,16 @@ local PressurePlateVariant = ____isaac_2Dtypescript_2Ddefinitions.PressurePlateV
 local RockVariant = ____isaac_2Dtypescript_2Ddefinitions.RockVariant
 local ____gridEntities = require("functions.gridEntities")
 local getGridEntities = ____gridEntities.getGridEntities
+local getMatchingGridEntities = ____gridEntities.getMatchingGridEntities
 local removeGridEntities = ____gridEntities.removeGridEntities
 local spawnGridEntityWithVariant = ____gridEntities.spawnGridEntityWithVariant
 local ____types = require("functions.types")
 local asNumber = ____types.asNumber
---- Helper function to spawn a `GridEntityType.DOOR` (16) with a specific variant.
+--- Helper function to spawn a `GridEntityType.CRAWL_SPACE` (18) with a specific variant.
+function ____exports.spawnCrawlSpaceWithVariant(self, crawlSpaceVariant, gridIndexOrPosition)
+    return spawnGridEntityWithVariant(nil, GridEntityType.CRAWL_SPACE, crawlSpaceVariant, gridIndexOrPosition)
+end
+--- Helper function to spawn a `GridEntityType.DOOR` (16).
 function ____exports.spawnDoorWithVariant(self, doorVariant, gridIndexOrPosition)
     local gridEntity = spawnGridEntityWithVariant(nil, GridEntityType.DOOR, doorVariant, gridIndexOrPosition)
     if gridEntity == nil then
@@ -96,6 +102,20 @@ function ____exports.spawnTNTWithVariant(self, variant, gridIndexOrPosition)
     end
     return tnt
 end
+--- Helper function to get all of the grid entities of type `GridEntityType.CRAWL_SPACE` (18) in the
+-- room.
+-- 
+-- @param crawlSpaceVariant Optional. If specified, will only get the crawl spaces that match the
+-- variant. Default is -1, which matches every variant.
+function ____exports.getCrawlSpaces(self, crawlSpaceVariant)
+    if crawlSpaceVariant == nil then
+        crawlSpaceVariant = -1
+    end
+    if asNumber(nil, crawlSpaceVariant) == -1 then
+        return getGridEntities(nil, GridEntityType.CRAWL_SPACE)
+    end
+    return getMatchingGridEntities(nil, GridEntityType.CRAWL_SPACE, crawlSpaceVariant)
+end
 --- Helper function to get all of the `GridEntityPit` in the room.
 -- 
 -- @param pitVariant Optional. If specified, will only get the pits that match the variant. Default
@@ -218,6 +238,33 @@ function ____exports.getTNT(self, variant)
     end
     return tntArray
 end
+--- Helper function to get all of the grid entities of type `GridEntityType.TRAPDOOR` (17) in the
+-- room. Specify a specific trapdoor variant to select only trapdoors of that variant.
+function ____exports.getTrapdoors(self, trapdoorVariant)
+    if trapdoorVariant == nil then
+        return getGridEntities(nil, GridEntityType.TRAPDOOR)
+    end
+    return getMatchingGridEntities(nil, GridEntityType.TRAPDOOR, trapdoorVariant)
+end
+--- Helper function to remove all of the `GridEntityType.CRAWL_SPACE` (18) in the room.
+-- 
+-- @param crawlSpaceVariant Optional. If specified, will only remove the crawl spaces that match
+-- this variant. Default is -1, which matches every variant.
+-- @param updateRoom Optional. Whether or not to update the room after the crawl spaces are removed.
+-- Default is false. For more information, see the description of the
+-- `removeGridEntities` helper function.
+-- @param cap Optional. If specified, will only remove the given amount of crawl spaces.
+-- @returns The crawl spaces that were removed.
+function ____exports.removeAllCrawlSpaces(self, crawlSpaceVariant, updateRoom, cap)
+    if crawlSpaceVariant == nil then
+        crawlSpaceVariant = -1
+    end
+    if updateRoom == nil then
+        updateRoom = false
+    end
+    local crawlSpaces = ____exports.getCrawlSpaces(nil, crawlSpaceVariant)
+    return removeGridEntities(nil, crawlSpaces, updateRoom, cap)
+end
 --- Helper function to remove all of the `GridEntityPit` in the room.
 -- 
 -- @param pitVariant Optional. If specified, will only remove the pits that match this variant.
@@ -337,11 +384,34 @@ function ____exports.removeAllTNT(self, variant, updateRoom, cap)
     local tnt = ____exports.getTNT(nil, variant)
     return removeGridEntities(nil, tnt, updateRoom, cap)
 end
---- Helper function to spawn a `GridEntityType.DOOR` (16).
+--- Helper function to remove all of the `GridEntityType.TRAPDOOR` (17) in the room.
+-- 
+-- @param trapdoorVariant Optional. If specified, will only remove the trapdoors that match this
+-- variant. Default is -1, which matches every variant.
+-- @param updateRoom Optional. Whether or not to update the room after the trapdoors are removed.
+-- Default is false. For more information, see the description of the
+-- `removeGridEntities` helper function.
+-- @param cap Optional. If specified, will only remove the given amount of trapdoors.
+-- @returns The trapdoors that were removed.
+function ____exports.removeAllTrapdoors(self, trapdoorVariant, updateRoom, cap)
+    if trapdoorVariant == nil then
+        trapdoorVariant = -1
+    end
+    if updateRoom == nil then
+        updateRoom = false
+    end
+    local trapdoors = ____exports.getTrapdoors(nil, trapdoorVariant)
+    return removeGridEntities(nil, trapdoors, updateRoom, cap)
+end
+--- Helper function to spawn a `GridEntityType.CRAWL_SPACE` (18).
+function ____exports.spawnCrawlSpace(self, gridIndexOrPosition)
+    return ____exports.spawnCrawlSpaceWithVariant(nil, CrawlSpaceVariant.NORMAL, gridIndexOrPosition)
+end
+--- Helper function to spawn a `GridEntityType.PIT` (7) with a specific variant.
 function ____exports.spawnDoor(self, gridIndexOrPosition)
     return ____exports.spawnDoorWithVariant(nil, DoorVariant.UNSPECIFIED, gridIndexOrPosition)
 end
---- Helper function to spawn a `GridEntityType.PIT` (7).
+--- Helper function to spawn a `GridEntityType.DOOR` (16) with a specific variant.
 function ____exports.spawnPit(self, gridIndexOrPosition)
     return ____exports.spawnPitWithVariant(nil, PitVariant.NORMAL, gridIndexOrPosition)
 end
@@ -365,4 +435,12 @@ end
 function ____exports.spawnTNT(self, gridIndexOrPosition)
     return ____exports.spawnTNTWithVariant(nil, 0, gridIndexOrPosition)
 end
+--- Helper function to spawn a `GridEntityType.TRAPDOOR` (17).
+function ____exports.spawnTrapdoor(self, gridIndexOrPosition)
+    return ____exports.spawnCrawlSpaceWithVariant(nil, CrawlSpaceVariant.NORMAL, gridIndexOrPosition)
+end
+--- Helper function to spawn a `GridEntityType.TRAPDOOR` (17) with a specific variant.
+function ____exports.spawnTrapdoorWithVariant(self, trapdoorVariant, gridIndexOrPosition)
+    return spawnGridEntityWithVariant(nil, GridEntityType.TRAPDOOR, trapdoorVariant, gridIndexOrPosition)
+end
 return ____exports

package/dist/index.d.ts

@@ -954,6 +954,19 @@ export declare function countEntities(entityType?: EntityType, variant?: number,
  */
 export declare function countSetBits(n: int): int;
 
+/**
+ * Equal to -1. Setting the stage to an invalid stage value is useful in that it prevents backdrops
+ * and shadows from loading.
+ */
+export declare const CUSTOM_FLOOR_STAGE: LevelStage;
+
+/**
+ * We must use `StageType.WRATH_OF_THE_LAMB` instead of `StageType.ORIGINAL` or else the walls will
+ * not render properly. DeadInfinity suspects that this might be because it is trying to use the
+ * Dark Room's backdrop (instead of The Chest).
+ */
+export declare const CUSTOM_FLOOR_STAGE_TYPE = StageType.WRATH_OF_THE_LAMB;
+
 /**
  * An object that represents a possible boss for a custom stage. This can be for a vanilla boss or a
  * custom boss.
@@ -2798,7 +2811,8 @@ export declare function getCollidingEntitiesWithGridEntity(gridEntity: GridEntit
 export declare function getCombinedBossSet(stage: int): ReadonlySet<string> | undefined;
 
 /**
- * Helper function to get all of the crawl spaces in the room.
+ * Helper function to get all of the grid entities of type `GridEntityType.CRAWL_SPACE` (18) in the
+ * room.
  *
  * @param crawlSpaceVariant Optional. If specified, will only get the crawl spaces that match the
  *                          variant. Default is -1, which matches every variant.
@@ -5014,8 +5028,8 @@ export declare function getTransformationName(playerForm: PlayerForm): string;
 export declare function getTransformationsForCollectibleType(collectibleType: CollectibleType): Set<PlayerForm>;
 
 /**
- * Helper function to get all of the grid entities of type `GridEntityType.TRAPDOOR` in the room.
- * Specify a specific trapdoor variant to select only trapdoors of that variant.
+ * Helper function to get all of the grid entities of type `GridEntityType.TRAPDOOR` (17) in the
+ * room. Specify a specific trapdoor variant to select only trapdoors of that variant.
  */
 export declare function getTrapdoors(trapdoorVariant?: TrapdoorVariant): GridEntity[];
 
@@ -5478,8 +5492,6 @@ export declare function inSecretShop(): boolean;
  */
 export declare function inStartingRoom(): boolean;
 
-export declare const INVALID_STAGE_VALUE: LevelStage;
-
 /**
  * Helper function to return an array with the elements from start to end, inclusive. (The "i"
  * stands for inclusive.)
@@ -9099,6 +9111,19 @@ export declare function removeAllCoins(coinSubType?: CoinSubType, cap?: int): En
  */
 export declare function removeAllCollectibles(collectibleType?: CollectibleType, cap?: int): EntityPickupCollectible[];
 
+/**
+ * Helper function to remove all of the `GridEntityType.CRAWL_SPACE` (18) in the room.
+ *
+ * @param crawlSpaceVariant Optional. If specified, will only remove the crawl spaces that match
+ *                          this variant. Default is -1, which matches every variant.
+ * @param updateRoom Optional. Whether or not to update the room after the crawl spaces are removed.
+ *                   Default is false. For more information, see the description of the
+ *                   `removeGridEntities` helper function.
+ * @param cap Optional. If specified, will only remove the given amount of crawl spaces.
+ * @returns The crawl spaces that were removed.
+ */
+export declare function removeAllCrawlSpaces(crawlSpaceVariant?: CrawlSpaceVariant, updateRoom?: boolean, cap?: int): GridEntity[];
+
 /**
  * Helper function to remove all of the doors in the room. By default, it will remove every door.
  * You can optionally specify one or more room types to remove only the doors that match the
@@ -9412,6 +9437,19 @@ export declare function removeAllTears(tearVariant?: TearVariant, subType?: numb
  */
 export declare function removeAllTNT(variant?: number, updateRoom?: boolean, cap?: int): GridEntityTNT[];
 
+/**
+ * Helper function to remove all of the `GridEntityType.TRAPDOOR` (17) in the room.
+ *
+ * @param trapdoorVariant Optional. If specified, will only remove the trapdoors that match this
+ *                        variant. Default is -1, which matches every variant.
+ * @param updateRoom Optional. Whether or not to update the room after the trapdoors are removed.
+ *                   Default is false. For more information, see the description of the
+ *                   `removeGridEntities` helper function.
+ * @param cap Optional. If specified, will only remove the given amount of trapdoors.
+ * @returns The trapdoors that were removed.
+ */
+export declare function removeAllTrapdoors(trapdoorVariant?: TrapdoorVariant, updateRoom?: boolean, cap?: int): GridEntity[];
+
 /**
  * Helper function to remove all of the trinkets in the room.
  *
@@ -10761,6 +10799,12 @@ export declare function spawnCoinWithSeed(coinSubType: CoinSubType, position: Ve
  */
 export declare function spawnCollectible(collectibleType: CollectibleType, position: Vector, seedOrRNG?: Seed | RNG, options?: boolean, forceFreeItem?: boolean, spawner?: Entity): EntityPickupCollectible;
 
+/** Helper function to spawn a `GridEntityType.CRAWL_SPACE` (18). */
+export declare function spawnCrawlSpace(gridIndexOrPosition: int | Vector): GridEntity | undefined;
+
+/** Helper function to spawn a `GridEntityType.CRAWL_SPACE` (18) with a specific variant. */
+export declare function spawnCrawlSpaceWithVariant(crawlSpaceVariant: CrawlSpaceVariant, gridIndexOrPosition: int | Vector): GridEntity | undefined;
+
 /**
  * Helper function to spawn a custom door. This is intended to be called from the `POST_NEW_ROOM`
  * callback when the player enters a room that should have a custom door. (You could also call it
@@ -10870,10 +10914,10 @@ export declare function spawnCustomTrapdoor(gridIndexOrPosition: int | Vector, c
  */
 export declare function spawnCustomTrapdoorToVanilla(gridIndexOrPosition: int | Vector, stage?: LevelStage, stageType?: StageType, anm2Path?: string, spawnOpen?: boolean): GridEntity;
 
-/** Helper function to spawn a `GridEntityType.DOOR` (16). */
+/** Helper function to spawn a `GridEntityType.PIT` (7) with a specific variant. */
 export declare function spawnDoor(gridIndexOrPosition: int | Vector): GridEntityDoor | undefined;
 
-/** Helper function to spawn a `GridEntityType.DOOR` (16) with a specific variant. */
+/** Helper function to spawn a `GridEntityType.DOOR` (16). */
 export declare function spawnDoorWithVariant(doorVariant: DoorVariant, gridIndexOrPosition: int | Vector): GridEntityDoor | undefined;
 
 /** Helper function to spawn a `EntityType.EFFECT` (1000). */
@@ -11006,7 +11050,7 @@ export declare function spawnPill(pillColor: PillColor, position: Vector, veloci
  */
 export declare function spawnPillWithSeed(pillColor: PillColor, position: Vector, seedOrRNG: Seed | RNG, velocity?: Vector, spawner?: Entity | undefined): EntityPickupPill;
 
-/** Helper function to spawn a `GridEntityType.PIT` (7). */
+/** Helper function to spawn a `GridEntityType.DOOR` (16) with a specific variant. */
 export declare function spawnPit(gridIndexOrPosition: int | Vector): GridEntityPit | undefined;
 
 /** Helper function to spawn a `GridEntityType.PIT` (7) with a specific variant. */
@@ -11099,6 +11143,12 @@ export declare function spawnTNT(gridIndexOrPosition: int | Vector): GridEntityT
 /** Helper function to spawn a `GridEntityType.TNT` (12) with a specific variant. */
 export declare function spawnTNTWithVariant(variant: int, gridIndexOrPosition: int | Vector): GridEntityTNT | undefined;
 
+/** Helper function to spawn a `GridEntityType.TRAPDOOR` (17). */
+export declare function spawnTrapdoor(gridIndexOrPosition: int | Vector): GridEntity | undefined;
+
+/** Helper function to spawn a `GridEntityType.TRAPDOOR` (17) with a specific variant. */
+export declare function spawnTrapdoorWithVariant(trapdoorVariant: TrapdoorVariant, gridIndexOrPosition: int | Vector): GridEntity | undefined;
+
 /**
  * Helper function to spawn a `EntityType.PICKUP` (5) with variant `PickupVariant.TRINKET` (350).
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "8.8.1",
+  "version": "8.9.1",
   "description": "Helper functions and features for IsaacScript mods.",
   "keywords": [
     "isaac",
@@ -22,6 +22,6 @@
   "main": "dist/index",
   "types": "dist/index.d.ts",
   "dependencies": {
-    "isaac-typescript-definitions": "^3.6.1"
+    "isaac-typescript-definitions": "^3.6.3"
   }
 }

package/src/features/customStage/exports.ts

@@ -36,7 +36,18 @@ import v, { customStageCachedRoomData, customStagesMap } from "./v";
 export const DEFAULT_BASE_STAGE = LevelStage.BASEMENT_2;
 export const DEFAULT_BASE_STAGE_TYPE = StageType.ORIGINAL;
 
-export const INVALID_STAGE_VALUE = -1 as LevelStage;
+/**
+ * Equal to -1. Setting the stage to an invalid stage value is useful in that it prevents backdrops
+ * and shadows from loading.
+ */
+export const CUSTOM_FLOOR_STAGE = -1 as LevelStage;
+
+/**
+ * We must use `StageType.WRATH_OF_THE_LAMB` instead of `StageType.ORIGINAL` or else the walls will
+ * not render properly. DeadInfinity suspects that this might be because it is trying to use the
+ * Dark Room's backdrop (instead of The Chest).
+ */
+export const CUSTOM_FLOOR_STAGE_TYPE = StageType.WRATH_OF_THE_LAMB;
 
 /**
  * Helper function to warp to a custom stage/level.
@@ -74,7 +85,7 @@ export function setCustomStage(
 
   // Before changing the stage, we have to revert the bugged stage, if necessary. This prevents the
   // bug where the backdrop will not spawn.
-  if (stage === INVALID_STAGE_VALUE) {
+  if (stage === CUSTOM_FLOOR_STAGE) {
     level.SetStage(LevelStage.BASEMENT_1, StageType.ORIGINAL);
   }
 
@@ -98,11 +109,8 @@ export function setCustomStage(
   setStageRoomsData(customStage, rng, verbose);
 
   // Set the stage to an invalid value, which will prevent the walls and floors from loading.
-  // Furthermore, we must use `StageType.WRATH_OF_THE_LAMB` instead of `StageType.ORIGINAL` or else
-  // the walls will not render properly. DeadInfinity suspects that this might be because it is
-  // trying to use the Dark Room's backdrop (instead of The Chest).
-  const targetStage = INVALID_STAGE_VALUE;
-  const targetStageType = StageType.WRATH_OF_THE_LAMB;
+  const targetStage = CUSTOM_FLOOR_STAGE;
+  const targetStageType = CUSTOM_FLOOR_STAGE_TYPE;
   level.SetStage(targetStage, targetStageType);
   reorderedCallbacksSetStageInternal(targetStage, targetStageType);
 

package/src/features/customStage/versusScreen.ts

@@ -4,7 +4,6 @@ import {
   RoomType,
   SoundEffect,
   StageID,
-  StageType,
 } from "isaac-typescript-definitions";
 import { game, sfxManager } from "../../core/cachedClasses";
 import { arrayRemove } from "../../functions/array";
@@ -27,9 +26,10 @@ import {
   ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH,
 } from "./customStageConstants";
 import {
+  CUSTOM_FLOOR_STAGE,
+  CUSTOM_FLOOR_STAGE_TYPE,
   DEFAULT_BASE_STAGE,
   DEFAULT_BASE_STAGE_TYPE,
-  INVALID_STAGE_VALUE,
 } from "./exports";
 import v from "./v";
 
@@ -132,7 +132,7 @@ export function playVersusScreenAnimation(customStage: CustomStage): void {
     level.SetStage(DEFAULT_BASE_STAGE, DEFAULT_BASE_STAGE_TYPE);
     runNextGameFrame(() => {
       const futureLevel = game.GetLevel();
-      futureLevel.SetStage(INVALID_STAGE_VALUE, StageType.ORIGINAL);
+      futureLevel.SetStage(CUSTOM_FLOOR_STAGE, CUSTOM_FLOOR_STAGE_TYPE);
     });
     return;
   }

package/src/functions/gridEntities.ts

@@ -1,5 +1,4 @@
 import {
-  CrawlSpaceVariant,
   EffectVariant,
   GridCollisionClass,
   GridEntityType,
@@ -130,22 +129,6 @@ export function getCollidingEntitiesWithGridEntity(
   );
 }
 
-/**
- * Helper function to get all of the crawl spaces in the room.
- *
- * @param crawlSpaceVariant Optional. If specified, will only get the crawl spaces that match the
- *                          variant. Default is -1, which matches every variant.
- */
-export function getCrawlSpaces(
-  crawlSpaceVariant: CrawlSpaceVariant = -1,
-): GridEntity[] {
-  if (asNumber(crawlSpaceVariant) === -1) {
-    return getGridEntities(GridEntityType.CRAWL_SPACE);
-  }
-
-  return getMatchingGridEntities(GridEntityType.CRAWL_SPACE, crawlSpaceVariant);
-}
-
 /**
  * Helper function to get every grid entity in the current room.
  *
@@ -329,18 +312,6 @@ export function getTopLeftWallGridIndex(): int {
     : topLeftWallGridIndex;
 }
 
-/**
- * Helper function to get all of the grid entities of type `GridEntityType.TRAPDOOR` in the room.
- * Specify a specific trapdoor variant to select only trapdoors of that variant.
- */
-export function getTrapdoors(trapdoorVariant?: TrapdoorVariant): GridEntity[] {
-  if (trapdoorVariant === undefined) {
-    return getGridEntities(GridEntityType.TRAPDOOR);
-  }
-
-  return getMatchingGridEntities(GridEntityType.TRAPDOOR, trapdoorVariant);
-}
-
 /**
  * Helper function to see if the provided gridEntity is in its respective broken state. See the
  * `GRID_ENTITY_TYPE_TO_BROKEN_STATE_MAP` constant for more details.

package/src/functions/gridEntitiesSpecific.ts

@@ -1,18 +1,38 @@
 import {
+  CrawlSpaceVariant,
   DoorVariant,
   GridEntityType,
   PitVariant,
   PoopGridEntityVariant,
   PressurePlateVariant,
   RockVariant,
+  TrapdoorVariant,
 } from "isaac-typescript-definitions";
 import {
   getGridEntities,
+  getMatchingGridEntities,
   removeGridEntities,
   spawnGridEntityWithVariant,
 } from "./gridEntities";
 import { asNumber } from "./types";
 
+/**
+ * Helper function to get all of the grid entities of type `GridEntityType.CRAWL_SPACE` (18) in the
+ * room.
+ *
+ * @param crawlSpaceVariant Optional. If specified, will only get the crawl spaces that match the
+ *                          variant. Default is -1, which matches every variant.
+ */
+export function getCrawlSpaces(
+  crawlSpaceVariant: CrawlSpaceVariant = -1,
+): GridEntity[] {
+  if (asNumber(crawlSpaceVariant) === -1) {
+    return getGridEntities(GridEntityType.CRAWL_SPACE);
+  }
+
+  return getMatchingGridEntities(GridEntityType.CRAWL_SPACE, crawlSpaceVariant);
+}
+
 // The `getDoors` function is not located here because doors are collected via the `Room.GetDoor`
 // method instead, which is faster.
 
@@ -153,6 +173,38 @@ export function getTNT(variant = -1): GridEntityTNT[] {
   return tntArray;
 }
 
+/**
+ * Helper function to get all of the grid entities of type `GridEntityType.TRAPDOOR` (17) in the
+ * room. Specify a specific trapdoor variant to select only trapdoors of that variant.
+ */
+export function getTrapdoors(trapdoorVariant?: TrapdoorVariant): GridEntity[] {
+  if (trapdoorVariant === undefined) {
+    return getGridEntities(GridEntityType.TRAPDOOR);
+  }
+
+  return getMatchingGridEntities(GridEntityType.TRAPDOOR, trapdoorVariant);
+}
+
+/**
+ * Helper function to remove all of the `GridEntityType.CRAWL_SPACE` (18) in the room.
+ *
+ * @param crawlSpaceVariant Optional. If specified, will only remove the crawl spaces that match
+ *                          this variant. Default is -1, which matches every variant.
+ * @param updateRoom Optional. Whether or not to update the room after the crawl spaces are removed.
+ *                   Default is false. For more information, see the description of the
+ *                   `removeGridEntities` helper function.
+ * @param cap Optional. If specified, will only remove the given amount of crawl spaces.
+ * @returns The crawl spaces that were removed.
+ */
+export function removeAllCrawlSpaces(
+  crawlSpaceVariant: CrawlSpaceVariant = -1,
+  updateRoom = false,
+  cap?: int,
+): GridEntity[] {
+  const crawlSpaces = getCrawlSpaces(crawlSpaceVariant);
+  return removeGridEntities(crawlSpaces, updateRoom, cap);
+}
+
 // The `removeAllDoors` function is not located here because doors are removed via the
 // `Room.RemoveDoor` method instead.
 
@@ -281,14 +333,56 @@ export function removeAllTNT(
   return removeGridEntities(tnt, updateRoom, cap);
 }
 
-/** Helper function to spawn a `GridEntityType.DOOR` (16). */
+/**
+ * Helper function to remove all of the `GridEntityType.TRAPDOOR` (17) in the room.
+ *
+ * @param trapdoorVariant Optional. If specified, will only remove the trapdoors that match this
+ *                        variant. Default is -1, which matches every variant.
+ * @param updateRoom Optional. Whether or not to update the room after the trapdoors are removed.
+ *                   Default is false. For more information, see the description of the
+ *                   `removeGridEntities` helper function.
+ * @param cap Optional. If specified, will only remove the given amount of trapdoors.
+ * @returns The trapdoors that were removed.
+ */
+export function removeAllTrapdoors(
+  trapdoorVariant: TrapdoorVariant = -1,
+  updateRoom = false,
+  cap?: int,
+): GridEntity[] {
+  const trapdoors = getTrapdoors(trapdoorVariant);
+  return removeGridEntities(trapdoors, updateRoom, cap);
+}
+
+/** Helper function to spawn a `GridEntityType.CRAWL_SPACE` (18). */
+export function spawnCrawlSpace(
+  gridIndexOrPosition: int | Vector,
+): GridEntity | undefined {
+  return spawnCrawlSpaceWithVariant(
+    CrawlSpaceVariant.NORMAL,
+    gridIndexOrPosition,
+  );
+}
+
+/** Helper function to spawn a `GridEntityType.CRAWL_SPACE` (18) with a specific variant. */
+export function spawnCrawlSpaceWithVariant(
+  crawlSpaceVariant: CrawlSpaceVariant,
+  gridIndexOrPosition: int | Vector,
+): GridEntity | undefined {
+  return spawnGridEntityWithVariant(
+    GridEntityType.CRAWL_SPACE,
+    crawlSpaceVariant,
+    gridIndexOrPosition,
+  );
+}
+
+/** Helper function to spawn a `GridEntityType.PIT` (7) with a specific variant. */
 export function spawnDoor(
   gridIndexOrPosition: int | Vector,
 ): GridEntityDoor | undefined {
   return spawnDoorWithVariant(DoorVariant.UNSPECIFIED, gridIndexOrPosition);
 }
 
-/** Helper function to spawn a `GridEntityType.DOOR` (16) with a specific variant. */
+/** Helper function to spawn a `GridEntityType.DOOR` (16). */
 export function spawnDoorWithVariant(
   doorVariant: DoorVariant,
   gridIndexOrPosition: int | Vector,
@@ -310,7 +404,7 @@ export function spawnDoorWithVariant(
   return door;
 }
 
-/** Helper function to spawn a `GridEntityType.PIT` (7). */
+/** Helper function to spawn a `GridEntityType.DOOR` (16) with a specific variant. */
 export function spawnPit(
   gridIndexOrPosition: int | Vector,
 ): GridEntityPit | undefined {
@@ -489,3 +583,25 @@ export function spawnTNTWithVariant(
 
   return tnt;
 }
+
+/** Helper function to spawn a `GridEntityType.TRAPDOOR` (17). */
+export function spawnTrapdoor(
+  gridIndexOrPosition: int | Vector,
+): GridEntity | undefined {
+  return spawnCrawlSpaceWithVariant(
+    CrawlSpaceVariant.NORMAL,
+    gridIndexOrPosition,
+  );
+}
+
+/** Helper function to spawn a `GridEntityType.TRAPDOOR` (17) with a specific variant. */
+export function spawnTrapdoorWithVariant(
+  trapdoorVariant: TrapdoorVariant,
+  gridIndexOrPosition: int | Vector,
+): GridEntity | undefined {
+  return spawnGridEntityWithVariant(
+    GridEntityType.TRAPDOOR,
+    trapdoorVariant,
+    gridIndexOrPosition,
+  );
+}