isaacscript-common 29.7.0 → 29.9.0

package/dist/index.rollup.d.ts

@@ -5106,8 +5106,11 @@ export declare function getFlagName<T extends BitFlag | BitFlag128>(flag: BitFla
  * that is indexed by the room's safe grid index.
  *
  * This function automatically accounts for whether or not MinimapAPI is being used.
+ *
+ * @param minimapAPI Optional. Whether or not MinimapAPI should be used, if present. Default is
+ *                   true.
  */
-export declare function getFloorDisplayFlags(): Map<int, BitFlags<DisplayFlag>>;
+export declare function getFloorDisplayFlags(minimapAPI?: boolean): Map<int, BitFlags<DisplayFlag>>;
 
 /**
  * Helper function to get the corresponding golden trinket type from a normal trinket type.
@@ -6312,8 +6315,10 @@ export declare function getRoomDescriptorsForType(...roomTypes: RoomType[]): Roo
  * This function automatically accounts for whether or not MinimapAPI is being used.
  *
  * @param roomGridIndex Optional. Default is the current room index.
+ * @param minimapAPI Optional. Whether or not MinimapAPI should be used, if present. Default is
+ *                   true.
  */
-export declare function getRoomDisplayFlags(roomGridIndex?: int): BitFlags<DisplayFlag>;
+export declare function getRoomDisplayFlags(roomGridIndex?: int, minimapAPI?: boolean): BitFlags<DisplayFlag>;
 
 /**
  * Helper function to get the grid index of the current room.
@@ -6915,6 +6920,13 @@ export declare function getTSTLClassName(object: unknown): string | undefined;
  */
 export declare function getUnusedDoorSlots(): DoorSlot[];
 
+/**
+ * Helper function to find the active slots that the player has the corresponding collectible type
+ * in and have enough charge to be used. Returns an empty array if the player does not have the
+ * collectible in any active slot or does not have enough charges.
+ */
+export declare function getUsableActiveItemSlots(player: EntityPlayer, collectibleType: CollectibleType): ActiveSlot[];
+
 /**
  * Helper function to get an array with every valid vanilla card sub-type.
  *

package/dist/isaacscript-common.lua

@@ -1,6 +1,6 @@
 --[[
 
-isaacscript-common 29.7.0
+isaacscript-common 29.9.0
 
 This is the "isaacscript-common" library, which was created with the IsaacScript tool.
 
@@ -25339,6 +25339,8 @@ end
 return ____exports
  end,
 ["src.functions.charge"] = function(...) 
+local ____lualib = require("lualib_bundle")
+local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
 local ____exports = {}
 local getChargesToAddWithAAAModifier, shouldPlayFullRechargeSound
 local ____isaac_2Dtypescript_2Ddefinitions = require("lua_modules.isaac-typescript-definitions.dist.src.index")
@@ -25355,6 +25357,8 @@ local getCollectibleChargeType = ____collectibles.getCollectibleChargeType
 local getCollectibleMaxCharges = ____collectibles.getCollectibleMaxCharges
 local ____playerIndex = require("src.functions.playerIndex")
 local getPlayers = ____playerIndex.getPlayers
+local ____players = require("src.functions.players")
+local getActiveItemSlots = ____players.getActiveItemSlots
 local ____roomShape = require("src.functions.roomShape")
 local getRoomShapeCharges = ____roomShape.getRoomShapeCharges
 function ____exports.addCharge(self, player, activeSlot, numCharges, playSoundEffect)
@@ -25489,6 +25493,17 @@ function ____exports.addRoomClearCharges(self, bigRoomDoubleCharge)
         ____exports.addRoomClearCharge(nil, player, bigRoomDoubleCharge)
     end
 end
+function ____exports.getUsableActiveItemSlots(self, player, collectibleType)
+    local maxCharges = getCollectibleMaxCharges(nil, collectibleType)
+    local activeSlots = getActiveItemSlots(nil, player, collectibleType)
+    return __TS__ArrayFilter(
+        activeSlots,
+        function(____, activeSlot)
+            local totalCharge = ____exports.getTotalCharge(nil, player, activeSlot)
+            return totalCharge >= maxCharges
+        end
+    )
+end
 function ____exports.isActiveSlotDoubleCharged(self, player, activeSlot)
     if activeSlot == nil then
         activeSlot = ActiveSlot.PRIMARY
@@ -53181,11 +53196,14 @@ local getRoomDescriptor = ____roomData.getRoomDescriptor
 local getRoomGridIndex = ____roomData.getRoomGridIndex
 local ____rooms = require("src.functions.rooms")
 local getRoomsInsideGrid = ____rooms.getRoomsInsideGrid
-function ____exports.getRoomDisplayFlags(self, roomGridIndex)
+function ____exports.getRoomDisplayFlags(self, roomGridIndex, minimapAPI)
+    if minimapAPI == nil then
+        minimapAPI = true
+    end
     if roomGridIndex == nil then
         roomGridIndex = getRoomGridIndex(nil)
     end
-    if MinimapAPI == nil then
+    if MinimapAPI == nil or not minimapAPI then
         local roomDescriptor = getRoomDescriptor(nil, roomGridIndex)
         return roomDescriptor.DisplayFlags
     end
@@ -53240,11 +53258,14 @@ end
 function ____exports.clearRoomDisplayFlags(self, roomGridIndex)
     ____exports.setRoomDisplayFlags(nil, roomGridIndex, DisplayFlagZero)
 end
-function ____exports.getFloorDisplayFlags(self)
+function ____exports.getFloorDisplayFlags(self, minimapAPI)
+    if minimapAPI == nil then
+        minimapAPI = true
+    end
     local displayFlagsMap = __TS__New(Map)
     for ____, roomDescriptor in ipairs(getRoomsInsideGrid(nil)) do
         local roomGridIndex = roomDescriptor.SafeGridIndex
-        local displayFlags = ____exports.getRoomDisplayFlags(nil, roomGridIndex)
+        local displayFlags = ____exports.getRoomDisplayFlags(nil, roomGridIndex, minimapAPI)
         displayFlagsMap:set(roomGridIndex, displayFlags)
     end
     return displayFlagsMap

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

@@ -1,4 +1,4 @@
-import { ActiveSlot } from "isaac-typescript-definitions";
+import { ActiveSlot, CollectibleType } from "isaac-typescript-definitions";
 /**
  * Helper function to add a charge to the player's active item. Will flash the HUD and play the
  * appropriate sound effect, depending on whether the charge is partially full or completely full.
@@ -90,6 +90,12 @@ export declare function getChargesAwayFromMax(player: EntityPlayer, activeSlot?:
  * @param activeSlot Optional. The slot to get the charges from. Default is `ActiveSlot.PRIMARY`.
  */
 export declare function getTotalCharge(player: EntityPlayer, activeSlot?: ActiveSlot): int;
+/**
+ * Helper function to find the active slots that the player has the corresponding collectible type
+ * in and have enough charge to be used. Returns an empty array if the player does not have the
+ * collectible in any active slot or does not have enough charges.
+ */
+export declare function getUsableActiveItemSlots(player: EntityPlayer, collectibleType: CollectibleType): ActiveSlot[];
 /**
  * Helper function to check if a player's active item is "double charged", meaning that it has both
  * a full normal charge and a full charge from The Battery.

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

@@ -1 +1 @@
-{"version":3,"file":"charge.d.ts","sourceRoot":"","sources":["../../../src/functions/charge.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EAKX,MAAM,8BAA8B,CAAC;AAStC;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,YAAY,EACpB,UAAU,aAAqB,EAC/B,UAAU,SAAI,EACd,eAAe,UAAO,GACrB,GAAG,CA+BL;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,EACpB,mBAAmB,UAAO,EAC1B,eAAe,UAAO,GACrB,IAAI,CAaN;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,YAAY,EACpB,UAAU,aAAqB,EAC/B,mBAAmB,UAAO,EAC1B,eAAe,UAAO,GACrB,IAAI,CA4BN;AAqBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,mBAAmB,UAAO,GAAG,IAAI,CAIpE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,YAAY,EACpB,UAAU,aAAqB,GAC9B,GAAG,CAQL;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,YAAY,EACpB,UAAU,aAAqB,GAC9B,GAAG,CAKL;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,YAAY,EACpB,UAAU,aAAqB,GAC9B,OAAO,CAMT;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,YAAY,EACpB,UAAU,aAAqB,GAC9B,IAAI,CAYN"}
+{"version":3,"file":"charge.d.ts","sourceRoot":"","sources":["../../../src/functions/charge.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,eAAe,EAIhB,MAAM,8BAA8B,CAAC;AAUtC;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,YAAY,EACpB,UAAU,aAAqB,EAC/B,UAAU,SAAI,EACd,eAAe,UAAO,GACrB,GAAG,CA+BL;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,EACpB,mBAAmB,UAAO,EAC1B,eAAe,UAAO,GACrB,IAAI,CAaN;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,YAAY,EACpB,UAAU,aAAqB,EAC/B,mBAAmB,UAAO,EAC1B,eAAe,UAAO,GACrB,IAAI,CA4BN;AAqBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,mBAAmB,UAAO,GAAG,IAAI,CAIpE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,YAAY,EACpB,UAAU,aAAqB,GAC9B,GAAG,CAQL;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,YAAY,EACpB,UAAU,aAAqB,GAC9B,GAAG,CAKL;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,YAAY,EACpB,eAAe,EAAE,eAAe,GAC/B,UAAU,EAAE,CAOd;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,YAAY,EACpB,UAAU,aAAqB,GAC9B,OAAO,CAMT;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,YAAY,EACpB,UAAU,aAAqB,GAC9B,IAAI,CAYN"}

package/dist/src/functions/charge.lua

@@ -1,3 +1,5 @@
+local ____lualib = require("lualib_bundle")
+local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
 local ____exports = {}
 local getChargesToAddWithAAAModifier, shouldPlayFullRechargeSound
 local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
@@ -14,6 +16,8 @@ local getCollectibleChargeType = ____collectibles.getCollectibleChargeType
 local getCollectibleMaxCharges = ____collectibles.getCollectibleMaxCharges
 local ____playerIndex = require("src.functions.playerIndex")
 local getPlayers = ____playerIndex.getPlayers
+local ____players = require("src.functions.players")
+local getActiveItemSlots = ____players.getActiveItemSlots
 local ____roomShape = require("src.functions.roomShape")
 local getRoomShapeCharges = ____roomShape.getRoomShapeCharges
 --- Helper function to add a charge to the player's active item. Will flash the HUD and play the
@@ -227,6 +231,20 @@ function ____exports.addRoomClearCharges(self, bigRoomDoubleCharge)
         ____exports.addRoomClearCharge(nil, player, bigRoomDoubleCharge)
     end
 end
+--- Helper function to find the active slots that the player has the corresponding collectible type
+-- in and have enough charge to be used. Returns an empty array if the player does not have the
+-- collectible in any active slot or does not have enough charges.
+function ____exports.getUsableActiveItemSlots(self, player, collectibleType)
+    local maxCharges = getCollectibleMaxCharges(nil, collectibleType)
+    local activeSlots = getActiveItemSlots(nil, player, collectibleType)
+    return __TS__ArrayFilter(
+        activeSlots,
+        function(____, activeSlot)
+            local totalCharge = ____exports.getTotalCharge(nil, player, activeSlot)
+            return totalCharge >= maxCharges
+        end
+    )
+end
 --- Helper function to check if a player's active item is "double charged", meaning that it has both
 -- a full normal charge and a full charge from The Battery.
 -- 

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

@@ -38,8 +38,11 @@ export declare function clearRoomDisplayFlags(roomGridIndex: int): void;
  * that is indexed by the room's safe grid index.
  *
  * This function automatically accounts for whether or not MinimapAPI is being used.
+ *
+ * @param minimapAPI Optional. Whether or not MinimapAPI should be used, if present. Default is
+ *                   true.
  */
-export declare function getFloorDisplayFlags(): Map<int, BitFlags<DisplayFlag>>;
+export declare function getFloorDisplayFlags(minimapAPI?: boolean): Map<int, BitFlags<DisplayFlag>>;
 /**
  * Helper function to get a particular room's minimap display flags (e.g. whether or not it is
  * visible and so on).
@@ -47,8 +50,10 @@ export declare function getFloorDisplayFlags(): Map<int, BitFlags<DisplayFlag>>;
  * This function automatically accounts for whether or not MinimapAPI is being used.
  *
  * @param roomGridIndex Optional. Default is the current room index.
+ * @param minimapAPI Optional. Whether or not MinimapAPI should be used, if present. Default is
+ *                   true.
  */
-export declare function getRoomDisplayFlags(roomGridIndex?: int): BitFlags<DisplayFlag>;
+export declare function getRoomDisplayFlags(roomGridIndex?: int, minimapAPI?: boolean): BitFlags<DisplayFlag>;
 /**
  * Helper function to hide a specific room on the minimap.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"minimap.d.ts","sourceRoot":"","sources":["../../../src/functions/minimap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAmB,MAAM,8BAA8B,CAAC;AAM5E;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,GAAG,GAAG,SAAS,EAC9B,WAAW,EAAE,WAAW,EACxB,gBAAgB,UAAO,GACtB,IAAI,CAIN;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,GAAG,GAAG,IAAI,CAE9D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,CAUtE;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,CAAC,EAAE,GAAG,GAClB,QAAQ,CAAC,WAAW,CAAC,CAiBvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,GAAG,GAAG,IAAI,CAe1D;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,IAAI,CAW5E;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,eAAe,EAAE,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,GAC/C,IAAI,CAWN;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,GAAG,GAAG,SAAS,EAC9B,YAAY,EAAE,QAAQ,CAAC,WAAW,CAAC,EACnC,gBAAgB,UAAO,GACtB,IAAI,CAsBN"}
+{"version":3,"file":"minimap.d.ts","sourceRoot":"","sources":["../../../src/functions/minimap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAmB,MAAM,8BAA8B,CAAC;AAM5E;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,GAAG,GAAG,SAAS,EAC9B,WAAW,EAAE,WAAW,EACxB,gBAAgB,UAAO,GACtB,IAAI,CAIN;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,GAAG,GAAG,IAAI,CAE9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,UAAO,GAChB,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,CAUjC;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,CAAC,EAAE,GAAG,EACnB,UAAU,UAAO,GAChB,QAAQ,CAAC,WAAW,CAAC,CAiBvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,GAAG,GAAG,IAAI,CAe1D;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,IAAI,CAW5E;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,eAAe,EAAE,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,GAC/C,IAAI,CAWN;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,GAAG,GAAG,SAAS,EAC9B,YAAY,EAAE,QAAQ,CAAC,WAAW,CAAC,EACnC,gBAAgB,UAAO,GACtB,IAAI,CAsBN"}

package/dist/src/functions/minimap.lua

@@ -20,11 +20,16 @@ local getRoomsInsideGrid = ____rooms.getRoomsInsideGrid
 -- This function automatically accounts for whether or not MinimapAPI is being used.
 -- 
 -- @param roomGridIndex Optional. Default is the current room index.
-function ____exports.getRoomDisplayFlags(self, roomGridIndex)
+-- @param minimapAPI Optional. Whether or not MinimapAPI should be used, if present. Default is
+-- true.
+function ____exports.getRoomDisplayFlags(self, roomGridIndex, minimapAPI)
+    if minimapAPI == nil then
+        minimapAPI = true
+    end
     if roomGridIndex == nil then
         roomGridIndex = getRoomGridIndex(nil)
     end
-    if MinimapAPI == nil then
+    if MinimapAPI == nil or not minimapAPI then
         local roomDescriptor = getRoomDescriptor(nil, roomGridIndex)
         return roomDescriptor.DisplayFlags
     end
@@ -125,11 +130,17 @@ end
 -- that is indexed by the room's safe grid index.
 -- 
 -- This function automatically accounts for whether or not MinimapAPI is being used.
-function ____exports.getFloorDisplayFlags(self)
+-- 
+-- @param minimapAPI Optional. Whether or not MinimapAPI should be used, if present. Default is
+-- true.
+function ____exports.getFloorDisplayFlags(self, minimapAPI)
+    if minimapAPI == nil then
+        minimapAPI = true
+    end
     local displayFlagsMap = __TS__New(Map)
     for ____, roomDescriptor in ipairs(getRoomsInsideGrid(nil)) do
         local roomGridIndex = roomDescriptor.SafeGridIndex
-        local displayFlags = ____exports.getRoomDisplayFlags(nil, roomGridIndex)
+        local displayFlags = ____exports.getRoomDisplayFlags(nil, roomGridIndex, minimapAPI)
         displayFlagsMap:set(roomGridIndex, displayFlags)
     end
     return displayFlagsMap

package/package.json

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

package/src/functions/charge.ts

@@ -11,6 +11,7 @@ import {
   getCollectibleMaxCharges,
 } from "./collectibles";
 import { getPlayers } from "./playerIndex";
+import { getActiveItemSlots } from "./players";
 import { getRoomShapeCharges } from "./roomShape";
 
 /**
@@ -238,6 +239,23 @@ export function getTotalCharge(
   return activeCharge + batteryCharge;
 }
 
+/**
+ * Helper function to find the active slots that the player has the corresponding collectible type
+ * in and have enough charge to be used. Returns an empty array if the player does not have the
+ * collectible in any active slot or does not have enough charges.
+ */
+export function getUsableActiveItemSlots(
+  player: EntityPlayer,
+  collectibleType: CollectibleType,
+): ActiveSlot[] {
+  const maxCharges = getCollectibleMaxCharges(collectibleType);
+  const activeSlots = getActiveItemSlots(player, collectibleType);
+  return activeSlots.filter((activeSlot) => {
+    const totalCharge = getTotalCharge(player, activeSlot);
+    return totalCharge >= maxCharges;
+  });
+}
+
 /**
  * Helper function to check if a player's active item is "double charged", meaning that it has both
  * a full normal charge and a full charge from The Battery.

package/src/functions/minimap.ts

@@ -58,13 +58,18 @@ export function clearRoomDisplayFlags(roomGridIndex: int): void {
  * that is indexed by the room's safe grid index.
  *
  * This function automatically accounts for whether or not MinimapAPI is being used.
+ *
+ * @param minimapAPI Optional. Whether or not MinimapAPI should be used, if present. Default is
+ *                   true.
  */
-export function getFloorDisplayFlags(): Map<int, BitFlags<DisplayFlag>> {
+export function getFloorDisplayFlags(
+  minimapAPI = true,
+): Map<int, BitFlags<DisplayFlag>> {
   const displayFlagsMap = new Map<int, BitFlags<DisplayFlag>>();
 
   for (const roomDescriptor of getRoomsInsideGrid()) {
     const roomGridIndex = roomDescriptor.SafeGridIndex;
-    const displayFlags = getRoomDisplayFlags(roomGridIndex);
+    const displayFlags = getRoomDisplayFlags(roomGridIndex, minimapAPI);
     displayFlagsMap.set(roomGridIndex, displayFlags);
   }
 
@@ -78,15 +83,18 @@ export function getFloorDisplayFlags(): Map<int, BitFlags<DisplayFlag>> {
  * This function automatically accounts for whether or not MinimapAPI is being used.
  *
  * @param roomGridIndex Optional. Default is the current room index.
+ * @param minimapAPI Optional. Whether or not MinimapAPI should be used, if present. Default is
+ *                   true.
  */
 export function getRoomDisplayFlags(
   roomGridIndex?: int,
+  minimapAPI = true,
 ): BitFlags<DisplayFlag> {
   if (roomGridIndex === undefined) {
     roomGridIndex = getRoomGridIndex();
   }
 
-  if (MinimapAPI === undefined) {
+  if (MinimapAPI === undefined || !minimapAPI) {
     const roomDescriptor = getRoomDescriptor(roomGridIndex);
     return roomDescriptor.DisplayFlags;
   }