isaacscript-common 33.3.1 → 33.4.1

package/dist/index.rollup.d.ts

@@ -1669,8 +1669,8 @@ export declare function convertDecimalToBinary(number: number, minLength?: int):
 
 /**
  * Helper function to convert the grid entity type found in a room XML file to the corresponding
- * grid entity type and variant normally used by the game. For example, a rock is represented as
- * 1000.0 in a room XML file, but `GridEntityType.ROCK` is equal to 2.
+ * grid entity type and variant normally used by the game. For example, `GridEntityXMLType.ROCK` is
+ * 1000 (in a room XML file), but `GridEntityType.ROCK` is equal to 2 (in-game).
  */
 export declare function convertXMLGridEntityType(gridEntityXMLType: GridEntityXMLType, gridEntityXMLVariant: int): [GridEntityType, int] | undefined;
 
@@ -3739,7 +3739,7 @@ export declare function doesEntityExist(entityType?: EntityType | -1, variant?:
 
 /**
  * Helper function to check if one or more of a specific kind of grid entity is present in the
- * current room. It uses the `countEntities` helper function to determine this.
+ * current room.
  *
  * @param gridEntityType The grid entity type to match.
  * @param variant Optional. Default is -1, which matches every variant.
@@ -4144,7 +4144,19 @@ export declare type Expand<T> = T extends infer O ? {
     [K in keyof O]: O[K];
 } : never;
 
+/**
+ * When you enable this feature, many custom commands will be added to the in-game console. See the
+ * [dedicated command list](ExtraConsoleCommandsList) for more information about them.
+ *
+ * Note that in order to avoid conflicts, if two or more mods enable this feature, then the first
+ * loaded one will control all of the command logic. When this occurs, a global variable of
+ * `__ISAACSCRIPT_COMMON_EXTRA_CONSOLE_COMMANDS_FEATURE` will be created and will automatically be
+ * used by the non-main instances. For this reason, if you use multiple mods with
+ * `isaacscript-common` and a custom command from the standard library is not working properly, then
+ * you might need to get another mod author to update their version of `isaacscript-common`.
+ */
 declare class ExtraConsoleCommands extends Feature {
+    private readonly isMainFeature;
     private readonly commandFunctionMap;
     private readonly postUpdate;
     private readonly evaluateCacheDamage;
@@ -4158,10 +4170,12 @@ declare class ExtraConsoleCommands extends Feature {
     /**
      * Helper function to add a custom console command.
      *
-     * The standard library comes with many existing console commands that are useful for debugging,
-     * but you can also add your own commands that are useful for your particular mod. It's easier to
-     * add commands to the existing command system than to add your own logic manually to the
-     * `EXECUTE_CMD` callback.
+     * The standard library comes with [many existing console commands](ExtraConsoleCommandsList) that
+     * are useful for debugging, but you can also add your own commands that are useful for your
+     * particular mod. It's easier to add commands to the existing command system than to add your own
+     * logic manually to the `EXECUTE_CMD` callback.
+     *
+     * This function is intended to be called when your mod is first loading.
      *
      * In order to use this function, you must upgrade your mod with
      * `ISCFeature.EXTRA_CONSOLE_COMMANDS`.
@@ -4170,8 +4184,10 @@ declare class ExtraConsoleCommands extends Feature {
     /**
      * Helper function to remove a custom console command.
      *
-     * The standard library comes with many existing console commands that are useful for debugging.
-     * If you want to disable one of them, use this function.
+     * The standard library comes with [many existing console commands](ExtraConsoleCommandsList) that
+     * are useful for debugging. If you want to disable one of them, use this function.
+     *
+     * This function is intended to be called when your mod is first loading.
      *
      * In order to use this function, you must upgrade your mod with
      * `ISCFeature.EXTRA_CONSOLE_COMMANDS`.
@@ -5454,7 +5470,10 @@ export declare function getGridEntitiesInRadius(targetPosition: Vector, radius:
 export declare function getGridEntitiesMap(...gridEntityTypes: GridEntityType[]): Map<int, GridEntity>;
 
 /** Helper function to get the top left and bottom right corners of a given grid entity. */
-export declare function getGridEntityCollisionPoints(gridEntity: GridEntity): [topLeft: Vector, bottomRight: Vector];
+export declare function getGridEntityCollisionPoints(gridEntity: GridEntity): {
+    topLeft: Vector;
+    bottomRight: Vector;
+};
 
 /** Helper function to get a string containing the grid entity's type and variant. */
 export declare function getGridEntityID(gridEntity: GridEntity): GridEntityID;
@@ -7030,6 +7049,12 @@ export declare function getStringsFromTable(luaMap: LuaMap<string, unknown>, obj
  */
 export declare function getSubPlayerParent(subPlayer: EntitySubPlayer): EntityPlayer | undefined;
 
+/**
+ * Helper function to get the grid entities on the surrounding tiles from the provided grid entity.
+ *
+ * For example, if a rock was surrounded by rocks on all sides, this would return an array of 8
+ * rocks (e.g. top-left + top + top-right + left + right + bottom-left + bottom + right).
+ */
 export declare function getSurroundingGridEntities(gridEntity: GridEntity): GridEntity[];
 
 /**
@@ -7103,11 +7128,18 @@ export declare function getTime(useSocketIfAvailable?: boolean): float;
 /** Helper function to get all of the `GridEntityTNT` in the room. */
 export declare function getTNT(variant?: number): GridEntityTNT[];
 
+/**
+ * Helper function to get the top left wall in the current room.
+ *
+ * This function can be useful in certain situations to determine if the room is currently loaded.
+ */
 export declare function getTopLeftWall(): GridEntity | undefined;
 
 /**
  * Helper function to get the grid index of the top left wall. (This will depend on what the current
  * room shape is.)
+ *
+ * This function can be useful in certain situations to determine if the room is currently loaded.
  */
 export declare function getTopLeftWallGridIndex(): int;
 
@@ -7892,6 +7924,8 @@ export declare function isAliveExceptionNPC(npc: EntityNPC): boolean;
  * order for the room to be cleared. This function ignores other types of pressure plates, such as
  * the ones that you press to get a reward, the ones that you press to start a Greed Mode wave, and
  * so on.
+ *
+ * Returns true if there are no pressure plates in the room.
  */
 export declare function isAllPressurePlatesPushed(): boolean;
 
@@ -8415,18 +8449,19 @@ export declare function isGreedMode(): boolean;
 export declare function isGridEntity(variable: unknown): variable is 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.
+ * Helper function to detect if a particular grid entity would "break" if it was touched by an
+ * explosion.
  *
- * Note that in the case of `GridEntityType.LOCK` (11), the state will turn to being broken before
- * the actual collision for the entity is removed.
+ * For example, rocks and pots are breakable by explosions, but blocks are not.
  */
 export declare function isGridEntityBreakableByExplosion(gridEntity: GridEntity): boolean;
 
 /**
- * Helper function to detect whether a given Void Portal is one that randomly spawns after a boss is
- * defeated or is one that naturally spawns in the room after Hush. (This is determined by looking
- * at the VarData of the entity.)
+ * Helper function to see if the provided grid entity is in its respective broken state. See the
+ * `GRID_ENTITY_TYPE_TO_BROKEN_STATE_MAP` constant for more details.
+ *
+ * Note that in the case of `GridEntityType.LOCK` (11), the state will turn to being broken before
+ * the actual collision for the entity is removed.
  */
 export declare function isGridEntityBroken(gridEntity: GridEntity): boolean;
 
@@ -8641,8 +8676,9 @@ export declare function isPoopGridEntityType(gridEntityXMLType: GridEntityXMLTyp
 export declare function isPoopPickup(pickup: EntityPickup): pickup is EntityPickupPoop;
 
 /**
- * Helper function to determine if all of the pressure plates in the current room are pushed.
- * Returns true if there are no pressure plates in the room.
+ * Helper function to detect whether a given Void Portal is one that randomly spawns after a boss is
+ * defeated or is one that naturally spawns in the room after Hush. (This is determined by looking
+ * at the `VarData` of the entity.)
  */
 export declare function isPostBossVoidPortal(gridEntity: GridEntity): boolean;
 
@@ -16170,6 +16206,9 @@ export declare function setTrinketSprite(trinket: EntityPickup, pngPath: string
  *
  * This is useful to revert the behavior where playing on a set and restarting the game will not
  * take you to a new seed.
+ *
+ * Under the hood, this function calls the `Seeds.Reset` method and the
+ * `Seeds.Restart(Challenge.NULL)` method.
  */
 export declare function setUnseeded(): void;
 

package/dist/isaacscript-common.lua

@@ -1,6 +1,6 @@
 --[[
 
-isaacscript-common 33.3.1
+isaacscript-common 33.4.1
 
 This is the "isaacscript-common" library, which was created with the IsaacScript tool.
 
@@ -27996,7 +27996,7 @@ end
 function ____exports.getGridEntityCollisionPoints(self, gridEntity)
     local topLeft = Vector(gridEntity.Position.X - DISTANCE_OF_GRID_TILE / 2, gridEntity.Position.Y - DISTANCE_OF_GRID_TILE / 2)
     local bottomRight = Vector(gridEntity.Position.X + DISTANCE_OF_GRID_TILE / 2, gridEntity.Position.Y + DISTANCE_OF_GRID_TILE / 2)
-    return {topLeft, bottomRight}
+    return {topLeft = topLeft, bottomRight = bottomRight}
 end
 function ____exports.getTopLeftWallGridIndex(self)
     local room = game:GetRoom()
@@ -28006,13 +28006,13 @@ function ____exports.getTopLeftWallGridIndex(self)
 end
 function ____exports.removeGridEntity(self, gridEntityOrGridIndex, updateRoom)
     local room = game:GetRoom()
-    local ____isNumber_result_0
+    local ____isNumber_result_2
     if isNumber(nil, gridEntityOrGridIndex) then
-        ____isNumber_result_0 = room:GetGridEntity(gridEntityOrGridIndex)
+        ____isNumber_result_2 = room:GetGridEntity(gridEntityOrGridIndex)
     else
-        ____isNumber_result_0 = gridEntityOrGridIndex
+        ____isNumber_result_2 = gridEntityOrGridIndex
     end
-    local gridEntity = ____isNumber_result_0
+    local gridEntity = ____isNumber_result_2
     if gridEntity == nil then
         return
     end
@@ -28036,13 +28036,13 @@ function ____exports.removeGridEntity(self, gridEntityOrGridIndex, updateRoom)
 end
 function ____exports.spawnGridEntityWithVariant(self, gridEntityType, variant, gridIndexOrPosition)
     local room = game:GetRoom()
-    local ____isVector_result_1
+    local ____isVector_result_3
     if isVector(nil, gridIndexOrPosition) then
-        ____isVector_result_1 = room:GetGridEntityFromPos(gridIndexOrPosition)
+        ____isVector_result_3 = room:GetGridEntityFromPos(gridIndexOrPosition)
     else
-        ____isVector_result_1 = room:GetGridEntity(gridIndexOrPosition)
+        ____isVector_result_3 = room:GetGridEntity(gridIndexOrPosition)
     end
-    local existingGridEntity = ____isVector_result_1
+    local existingGridEntity = ____isVector_result_3
     if existingGridEntity ~= nil then
         ____exports.removeGridEntity(nil, existingGridEntity, true)
     end
@@ -28112,7 +28112,9 @@ function ____exports.doesGridEntityExist(self, gridEntityType, variant)
     )
 end
 function ____exports.getCollidingEntitiesWithGridEntity(self, gridEntity)
-    local topLeft, bottomRight = table.unpack(____exports.getGridEntityCollisionPoints(nil, gridEntity))
+    local ____exports_getGridEntityCollisionPoints_result_0 = ____exports.getGridEntityCollisionPoints(nil, gridEntity)
+    local topLeft = ____exports_getGridEntityCollisionPoints_result_0.topLeft
+    local bottomRight = ____exports_getGridEntityCollisionPoints_result_0.bottomRight
     local closeEntities = Isaac.FindInRadius(gridEntity.Position, DISTANCE_OF_GRID_TILE * 2)
     return __TS__ArrayFilter(
         closeEntities,
@@ -28195,7 +28197,9 @@ function ____exports.getGridEntitiesInRadius(self, targetPosition, radius)
                     goto __continue24
                 end
                 registeredGridIndexes:add(gridIndex)
-                local topLeft, bottomRight = table.unpack(____exports.getGridEntityCollisionPoints(nil, gridEntity))
+                local ____exports_getGridEntityCollisionPoints_result_1 = ____exports.getGridEntityCollisionPoints(nil, gridEntity)
+                local topLeft = ____exports_getGridEntityCollisionPoints_result_1.topLeft
+                local bottomRight = ____exports_getGridEntityCollisionPoints_result_1.bottomRight
                 if isCircleIntersectingRectangle(
                     nil,
                     targetPosition,
@@ -50598,6 +50602,8 @@ local addFlag = ____flag.addFlag
 local bitFlags = ____flag.bitFlags
 local ____map = require("src.functions.map")
 local getMapPartialMatch = ____map.getMapPartialMatch
+local ____utils = require("src.functions.utils")
+local assertDefined = ____utils.assertDefined
 local ____Feature = require("src.classes.private.Feature")
 local Feature = ____Feature.Feature
 local commands = require("src.classes.features.other.extraConsoleCommands.commands")
@@ -50694,6 +50700,11 @@ function ExtraConsoleCommands.prototype.____constructor(self)
         end
         return nil
     end
+    self.isMainFeature = __ISAACSCRIPT_COMMON_EXTRA_CONSOLE_COMMANDS_FEATURE == nil
+    if not self.isMainFeature then
+        return
+    end
+    __ISAACSCRIPT_COMMON_EXTRA_CONSOLE_COMMANDS_FEATURE = self
     self.callbacksUsed = {
         {ModCallback.POST_UPDATE, self.postUpdate},
         {ModCallback.EVALUATE_CACHE, self.evaluateCacheDamage, {CacheFlag.DAMAGE}},
@@ -50712,6 +50723,11 @@ function ExtraConsoleCommands.prototype.____constructor(self)
     end
 end
 function ExtraConsoleCommands.prototype.addConsoleCommand(self, commandName, commandFunction)
+    if not self.isMainFeature then
+        assertDefined(nil, __ISAACSCRIPT_COMMON_EXTRA_CONSOLE_COMMANDS_FEATURE, "Failed to find the non-main isaacscript-common extra console commands feature in the global variable.")
+        __ISAACSCRIPT_COMMON_EXTRA_CONSOLE_COMMANDS_FEATURE:addConsoleCommand(commandName, commandFunction)
+        return
+    end
     if isVanillaConsoleCommand(nil, commandName) then
         error(("Failed to add a new console command of \"" .. commandName) .. "\" because that name already belongs to a vanilla command. You must pick a non-colliding name.")
     end
@@ -50722,8 +50738,13 @@ function ExtraConsoleCommands.prototype.addConsoleCommand(self, commandName, com
 end
 __TS__DecorateLegacy({Exported}, ExtraConsoleCommands.prototype, "addConsoleCommand", true)
 function ExtraConsoleCommands.prototype.removeConsoleCommand(self, commandName)
+    if not self.isMainFeature then
+        assertDefined(nil, __ISAACSCRIPT_COMMON_EXTRA_CONSOLE_COMMANDS_FEATURE, "Failed to find the non-main isaacscript-common extra console commands feature in the global variable.")
+        __ISAACSCRIPT_COMMON_EXTRA_CONSOLE_COMMANDS_FEATURE:removeConsoleCommand(commandName)
+        return
+    end
     if not self.commandFunctionMap:has(commandName) then
-        error(("Failed to remove the console command of \"" .. commandName) .. "\", since it does not already exist in the map.")
+        error(("Failed to remove the console command of \"" .. commandName) .. "\", since it does not already exist in the command map.")
     end
     self.commandFunctionMap:delete(commandName)
 end

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

@@ -1,5 +1,17 @@
 import { Feature } from "../../private/Feature";
+/**
+ * When you enable this feature, many custom commands will be added to the in-game console. See the
+ * [dedicated command list](ExtraConsoleCommandsList) for more information about them.
+ *
+ * Note that in order to avoid conflicts, if two or more mods enable this feature, then the first
+ * loaded one will control all of the command logic. When this occurs, a global variable of
+ * `__ISAACSCRIPT_COMMON_EXTRA_CONSOLE_COMMANDS_FEATURE` will be created and will automatically be
+ * used by the non-main instances. For this reason, if you use multiple mods with
+ * `isaacscript-common` and a custom command from the standard library is not working properly, then
+ * you might need to get another mod author to update their version of `isaacscript-common`.
+ */
 export declare class ExtraConsoleCommands extends Feature {
+    private readonly isMainFeature;
     private readonly commandFunctionMap;
     private readonly postUpdate;
     private readonly evaluateCacheDamage;
@@ -13,10 +25,12 @@ export declare class ExtraConsoleCommands extends Feature {
     /**
      * Helper function to add a custom console command.
      *
-     * The standard library comes with many existing console commands that are useful for debugging,
-     * but you can also add your own commands that are useful for your particular mod. It's easier to
-     * add commands to the existing command system than to add your own logic manually to the
-     * `EXECUTE_CMD` callback.
+     * The standard library comes with [many existing console commands](ExtraConsoleCommandsList) that
+     * are useful for debugging, but you can also add your own commands that are useful for your
+     * particular mod. It's easier to add commands to the existing command system than to add your own
+     * logic manually to the `EXECUTE_CMD` callback.
+     *
+     * This function is intended to be called when your mod is first loading.
      *
      * In order to use this function, you must upgrade your mod with
      * `ISCFeature.EXTRA_CONSOLE_COMMANDS`.
@@ -25,8 +39,10 @@ export declare class ExtraConsoleCommands extends Feature {
     /**
      * Helper function to remove a custom console command.
      *
-     * The standard library comes with many existing console commands that are useful for debugging.
-     * If you want to disable one of them, use this function.
+     * The standard library comes with [many existing console commands](ExtraConsoleCommandsList) that
+     * are useful for debugging. If you want to disable one of them, use this function.
+     *
+     * This function is intended to be called when your mod is first loading.
      *
      * In order to use this function, you must upgrade your mod with
      * `ISCFeature.EXTRA_CONSOLE_COMMANDS`.

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

@@ -1 +1 @@
-{"version":3,"file":"ExtraConsoleCommands.d.ts","sourceRoot":"","sources":["../../../../../src/classes/features/other/ExtraConsoleCommands.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAIhD,qBAAa,oBAAqB,SAAQ,OAAO;IAI/C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAG/B;IA0DJ,OAAO,CAAC,QAAQ,CAAC,UAAU,CAKzB;IAIF,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAIlC;IAIF,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAIrC;IAIF,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAIjC;IAIF,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAIlC;IAGF,OAAO,CAAC,QAAQ,CAAC,aAAa,CAkD5B;IAGF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAWzB;IAGF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAI3B;IAGF,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAYlC;IAEF;;;;;;;;;;OAUG;IAEI,iBAAiB,CACtB,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GACxC,IAAI;IAgBP;;;;;;;;OAQG;IAEI,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;CASvD"}
+{"version":3,"file":"ExtraConsoleCommands.d.ts","sourceRoot":"","sources":["../../../../../src/classes/features/other/ExtraConsoleCommands.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAShD;;;;;;;;;;GAUG;AACH,qBAAa,oBAAqB,SAAQ,OAAO;IAI/C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;IAExC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAG/B;IAoEJ,OAAO,CAAC,QAAQ,CAAC,UAAU,CAKzB;IAIF,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAIlC;IAIF,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAIrC;IAIF,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAIjC;IAIF,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAIlC;IAGF,OAAO,CAAC,QAAQ,CAAC,aAAa,CAkD5B;IAGF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAWzB;IAGF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAI3B;IAGF,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAYlC;IAEF;;;;;;;;;;;;OAYG;IAEI,iBAAiB,CACtB,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GACxC,IAAI;IA4BP;;;;;;;;;;OAUG;IAEI,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;CAoBvD"}

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

@@ -23,11 +23,22 @@ local addFlag = ____flag.addFlag
 local bitFlags = ____flag.bitFlags
 local ____map = require("src.functions.map")
 local getMapPartialMatch = ____map.getMapPartialMatch
+local ____utils = require("src.functions.utils")
+local assertDefined = ____utils.assertDefined
 local ____Feature = require("src.classes.private.Feature")
 local Feature = ____Feature.Feature
 local commands = require("src.classes.features.other.extraConsoleCommands.commands")
 local ____v = require("src.classes.features.other.extraConsoleCommands.v")
 local v = ____v.v
+--- When you enable this feature, many custom commands will be added to the in-game console. See the
+-- [dedicated command list](ExtraConsoleCommandsList) for more information about them.
+-- 
+-- Note that in order to avoid conflicts, if two or more mods enable this feature, then the first
+-- loaded one will control all of the command logic. When this occurs, a global variable of
+-- `__ISAACSCRIPT_COMMON_EXTRA_CONSOLE_COMMANDS_FEATURE` will be created and will automatically be
+-- used by the non-main instances. For this reason, if you use multiple mods with
+-- `isaacscript-common` and a custom command from the standard library is not working properly, then
+-- you might need to get another mod author to update their version of `isaacscript-common`.
 ____exports.ExtraConsoleCommands = __TS__Class()
 local ExtraConsoleCommands = ____exports.ExtraConsoleCommands
 ExtraConsoleCommands.name = "ExtraConsoleCommands"
@@ -119,6 +130,11 @@ function ExtraConsoleCommands.prototype.____constructor(self)
         end
         return nil
     end
+    self.isMainFeature = __ISAACSCRIPT_COMMON_EXTRA_CONSOLE_COMMANDS_FEATURE == nil
+    if not self.isMainFeature then
+        return
+    end
+    __ISAACSCRIPT_COMMON_EXTRA_CONSOLE_COMMANDS_FEATURE = self
     self.callbacksUsed = {
         {ModCallback.POST_UPDATE, self.postUpdate},
         {ModCallback.EVALUATE_CACHE, self.evaluateCacheDamage, {CacheFlag.DAMAGE}},
@@ -137,6 +153,11 @@ function ExtraConsoleCommands.prototype.____constructor(self)
     end
 end
 function ExtraConsoleCommands.prototype.addConsoleCommand(self, commandName, commandFunction)
+    if not self.isMainFeature then
+        assertDefined(nil, __ISAACSCRIPT_COMMON_EXTRA_CONSOLE_COMMANDS_FEATURE, "Failed to find the non-main isaacscript-common extra console commands feature in the global variable.")
+        __ISAACSCRIPT_COMMON_EXTRA_CONSOLE_COMMANDS_FEATURE:addConsoleCommand(commandName, commandFunction)
+        return
+    end
     if isVanillaConsoleCommand(nil, commandName) then
         error(("Failed to add a new console command of \"" .. commandName) .. "\" because that name already belongs to a vanilla command. You must pick a non-colliding name.")
     end
@@ -147,8 +168,13 @@ function ExtraConsoleCommands.prototype.addConsoleCommand(self, commandName, com
 end
 __TS__DecorateLegacy({Exported}, ExtraConsoleCommands.prototype, "addConsoleCommand", true)
 function ExtraConsoleCommands.prototype.removeConsoleCommand(self, commandName)
+    if not self.isMainFeature then
+        assertDefined(nil, __ISAACSCRIPT_COMMON_EXTRA_CONSOLE_COMMANDS_FEATURE, "Failed to find the non-main isaacscript-common extra console commands feature in the global variable.")
+        __ISAACSCRIPT_COMMON_EXTRA_CONSOLE_COMMANDS_FEATURE:removeConsoleCommand(commandName)
+        return
+    end
     if not self.commandFunctionMap:has(commandName) then
-        error(("Failed to remove the console command of \"" .. commandName) .. "\", since it does not already exist in the map.")
+        error(("Failed to remove the console command of \"" .. commandName) .. "\", since it does not already exist in the command map.")
     end
     self.commandFunctionMap:delete(commandName)
 end

package/dist/src/classes/features/other/extraConsoleCommands/commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../../../../src/classes/features/other/extraConsoleCommands/commands.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../../../../src/classes/features/other/extraConsoleCommands/commands.ts"],"names":[],"mappings":"AAkJA;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CA2C/C;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,IAAI,CAEhC;AAED,gEAAgE;AAChE,wBAAgB,MAAM,IAAI,IAAI,CAK7B;AAED,sEAAsE;AACtE,wBAAgB,OAAO,IAAI,IAAI,CAkB9B;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEhD;AAED,+CAA+C;AAC/C,wBAAgB,WAAW,IAAI,IAAI,CAElC;AAED,4CAA4C;AAC5C,wBAAgB,KAAK,IAAI,IAAI,CAG5B;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAcjD;AAED,2CAA2C;AAC3C,wBAAgB,EAAE,IAAI,IAAI,CAEzB;AAED;;;GAGG;AACH,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAczC;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAc1C;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAE/C;AAED,wCAAwC;AACxC,wBAAgB,IAAI,IAAI,IAAI,CAE3B;AAED,kEAAkE;AAClE,wBAAgB,YAAY,IAAI,IAAI,CAEnC;AAED,iDAAiD;AACjD,wBAAgB,QAAQ,IAAI,IAAI,CAE/B;AAED,4CAA4C;AAC5C,wBAAgB,QAAQ,IAAI,IAAI,CAE/B;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEjD;AAED;;;;;;GAMG;AACH,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CA4BzC;AAED,2EAA2E;AAC3E,wBAAgB,KAAK,IAAI,IAAI,CAa5B;AAED,8CAA8C;AAC9C,wBAAgB,EAAE,IAAI,IAAI,CAEzB;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAGrC;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CA4B9C;AAED,0CAA0C;AAC1C,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAE3C;AAED,qDAAqD;AACrD,wBAAgB,YAAY,IAAI,IAAI,CAEnC;AAED;;;GAGG;AACH,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAczC;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAc1C;AAED,gDAAgD;AAChD,wBAAgB,UAAU,IAAI,IAAI,CAEjC;AAED,6CAA6C;AAC7C,wBAAgB,MAAM,IAAI,IAAI,CAG7B;AAED,oBAAoB;AACpB,wBAAgB,GAAG,IAAI,IAAI,CAG1B;AAED,mBAAmB;AACnB,wBAAgB,EAAE,IAAI,IAAI,CAGzB;AAED,oEAAoE;AACpE,wBAAgB,QAAQ,IAAI,IAAI,CAI/B;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAkB3C;AAED,2CAA2C;AAC3C,wBAAgB,QAAQ,IAAI,IAAI,CAG/B;AAED,qCAAqC;AACrC,wBAAgB,EAAE,IAAI,IAAI,CAEzB;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,IAAI,CAEhC;AAED,qDAAqD;AACrD,wBAAgB,YAAY,IAAI,IAAI,CAEnC;AAED,yCAAyC;AACzC,wBAAgB,aAAa,IAAI,IAAI,CAGpC;AAED,oCAAoC;AACpC,wBAAgB,KAAK,IAAI,IAAI,CAG5B;AAED,0FAA0F;AAC1F,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEzC;AAED,sEAAsE;AACtE,wBAAgB,OAAO,IAAI,IAAI,CAE9B;AAED,yEAAyE;AACzE,wBAAgB,OAAO,IAAI,IAAI,CAI9B;AAED,wCAAwC;AACxC,wBAAgB,SAAS,IAAI,IAAI,CAEhC;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAElD;AAED,6DAA6D;AAC7D,wBAAgB,KAAK,IAAI,IAAI,CAG5B;AAED,qCAAqC;AACrC,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAuB3C;AAED,4CAA4C;AAC5C,wBAAgB,IAAI,IAAI,IAAI,CAE3B;AAED,8CAA8C;AAC9C,wBAAgB,YAAY,IAAI,IAAI,CAUnC;AAED,2FAA2F;AAC3F,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAiB9C;AAED,kDAAkD;AAClD,wBAAgB,WAAW,IAAI,IAAI,CAOlC;AAED,4CAA4C;AAC5C,wBAAgB,KAAK,IAAI,IAAI,CAG5B;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAc7C;AAED,0CAA0C;AAC1C,wBAAgB,QAAQ,IAAI,IAAI,CAE/B;AAED,4CAA4C;AAC5C,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAE/C;AAED,yCAAyC;AACzC,wBAAgB,OAAO,IAAI,IAAI,CAE9B;AAED,sCAAsC;AACtC,wBAAgB,UAAU,IAAI,IAAI,CAGjC;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEjD;AAED,qCAAqC;AACrC,wBAAgB,SAAS,IAAI,IAAI,CAGhC;AAED;;;GAGG;AACH,wBAAgB,IAAI,IAAI,IAAI,CAE3B;AAED,yCAAyC;AACzC,wBAAgB,KAAK,IAAI,IAAI,CAE5B;AAED,kGAAkG;AAClG,wBAAgB,SAAS,IAAI,IAAI,CAEhC;AAED,oEAAoE;AACpE,wBAAgB,YAAY,IAAI,IAAI,CAcnC;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAE3C;AAED,uCAAuC;AACvC,wBAAgB,QAAQ,IAAI,IAAI,CAE/B;AAED,wCAAwC;AACxC,wBAAgB,IAAI,IAAI,IAAI,CAG3B;AAED,kDAAkD;AAClD,wBAAgB,YAAY,IAAI,IAAI,CAEnC;AAED;;;GAGG;AACH,wBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAcxC;AAED;;;GAGG;AACH,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAczC;AAED,gDAAgD;AAChD,wBAAgB,SAAS,IAAI,IAAI,CAGhC;AAED,0FAA0F;AAC1F,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEzC;AAED,+CAA+C;AAC/C,wBAAgB,OAAO,IAAI,IAAI,CAE9B;AAED;;;;;;GAMG;AACH,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEzC;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAE5C;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEhD;AAED,2CAA2C;AAC3C,wBAAgB,IAAI,IAAI,IAAI,CAG3B;AAED,mCAAmC;AACnC,wBAAgB,KAAK,IAAI,IAAI,CAE5B;AAED,2BAA2B;AAC3B,wBAAgB,IAAI,IAAI,IAAI,CAE3B;AAED,wCAAwC;AACxC,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEzC;AAED,0EAA0E;AAC1E,wBAAgB,GAAG,IAAI,IAAI,CAgB1B;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAE9C;AAED,2CAA2C;AAC3C,wBAAgB,IAAI,IAAI,IAAI,CAG3B;AAED,qDAAqD;AACrD,wBAAgB,QAAQ,IAAI,IAAI,CAE/B;AAED,oEAAoE;AACpE,wBAAgB,KAAK,IAAI,IAAI,CAG5B;AAED,6CAA6C;AAC7C,wBAAgB,QAAQ,IAAI,IAAI,CAE/B;AAED,0CAA0C;AAC1C,wBAAgB,KAAK,IAAI,IAAI,CAM5B;AAED;;;;;;;;GAQG;AACH,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CA4BzC;AAED,2EAA2E;AAC3E,wBAAgB,KAAK,IAAI,IAAI,CAiC5B;AAED,mDAAmD;AACnD,wBAAgB,WAAW,IAAI,IAAI,CAElC;AAED,qCAAqC;AACrC,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAE9C;AAED,uEAAuE;AACvE,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAmB3C;AAED,qDAAqD;AACrD,wBAAgB,IAAI,IAAI,IAAI,CAM3B;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAc7C;AAED,2CAA2C;AAC3C,wBAAgB,QAAQ,IAAI,IAAI,CAE/B;AAED,sCAAsC;AACtC,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAE9C;AAED,yEAAyE;AACzE,wBAAgB,UAAU,IAAI,IAAI,CAEjC;AAED,2FAA2F;AAC3F,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED,6DAA6D;AAC7D,wBAAgB,IAAI,IAAI,IAAI,CAG3B;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEjD;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,IAAI,IAAI,CAG/B;AAED;;;;;;GAMG;AACH,wBAAgB,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAsCtC;AAED,sDAAsD;AACtD,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED,mDAAmD;AACnD,wBAAgB,UAAU,IAAI,IAAI,CAEjC;AAED,kFAAkF;AAClF,wBAAgB,UAAU,IAAI,IAAI,CAEjC;AAED,kEAAkE;AAClE,wBAAgB,SAAS,IAAI,IAAI,CAIhC;AAED,wEAAwE;AACxE,wBAAgB,KAAK,IAAI,IAAI,CAG5B;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CA8C/C;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CA6BhD;AAED,4CAA4C;AAC5C,wBAAgB,IAAI,IAAI,IAAI,CAE3B;AAED,8DAA8D;AAC9D,wBAAgB,KAAK,IAAI,IAAI,CAG5B;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAchD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAE/C;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAQ1C;AAED,6EAA6E;AAC7E,wBAAgB,MAAM,IAAI,IAAI,CAG7B;AAED;;;GAGG;AACH,wBAAgB,IAAI,IAAI,IAAI,CAG3B;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAyBrD;AAED,6DAA6D;AAC7D,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CA0BvD;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAyBjD;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAsB1C;AAED,uDAAuD;AACvD,wBAAgB,MAAM,IAAI,IAAI,CAM7B;AAED,4CAA4C;AAC5C,wBAAgB,SAAS,IAAI,IAAI,CAEhC;AAED,+CAA+C;AAC/C,wBAAgB,YAAY,IAAI,IAAI,CAInC;AAED,yDAAyD;AACzD,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAkB1C;AAED,wCAAwC;AACxC,wBAAgB,KAAK,IAAI,IAAI,CAE5B;AAED,6CAA6C;AAC7C,wBAAgB,QAAQ,IAAI,IAAI,CAE/B;AAED,qDAAqD;AACrD,wBAAgB,YAAY,IAAI,IAAI,CAEnC;AAED,yDAAyD;AACzD,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAED,8CAA8C;AAC9C,wBAAgB,OAAO,IAAI,IAAI,CAG9B;AAED,sFAAsF;AACtF,wBAAgB,MAAM,IAAI,IAAI,CAQ7B;AAED,wFAAwF;AACxF,wBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEvC;AAED;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CA0BzC"}

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

@@ -4,13 +4,13 @@ import type { AnyGridEntity } from "../types/AnyGridEntity";
 import type { GridEntityID } from "../types/GridEntityID";
 /**
  * Helper function to convert the grid entity type found in a room XML file to the corresponding
- * grid entity type and variant normally used by the game. For example, a rock is represented as
- * 1000.0 in a room XML file, but `GridEntityType.ROCK` is equal to 2.
+ * grid entity type and variant normally used by the game. For example, `GridEntityXMLType.ROCK` is
+ * 1000 (in a room XML file), but `GridEntityType.ROCK` is equal to 2 (in-game).
  */
 export declare function convertXMLGridEntityType(gridEntityXMLType: GridEntityXMLType, gridEntityXMLVariant: int): [GridEntityType, int] | undefined;
 /**
  * Helper function to check if one or more of a specific kind of grid entity is present in the
- * current room. It uses the `countEntities` helper function to determine this.
+ * current room.
  *
  * @param gridEntityType The grid entity type to match.
  * @param variant Optional. Default is -1, which matches every variant.
@@ -82,7 +82,10 @@ export declare function getGridEntitiesInRadius(targetPosition: Vector, radius:
  */
 export declare function getGridEntitiesMap(...gridEntityTypes: GridEntityType[]): Map<int, GridEntity>;
 /** Helper function to get the top left and bottom right corners of a given grid entity. */
-export declare function getGridEntityCollisionPoints(gridEntity: GridEntity): [topLeft: Vector, bottomRight: Vector];
+export declare function getGridEntityCollisionPoints(gridEntity: GridEntity): {
+    topLeft: Vector;
+    bottomRight: Vector;
+};
 /** Helper function to get a string containing the grid entity's type and variant. */
 export declare function getGridEntityID(gridEntity: GridEntity): GridEntityID;
 /**
@@ -97,32 +100,47 @@ export declare function getGridEntityIDFromConstituents(gridEntityType: GridEnti
  * If you want to match every variant, use the `getGridEntities` function instead.
  */
 export declare function getMatchingGridEntities(gridEntityType: GridEntityType, variant: int): GridEntity[];
+/**
+ * Helper function to get the grid entities on the surrounding tiles from the provided grid entity.
+ *
+ * For example, if a rock was surrounded by rocks on all sides, this would return an array of 8
+ * rocks (e.g. top-left + top + top-right + left + right + bottom-left + bottom + right).
+ */
 export declare function getSurroundingGridEntities(gridEntity: GridEntity): GridEntity[];
+/**
+ * Helper function to get the top left wall in the current room.
+ *
+ * This function can be useful in certain situations to determine if the room is currently loaded.
+ */
 export declare function getTopLeftWall(): GridEntity | undefined;
 /**
  * Helper function to get the grid index of the top left wall. (This will depend on what the current
  * room shape is.)
+ *
+ * This function can be useful in certain situations to determine if the room is currently loaded.
  */
 export declare function getTopLeftWallGridIndex(): int;
 /**
- * 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.
+ * Helper function to detect if a particular grid entity would "break" if it was touched by an
+ * explosion.
  *
- * Note that in the case of `GridEntityType.LOCK` (11), the state will turn to being broken before
- * the actual collision for the entity is removed.
+ * For example, rocks and pots are breakable by explosions, but blocks are not.
  */
 export declare function isGridEntityBreakableByExplosion(gridEntity: GridEntity): boolean;
 /**
- * Helper function to detect whether a given Void Portal is one that randomly spawns after a boss is
- * defeated or is one that naturally spawns in the room after Hush. (This is determined by looking
- * at the VarData of the entity.)
+ * Helper function to see if the provided grid entity is in its respective broken state. See the
+ * `GRID_ENTITY_TYPE_TO_BROKEN_STATE_MAP` constant for more details.
+ *
+ * Note that in the case of `GridEntityType.LOCK` (11), the state will turn to being broken before
+ * the actual collision for the entity is removed.
  */
 export declare function isGridEntityBroken(gridEntity: GridEntity): boolean;
 /** Helper function to see if a `GridEntityXMLType` is some kind of poop. */
 export declare function isPoopGridEntityType(gridEntityXMLType: GridEntityXMLType): boolean;
 /**
- * Helper function to determine if all of the pressure plates in the current room are pushed.
- * Returns true if there are no pressure plates in the room.
+ * Helper function to detect whether a given Void Portal is one that randomly spawns after a boss is
+ * defeated or is one that naturally spawns in the room after Hush. (This is determined by looking
+ * at the `VarData` of the entity.)
  */
 export declare function isPostBossVoidPortal(gridEntity: GridEntity): boolean;
 /**

package/dist/src/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/src/functions/gridEntities.lua

@@ -71,10 +71,12 @@ end
 function ____exports.getGridEntityCollisionPoints(self, gridEntity)
     local topLeft = Vector(gridEntity.Position.X - DISTANCE_OF_GRID_TILE / 2, gridEntity.Position.Y - DISTANCE_OF_GRID_TILE / 2)
     local bottomRight = Vector(gridEntity.Position.X + DISTANCE_OF_GRID_TILE / 2, gridEntity.Position.Y + DISTANCE_OF_GRID_TILE / 2)
-    return {topLeft, bottomRight}
+    return {topLeft = topLeft, bottomRight = bottomRight}
 end
 --- Helper function to get the grid index of the top left wall. (This will depend on what the current
 -- room shape is.)
+-- 
+-- This function can be useful in certain situations to determine if the room is currently loaded.
 function ____exports.getTopLeftWallGridIndex(self)
     local room = game:GetRoom()
     local roomShape = room:GetRoomShape()
@@ -95,13 +97,13 @@ end
 -- this to false if you need to run this function multiple times.
 function ____exports.removeGridEntity(self, gridEntityOrGridIndex, updateRoom)
     local room = game:GetRoom()
-    local ____isNumber_result_0
+    local ____isNumber_result_2
     if isNumber(nil, gridEntityOrGridIndex) then
-        ____isNumber_result_0 = room:GetGridEntity(gridEntityOrGridIndex)
+        ____isNumber_result_2 = room:GetGridEntity(gridEntityOrGridIndex)
     else
-        ____isNumber_result_0 = gridEntityOrGridIndex
+        ____isNumber_result_2 = gridEntityOrGridIndex
     end
-    local gridEntity = ____isNumber_result_0
+    local gridEntity = ____isNumber_result_2
     if gridEntity == nil then
         return
     end
@@ -131,13 +133,13 @@ end
 -- - allows you to specify the grid index or the position
 function ____exports.spawnGridEntityWithVariant(self, gridEntityType, variant, gridIndexOrPosition)
     local room = game:GetRoom()
-    local ____isVector_result_1
+    local ____isVector_result_3
     if isVector(nil, gridIndexOrPosition) then
-        ____isVector_result_1 = room:GetGridEntityFromPos(gridIndexOrPosition)
+        ____isVector_result_3 = room:GetGridEntityFromPos(gridIndexOrPosition)
     else
-        ____isVector_result_1 = room:GetGridEntity(gridIndexOrPosition)
+        ____isVector_result_3 = room:GetGridEntity(gridIndexOrPosition)
     end
-    local existingGridEntity = ____isVector_result_1
+    local existingGridEntity = ____isVector_result_3
     if existingGridEntity ~= nil then
         ____exports.removeGridEntity(nil, existingGridEntity, true)
     end
@@ -174,8 +176,8 @@ local BREAKABLE_GRID_ENTITY_TYPES_VARIANTS_BY_EXPLOSIONS = __TS__New(
     {(tostring(GridEntityType.STATUE) .. ".") .. tostring(StatueVariant.ANGEL)}
 )
 --- Helper function to convert the grid entity type found in a room XML file to the corresponding
--- grid entity type and variant normally used by the game. For example, a rock is represented as
--- 1000.0 in a room XML file, but `GridEntityType.ROCK` is equal to 2.
+-- grid entity type and variant normally used by the game. For example, `GridEntityXMLType.ROCK` is
+-- 1000 (in a room XML file), but `GridEntityType.ROCK` is equal to 2 (in-game).
 function ____exports.convertXMLGridEntityType(self, gridEntityXMLType, gridEntityXMLVariant)
     local gridEntityArray = GRID_ENTITY_XML_MAP:get(gridEntityXMLType)
     assertDefined(
@@ -191,7 +193,7 @@ function ____exports.convertXMLGridEntityType(self, gridEntityXMLType, gridEntit
     return {gridEntityType, variant}
 end
 --- Helper function to check if one or more of a specific kind of grid entity is present in the
--- current room. It uses the `countEntities` helper function to determine this.
+-- current room.
 -- 
 -- @param gridEntityType The grid entity type to match.
 -- @param variant Optional. Default is -1, which matches every variant.
@@ -223,7 +225,9 @@ end
 -- Note that this function will not work properly in the `POST_NEW_ROOM` callback since entities do
 -- not have collision yet in that callback.
 function ____exports.getCollidingEntitiesWithGridEntity(self, gridEntity)
-    local topLeft, bottomRight = table.unpack(____exports.getGridEntityCollisionPoints(nil, gridEntity))
+    local ____exports_getGridEntityCollisionPoints_result_0 = ____exports.getGridEntityCollisionPoints(nil, gridEntity)
+    local topLeft = ____exports_getGridEntityCollisionPoints_result_0.topLeft
+    local bottomRight = ____exports_getGridEntityCollisionPoints_result_0.bottomRight
     local closeEntities = Isaac.FindInRadius(gridEntity.Position, DISTANCE_OF_GRID_TILE * 2)
     return __TS__ArrayFilter(
         closeEntities,
@@ -336,7 +340,9 @@ function ____exports.getGridEntitiesInRadius(self, targetPosition, radius)
                     goto __continue24
                 end
                 registeredGridIndexes:add(gridIndex)
-                local topLeft, bottomRight = table.unpack(____exports.getGridEntityCollisionPoints(nil, gridEntity))
+                local ____exports_getGridEntityCollisionPoints_result_1 = ____exports.getGridEntityCollisionPoints(nil, gridEntity)
+                local topLeft = ____exports_getGridEntityCollisionPoints_result_1.topLeft
+                local bottomRight = ____exports_getGridEntityCollisionPoints_result_1.bottomRight
                 if isCircleIntersectingRectangle(
                     nil,
                     targetPosition,
@@ -390,6 +396,10 @@ function ____exports.getMatchingGridEntities(self, gridEntityType, variant)
         function(____, gridEntity) return gridEntity:GetVariant() == variant end
     )
 end
+--- Helper function to get the grid entities on the surrounding tiles from the provided grid entity.
+-- 
+-- For example, if a rock was surrounded by rocks on all sides, this would return an array of 8
+-- rocks (e.g. top-left + top + top-right + left + right + bottom-left + bottom + right).
 function ____exports.getSurroundingGridEntities(self, gridEntity)
     local room = game:GetRoom()
     local gridWidth = room:GetGridWidth()
@@ -413,25 +423,29 @@ function ____exports.getSurroundingGridEntities(self, gridEntity)
     end
     return surroundingGridEntities
 end
+--- Helper function to get the top left wall in the current room.
+-- 
+-- This function can be useful in certain situations to determine if the room is currently loaded.
 function ____exports.getTopLeftWall(self)
     local room = game:GetRoom()
     local topLeftWallGridIndex = ____exports.getTopLeftWallGridIndex(nil)
     return room:GetGridEntity(topLeftWallGridIndex)
 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.
+--- Helper function to detect if a particular grid entity would "break" if it was touched by an
+-- explosion.
 -- 
--- Note that in the case of `GridEntityType.LOCK` (11), the state will turn to being broken before
--- the actual collision for the entity is removed.
+-- For example, rocks and pots are breakable by explosions, but blocks are not.
 function ____exports.isGridEntityBreakableByExplosion(self, gridEntity)
     local gridEntityType = gridEntity:GetType()
     local variant = gridEntity:GetVariant()
     local gridEntityTypeVariant = (tostring(gridEntityType) .. ".") .. tostring(variant)
     return BREAKABLE_GRID_ENTITY_TYPES_BY_EXPLOSIONS:has(gridEntityType) or BREAKABLE_GRID_ENTITY_TYPES_VARIANTS_BY_EXPLOSIONS:has(gridEntityTypeVariant)
 end
---- Helper function to detect whether a given Void Portal is one that randomly spawns after a boss is
--- defeated or is one that naturally spawns in the room after Hush. (This is determined by looking
--- at the VarData of the entity.)
+--- Helper function to see if the provided grid entity is in its respective broken state. See the
+-- `GRID_ENTITY_TYPE_TO_BROKEN_STATE_MAP` constant for more details.
+-- 
+-- Note that in the case of `GridEntityType.LOCK` (11), the state will turn to being broken before
+-- the actual collision for the entity is removed.
 function ____exports.isGridEntityBroken(self, gridEntity)
     local gridEntityType = gridEntity:GetType()
     local brokenState = GRID_ENTITY_TYPE_TO_BROKEN_STATE_MAP:get(gridEntityType)
@@ -441,8 +455,9 @@ end
 function ____exports.isPoopGridEntityType(self, gridEntityXMLType)
     return POOP_GRID_ENTITY_XML_TYPES_SET:has(gridEntityXMLType)
 end
---- Helper function to determine if all of the pressure plates in the current room are pushed.
--- Returns true if there are no pressure plates in the room.
+--- Helper function to detect whether a given Void Portal is one that randomly spawns after a boss is
+-- defeated or is one that naturally spawns in the room after Hush. (This is determined by looking
+-- at the `VarData` of the entity.)
 function ____exports.isPostBossVoidPortal(self, gridEntity)
     local saveState = gridEntity:GetSaveState()
     return saveState.VarData == 1

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

@@ -5,6 +5,8 @@
  * order for the room to be cleared. This function ignores other types of pressure plates, such as
  * the ones that you press to get a reward, the ones that you press to start a Greed Mode wave, and
  * so on.
+ *
+ * Returns true if there are no pressure plates in the room.
  */
 export declare function isAllPressurePlatesPushed(): boolean;
 //# sourceMappingURL=pressurePlate.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"pressurePlate.d.ts","sourceRoot":"","sources":["../../../src/functions/pressurePlate.ts"],"names":[],"mappings":"AAOA;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,IAAI,OAAO,CAanD"}
+{"version":3,"file":"pressurePlate.d.ts","sourceRoot":"","sources":["../../../src/functions/pressurePlate.ts"],"names":[],"mappings":"AAOA;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,IAAI,OAAO,CAanD"}

package/dist/src/functions/pressurePlate.lua

@@ -14,6 +14,8 @@ local getPressurePlates = ____gridEntitiesSpecific.getPressurePlates
 -- order for the room to be cleared. This function ignores other types of pressure plates, such as
 -- the ones that you press to get a reward, the ones that you press to start a Greed Mode wave, and
 -- so on.
+-- 
+-- Returns true if there are no pressure plates in the room.
 function ____exports.isAllPressurePlatesPushed(self)
     local room = game:GetRoom()
     local hasPressurePlates = room:HasTriggerPressurePlates()

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

@@ -28,6 +28,9 @@ export declare function restart(character?: PlayerType): void;
  *
  * This is useful to revert the behavior where playing on a set and restarting the game will not
  * take you to a new seed.
+ *
+ * Under the hood, this function calls the `Seeds.Reset` method and the
+ * `Seeds.Restart(Challenge.NULL)` method.
  */
 export declare function setUnseeded(): void;
 //# sourceMappingURL=run.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/functions/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,UAAU,EAEX,MAAM,8BAA8B,CAAC;AAOtC;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,OAAO,CAUlD;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAKrC;AAED;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAMnC;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,SAAS,CAAC,EAAE,UAAU,GAAG,IAAI,CAiBpD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAUlC"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/functions/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,UAAU,EAEX,MAAM,8BAA8B,CAAC;AAOtC;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,OAAO,CAUlD;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAKrC;AAED;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAMnC;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,SAAS,CAAC,EAAE,UAAU,GAAG,IAAI,CAiBpD;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAUlC"}

package/dist/src/functions/run.lua

@@ -59,6 +59,9 @@ end
 -- 
 -- This is useful to revert the behavior where playing on a set and restarting the game will not
 -- take you to a new seed.
+-- 
+-- Under the hood, this function calls the `Seeds.Reset` method and the
+-- `Seeds.Restart(Challenge.NULL)` method.
 function ____exports.setUnseeded(self)
     local seeds = game:GetSeeds()
     seeds:Reset()

package/dist/src/maps/gridEntityTypeToBrokenStateMap.d.ts

@@ -1,3 +1,4 @@
 import { GridEntityType } from "isaac-typescript-definitions";
+/** Not every grid entity can be broken. Thus use a map to represent this. */
 export declare const GRID_ENTITY_TYPE_TO_BROKEN_STATE_MAP: ReadonlyMap<GridEntityType, int>;
 //# sourceMappingURL=gridEntityTypeToBrokenStateMap.d.ts.map

package/dist/src/maps/gridEntityTypeToBrokenStateMap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gridEntityTypeToBrokenStateMap.d.ts","sourceRoot":"","sources":["../../../src/maps/gridEntityTypeToBrokenStateMap.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EAMf,MAAM,8BAA8B,CAAC;AAItC,eAAO,MAAM,oCAAoC,kCAuC/C,CAAC"}
+{"version":3,"file":"gridEntityTypeToBrokenStateMap.d.ts","sourceRoot":"","sources":["../../../src/maps/gridEntityTypeToBrokenStateMap.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EAMf,MAAM,8BAA8B,CAAC;AAGtC,6EAA6E;AAC7E,eAAO,MAAM,oCAAoC,kCAuC/C,CAAC"}

package/dist/src/maps/gridEntityTypeToBrokenStateMap.lua

@@ -10,6 +10,7 @@ local SpiderWebState = ____isaac_2Dtypescript_2Ddefinitions.SpiderWebState
 local TNTState = ____isaac_2Dtypescript_2Ddefinitions.TNTState
 local ____ReadonlyMap = require("src.types.ReadonlyMap")
 local ReadonlyMap = ____ReadonlyMap.ReadonlyMap
+--- Not every grid entity can be broken. Thus use a map to represent this.
 ____exports.GRID_ENTITY_TYPE_TO_BROKEN_STATE_MAP = __TS__New(ReadonlyMap, {
     {GridEntityType.ROCK, RockState.BROKEN},
     {GridEntityType.ROCK_TINTED, RockState.BROKEN},

package/package.json

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

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

@@ -11,14 +11,33 @@ import { ModCallbackCustom } from "../../../enums/ModCallbackCustom";
 import { isVanillaConsoleCommand } from "../../../functions/console";
 import { addFlag, bitFlags } from "../../../functions/flag";
 import { getMapPartialMatch } from "../../../functions/map";
+import { assertDefined } from "../../../functions/utils";
 import { Feature } from "../../private/Feature";
 import * as commands from "./extraConsoleCommands/commands";
 import { v } from "./extraConsoleCommands/v";
 
+// eslint-disable-next-line @typescript-eslint/naming-convention
+declare let __ISAACSCRIPT_COMMON_EXTRA_CONSOLE_COMMANDS_FEATURE:
+  | ExtraConsoleCommands
+  | undefined;
+
+/**
+ * When you enable this feature, many custom commands will be added to the in-game console. See the
+ * [dedicated command list](ExtraConsoleCommandsList) for more information about them.
+ *
+ * Note that in order to avoid conflicts, if two or more mods enable this feature, then the first
+ * loaded one will control all of the command logic. When this occurs, a global variable of
+ * `__ISAACSCRIPT_COMMON_EXTRA_CONSOLE_COMMANDS_FEATURE` will be created and will automatically be
+ * used by the non-main instances. For this reason, if you use multiple mods with
+ * `isaacscript-common` and a custom command from the standard library is not working properly, then
+ * you might need to get another mod author to update their version of `isaacscript-common`.
+ */
 export class ExtraConsoleCommands extends Feature {
   /** @internal */
   public override v = v;
 
+  private readonly isMainFeature: boolean;
+
   private readonly commandFunctionMap = new Map<
     string,
     (params: string) => void
@@ -28,6 +47,16 @@ export class ExtraConsoleCommands extends Feature {
   constructor() {
     super();
 
+    // Only one instance of this feature can be instantiated across all mods.
+    this.isMainFeature =
+      __ISAACSCRIPT_COMMON_EXTRA_CONSOLE_COMMANDS_FEATURE === undefined;
+    if (!this.isMainFeature) {
+      return;
+    }
+
+    // eslint-disable-next-line @typescript-eslint/no-this-alias, consistent-this
+    __ISAACSCRIPT_COMMON_EXTRA_CONSOLE_COMMANDS_FEATURE = this;
+
     this.callbacksUsed = [
       // 1
       [ModCallback.POST_UPDATE, this.postUpdate],
@@ -176,8 +205,8 @@ export class ExtraConsoleCommands extends Feature {
   private readonly executeCmd = (command: string, params: string) => {
     const resultTuple = getMapPartialMatch(command, this.commandFunctionMap);
     if (resultTuple === undefined) {
-      // We cannot print an error message, because if multiple mods have this feature enabled, then
-      // multiple error messages would appear.
+      // We opt to not print an error message because a non-IsaacScript mod may have configured a
+      // custom console command.
       return;
     }
 
@@ -211,10 +240,12 @@ export class ExtraConsoleCommands extends Feature {
   /**
    * Helper function to add a custom console command.
    *
-   * The standard library comes with many existing console commands that are useful for debugging,
-   * but you can also add your own commands that are useful for your particular mod. It's easier to
-   * add commands to the existing command system than to add your own logic manually to the
-   * `EXECUTE_CMD` callback.
+   * The standard library comes with [many existing console commands](ExtraConsoleCommandsList) that
+   * are useful for debugging, but you can also add your own commands that are useful for your
+   * particular mod. It's easier to add commands to the existing command system than to add your own
+   * logic manually to the `EXECUTE_CMD` callback.
+   *
+   * This function is intended to be called when your mod is first loading.
    *
    * In order to use this function, you must upgrade your mod with
    * `ISCFeature.EXTRA_CONSOLE_COMMANDS`.
@@ -224,6 +255,18 @@ export class ExtraConsoleCommands extends Feature {
     commandName: string,
     commandFunction: (params: string) => void,
   ): void {
+    if (!this.isMainFeature) {
+      assertDefined(
+        __ISAACSCRIPT_COMMON_EXTRA_CONSOLE_COMMANDS_FEATURE,
+        "Failed to find the non-main isaacscript-common extra console commands feature in the global variable.",
+      );
+      __ISAACSCRIPT_COMMON_EXTRA_CONSOLE_COMMANDS_FEATURE.addConsoleCommand(
+        commandName,
+        commandFunction,
+      );
+      return;
+    }
+
     if (isVanillaConsoleCommand(commandName)) {
       error(
         `Failed to add a new console command of "${commandName}" because that name already belongs to a vanilla command. You must pick a non-colliding name.`,
@@ -242,17 +285,30 @@ export class ExtraConsoleCommands extends Feature {
   /**
    * Helper function to remove a custom console command.
    *
-   * The standard library comes with many existing console commands that are useful for debugging.
-   * If you want to disable one of them, use this function.
+   * The standard library comes with [many existing console commands](ExtraConsoleCommandsList) that
+   * are useful for debugging. If you want to disable one of them, use this function.
+   *
+   * This function is intended to be called when your mod is first loading.
    *
    * In order to use this function, you must upgrade your mod with
    * `ISCFeature.EXTRA_CONSOLE_COMMANDS`.
    */
   @Exported
   public removeConsoleCommand(commandName: string): void {
+    if (!this.isMainFeature) {
+      assertDefined(
+        __ISAACSCRIPT_COMMON_EXTRA_CONSOLE_COMMANDS_FEATURE,
+        "Failed to find the non-main isaacscript-common extra console commands feature in the global variable.",
+      );
+      __ISAACSCRIPT_COMMON_EXTRA_CONSOLE_COMMANDS_FEATURE.removeConsoleCommand(
+        commandName,
+      );
+      return;
+    }
+
     if (!this.commandFunctionMap.has(commandName)) {
       error(
-        `Failed to remove the console command of "${commandName}", since it does not already exist in the map.`,
+        `Failed to remove the console command of "${commandName}", since it does not already exist in the command map.`,
       );
     }
 

package/src/classes/features/other/extraConsoleCommands/commands.ts

@@ -10,7 +10,12 @@ eslint "sort-exports/sort-exports": [
 */
 
 /**
- * This is a list of custom console commands that are included with the standard library.
+ * __DOCS_LINE_THAT_WILL_BE_AUTOMATICALLY_REMOVED__
+ *
+ * This is a list of custom console commands that are included with the standard library. By
+ * default, they will not be enabled. You can enable them by upgrading your mod with
+ * `ISCFeature.EXTRA_CONSOLE_COMMANDS`. (Also see the [Extra Console Commands](ExtraConsoleCommands)
+ * feature documentation.)
  *
  * As a quality of life feature, you do not have to match the casing of the command. For example,
  * you can type the "addCharges" command as "addcharges", and it will still work the same.
@@ -22,9 +27,9 @@ eslint "sort-exports/sort-exports": [
  * `ISCFeature.EXTRA_CONSOLE_COMMANDS` when upgrading your mod. (See the "Extra Console Commands
  * (Init)" page for more details.)
  *
- * Each command has a corresponding function of the same name, but these functions are not actually
- * exported for end-user consumption. (This is to cut down on namespace conflicts and because the
- * names of the functions are not very descriptive.)
+ * Each command has a corresponding function of the same name, but these functions are not exported
+ * for end-user consumption. (This is to cut down on namespace conflicts and because the names of
+ * the functions are not very descriptive.)
  *
  * @module
  */

package/src/functions/gridEntities.ts

@@ -35,10 +35,8 @@ const BREAKABLE_GRID_ENTITY_TYPES_BY_EXPLOSIONS =
     GridEntityType.ROCK_ALT, // 6
     GridEntityType.SPIDER_WEB, // 10
     GridEntityType.TNT, // 12
-
     // GridEntityType.FIREPLACE (13) does not count since it is turned into a non-grid entity upon
     // spawning.
-
     GridEntityType.POOP, // 14
     GridEntityType.ROCK_SUPER_SPECIAL, // 22
     GridEntityType.ROCK_SPIKED, // 25
@@ -51,8 +49,8 @@ const BREAKABLE_GRID_ENTITY_TYPES_VARIANTS_BY_EXPLOSIONS =
 
 /**
  * Helper function to convert the grid entity type found in a room XML file to the corresponding
- * grid entity type and variant normally used by the game. For example, a rock is represented as
- * 1000.0 in a room XML file, but `GridEntityType.ROCK` is equal to 2.
+ * grid entity type and variant normally used by the game. For example, `GridEntityXMLType.ROCK` is
+ * 1000 (in a room XML file), but `GridEntityType.ROCK` is equal to 2 (in-game).
  */
 export function convertXMLGridEntityType(
   gridEntityXMLType: GridEntityXMLType,
@@ -82,7 +80,7 @@ export function convertXMLGridEntityType(
 
 /**
  * Helper function to check if one or more of a specific kind of grid entity is present in the
- * current room. It uses the `countEntities` helper function to determine this.
+ * current room.
  *
  * @param gridEntityType The grid entity type to match.
  * @param variant Optional. Default is -1, which matches every variant.
@@ -134,7 +132,7 @@ export function getAllGridIndexes(): int[] {
 export function getCollidingEntitiesWithGridEntity(
   gridEntity: GridEntity,
 ): Entity[] {
-  const [topLeft, bottomRight] = getGridEntityCollisionPoints(gridEntity);
+  const { topLeft, bottomRight } = getGridEntityCollisionPoints(gridEntity);
 
   const closeEntities = Isaac.FindInRadius(
     gridEntity.Position,
@@ -290,7 +288,7 @@ export function getGridEntitiesInRadius(
       }
 
       registeredGridIndexes.add(gridIndex);
-      const [topLeft, bottomRight] = getGridEntityCollisionPoints(gridEntity);
+      const { topLeft, bottomRight } = getGridEntityCollisionPoints(gridEntity);
 
       if (
         isCircleIntersectingRectangle(
@@ -332,9 +330,10 @@ export function getGridEntitiesMap(
 }
 
 /** Helper function to get the top left and bottom right corners of a given grid entity. */
-export function getGridEntityCollisionPoints(
-  gridEntity: GridEntity,
-): [topLeft: Vector, bottomRight: Vector] {
+export function getGridEntityCollisionPoints(gridEntity: GridEntity): {
+  topLeft: Vector;
+  bottomRight: Vector;
+} {
   const topLeft = Vector(
     gridEntity.Position.X - DISTANCE_OF_GRID_TILE / 2,
     gridEntity.Position.Y - DISTANCE_OF_GRID_TILE / 2,
@@ -344,7 +343,7 @@ export function getGridEntityCollisionPoints(
     gridEntity.Position.Y + DISTANCE_OF_GRID_TILE / 2,
   );
 
-  return [topLeft, bottomRight];
+  return { topLeft, bottomRight };
 }
 
 /** Helper function to get a string containing the grid entity's type and variant. */
@@ -381,6 +380,12 @@ export function getMatchingGridEntities(
   );
 }
 
+/**
+ * Helper function to get the grid entities on the surrounding tiles from the provided grid entity.
+ *
+ * For example, if a rock was surrounded by rocks on all sides, this would return an array of 8
+ * rocks (e.g. top-left + top + top-right + left + right + bottom-left + bottom + right).
+ */
 export function getSurroundingGridEntities(
   gridEntity: GridEntity,
 ): GridEntity[] {
@@ -412,6 +417,11 @@ export function getSurroundingGridEntities(
   return surroundingGridEntities;
 }
 
+/**
+ * Helper function to get the top left wall in the current room.
+ *
+ * This function can be useful in certain situations to determine if the room is currently loaded.
+ */
 export function getTopLeftWall(): GridEntity | undefined {
   const room = game.GetRoom();
   const topLeftWallGridIndex = getTopLeftWallGridIndex();
@@ -421,6 +431,8 @@ export function getTopLeftWall(): GridEntity | undefined {
 /**
  * Helper function to get the grid index of the top left wall. (This will depend on what the current
  * room shape is.)
+ *
+ * This function can be useful in certain situations to determine if the room is currently loaded.
  */
 export function getTopLeftWallGridIndex(): int {
   const room = game.GetRoom();
@@ -432,11 +444,10 @@ export function getTopLeftWallGridIndex(): int {
 }
 
 /**
- * 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.
+ * Helper function to detect if a particular grid entity would "break" if it was touched by an
+ * explosion.
  *
- * Note that in the case of `GridEntityType.LOCK` (11), the state will turn to being broken before
- * the actual collision for the entity is removed.
+ * For example, rocks and pots are breakable by explosions, but blocks are not.
  */
 export function isGridEntityBreakableByExplosion(
   gridEntity: GridEntity,
@@ -454,9 +465,11 @@ export function isGridEntityBreakableByExplosion(
 }
 
 /**
- * Helper function to detect whether a given Void Portal is one that randomly spawns after a boss is
- * defeated or is one that naturally spawns in the room after Hush. (This is determined by looking
- * at the VarData of the entity.)
+ * Helper function to see if the provided grid entity is in its respective broken state. See the
+ * `GRID_ENTITY_TYPE_TO_BROKEN_STATE_MAP` constant for more details.
+ *
+ * Note that in the case of `GridEntityType.LOCK` (11), the state will turn to being broken before
+ * the actual collision for the entity is removed.
  */
 export function isGridEntityBroken(gridEntity: GridEntity): boolean {
   const gridEntityType = gridEntity.GetType();
@@ -472,8 +485,9 @@ export function isPoopGridEntityType(
 }
 
 /**
- * Helper function to determine if all of the pressure plates in the current room are pushed.
- * Returns true if there are no pressure plates in the room.
+ * Helper function to detect whether a given Void Portal is one that randomly spawns after a boss is
+ * defeated or is one that naturally spawns in the room after Hush. (This is determined by looking
+ * at the `VarData` of the entity.)
  */
 export function isPostBossVoidPortal(gridEntity: GridEntity): boolean {
   // - The VarData of Void Portals that are spawned after bosses will be equal to 1.

package/src/functions/pressurePlate.ts

@@ -12,6 +12,8 @@ import { getPressurePlates } from "./gridEntitiesSpecific";
  * order for the room to be cleared. This function ignores other types of pressure plates, such as
  * the ones that you press to get a reward, the ones that you press to start a Greed Mode wave, and
  * so on.
+ *
+ * Returns true if there are no pressure plates in the room.
  */
 export function isAllPressurePlatesPushed(): boolean {
   const room = game.GetRoom();

package/src/functions/run.ts

@@ -81,6 +81,9 @@ export function restart(character?: PlayerType): void {
  *
  * This is useful to revert the behavior where playing on a set and restarting the game will not
  * take you to a new seed.
+ *
+ * Under the hood, this function calls the `Seeds.Reset` method and the
+ * `Seeds.Restart(Challenge.NULL)` method.
  */
 export function setUnseeded(): void {
   const seeds = game.GetSeeds();

package/src/maps/gridEntityTypeToBrokenStateMap.ts

@@ -8,7 +8,7 @@ import {
 } from "isaac-typescript-definitions";
 import { ReadonlyMap } from "../types/ReadonlyMap";
 
-// Not every grid entity can be broken, thus we can use a map to represent this.
+/** Not every grid entity can be broken. Thus use a map to represent this. */
 export const GRID_ENTITY_TYPE_TO_BROKEN_STATE_MAP = new ReadonlyMap<
   GridEntityType,
   int