isaacscript-common 9.13.1 → 9.13.4

package/dist/callbacks/customRevive.lua

@@ -116,14 +116,17 @@ function playerIsAboutToDie(self, player)
             if futurePlayer:IsDead() then
                 return
             end
-            logError("The player is still alive after initializing a custom revive. Explicitly killing the player.")
+            logError(nil, "The player is still alive after initializing a custom revive. Explicitly killing the player.")
             futurePlayer:Kill()
         end
     )
 end
 function logStateChanged(self)
     if DEBUG then
-        log(((("Custom revive state changed: " .. tostring(CustomReviveState[v.run.state])) .. " (") .. tostring(v.run.state)) .. ")")
+        log(
+            nil,
+            ((("Custom revive state changed: " .. tostring(CustomReviveState[v.run.state])) .. " (") .. tostring(v.run.state)) .. ")"
+        )
     end
 end
 DEBUG = false

package/dist/callbacks/postNewRoomEarly.lua

@@ -38,14 +38,14 @@ function checkRoomChanged(self)
     if topLeftWall == nil then
         topLeftWall = spawnGridEntity(nil, GridEntityType.WALL, topLeftWallGridIndex)
         if topLeftWall == nil then
-            logError("Failed to spawn a new wall (1) for the POST_NEW_ROOM_EARLY callback.")
+            logError(nil, "Failed to spawn a new wall (1) for the POST_NEW_ROOM_EARLY callback.")
             return
         end
     end
     if topLeftWall2 == nil then
         topLeftWall2 = spawnGridEntity(nil, GridEntityType.WALL, rightOfTopWallGridIndex)
         if topLeftWall2 == nil then
-            logError("Failed to spawn a new wall (2) for the POST_NEW_ROOM_EARLY callback.")
+            logError(nil, "Failed to spawn a new wall (2) for the POST_NEW_ROOM_EARLY callback.")
             return
         end
     end

package/dist/features/customPickup.d.ts

@@ -22,5 +22,5 @@ import { PickupVariant } from "isaac-typescript-definitions";
  *                      this function if your pickup should only be able to be collected under
  *                      certain conditions.
  */
-export declare function registerCustomPickup(pickupVariantCustom: PickupVariant, subType: int, collectFunc: (player: EntityPlayer) => void, collisionFunc?: (player: EntityPlayer) => boolean): void;
+export declare function registerCustomPickup(pickupVariantCustom: PickupVariant, subType: int, collectFunc: (this: void, player: EntityPlayer) => void, collisionFunc?: (this: void, player: EntityPlayer) => boolean): void;
 //# sourceMappingURL=customPickup.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"customPickup.d.ts","sourceRoot":"","sources":["../../src/features/customPickup.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,aAAa,EACd,MAAM,8BAA8B,CAAC;AA4FtC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,oBAAoB,CAClC,mBAAmB,EAAE,aAAa,EAClC,OAAO,EAAE,GAAG,EACZ,WAAW,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,EAC3C,aAAa,GAAE,CAAC,MAAM,EAAE,YAAY,KAAK,OAAoB,GAC5D,IAAI,CAaN"}
+{"version":3,"file":"customPickup.d.ts","sourceRoot":"","sources":["../../src/features/customPickup.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,aAAa,EACd,MAAM,8BAA8B,CAAC;AA6FtC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,oBAAoB,CAClC,mBAAmB,EAAE,aAAa,EAClC,OAAO,EAAE,GAAG,EACZ,WAAW,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,KAAK,IAAI,EACvD,aAAa,GAAE,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,KAAK,OAAoB,GACxE,IAAI,CAaN"}

package/dist/features/customPickup.lua

@@ -24,7 +24,7 @@ function prePickupCollision(self, pickup, collider)
     if player == nil then
         return nil
     end
-    local shouldPickup = customPickupFunctions:collisionFunc(player)
+    local shouldPickup = customPickupFunctions.collisionFunc(player)
     if not shouldPickup then
         return nil
     end
@@ -35,7 +35,7 @@ function prePickupCollision(self, pickup, collider)
     local effectSprite = effect:GetSprite()
     effectSprite:Load(fileName, true)
     effectSprite:Play("Collect", true)
-    customPickupFunctions:collectFunc(player)
+    customPickupFunctions.collectFunc(player)
     return nil
 end
 function postEffectRenderPickupEffect(self, effect)

package/dist/features/customStage/customStageUtils.lua

@@ -57,11 +57,17 @@ function ____exports.getRandomCustomStageRoom(self, roomsMetadata, seedOrRNG, ve
     end
     local totalWeight = getTotalWeightOfCustomStageRooms(nil, roomsMetadata)
     if verbose then
-        log("Total weight of the custom stage rooms provided: " .. tostring(totalWeight))
+        log(
+            nil,
+            "Total weight of the custom stage rooms provided: " .. tostring(totalWeight)
+        )
     end
     local chosenWeight = getRandomFloat(nil, 0, totalWeight, seedOrRNG)
     if verbose then
-        log("Randomly chose weight for custom stage room: " .. tostring(chosenWeight))
+        log(
+            nil,
+            "Randomly chose weight for custom stage room: " .. tostring(chosenWeight)
+        )
     end
     return getCustomStageRoomWithChosenWeight(nil, roomsMetadata, chosenWeight)
 end
@@ -74,11 +80,17 @@ function ____exports.getRandomBossRoomFromPool(self, roomsMetadata, bossPool, se
     end
     local totalWeight = getTotalWeightOfBossPool(nil, bossPool)
     if verbose then
-        log("Total weight of the custom stage boss pool provided: " .. tostring(totalWeight))
+        log(
+            nil,
+            "Total weight of the custom stage boss pool provided: " .. tostring(totalWeight)
+        )
     end
     local chosenWeight = getRandomFloat(nil, 0, totalWeight, seedOrRNG)
     if verbose then
-        log("Randomly chose weight for custom stage boss pool: " .. tostring(chosenWeight))
+        log(
+            nil,
+            "Randomly chose weight for custom stage boss pool: " .. tostring(chosenWeight)
+        )
     end
     local bossEntry = getBossEntryWithChosenWeight(nil, bossPool, chosenWeight)
     local roomsMetadataForBoss = __TS__ArrayFilter(

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;;;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"}
+{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../../../src/features/customStage/exports.ts"],"names":[],"mappings":"AAAA;;;;;;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

@@ -48,20 +48,29 @@ function setStageRoomsData(self, customStage, rng, verbose)
             local roomShapeMap = customStage.roomTypeMap:get(roomType)
             if roomShapeMap == nil then
                 if roomType == RoomType.DEFAULT then
-                    logError((((("Failed to find any custom rooms for RoomType." .. tostring(RoomType[roomType])) .. " (") .. tostring(roomType)) .. ") for custom stage: ") .. customStage.name)
+                    logError(
+                        nil,
+                        (((("Failed to find any custom rooms for RoomType." .. tostring(RoomType[roomType])) .. " (") .. tostring(roomType)) .. ") for custom stage: ") .. customStage.name
+                    )
                 end
                 goto __continue7
             end
             local roomShape = room.Data.Shape
             local roomDoorSlotFlagMap = roomShapeMap:get(roomShape)
             if roomDoorSlotFlagMap == nil then
-                logError((((((((("Failed to find any custom rooms for RoomType." .. tostring(RoomType[roomType])) .. " (") .. tostring(roomType)) .. ") + RoomShape.") .. tostring(RoomShape[roomShape])) .. " (") .. tostring(roomShape)) .. ") for custom stage: ") .. customStage.name)
+                logError(
+                    nil,
+                    (((((((("Failed to find any custom rooms for RoomType." .. tostring(RoomType[roomType])) .. " (") .. tostring(roomType)) .. ") + RoomShape.") .. tostring(RoomShape[roomShape])) .. " (") .. tostring(roomShape)) .. ") for custom stage: ") .. customStage.name
+                )
                 goto __continue7
             end
             local doorSlotFlags = room.Data.Doors
             local roomsMetadata = roomDoorSlotFlagMap:get(doorSlotFlags)
             if roomsMetadata == nil then
-                logError((((((((((("Failed to find any custom rooms for RoomType." .. tostring(RoomType[roomType])) .. " (") .. tostring(roomType)) .. ") + RoomShape.") .. tostring(RoomShape[roomShape])) .. " (") .. tostring(roomShape)) .. ") + DoorSlotFlags ") .. tostring(doorSlotFlags)) .. " for custom stage: ") .. customStage.name)
+                logError(
+                    nil,
+                    (((((((((("Failed to find any custom rooms for RoomType." .. tostring(RoomType[roomType])) .. " (") .. tostring(roomType)) .. ") + RoomShape.") .. tostring(RoomShape[roomShape])) .. " (") .. tostring(roomShape)) .. ") + DoorSlotFlags ") .. tostring(doorSlotFlags)) .. " for custom stage: ") .. customStage.name
+                )
                 local header = ("For reference, a DoorSlotFlags of " .. tostring(doorSlotFlags)) .. " is equal to the following doors being enabled:\n"
                 local doorSlots = doorSlotFlagsToDoorSlots(nil, doorSlotFlags)
                 local doorSlotLines = __TS__ArrayMap(
@@ -69,7 +78,7 @@ function setStageRoomsData(self, customStage, rng, verbose)
                     function(____, doorSlot) return ((("- DoorSlot." .. tostring(DoorSlot[doorSlot])) .. " (") .. tostring(doorSlot)) .. ")" end
                 )
                 local explanation = header .. table.concat(doorSlotLines, "\n")
-                logError(explanation)
+                logError(nil, explanation)
                 goto __continue7
             end
             local randomRoom
@@ -91,7 +100,10 @@ function setStageRoomsData(self, customStage, rng, verbose)
             if newRoomData == nil then
                 newRoomData = getRoomDataForTypeVariant(nil, roomType, randomRoom.variant, false)
                 if newRoomData == nil then
-                    logError((("Failed to get the room data for room variant " .. tostring(randomRoom.variant)) .. " for custom stage: ") .. customStage.name)
+                    logError(
+                        nil,
+                        (("Failed to get the room data for room variant " .. tostring(randomRoom.variant)) .. " for custom stage: ") .. customStage.name
+                    )
                     goto __continue7
                 end
                 customStageCachedRoomData:set(randomRoom.variant, newRoomData)

package/dist/features/deployJSONRoom.lua

@@ -244,7 +244,10 @@ function spawnAllEntities(self, jsonRoom, rng, verbose)
         if entityTypeNumber >= 1000 then
             local gridEntityXMLType = entityTypeNumber
             if verbose then
-                log(((((((("Spawning grid entity " .. tostring(gridEntityXMLType)) .. ".") .. tostring(variant)) .. " at: (") .. tostring(x)) .. ", ") .. tostring(y)) .. ")")
+                log(
+                    nil,
+                    ((((((("Spawning grid entity " .. tostring(gridEntityXMLType)) .. ".") .. tostring(variant)) .. " at: (") .. tostring(x)) .. ", ") .. tostring(y)) .. ")"
+                )
             end
             spawnGridEntityForJSONRoom(
                 nil,
@@ -257,7 +260,10 @@ function spawnAllEntities(self, jsonRoom, rng, verbose)
             local entityType = entityTypeNumber
             if verbose then
                 local entityID = getEntityIDFromConstituents(nil, entityType, variant, subType)
-                log(((((("Spawning normal entity " .. entityID) .. " at: (") .. tostring(x)) .. ", ") .. tostring(y)) .. ")")
+                log(
+                    nil,
+                    ((((("Spawning normal entity " .. entityID) .. " at: (") .. tostring(x)) .. ", ") .. tostring(y)) .. ")"
+                )
             end
             local entity = spawnNormalEntityForJSONRoom(
                 nil,
@@ -276,11 +282,11 @@ function spawnAllEntities(self, jsonRoom, rng, verbose)
     end
     if shouldUnclearRoom then
         if verbose then
-            log("Setting the room to be uncleared since there were one or more battle NPCs spawned.")
+            log(nil, "Setting the room to be uncleared since there were one or more battle NPCs spawned.")
         end
         setRoomUncleared(nil)
     elseif verbose then
-        log("Leaving the room cleared since there were no battle NPCs spawned.")
+        log(nil, "Leaving the room cleared since there were no battle NPCs spawned.")
     end
 end
 function spawnGridEntityForJSONRoom(self, gridEntityXMLType, gridEntityXMLVariant, x, y)
@@ -511,18 +517,18 @@ function ____exports.deployJSONRoom(self, jsonRoom, seedOrRNG, verbose)
     errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
     local rng = isRNG(nil, seedOrRNG) and seedOrRNG or newRNG(nil, seedOrRNG)
     if verbose then
-        log("Starting to empty the room of entities and grid entities.")
+        log(nil, "Starting to empty the room of entities and grid entities.")
     end
     ____exports.emptyRoom(nil, false)
     if verbose then
-        log("Finished emptying the room of entities and grid entities.")
+        log(nil, "Finished emptying the room of entities and grid entities.")
     end
     if verbose then
-        log("Starting to spawn all of the new entities and grid entities.")
+        log(nil, "Starting to spawn all of the new entities and grid entities.")
     end
     spawnAllEntities(nil, jsonRoom, rng, verbose)
     if verbose then
-        log("Finished spawning all of the new entities and grid entities.")
+        log(nil, "Finished spawning all of the new entities and grid entities.")
     end
     fixPitGraphics(nil)
     fillRoomWithDecorations(nil)
@@ -563,7 +569,7 @@ function ____exports.deployRandomJSONRoom(self, jsonRooms, seedOrRNG, verbose)
     local rng = isRNG(nil, seedOrRNG) and seedOrRNG or newRNG(nil, seedOrRNG)
     local randomJSONRoom = getRandomJSONRoom(nil, jsonRooms, rng, verbose)
     if verbose then
-        log((((((("Randomly chose JSON room " .. randomJSONRoom["$"].type) .. ".") .. randomJSONRoom["$"].variant) .. ".") .. randomJSONRoom["$"].subtype) .. " with name: ") .. randomJSONRoom["$"].name)
+        log(nil, (((((("Randomly chose JSON room " .. randomJSONRoom["$"].type) .. ".") .. randomJSONRoom["$"].variant) .. ".") .. randomJSONRoom["$"].subtype) .. " with name: ") .. randomJSONRoom["$"].name)
     end
     return ____exports.deployJSONRoom(nil, randomJSONRoom, rng, verbose)
 end

package/dist/features/extraConsoleCommands/commandsSubroutines.lua

@@ -72,7 +72,7 @@ function ____exports.listEntities(self, params, includeBackgroundEffects)
             return
         end
     end
-    logAllEntities(includeBackgroundEffects, entityTypeFilter)
+    logAllEntities(nil, includeBackgroundEffects, entityTypeFilter)
     printConsole(nil, "Logged the entities in the room to the \"log.txt\" file.")
 end
 function ____exports.listGridEntities(self, params, includeWalls)
@@ -84,7 +84,7 @@ function ____exports.listGridEntities(self, params, includeWalls)
             return
         end
     end
-    logAllGridEntities(includeWalls, gridEntityTypeFilter)
+    logAllGridEntities(nil, includeWalls, gridEntityTypeFilter)
     printConsole(nil, "Logged the grid entities in the room to the \"log.txt\" file.")
 end
 function ____exports.movePlayer(self, params, direction)

package/dist/features/extraConsoleCommands/listCommands.lua

@@ -550,7 +550,7 @@ end
 --- Logs the player's current temporary effects to the "log.txt" file.
 function ____exports.effects(self)
     local player = Isaac.GetPlayer()
-    logPlayerEffects(player)
+    logPlayerEffects(nil, player)
     printConsole(nil, "Logged the player's effects to the \"log.txt\" file.")
 end
 --- Alias for the "iAmError" command.
@@ -900,7 +900,7 @@ function ____exports.right(self, params)
 end
 --- Logs information about the room to the "log.txt" file.
 function ____exports.room(self)
-    logRoom()
+    logRoom(nil)
     printConsole(nil, "Logged room information to the \"log.txt\" file.")
 end
 --- Gives a rotten heart. Provide a number to give a custom amount of hearts. (You can use negative
@@ -970,7 +970,7 @@ function ____exports.seedStick(self)
 end
 --- Logs all of the current run's seed effects to the "log.txt" file.
 function ____exports.seeds(self)
-    logSeedEffects()
+    logSeedEffects(nil)
     printConsole(nil, "Logged the seed effects to the \"log.txt\" file.")
 end
 --- Sets a charge to the player's specified active item. You must provide the active slot number and
@@ -1090,7 +1090,7 @@ function ____exports.soulHearts(self, params)
 end
 --- Logs all of the currently playing sound effects to the "log.txt" file.
 function ____exports.sounds(self)
-    logSounds()
+    logSounds(nil)
     printConsole(nil, "Logged the currently playing sound effects to the \"log.txt\" file.")
 end
 --- Toggles spamming Blood Rights on every frame. Useful for killing enemies very fast without using

package/dist/features/pause.lua

@@ -99,7 +99,7 @@ end
 -- - disables any player inputs (except for `ButtonAction.MENU_CONFIRM` and `ButtonAction.CONSOLE`)
 function ____exports.pause(self)
     if v.run.isPseudoPaused then
-        logError("Failed to pseudo-pause the game, since it was already pseudo-paused.")
+        logError(nil, "Failed to pseudo-pause the game, since it was already pseudo-paused.")
         return
     end
     v.run.isPseudoPaused = true
@@ -135,7 +135,7 @@ end
 --- Helper function to put things back to normal after the `pause` function was used.
 function ____exports.unpause(self)
     if not v.run.isPseudoPaused then
-        logError("Failed to pseudo-unpause the game, since it was not already pseudo-paused.")
+        logError(nil, "Failed to pseudo-unpause the game, since it was not already pseudo-paused.")
         return
     end
     v.run.isPseudoPaused = false

package/dist/features/saveDataManager/load.lua

@@ -21,7 +21,10 @@ function readSaveDatFile(self, mod)
     local renderFrameCount = Isaac.GetFrameCount()
     local ok, jsonStringOrErrMsg = pcall(tryLoadModData, mod)
     if not ok then
-        logError((("Failed to read from the \"save#.dat\" file on render frame " .. tostring(renderFrameCount)) .. ": ") .. jsonStringOrErrMsg)
+        logError(
+            nil,
+            (("Failed to read from the \"save#.dat\" file on render frame " .. tostring(renderFrameCount)) .. ": ") .. jsonStringOrErrMsg
+        )
         return DEFAULT_MOD_DATA
     end
     if jsonStringOrErrMsg == nil then
@@ -44,7 +47,7 @@ function ____exports.loadFromDisk(self, mod, oldSaveData)
     local jsonString = readSaveDatFile(nil, mod)
     local newSaveData = jsonDecode(nil, jsonString)
     if SAVE_DATA_MANAGER_DEBUG then
-        log("Converted data from the \"save#.dat\" to a Lua table.")
+        log(nil, "Converted data from the \"save#.dat\" to a Lua table.")
     end
     iterateTableInOrder(
         nil,
@@ -61,12 +64,12 @@ function ____exports.loadFromDisk(self, mod, oldSaveData)
                 return
             end
             if SAVE_DATA_MANAGER_DEBUG then
-                log("Merging in stored data for feature: " .. key)
+                log(nil, "Merging in stored data for feature: " .. key)
             end
             merge(nil, oldSaveDataForSubscriber, value, key)
         end,
         SAVE_DATA_MANAGER_DEBUG
     )
-    log(("The " .. SAVE_DATA_MANAGER_FEATURE_NAME) .. " loaded data from the \"save#.dat\" file.")
+    log(nil, ("The " .. SAVE_DATA_MANAGER_FEATURE_NAME) .. " loaded data from the \"save#.dat\" file.")
 end
 return ____exports

package/dist/features/saveDataManager/main.lua

@@ -93,12 +93,12 @@ function ____exports.restoreDefaultSaveData(self, subscriberName, saveData, save
     end
     local saveDataDefaults = saveDataDefaultsMap[subscriberName]
     if saveDataDefaults == nil then
-        logError("Failed to find the default copy of the save data for subscriber: " .. subscriberName)
+        logError(nil, "Failed to find the default copy of the save data for subscriber: " .. subscriberName)
         return
     end
     local childTableDefaults = saveDataDefaults[saveDataKey]
     if childTableDefaults == nil then
-        logError(((("Failed to find the default copy of the child table \"" .. saveDataKey) .. "\" for subscriber \"") .. subscriberName) .. "\". This error usually means that your save data is out of date. You can try purging all of your save data by deleting the following directory: C:\\Program Files (x86)\\Steam\\steamapps\\common\\The Binding of Isaac Rebirth\\data")
+        logError(nil, ((("Failed to find the default copy of the child table \"" .. saveDataKey) .. "\" for subscriber \"") .. subscriberName) .. "\". This error usually means that your save data is out of date. You can try purging all of your save data by deleting the following directory: C:\\Program Files (x86)\\Steam\\steamapps\\common\\The Binding of Isaac Rebirth\\data")
         return
     end
     local childTableDefaultsCopy = deepCopy(nil, childTableDefaults, SerializationType.NONE, (subscriberName .. " --> ") .. saveDataKey)

package/dist/features/saveDataManager/merge.lua

@@ -54,7 +54,7 @@ local isSerializationBrand = ____serializationBrands.isSerializationBrand
 -- run-time errors. In such cases, users will have to manually delete their save data.
 function ____exports.merge(self, oldObject, newTable, traversalDescription)
     if SAVE_DATA_MANAGER_DEBUG then
-        log("merge is traversing: " .. traversalDescription)
+        log(nil, "merge is traversing: " .. traversalDescription)
     end
     if not isTable(nil, oldObject) then
         error("The first argument given to the merge function is not a table.")
@@ -123,14 +123,14 @@ function mergeTable(self, oldTable, newTable, traversalDescription)
         function(____, key, value)
             if SAVE_DATA_MANAGER_DEBUG then
                 local valueToPrint = value == "" and "(empty string)" or tostring(value)
-                log((("merge is merging: " .. traversalDescription) .. " --> ") .. valueToPrint)
+                log(nil, (("merge is merging: " .. traversalDescription) .. " --> ") .. valueToPrint)
             end
             if isSerializationBrand(nil, key) then
                 return
             end
             if isSerializedIsaacAPIClass(nil, value) then
                 if SAVE_DATA_MANAGER_DEBUG then
-                    log("merge found a serialized Isaac API class.")
+                    log(nil, "merge found a serialized Isaac API class.")
                 end
                 local deserializedObject = deserializeIsaacAPIClass(nil, value)
                 oldTable[key] = deserializedObject

package/dist/features/saveDataManager/save.lua

@@ -43,6 +43,6 @@ function ____exports.saveToDisk(self, mod, saveDataMap, saveDataConditionalFuncM
     local allSaveData = getAllSaveDataToWriteToDisk(nil, saveDataMap, saveDataConditionalFuncMap)
     local jsonString = jsonEncode(nil, allSaveData)
     mod:SaveData(jsonString)
-    log(("The " .. SAVE_DATA_MANAGER_FEATURE_NAME) .. " wrote data to the \"save#.dat\" file.")
+    log(nil, ("The " .. SAVE_DATA_MANAGER_FEATURE_NAME) .. " wrote data to the \"save#.dat\" file.")
 end
 return ____exports

package/dist/features/taintedLazarusPlayers.lua

@@ -37,7 +37,7 @@ function checkDequeue(self)
     local taintedLazarusPtrHash = GetPtrHash(taintedLazarus)
     local deadTaintedLazarusPtrHash = GetPtrHash(deadTaintedLazarus)
     if taintedLazarusPtrHash == deadTaintedLazarusPtrHash then
-        logError("Failed to cache the Tainted Lazarus player objects, since the hash for Tainted Lazarus and Dead Tainted Lazarus were the same.")
+        logError(nil, "Failed to cache the Tainted Lazarus player objects, since the hash for Tainted Lazarus and Dead Tainted Lazarus were the same.")
         return
     end
     v.run.subPlayerMap:set(taintedLazarusPtrHash, deadTaintedLazarus)

package/dist/functions/benchmark.lua

@@ -16,7 +16,10 @@ local log = ____log.log
 -- be printed to the log.)
 function ____exports.benchmark(self, numTrials, ...)
     local functions = {...}
-    log(((("Benchmarking " .. tostring(#functions)) .. " function(s) with ") .. tostring(numTrials)) .. " trials.")
+    log(
+        nil,
+        ((("Benchmarking " .. tostring(#functions)) .. " function(s) with ") .. tostring(numTrials)) .. " trials."
+    )
     local averages = {}
     __TS__ArrayForEach(
         functions,
@@ -34,7 +37,10 @@ function ____exports.benchmark(self, numTrials, ...)
                 end
             end
             local averageTimeMilliseconds = totalTimeMilliseconds / numTrials
-            log(((("The average time of the function at index " .. tostring(i)) .. " is: ") .. tostring(averageTimeMilliseconds)) .. " milliseconds")
+            log(
+                nil,
+                ((("The average time of the function at index " .. tostring(i)) .. " is: ") .. tostring(averageTimeMilliseconds)) .. " milliseconds"
+            )
             averages[#averages + 1] = averageTimeMilliseconds
         end
     )

package/dist/functions/debug.lua

@@ -83,7 +83,7 @@ end
 -- enabled.
 function ____exports.traceback(self)
     local tracebackOutput = ____exports.getTraceback(nil)
-    log(tracebackOutput)
+    log(nil, tracebackOutput)
 end
 local function setDebugFunctionsGlobal(self)
     if _G.debug == nil and sandboxGetTraceback == nil then

package/dist/functions/deepCopy.lua

@@ -96,7 +96,7 @@ function ____exports.deepCopy(self, value, serializationType, traversalDescripti
             logString = logString .. " (deserializing)"
         end
         logString = logString .. ": " .. tostring(value)
-        log(logString)
+        log(nil, logString)
     end
     local valueType = type(value)
     repeat
@@ -204,7 +204,7 @@ function deepCopyTable(self, luaMap, serializationType, traversalDescription, in
 end
 function deepCopyDefaultMap(self, defaultMap, serializationType, traversalDescription, insideMap)
     if SAVE_DATA_MANAGER_DEBUG then
-        log("deepCopy is copying a DefaultMap.")
+        log(nil, "deepCopy is copying a DefaultMap.")
     end
     local ____isDefaultMap_result_0
     if isDefaultMap(nil, defaultMap) then
@@ -297,7 +297,7 @@ function getNewDefaultMap(self, defaultMap, serializationType, traversalDescript
 end
 function deepCopyMap(self, map, serializationType, traversalDescription, insideMap)
     if SAVE_DATA_MANAGER_DEBUG then
-        log("deepCopy is copying a Map.")
+        log(nil, "deepCopy is copying a Map.")
     end
     local newMap
     if serializationType == SerializationType.SERIALIZE then
@@ -337,7 +337,7 @@ function deepCopyMap(self, map, serializationType, traversalDescription, insideM
 end
 function deepCopySet(self, set, serializationType, traversalDescription, insideMap)
     if SAVE_DATA_MANAGER_DEBUG then
-        log("deepCopy is copying a Set.")
+        log(nil, "deepCopy is copying a Set.")
     end
     local newSet
     if serializationType == SerializationType.SERIALIZE then
@@ -374,7 +374,7 @@ function deepCopySet(self, set, serializationType, traversalDescription, insideM
 end
 function deepCopyTSTLClass(self, tstlClass, serializationType, traversalDescription, insideMap)
     if SAVE_DATA_MANAGER_DEBUG then
-        log("deepCopy is copying a TSTL class.")
+        log(nil, "deepCopy is copying a TSTL class.")
     end
     local newClass
     if serializationType == SerializationType.SERIALIZE then
@@ -403,7 +403,7 @@ function deepCopyTSTLClass(self, tstlClass, serializationType, traversalDescript
 end
 function deepCopyArray(self, array, serializationType, traversalDescription, insideMap)
     if SAVE_DATA_MANAGER_DEBUG then
-        log("deepCopy is copying an array.")
+        log(nil, "deepCopy is copying an array.")
     end
     local newArray = {}
     for ____, value in ipairs(array) do
@@ -420,7 +420,7 @@ function deepCopyArray(self, array, serializationType, traversalDescription, ins
 end
 function deepCopyNormalLuaTable(self, luaMap, serializationType, traversalDescription, insideMap)
     if SAVE_DATA_MANAGER_DEBUG then
-        log("deepCopy is copying a normal Lua table.")
+        log(nil, "deepCopy is copying a normal Lua table.")
     end
     local newTable = {}
     local ____getCopiedEntries_result_5 = getCopiedEntries(
@@ -517,7 +517,7 @@ function checkMetatable(self, luaMap, traversalDescription)
 end
 function deepCopyUserdata(self, value, serializationType, traversalDescription)
     if SAVE_DATA_MANAGER_DEBUG then
-        log("deepCopy is copying userdata.")
+        log(nil, "deepCopy is copying userdata.")
     end
     local classType = getIsaacAPIClassName(nil, value)
     if classType == nil then

package/dist/functions/deepCopyTests.lua

@@ -373,7 +373,7 @@ function ____exports.runDeepCopyTests(self)
     copiedSerializedDefaultMapHasStringKey(nil)
     copiedSerializedDefaultMapHasNumberKey(nil)
     local successText = "All deep copy tests passed!"
-    log(successText)
+    log(nil, successText)
     printConsole(nil, successText)
 end
 return ____exports

package/dist/functions/globals.lua

@@ -216,9 +216,9 @@ function ____exports.getNewGlobals(self)
 end
 function ____exports.logNewGlobals(self)
     local newGlobals = ____exports.getNewGlobals(nil)
-    log("List of added global variables in the Isaac environment:")
+    log(nil, "List of added global variables in the Isaac environment:")
     if #newGlobals == 0 then
-        log("- n/a (no extra global variables found)")
+        log(nil, "- n/a (no extra global variables found)")
     end
     __TS__ArrayForEach(
         newGlobals,
@@ -227,7 +227,10 @@ function ____exports.logNewGlobals(self)
             local key
             key = ____bindingPattern0[1]
             value = ____bindingPattern0[2]
-            log((((tostring(i + 1) .. ") ") .. tostring(key)) .. " - ") .. tostring(value))
+            log(
+                nil,
+                (((tostring(i + 1) .. ") ") .. tostring(key)) .. " - ") .. tostring(value)
+            )
         end
     )
 end

package/dist/functions/hex.lua

@@ -8,25 +8,28 @@ local logError = ____log.logError
 function hexToRGB(self, hexString)
     hexString = __TS__StringReplace(hexString, "#", "")
     if #hexString ~= HEX_STRING_LENGTH then
-        logError("Hex strings must be of length: " .. tostring(HEX_STRING_LENGTH))
+        logError(
+            nil,
+            "Hex strings must be of length: " .. tostring(HEX_STRING_LENGTH)
+        )
         return {0, 0, 0}
     end
     local rString = __TS__StringSubstring(hexString, 0, 2)
     local r = tonumber("0x" .. rString)
     if r == nil then
-        logError(("Failed to convert `0x" .. rString) .. "` to a number.")
+        logError(nil, ("Failed to convert `0x" .. rString) .. "` to a number.")
         return {0, 0, 0}
     end
     local gString = __TS__StringSubstring(hexString, 2, 4)
     local g = tonumber("0x" .. gString)
     if g == nil then
-        logError(("Failed to convert `0x" .. gString) .. "` to a number.")
+        logError(nil, ("Failed to convert `0x" .. gString) .. "` to a number.")
         return {0, 0, 0}
     end
     local bString = __TS__StringSubstring(hexString, 4, 6)
     local b = tonumber("0x" .. bString)
     if b == nil then
-        logError(("Failed to convert `0x" .. bString) .. "` to a number.")
+        logError(nil, ("Failed to convert `0x" .. bString) .. "` to a number.")
         return {0, 0, 0}
     end
     return {r, g, b}

package/dist/functions/jsonHelpers.lua

@@ -20,7 +20,7 @@ end
 function ____exports.jsonDecode(self, jsonString)
     local ok, luaTableOrErrMsg = pcall(tryDecode, jsonString)
     if not ok then
-        logError("Failed to convert the JSON string to a Lua table: " .. jsonString)
+        logError(nil, "Failed to convert the JSON string to a Lua table: " .. jsonString)
         return {}
     end
     return luaTableOrErrMsg

package/dist/functions/jsonRoom.lua

@@ -142,11 +142,17 @@ function ____exports.getRandomJSONRoom(self, jsonRooms, seedOrRNG, verbose)
     end
     local totalWeight = getTotalWeightOfJSONRooms(nil, jsonRooms)
     if verbose then
-        log("Total weight of the JSON rooms provided: " .. tostring(totalWeight))
+        log(
+            nil,
+            "Total weight of the JSON rooms provided: " .. tostring(totalWeight)
+        )
     end
     local chosenWeight = getRandomFloat(nil, 0, totalWeight, seedOrRNG)
     if verbose then
-        log("Randomly chose weight for JSON room: " .. tostring(chosenWeight))
+        log(
+            nil,
+            "Randomly chose weight for JSON room: " .. tostring(chosenWeight)
+        )
     end
     return getJSONRoomWithChosenWeight(nil, jsonRooms, chosenWeight)
 end

package/dist/functions/levelGrid.d.ts

@@ -165,10 +165,12 @@ export declare function isRoomInsideGrid(roomGridIndex?: int): boolean;
  * The newly created room will have data corresponding to the game's randomly generated red room. If
  * you want to modify this, use the `setRoomData` helper function.
  *
+ * @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided, the
+ *                  `RNG.Next` method will be called. Default is `Level.GetDungeonPlacementSeed`.
  * @returns The room grid index of the new room or undefined if the floor had no valid dead ends to
  *          place a room.
  */
-export declare function newRoom(): int | undefined;
+export declare function newRoom(seedOrRNG?: Seed | RNG): int | undefined;
 /**
  * Helper function to check if a room exists at the given room grid index. (A room will exist if it
  * has non-undefined data in the room descriptor.)