isaacscript-common 1.0.574 → 1.0.578

package/dist/functions/player.lua

@@ -30,7 +30,7 @@ function ____exports.getCharacterMaxHeartContainers(self, character)
 end
 function ____exports.getPlayerIndex(self, player)
     local character = player:GetPlayerType()
-    local collectibleToUse = ((character == PlayerType.PLAYER_LAZARUS2_B) and CollectibleType.COLLECTIBLE_INNER_EYE) or CollectibleType.COLLECTIBLE_SAD_ONION
+    local collectibleToUse = character == PlayerType.PLAYER_LAZARUS2_B and CollectibleType.COLLECTIBLE_INNER_EYE or CollectibleType.COLLECTIBLE_SAD_ONION
     local collectibleRNG = player:GetCollectibleRNG(collectibleToUse)
     local seed = collectibleRNG:GetSeed()
     return seed
@@ -38,7 +38,7 @@ end
 function ____exports.getPlayerMaxHeartContainers(self, player)
     local character = player:GetPlayerType()
     local maxHeartContainers = ____exports.getCharacterMaxHeartContainers(nil, character)
-    if (character == PlayerType.PLAYER_MAGDALENE) and player:HasCollectible(CollectibleType.COLLECTIBLE_BIRTHRIGHT) then
+    if character == PlayerType.PLAYER_MAGDALENE and player:HasCollectible(CollectibleType.COLLECTIBLE_BIRTHRIGHT) then
         maxHeartContainers = maxHeartContainers + 6
     end
     local numMothersKisses = player:GetTrinketMultiplier(TrinketType.TRINKET_MOTHERS_KISS)
@@ -60,18 +60,18 @@ function ____exports.getPlayers(self, performExclusions)
             do
                 local player = Isaac.GetPlayer(i)
                 if player == nil then
-                    goto __continue67
+                    goto __continue76
                 end
                 if ____exports.isChildPlayer(nil, player) then
-                    goto __continue67
+                    goto __continue76
                 end
                 local character = player:GetPlayerType()
                 if performExclusions and EXCLUDED_CHARACTERS:has(character) then
-                    goto __continue67
+                    goto __continue76
                 end
                 __TS__ArrayPush(players, player)
             end
-            ::__continue67::
+            ::__continue76::
             i = i + 1
         end
     end
@@ -98,9 +98,7 @@ function ____exports.addTrinketCostume(self, player, trinketType)
     player:AddCostume(itemConfigTrinket, false)
 end
 function ____exports.anyPlayerCloserThan(self, position, distance)
-    for ____, player in ipairs(
-        ____exports.getPlayers(nil)
-    ) do
+    for ____, player in ipairs(____exports.getPlayers(nil)) do
         if player.Position:Distance(position) <= distance then
             return true
         end
@@ -108,9 +106,7 @@ function ____exports.anyPlayerCloserThan(self, position, distance)
     return false
 end
 function ____exports.anyPlayerHasCollectible(self, collectibleType)
-    for ____, player in ipairs(
-        ____exports.getPlayers(nil)
-    ) do
+    for ____, player in ipairs(____exports.getPlayers(nil)) do
         if player:HasCollectible(collectibleType) then
             return true
         end
@@ -118,9 +114,7 @@ function ____exports.anyPlayerHasCollectible(self, collectibleType)
     return false
 end
 function ____exports.anyPlayerHasTrinket(self, trinketType)
-    for ____, player in ipairs(
-        ____exports.getPlayers(nil)
-    ) do
+    for ____, player in ipairs(____exports.getPlayers(nil)) do
         if player:HasTrinket(trinketType) then
             return true
         end
@@ -130,9 +124,7 @@ end
 function ____exports.anyPlayerIs(self, ...)
     local characters = {...}
     local characterSet = __TS__New(Set, characters)
-    for ____, player in ipairs(
-        ____exports.getPlayers(nil)
-    ) do
+    for ____, player in ipairs(____exports.getPlayers(nil)) do
         local character = player:GetPlayerType()
         if characterSet:has(character) then
             return true
@@ -155,14 +147,12 @@ function ____exports.getAzazelBrimstoneDistance(self, playerOrTearHeight)
         local player = playerOrTearHeight
         tearHeight = player.TearHeight
     end
-    return 32 - (2.5 * tearHeight)
+    return 32 - 2.5 * tearHeight
 end
 function ____exports.getClosestPlayer(self, position)
     local closestPlayer = nil
     local closestDistance = math.huge
-    for ____, player in ipairs(
-        ____exports.getPlayers(nil)
-    ) do
+    for ____, player in ipairs(____exports.getPlayers(nil)) do
         local distance = position:Distance(player.Position)
         if distance < closestDistance then
             closestPlayer = player
@@ -197,10 +187,10 @@ function ____exports.getLastHeart(self, player)
     local boneHearts = player:GetBoneHearts()
     local rottenHearts = player:GetRottenHearts()
     local soulHeartSlots = soulHearts / 2
-    local lastHeartIndex = (boneHearts + soulHeartSlots) - 1
+    local lastHeartIndex = boneHearts + soulHeartSlots - 1
     local isLastHeartBone = player:IsBoneHeart(lastHeartIndex)
     if isLastHeartBone then
-        local isLastContainerEmpty = hearts <= (effectiveMaxHearts - 2)
+        local isLastContainerEmpty = hearts <= effectiveMaxHearts - 2
         if isLastContainerEmpty then
             return HealthType.BONE
         end
@@ -232,9 +222,7 @@ end
 function ____exports.getNewestPlayer(self)
     local newestPlayer = nil
     local lowestFrame = math.huge
-    for ____, player in ipairs(
-        ____exports.getPlayers(nil)
-    ) do
+    for ____, player in ipairs(____exports.getPlayers(nil)) do
         if player.FrameCount < lowestFrame then
             newestPlayer = player
             lowestFrame = player.FrameCount
@@ -257,9 +245,7 @@ function ____exports.getPlayerAvailableHeartSlots(self, player)
     return maxHeartContainers - totalOccupiedHeartSlots
 end
 function ____exports.getPlayerCloserThan(self, position, distance)
-    for ____, player in ipairs(
-        ____exports.getPlayers(nil)
-    ) do
+    for ____, player in ipairs(____exports.getPlayers(nil)) do
         if player.Position:Distance(position) <= distance then
             return player
         end
@@ -269,9 +255,7 @@ end
 function ____exports.getPlayerCollectibleMap(self, player)
     local collectibleSet = getCollectibleSet(nil)
     local collectibleMap = __TS__New(Map)
-    for ____, collectibleType in __TS__Iterator(
-        collectibleSet:values()
-    ) do
+    for ____, collectibleType in __TS__Iterator(collectibleSet:values()) do
         local collectibleNum = player:GetCollectibleNum(collectibleType, true)
         if collectibleNum > 0 then
             collectibleMap:set(collectibleType, collectibleNum)
@@ -280,9 +264,7 @@ function ____exports.getPlayerCollectibleMap(self, player)
     return collectibleMap
 end
 function ____exports.getPlayerFromIndex(self, playerIndex)
-    for ____, player in ipairs(
-        ____exports.getPlayers(nil)
-    ) do
+    for ____, player in ipairs(____exports.getPlayers(nil)) do
         local existingPlayerIndex = ____exports.getPlayerIndex(nil, player)
         if existingPlayerIndex == playerIndex then
             return player
@@ -299,14 +281,14 @@ function ____exports.getPlayerIndexVanilla(self, playerToFind)
             do
                 local player = Isaac.GetPlayer(i)
                 if player == nil then
-                    goto __continue59
+                    goto __continue68
                 end
                 local playerHash = GetPtrHash(player)
                 if playerHash == playerToFindHash then
                     return i
                 end
             end
-            ::__continue59::
+            ::__continue68::
             i = i + 1
         end
     end
@@ -318,13 +300,11 @@ function ____exports.getPlayerNumAllHearts(self, player)
     local boneHearts = player:GetBoneHearts()
     local eternalHearts = player:GetEternalHearts()
     local rottenHearts = player:GetRottenHearts()
-    return (((hearts + soulHearts) + boneHearts) + eternalHearts) - rottenHearts
+    return hearts + soulHearts + boneHearts + eternalHearts - rottenHearts
 end
 function ____exports.getPlayersOfType(self, playerType)
     local players = {}
-    for ____, player in ipairs(
-        ____exports.getPlayers(nil)
-    ) do
+    for ____, player in ipairs(____exports.getPlayers(nil)) do
         local character = player:GetPlayerType()
         if character == playerType then
             __TS__ArrayPush(players, player)
@@ -339,9 +319,7 @@ function ____exports.getTotalCharge(self, player, activeSlot)
 end
 function ____exports.getTotalPlayerCollectibles(self, collectibleType)
     local numCollectibles = 0
-    for ____, player in ipairs(
-        ____exports.getPlayers(nil)
-    ) do
+    for ____, player in ipairs(____exports.getPlayers(nil)) do
         numCollectibles = numCollectibles + player:GetCollectibleNum(collectibleType)
     end
     return numCollectibles
@@ -359,32 +337,32 @@ function ____exports.hasOpenActiveItemSlot(self, player)
     local activeItemSecondary = player:GetActiveItem(ActiveSlot.SLOT_SECONDARY)
     local hasSchoolbag = player:HasCollectible(CollectibleType.COLLECTIBLE_SCHOOLBAG)
     if hasSchoolbag then
-        return (activeItemPrimary == CollectibleType.COLLECTIBLE_NULL) or (activeItemSecondary == CollectibleType.COLLECTIBLE_NULL)
+        return activeItemPrimary == CollectibleType.COLLECTIBLE_NULL or activeItemSecondary == CollectibleType.COLLECTIBLE_NULL
     end
     return activeItemPrimary == CollectibleType.COLLECTIBLE_NULL
 end
 function ____exports.isBethany(self, player)
     local character = player:GetPlayerType()
-    return (character == PlayerType.PLAYER_BETHANY) or (character == PlayerType.PLAYER_BETHANY_B)
+    return character == PlayerType.PLAYER_BETHANY or character == PlayerType.PLAYER_BETHANY_B
 end
 function ____exports.isFirstPlayer(self, player)
     return ____exports.getPlayerIndexVanilla(nil, player) == 0
 end
 function ____exports.isJacobOrEsau(self, player)
     local character = player:GetPlayerType()
-    return (character == PlayerType.PLAYER_JACOB) or (character == PlayerType.PLAYER_ESAU)
+    return character == PlayerType.PLAYER_JACOB or character == PlayerType.PLAYER_ESAU
 end
 function ____exports.isKeeper(self, player)
     local character = player:GetPlayerType()
-    return (character == PlayerType.PLAYER_KEEPER) or (character == PlayerType.PLAYER_KEEPER_B)
+    return character == PlayerType.PLAYER_KEEPER or character == PlayerType.PLAYER_KEEPER_B
 end
 function ____exports.isLost(self, player)
     local character = player:GetPlayerType()
-    return (character == PlayerType.PLAYER_THELOST) or (character == PlayerType.PLAYER_THELOST_B)
+    return character == PlayerType.PLAYER_THELOST or character == PlayerType.PLAYER_THELOST_B
 end
 function ____exports.isTaintedLazarus(self, player)
     local character = player:GetPlayerType()
-    return (character == PlayerType.PLAYER_LAZARUS_B) or (character == PlayerType.PLAYER_LAZARUS2_B)
+    return character == PlayerType.PLAYER_LAZARUS_B or character == PlayerType.PLAYER_LAZARUS2_B
 end
 function ____exports.removeCollectibleCostume(self, player, collectibleType)
     local itemConfig = Isaac.GetItemConfig()
@@ -427,9 +405,9 @@ function ____exports.setActiveItem(self, player, collectibleType, activeSlot, ch
         itemPool:RemoveCollectible(collectibleType)
     end
     repeat
-        local ____switch97 = activeSlot
-        local ____cond97 = ____switch97 == ActiveSlot.SLOT_PRIMARY
-        if ____cond97 then
+        local ____switch108 = activeSlot
+        local ____cond108 = ____switch108 == ActiveSlot.SLOT_PRIMARY
+        if ____cond108 then
             do
                 if primaryCollectibleType ~= CollectibleType.COLLECTIBLE_NULL then
                     player:RemoveCollectible(primaryCollectibleType)
@@ -438,8 +416,8 @@ function ____exports.setActiveItem(self, player, collectibleType, activeSlot, ch
                 break
             end
         end
-        ____cond97 = ____cond97 or (____switch97 == ActiveSlot.SLOT_SECONDARY)
-        if ____cond97 then
+        ____cond108 = ____cond108 or ____switch108 == ActiveSlot.SLOT_SECONDARY
+        if ____cond108 then
             do
                 if primaryCollectibleType ~= CollectibleType.COLLECTIBLE_NULL then
                     player:RemoveCollectible(primaryCollectibleType)
@@ -454,16 +432,16 @@ function ____exports.setActiveItem(self, player, collectibleType, activeSlot, ch
                 break
             end
         end
-        ____cond97 = ____cond97 or (____switch97 == ActiveSlot.SLOT_POCKET)
-        if ____cond97 then
+        ____cond108 = ____cond108 or ____switch108 == ActiveSlot.SLOT_POCKET
+        if ____cond108 then
             do
                 player:SetPocketActiveItem(collectibleType, activeSlot, keepInPools)
                 player:SetActiveCharge(charge, activeSlot)
                 break
             end
         end
-        ____cond97 = ____cond97 or (____switch97 == ActiveSlot.SLOT_POCKET2)
-        if ____cond97 then
+        ____cond108 = ____cond108 or ____switch108 == ActiveSlot.SLOT_POCKET2
+        if ____cond108 then
             do
                 player:SetPocketActiveItem(collectibleType, activeSlot, keepInPools)
                 break

package/dist/functions/playerHealth.lua

@@ -27,29 +27,29 @@ function ____exports.getPlayerHealth(self, player)
     local rottenHearts = player:GetRottenHearts()
     local brokenHearts = player:GetBrokenHearts()
     local subPlayer = player:GetSubPlayer()
-    if (character == PlayerType.PLAYER_THEFORGOTTEN) and (subPlayer ~= nil) then
+    if character == PlayerType.PLAYER_THEFORGOTTEN and subPlayer ~= nil then
         maxHearts = boneHearts * 2
         boneHearts = 0
         soulHearts = subPlayer:GetSoulHearts()
-    elseif (character == PlayerType.PLAYER_THESOUL) and (subPlayer ~= nil) then
+    elseif character == PlayerType.PLAYER_THESOUL and subPlayer ~= nil then
         maxHearts = subPlayer:GetBoneHearts() * 2
         hearts = subPlayer:GetHearts()
     end
-    hearts = hearts - (rottenHearts * 2)
+    hearts = hearts - rottenHearts * 2
     local extraHearts = math.ceil(soulHearts / 2) + boneHearts
     local currentSoulHeart = 0
     do
         local i = 0
         while i < extraHearts do
             local isBoneHeart = player:IsBoneHeart(i)
-            if (character == PlayerType.PLAYER_THEFORGOTTEN) and (subPlayer ~= nil) then
+            if character == PlayerType.PLAYER_THEFORGOTTEN and subPlayer ~= nil then
                 isBoneHeart = subPlayer:IsBoneHeart(i)
             end
             if isBoneHeart then
                 __TS__ArrayPush(soulHeartTypes, HeartSubType.HEART_BONE)
             else
                 local isBlackHeart = player:IsBlackHeart(currentSoulHeart + 1)
-                if (character == PlayerType.PLAYER_THEFORGOTTEN) and (subPlayer ~= nil) then
+                if character == PlayerType.PLAYER_THEFORGOTTEN and subPlayer ~= nil then
                     isBlackHeart = subPlayer:IsBlackHeart(currentSoulHeart + 1)
                 end
                 if isBlackHeart then
@@ -62,13 +62,23 @@ function ____exports.getPlayerHealth(self, player)
             i = i + 1
         end
     end
-    return {soulHeartTypes = soulHeartTypes, maxHearts = maxHearts, hearts = hearts, eternalHearts = eternalHearts, soulHearts = soulHearts, boneHearts = boneHearts, goldenHearts = goldenHearts, rottenHearts = rottenHearts, brokenHearts = brokenHearts}
+    return {
+        soulHeartTypes = soulHeartTypes,
+        maxHearts = maxHearts,
+        hearts = hearts,
+        eternalHearts = eternalHearts,
+        soulHearts = soulHearts,
+        boneHearts = boneHearts,
+        goldenHearts = goldenHearts,
+        rottenHearts = rottenHearts,
+        brokenHearts = brokenHearts
+    }
 end
 function ____exports.setPlayerHealth(self, player, playerHealth)
     local character = player:GetPlayerType()
     local subPlayer = player:GetSubPlayer()
     ____exports.removeAllPlayerHealth(nil, player)
-    if (character == PlayerType.PLAYER_THESOUL) and (subPlayer ~= nil) then
+    if character == PlayerType.PLAYER_THESOUL and subPlayer ~= nil then
         subPlayer:AddMaxHearts(playerHealth.maxHearts, false)
     else
         player:AddMaxHearts(playerHealth.maxHearts, false)
@@ -79,9 +89,9 @@ function ____exports.setPlayerHealth(self, player, playerHealth)
         local i = 0
         while i < #playerHealth.soulHeartTypes do
             local heartType = playerHealth.soulHeartTypes[i + 1]
-            local isHalf = (playerHealth.soulHearts + (playerHealth.boneHearts * 2)) < ((i + 1) * 2)
+            local isHalf = playerHealth.soulHearts + playerHealth.boneHearts * 2 < (i + 1) * 2
             local addAmount = 2
-            if (isHalf or (heartType == HeartSubType.HEART_BONE)) or (soulHeartsRemaining < 2) then
+            if isHalf or heartType == HeartSubType.HEART_BONE or soulHeartsRemaining < 2 then
                 addAmount = 1
             end
             if heartType == HeartSubType.HEART_SOUL then

package/dist/functions/pocketItems.lua

@@ -23,10 +23,10 @@ function ____exports.getPocketItems(self, player)
                 __TS__ArrayPush(pocketItems, {type = PocketItemType.CARD, id = card, slot = slot})
             elseif pill ~= PillColor.PILL_NULL then
                 __TS__ArrayPush(pocketItems, {type = PocketItemType.PILL, id = pill, slot = slot})
-            elseif (hasPocketItem and (not hasPocketItem2)) and (not pocketItemIdentified) then
+            elseif hasPocketItem and not hasPocketItem2 and not pocketItemIdentified then
                 pocketItemIdentified = true
                 __TS__ArrayPush(pocketItems, {type = PocketItemType.ACTIVE_ITEM, id = pocketItem, slot = slot})
-            elseif ((not hasPocketItem) and hasPocketItem2) and (not pocketItem2Identified) then
+            elseif not hasPocketItem and hasPocketItem2 and not pocketItem2Identified then
                 pocketItem2Identified = true
                 __TS__ArrayPush(pocketItems, {type = PocketItemType.DICE_BAG_DICE, id = pocketItem2, slot = slot})
             elseif hasPocketItem and hasPocketItem2 then
@@ -34,7 +34,7 @@ function ____exports.getPocketItems(self, player)
             else
                 __TS__ArrayPush(pocketItems, {type = PocketItemType.EMPTY, id = 0, slot = slot})
             end
-            if (slot + 1) == maxPocketItems then
+            if slot + 1 == maxPocketItems then
                 break
             end
             slot = slot + 1
@@ -45,7 +45,7 @@ end
 function ____exports.getFirstCardOrPill(self, player)
     local pocketItems = ____exports.getPocketItems(nil, player)
     for ____, pocketItem in ipairs(pocketItems) do
-        if (pocketItem.type == PocketItemType.CARD) or (pocketItem.type == PocketItemType.PILL) then
+        if pocketItem.type == PocketItemType.CARD or pocketItem.type == PocketItemType.PILL then
             return pocketItem
         end
     end

package/dist/functions/random.lua

@@ -24,14 +24,14 @@ function ____exports.getRandomFloat(self, min, max, seed)
     if seed == nil then
         seed = Random()
     end
-    return min + (____exports.getRandom(nil, seed) * (max - min))
+    return min + ____exports.getRandom(nil, seed) * (max - min)
 end
 function ____exports.getRandomInt(self, min, max, seed)
     if seed == nil then
         seed = Random()
     end
     local rng = ____exports.initRNG(nil, seed)
-    return rng:RandomInt((max - min) + 1) + min
+    return rng:RandomInt(max - min + 1) + min
 end
 function ____exports.nextSeed(self, seed)
     local rng = ____exports.initRNG(nil, seed)

package/dist/functions/revive.lua

@@ -13,12 +13,12 @@ function ____exports.willMysteriousPaperRevive(self, player)
     local sprite = player:GetSprite()
     local animation = getDeathAnimationName(nil, player)
     local deathAnimationFrames = getFinalFrameOfAnimation(nil, sprite, animation)
-    local frameOfDeath = (gameFrameCount + deathAnimationFrames) + 1
-    return (frameOfDeath % 4) == 3
+    local frameOfDeath = gameFrameCount + deathAnimationFrames + 1
+    return frameOfDeath % 4 == 3
 end
 function ____exports.willPlayerRevive(self, player)
     local trinketSituation = temporarilyRemoveTrinket(nil, player, TrinketType.TRINKET_MYSTERIOUS_PAPER)
-    local willRevive = player:WillPlayerRevive() or ((trinketSituation ~= nil) and ____exports.willMysteriousPaperRevive(nil, player))
+    local willRevive = player:WillPlayerRevive() or trinketSituation ~= nil and ____exports.willMysteriousPaperRevive(nil, player)
     giveTrinketsBack(nil, player, trinketSituation)
     return willRevive
 end
@@ -29,6 +29,6 @@ function ____exports.willReviveFromSpiritShackles(self, player)
     local effects = player:GetEffects()
     local spiritShacklesEnabled = not effects:HasNullEffect(NullItemID.ID_SPIRIT_SHACKLES_DISABLED)
     local playerInSoulForm = effects:HasNullEffect(NullItemID.ID_SPIRIT_SHACKLES_SOUL)
-    return spiritShacklesEnabled and (not playerInSoulForm)
+    return spiritShacklesEnabled and not playerInSoulForm
 end
 return ____exports

package/dist/functions/rooms.d.ts

@@ -1,8 +1,8 @@
 /// <reference types="isaac-typescript-definitions" />
 /**
  * Helper function for quickly switching to a new room without playing a particular animation.
- * Always use this helper function over invoking `Game().ChangeRoom()` directly to ensure that you
- * do not forget to set the LeaveDoor property.
+ * Use this helper function over invoking `Game().ChangeRoom()` directly to ensure that you do not
+ * forget to set the LeaveDoor property and to prevent crashing on invalid room grid indexes.
  */
 export declare function changeRoom(roomGridIndex: int): void;
 export declare function getAllRoomGridIndexes(): int[];
@@ -220,3 +220,15 @@ export declare function setRoomCleared(): void;
  * spawns an NPC.
  */
 export declare function setRoomUncleared(): void;
+/**
+ * Helper function to change the current room. It can be used for both teleportation and "normal"
+ * room transitions, depending on what is passed for the `direction` and `roomTransitionAnim`
+ * arguments. Use this function instead of invoking `Game.StartRoomTransition()` directly so that
+ * you do not forget to set `Level.LeaveDoor` property and to prevent crashing on invalid room grid
+ * indexes.
+ *
+ * @param roomGridIndex The room grid index of the destination room.
+ * @param direction Optional. Default is `Direction.NO_DIRECTION`.
+ * @param roomTransitionAnim Optional. Default is `RoomTransitionAnim.TELEPORT`.
+ */
+export declare function teleport(roomGridIndex: int, direction?: Direction, roomTransitionAnim?: RoomTransitionAnim): void;