isaacscript-common 20.12.3 → 20.13.1

package/dist/index.d.ts

@@ -5158,6 +5158,28 @@ export declare function getMatchingGridEntities(gridEntityType: GridEntityType,
 
 export declare function getMoveActions(): ReadonlySet<ButtonAction>;
 
+/**
+ * Helper function to get the current effect that the Mysterious Paper trinket is providing to the
+ * player. Returns undefined if the player does not have the Mysterious Paper trinket.
+ *
+ * The Mysterious Paper trinket has four different effects:
+ *
+ * - The Polaroid (collectible)
+ * - The Negative (collectible)
+ * - A Missing Page (trinket)
+ * - Missing Poster (trinket)
+ *
+ * It rotates between these four effects on every frame. Note that Mysterious Paper will cause the
+ * `EntityPlayer.HasCollectible` and `EntityPlayer.HasTrinket` methods to return true for the
+ * respective items on the particular frame, with the exception of the Missing Poster. (The player
+ * will never "have" the Missing Poster, even on the correct corresponding frame.)
+ *
+ * @param player The player to look at.
+ * @param frameCount Optional. The frame count that corresponds to time the effect will be active.
+ *                   Default is the current frame.
+ */
+export declare function getMysteriousPaperEffectForFrame(player: EntityPlayer, frameCount?: int): MysteriousPaperEffect | undefined;
+
 /**
  * Helper function to get the first player with the lowest frame count. Useful to find a freshly
  * spawned player after using items like Esau Jr. Don't use this function if two or more players
@@ -11637,6 +11659,19 @@ export declare function movePlayersToCenter(radius?: float): void;
  */
 export declare const musicManager: MusicManager;
 
+/**
+ * The possible effects that the Mysterious Paper trinket can grant.
+ *
+ * This enum has hard-coded values because they correspond to the specific in-game frame count of
+ * the player.
+ */
+export declare enum MysteriousPaperEffect {
+    POLAROID = 0,
+    NEGATIVE = 1,
+    MISSING_PAGE = 2,
+    MISSING_POSTER = 3
+}
+
 /** This is near the top door. */
 export declare const NEW_FLOOR_STARTING_POSITION_GREED_MODE: Vector;
 

package/dist/isaacscript-common.lua

@@ -1,6 +1,6 @@
 --[[
 
-isaacscript-common 20.12.3
+isaacscript-common 20.13.1
 
 This is the "isaacscript-common" library, which was created with the IsaacScript tool.
 
@@ -27210,6 +27210,19 @@ function ____exports.sumSet(self, set)
     local values = {__TS__Spread(set:values())}
     return sumArray(nil, values)
 end
+return ____exports
+ end,
+["src.enums.MysteriousPaperEffect"] = function(...) 
+local ____exports = {}
+____exports.MysteriousPaperEffect = {}
+____exports.MysteriousPaperEffect.POLAROID = 0
+____exports.MysteriousPaperEffect[____exports.MysteriousPaperEffect.POLAROID] = "POLAROID"
+____exports.MysteriousPaperEffect.NEGATIVE = 1
+____exports.MysteriousPaperEffect[____exports.MysteriousPaperEffect.NEGATIVE] = "NEGATIVE"
+____exports.MysteriousPaperEffect.MISSING_PAGE = 2
+____exports.MysteriousPaperEffect[____exports.MysteriousPaperEffect.MISSING_PAGE] = "MISSING_PAGE"
+____exports.MysteriousPaperEffect.MISSING_POSTER = 3
+____exports.MysteriousPaperEffect[____exports.MysteriousPaperEffect.MISSING_POSTER] = "MISSING_POSTER"
 return ____exports
  end,
 ["src.maps.trinketDescriptionMap"] = function(...) 
@@ -27621,6 +27634,8 @@ local BLIND_ITEM_PNG_PATH = ____constants.BLIND_ITEM_PNG_PATH
 local ____constantsFirstLast = require("src.core.constantsFirstLast")
 local FIRST_TRINKET_TYPE = ____constantsFirstLast.FIRST_TRINKET_TYPE
 local LAST_VANILLA_TRINKET_TYPE = ____constantsFirstLast.LAST_VANILLA_TRINKET_TYPE
+local ____MysteriousPaperEffect = require("src.enums.MysteriousPaperEffect")
+local MysteriousPaperEffect = ____MysteriousPaperEffect.MysteriousPaperEffect
 local ____trinketDescriptionMap = require("src.maps.trinketDescriptionMap")
 local DEFAULT_TRINKET_DESCRIPTION = ____trinketDescriptionMap.DEFAULT_TRINKET_DESCRIPTION
 local TRINKET_DESCRIPTION_MAP = ____trinketDescriptionMap.TRINKET_DESCRIPTION_MAP
@@ -27629,6 +27644,8 @@ local DEFAULT_TRINKET_NAME = ____trinketTypeToNameMap.DEFAULT_TRINKET_NAME
 local TRINKET_TYPE_TO_NAME_MAP = ____trinketTypeToNameMap.TRINKET_TYPE_TO_NAME_MAP
 local ____entities = require("src.functions.entities")
 local getEntityID = ____entities.getEntityID
+local ____enums = require("src.functions.enums")
+local getEnumLength = ____enums.getEnumLength
 local ____flag = require("src.functions.flag")
 local hasFlag = ____flag.hasFlag
 local ____pickupVariants = require("src.functions.pickupVariants")
@@ -27645,11 +27662,21 @@ function ____exports.isVanillaTrinketType(self, trinketType)
     return trinketType <= LAST_VANILLA_TRINKET_TYPE
 end
 local GOLDEN_TRINKET_ADJUSTMENT = 32768
+local NUM_MYSTERIOUS_PAPER_EFFECTS = getEnumLength(nil, MysteriousPaperEffect)
 local TRINKET_ANM2_PATH = "gfx/005.350_trinket.anm2"
 local TRINKET_SPRITE_LAYER = 0
 function ____exports.getGoldenTrinketType(self, trinketType)
     return asNumber(nil, trinketType) + GOLDEN_TRINKET_ADJUSTMENT
 end
+function ____exports.getMysteriousPaperEffectForFrame(self, player, frameCount)
+    if frameCount == nil then
+        frameCount = player.FrameCount
+    end
+    if not player:HasTrinket(TrinketType.MYSTERIOUS_PAPER) then
+        return nil
+    end
+    return frameCount % NUM_MYSTERIOUS_PAPER_EFFECTS
+end
 function ____exports.getOpenTrinketSlot(self, player)
     local maxTrinkets = player:GetMaxTrinkets()
     local trinketType1 = player:GetTrinket(TrinketSlot.SLOT_1)
@@ -29452,6 +29479,8 @@ local game = ____cachedClasses.game
 local ____constants = require("src.core.constants")
 local MAX_TAINTED_SAMSON_BERSERK_CHARGE = ____constants.MAX_TAINTED_SAMSON_BERSERK_CHARGE
 local TAINTED_SAMSON_BERSERK_CHARGE_FROM_TAKING_DAMAGE = ____constants.TAINTED_SAMSON_BERSERK_CHARGE_FROM_TAKING_DAMAGE
+local ____MysteriousPaperEffect = require("src.enums.MysteriousPaperEffect")
+local MysteriousPaperEffect = ____MysteriousPaperEffect.MysteriousPaperEffect
 local ____characters = require("src.functions.characters")
 local getCharacterDeathAnimationName = ____characters.getCharacterDeathAnimationName
 local ____playerHealth = require("src.functions.playerHealth")
@@ -29465,6 +29494,8 @@ local getLastFrameOfAnimation = ____sprites.getLastFrameOfAnimation
 local ____trinketGive = require("src.functions.trinketGive")
 local giveTrinketsBack = ____trinketGive.giveTrinketsBack
 local temporarilyRemoveTrinket = ____trinketGive.temporarilyRemoveTrinket
+local ____trinkets = require("src.functions.trinkets")
+local getMysteriousPaperEffectForFrame = ____trinkets.getMysteriousPaperEffectForFrame
 function ____exports.willReviveFromHeartbreak(self, player)
     if not player:HasCollectible(CollectibleType.HEARTBREAK) then
         return false
@@ -29528,13 +29559,16 @@ function ____exports.isDamageToPlayerFatal(self, player, amount, source, lastDam
     return true
 end
 function ____exports.willMysteriousPaperRevive(self, player)
-    local gameFrameCount = game:GetFrameCount()
     local sprite = player:GetSprite()
     local character = player:GetPlayerType()
     local animation = getCharacterDeathAnimationName(nil, character)
     local deathAnimationFrames = getLastFrameOfAnimation(nil, sprite, animation)
-    local frameOfDeath = gameFrameCount + deathAnimationFrames + 1
-    return frameOfDeath % 4 == 3
+    local frameOfDeath = player.FrameCount + deathAnimationFrames
+    local mysteriousPaperEffect = getMysteriousPaperEffectForFrame(nil, player, frameOfDeath)
+    if mysteriousPaperEffect == nil then
+        return false
+    end
+    return mysteriousPaperEffect == MysteriousPaperEffect.MISSING_POSTER
 end
 function ____exports.willPlayerRevive(self, player)
     local trinketSituation = temporarilyRemoveTrinket(nil, player, TrinketType.MYSTERIOUS_PAPER)
@@ -41831,6 +41865,8 @@ local ____roomData = require("src.functions.roomData")
 local getRoomSubType = ____roomData.getRoomSubType
 local ____string = require("src.functions.string")
 local removeCharactersBefore = ____string.removeCharactersBefore
+local ____ui = require("src.functions.ui")
+local getScreenCenterPos = ____ui.getScreenCenterPos
 local ____utils = require("src.functions.utils")
 local eRange = ____utils.eRange
 local ____bossNamePNGFileNames = require("src.objects.bossNamePNGFileNames")
@@ -42053,9 +42089,7 @@ function ____exports.versusScreenPostRender(self, v, pause, disableAllSound)
         finishVersusScreenAnimation(nil, v, pause, disableAllSound)
         return
     end
-    local room = game:GetRoom()
-    local centerPos = room:GetCenterPos()
-    local position = Isaac.WorldToRenderPosition(centerPos)
+    local position = getScreenCenterPos(nil)
     versusScreenBackgroundSprite:RenderLayer(VersusScreenLayer.BACKGROUND, position)
     versusScreenBackgroundSprite:Update()
     versusScreenSprite:RenderLayer(VersusScreenLayer.OVERLAY, position)
@@ -51334,6 +51368,14 @@ do
         end
     end
 end
+do
+    local ____export = require("src.enums.MysteriousPaperEffect")
+    for ____exportKey, ____exportValue in pairs(____export) do
+        if ____exportKey ~= "default" then
+            ____exports[____exportKey] = ____exportValue
+        end
+    end
+end
 do
     local ____export = require("src.enums.PocketItemType")
     for ____exportKey, ____exportValue in pairs(____export) do
@@ -52394,6 +52436,14 @@ do
         end
     end
 end
+do
+    local ____export = require("src.enums.MysteriousPaperEffect")
+    for ____exportKey, ____exportValue in pairs(____export) do
+        if ____exportKey ~= "default" then
+            ____exports[____exportKey] = ____exportValue
+        end
+    end
+end
 do
     local ____export = require("src.enums.PocketItemType")
     for ____exportKey, ____exportValue in pairs(____export) do

package/dist/src/classes/features/other/customStages/versusScreen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"versusScreen.d.ts","sourceRoot":"","sources":["../../../../../../src/classes/features/other/customStages/versusScreen.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,WAAW,EAAE,MAAM,4CAA4C,CAAC;AAOzE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAU/C,UAAU,gBAAgB;IACxB,GAAG,EAAE;QACH,uBAAuB,EAAE,OAAO,CAAC;KAClC,CAAC;CACH;AA8ED,wBAAgB,yBAAyB,CACvC,CAAC,EAAE,gBAAgB,EACnB,WAAW,EAAE,WAAW,EACxB,eAAe,EAAE,eAAe,EAChC,KAAK,EAAE,KAAK,EACZ,YAAY,EAAE,YAAY,GACzB,IAAI,CA0GN;AAiGD,wBAAgB,sBAAsB,CACpC,CAAC,EAAE,gBAAgB,EACnB,KAAK,EAAE,KAAK,EACZ,eAAe,EAAE,eAAe,GAC/B,IAAI,CAwCN"}
+{"version":3,"file":"versusScreen.d.ts","sourceRoot":"","sources":["../../../../../../src/classes/features/other/customStages/versusScreen.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,WAAW,EAAE,MAAM,4CAA4C,CAAC;AAOzE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAU/C,UAAU,gBAAgB;IACxB,GAAG,EAAE;QACH,uBAAuB,EAAE,OAAO,CAAC;KAClC,CAAC;CACH;AA8ED,wBAAgB,yBAAyB,CACvC,CAAC,EAAE,gBAAgB,EACnB,WAAW,EAAE,WAAW,EACxB,eAAe,EAAE,eAAe,EAChC,KAAK,EAAE,KAAK,EACZ,YAAY,EAAE,YAAY,GACzB,IAAI,CA0GN;AAiGD,wBAAgB,sBAAsB,CACpC,CAAC,EAAE,gBAAgB,EACnB,KAAK,EAAE,KAAK,EACZ,eAAe,EAAE,eAAe,GAC/B,IAAI,CAsCN"}

package/dist/src/classes/features/other/customStages/versusScreen.lua

@@ -20,6 +20,8 @@ local ____roomData = require("src.functions.roomData")
 local getRoomSubType = ____roomData.getRoomSubType
 local ____string = require("src.functions.string")
 local removeCharactersBefore = ____string.removeCharactersBefore
+local ____ui = require("src.functions.ui")
+local getScreenCenterPos = ____ui.getScreenCenterPos
 local ____utils = require("src.functions.utils")
 local eRange = ____utils.eRange
 local ____bossNamePNGFileNames = require("src.objects.bossNamePNGFileNames")
@@ -254,9 +256,7 @@ function ____exports.versusScreenPostRender(self, v, pause, disableAllSound)
         finishVersusScreenAnimation(nil, v, pause, disableAllSound)
         return
     end
-    local room = game:GetRoom()
-    local centerPos = room:GetCenterPos()
-    local position = Isaac.WorldToRenderPosition(centerPos)
+    local position = getScreenCenterPos(nil)
     versusScreenBackgroundSprite:RenderLayer(VersusScreenLayer.BACKGROUND, position)
     versusScreenBackgroundSprite:Update()
     versusScreenSprite:RenderLayer(VersusScreenLayer.OVERLAY, position)

package/dist/src/enums/MysteriousPaperEffect.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The possible effects that the Mysterious Paper trinket can grant.
+ *
+ * This enum has hard-coded values because they correspond to the specific in-game frame count of
+ * the player.
+ */
+export declare enum MysteriousPaperEffect {
+    POLAROID = 0,
+    NEGATIVE = 1,
+    MISSING_PAGE = 2,
+    MISSING_POSTER = 3
+}
+//# sourceMappingURL=MysteriousPaperEffect.d.ts.map

package/dist/src/enums/MysteriousPaperEffect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MysteriousPaperEffect.d.ts","sourceRoot":"","sources":["../../../src/enums/MysteriousPaperEffect.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,oBAAY,qBAAqB;IAC/B,QAAQ,IAAI;IACZ,QAAQ,IAAI;IACZ,YAAY,IAAI;IAChB,cAAc,IAAI;CACnB"}

package/dist/src/enums/MysteriousPaperEffect.lua

@@ -0,0 +1,15 @@
+local ____exports = {}
+--- The possible effects that the Mysterious Paper trinket can grant.
+-- 
+-- This enum has hard-coded values because they correspond to the specific in-game frame count of
+-- the player.
+____exports.MysteriousPaperEffect = {}
+____exports.MysteriousPaperEffect.POLAROID = 0
+____exports.MysteriousPaperEffect[____exports.MysteriousPaperEffect.POLAROID] = "POLAROID"
+____exports.MysteriousPaperEffect.NEGATIVE = 1
+____exports.MysteriousPaperEffect[____exports.MysteriousPaperEffect.NEGATIVE] = "NEGATIVE"
+____exports.MysteriousPaperEffect.MISSING_PAGE = 2
+____exports.MysteriousPaperEffect[____exports.MysteriousPaperEffect.MISSING_PAGE] = "MISSING_PAGE"
+____exports.MysteriousPaperEffect.MISSING_POSTER = 3
+____exports.MysteriousPaperEffect[____exports.MysteriousPaperEffect.MISSING_POSTER] = "MISSING_POSTER"
+return ____exports

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

@@ -1 +1 @@
-{"version":3,"file":"revive.d.ts","sourceRoot":"","sources":["../../../src/functions/revive.ts"],"names":[],"mappings":";;;AAkBA;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,GAAG,EACX,MAAM,EAAE,SAAS,EACjB,mBAAmB,EAAE,GAAG,GAAG,SAAS,GACnC,OAAO,CAuFT;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAavE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAa9D;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAYtE;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAe1E"}
+{"version":3,"file":"revive.d.ts","sourceRoot":"","sources":["../../../src/functions/revive.ts"],"names":[],"mappings":";;;AAoBA;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,GAAG,EACX,MAAM,EAAE,SAAS,EACjB,mBAAmB,EAAE,GAAG,GAAG,SAAS,GACnC,OAAO,CAuFT;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAmBvE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAa9D;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAYtE;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAe1E"}

package/dist/src/functions/revive.lua

@@ -10,6 +10,8 @@ local game = ____cachedClasses.game
 local ____constants = require("src.core.constants")
 local MAX_TAINTED_SAMSON_BERSERK_CHARGE = ____constants.MAX_TAINTED_SAMSON_BERSERK_CHARGE
 local TAINTED_SAMSON_BERSERK_CHARGE_FROM_TAKING_DAMAGE = ____constants.TAINTED_SAMSON_BERSERK_CHARGE_FROM_TAKING_DAMAGE
+local ____MysteriousPaperEffect = require("src.enums.MysteriousPaperEffect")
+local MysteriousPaperEffect = ____MysteriousPaperEffect.MysteriousPaperEffect
 local ____characters = require("src.functions.characters")
 local getCharacterDeathAnimationName = ____characters.getCharacterDeathAnimationName
 local ____playerHealth = require("src.functions.playerHealth")
@@ -23,6 +25,8 @@ local getLastFrameOfAnimation = ____sprites.getLastFrameOfAnimation
 local ____trinketGive = require("src.functions.trinketGive")
 local giveTrinketsBack = ____trinketGive.giveTrinketsBack
 local temporarilyRemoveTrinket = ____trinketGive.temporarilyRemoveTrinket
+local ____trinkets = require("src.functions.trinkets")
+local getMysteriousPaperEffectForFrame = ____trinkets.getMysteriousPaperEffectForFrame
 --- Helper function to determine if the player will be revived by the Heartbreak collectible if they
 -- take fatal damage. This is contingent on the character that they are playing as and the amount of
 -- broken hearts that they already have.
@@ -99,13 +103,16 @@ end
 -- Mysterious Paper rotates between the 4 items on every frame, in order. The formula for whether
 -- Mysterious Paper be Missing Power is: `gameFrameCount % 4 === 3`
 function ____exports.willMysteriousPaperRevive(self, player)
-    local gameFrameCount = game:GetFrameCount()
     local sprite = player:GetSprite()
     local character = player:GetPlayerType()
     local animation = getCharacterDeathAnimationName(nil, character)
     local deathAnimationFrames = getLastFrameOfAnimation(nil, sprite, animation)
-    local frameOfDeath = gameFrameCount + deathAnimationFrames + 1
-    return frameOfDeath % 4 == 3
+    local frameOfDeath = player.FrameCount + deathAnimationFrames
+    local mysteriousPaperEffect = getMysteriousPaperEffectForFrame(nil, player, frameOfDeath)
+    if mysteriousPaperEffect == nil then
+        return false
+    end
+    return mysteriousPaperEffect == MysteriousPaperEffect.MISSING_POSTER
 end
 --- The `EntityPlayer.WillPlayerRevive` method does not properly account for Mysterious Paper, so use
 -- this helper function instead for more robust revival detection.

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

@@ -1,4 +1,5 @@
 import { CacheFlag, TrinketType } from "isaac-typescript-definitions";
+import { MysteriousPaperEffect } from "../enums/MysteriousPaperEffect";
 /**
  * Helper function to get the corresponding golden trinket type from a normal trinket type.
  *
@@ -6,6 +7,27 @@ import { CacheFlag, TrinketType } from "isaac-typescript-definitions";
  * corresponds to the golden trinket sub-type for Swallowed Penny.
  */
 export declare function getGoldenTrinketType(trinketType: TrinketType): TrinketType;
+/**
+ * Helper function to get the current effect that the Mysterious Paper trinket is providing to the
+ * player. Returns undefined if the player does not have the Mysterious Paper trinket.
+ *
+ * The Mysterious Paper trinket has four different effects:
+ *
+ * - The Polaroid (collectible)
+ * - The Negative (collectible)
+ * - A Missing Page (trinket)
+ * - Missing Poster (trinket)
+ *
+ * It rotates between these four effects on every frame. Note that Mysterious Paper will cause the
+ * `EntityPlayer.HasCollectible` and `EntityPlayer.HasTrinket` methods to return true for the
+ * respective items on the particular frame, with the exception of the Missing Poster. (The player
+ * will never "have" the Missing Poster, even on the correct corresponding frame.)
+ *
+ * @param player The player to look at.
+ * @param frameCount Optional. The frame count that corresponds to time the effect will be active.
+ *                   Default is the current frame.
+ */
+export declare function getMysteriousPaperEffectForFrame(player: EntityPlayer, frameCount?: int): MysteriousPaperEffect | undefined;
 /**
  * Returns the slot number corresponding to where a trinket can be safely inserted.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"trinkets.d.ts","sourceRoot":"","sources":["../../../src/functions/trinkets.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EAGT,WAAW,EACZ,MAAM,8BAA8B,CAAC;AAmCtC;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,WAAW,GAAG,WAAW,CAE1E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,GAAG,GAAG,SAAS,CAkBxE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CActE;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAOtE;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAc/D;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,IAAI,WAAW,EAAE,CAE1D;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAOhE;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAErE;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAErE;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAEtE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAYjE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B,IAAI,CAiBN;AAED,6FAA6F;AAC7F,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,SAAS,GACnB,OAAO,CAOT"}
+{"version":3,"file":"trinkets.d.ts","sourceRoot":"","sources":["../../../src/functions/trinkets.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EAGT,WAAW,EACZ,MAAM,8BAA8B,CAAC;AAOtC,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAgCvE;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,WAAW,GAAG,WAAW,CAE1E;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,YAAY,EACpB,UAAU,CAAC,EAAE,GAAG,GACf,qBAAqB,GAAG,SAAS,CAUnC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,GAAG,GAAG,SAAS,CAkBxE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CActE;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAOtE;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAc/D;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,IAAI,WAAW,EAAE,CAE1D;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAOhE;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAErE;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAErE;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAEtE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAYjE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B,IAAI,CAiBN;AAED,6FAA6F;AAC7F,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,SAAS,GACnB,OAAO,CAOT"}

package/dist/src/functions/trinkets.lua

@@ -10,6 +10,8 @@ local BLIND_ITEM_PNG_PATH = ____constants.BLIND_ITEM_PNG_PATH
 local ____constantsFirstLast = require("src.core.constantsFirstLast")
 local FIRST_TRINKET_TYPE = ____constantsFirstLast.FIRST_TRINKET_TYPE
 local LAST_VANILLA_TRINKET_TYPE = ____constantsFirstLast.LAST_VANILLA_TRINKET_TYPE
+local ____MysteriousPaperEffect = require("src.enums.MysteriousPaperEffect")
+local MysteriousPaperEffect = ____MysteriousPaperEffect.MysteriousPaperEffect
 local ____trinketDescriptionMap = require("src.maps.trinketDescriptionMap")
 local DEFAULT_TRINKET_DESCRIPTION = ____trinketDescriptionMap.DEFAULT_TRINKET_DESCRIPTION
 local TRINKET_DESCRIPTION_MAP = ____trinketDescriptionMap.TRINKET_DESCRIPTION_MAP
@@ -18,6 +20,8 @@ local DEFAULT_TRINKET_NAME = ____trinketTypeToNameMap.DEFAULT_TRINKET_NAME
 local TRINKET_TYPE_TO_NAME_MAP = ____trinketTypeToNameMap.TRINKET_TYPE_TO_NAME_MAP
 local ____entities = require("src.functions.entities")
 local getEntityID = ____entities.getEntityID
+local ____enums = require("src.functions.enums")
+local getEnumLength = ____enums.getEnumLength
 local ____flag = require("src.functions.flag")
 local hasFlag = ____flag.hasFlag
 local ____pickupVariants = require("src.functions.pickupVariants")
@@ -39,6 +43,7 @@ end
 -- 
 -- 1 << 15
 local GOLDEN_TRINKET_ADJUSTMENT = 32768
+local NUM_MYSTERIOUS_PAPER_EFFECTS = getEnumLength(nil, MysteriousPaperEffect)
 local TRINKET_ANM2_PATH = "gfx/005.350_trinket.anm2"
 local TRINKET_SPRITE_LAYER = 0
 --- Helper function to get the corresponding golden trinket type from a normal trinket type.
@@ -48,6 +53,33 @@ local TRINKET_SPRITE_LAYER = 0
 function ____exports.getGoldenTrinketType(self, trinketType)
     return asNumber(nil, trinketType) + GOLDEN_TRINKET_ADJUSTMENT
 end
+--- Helper function to get the current effect that the Mysterious Paper trinket is providing to the
+-- player. Returns undefined if the player does not have the Mysterious Paper trinket.
+-- 
+-- The Mysterious Paper trinket has four different effects:
+-- 
+-- - The Polaroid (collectible)
+-- - The Negative (collectible)
+-- - A Missing Page (trinket)
+-- - Missing Poster (trinket)
+-- 
+-- It rotates between these four effects on every frame. Note that Mysterious Paper will cause the
+-- `EntityPlayer.HasCollectible` and `EntityPlayer.HasTrinket` methods to return true for the
+-- respective items on the particular frame, with the exception of the Missing Poster. (The player
+-- will never "have" the Missing Poster, even on the correct corresponding frame.)
+-- 
+-- @param player The player to look at.
+-- @param frameCount Optional. The frame count that corresponds to time the effect will be active.
+-- Default is the current frame.
+function ____exports.getMysteriousPaperEffectForFrame(self, player, frameCount)
+    if frameCount == nil then
+        frameCount = player.FrameCount
+    end
+    if not player:HasTrinket(TrinketType.MYSTERIOUS_PAPER) then
+        return nil
+    end
+    return frameCount % NUM_MYSTERIOUS_PAPER_EFFECTS
+end
 --- Returns the slot number corresponding to where a trinket can be safely inserted.
 -- 
 -- For example:

package/dist/src/index.d.ts

@@ -11,6 +11,7 @@ export * from "./enums/HealthType";
 export * from "./enums/ISCFeature";
 export * from "./enums/LadderSubTypeCustom";
 export * from "./enums/ModCallbackCustom";
+export * from "./enums/MysteriousPaperEffect";
 export * from "./enums/PocketItemType";
 export * from "./enums/RockAltType";
 export * from "./enums/SaveDataKey";

package/dist/src/index.d.ts.map

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

package/dist/src/index.lua

@@ -103,6 +103,14 @@ do
         end
     end
 end
+do
+    local ____export = require("src.enums.MysteriousPaperEffect")
+    for ____exportKey, ____exportValue in pairs(____export) do
+        if ____exportKey ~= "default" then
+            ____exports[____exportKey] = ____exportValue
+        end
+    end
+end
 do
     local ____export = require("src.enums.PocketItemType")
     for ____exportKey, ____exportValue in pairs(____export) do

package/package.json

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

package/src/classes/features/other/customStages/versusScreen.ts

@@ -12,6 +12,7 @@ import { arrayRemove } from "../../../../functions/array";
 import { getBosses } from "../../../../functions/bosses";
 import { getRoomSubType } from "../../../../functions/roomData";
 import { removeCharactersBefore } from "../../../../functions/string";
+import { getScreenCenterPos } from "../../../../functions/ui";
 import { eRange } from "../../../../functions/utils";
 import { CustomStage } from "../../../../interfaces/private/CustomStage";
 import { BOSS_NAME_PNG_FILE_NAMES } from "../../../../objects/bossNamePNGFileNames";
@@ -340,9 +341,7 @@ export function versusScreenPostRender(
     return;
   }
 
-  const room = game.GetRoom();
-  const centerPos = room.GetCenterPos();
-  const position = Isaac.WorldToRenderPosition(centerPos);
+  const position = getScreenCenterPos();
 
   // First, we render the background.
   versusScreenBackgroundSprite.RenderLayer(

package/src/enums/MysteriousPaperEffect.ts

@@ -0,0 +1,12 @@
+/**
+ * The possible effects that the Mysterious Paper trinket can grant.
+ *
+ * This enum has hard-coded values because they correspond to the specific in-game frame count of
+ * the player.
+ */
+export enum MysteriousPaperEffect {
+  POLAROID = 0,
+  NEGATIVE = 1,
+  MISSING_PAGE = 2,
+  MISSING_POSTER = 3,
+}

package/src/functions/revive.ts

@@ -10,11 +10,13 @@ import {
   MAX_TAINTED_SAMSON_BERSERK_CHARGE,
   TAINTED_SAMSON_BERSERK_CHARGE_FROM_TAKING_DAMAGE,
 } from "../core/constants";
+import { MysteriousPaperEffect } from "../enums/MysteriousPaperEffect";
 import { getCharacterDeathAnimationName } from "./characters";
 import { getPlayerMaxHeartContainers } from "./playerHealth";
 import { getPlayerNumHitsRemaining, hasLostCurse, isKeeper } from "./players";
 import { getLastFrameOfAnimation } from "./sprites";
 import { giveTrinketsBack, temporarilyRemoveTrinket } from "./trinketGive";
+import { getMysteriousPaperEffectForFrame } from "./trinkets";
 
 /**
  * Uses the player's current health and other miscellaneous things to determine if incoming damage
@@ -123,7 +125,6 @@ export function isDamageToPlayerFatal(
  * Mysterious Paper be Missing Power is: `gameFrameCount % 4 === 3`
  */
 export function willMysteriousPaperRevive(player: EntityPlayer): boolean {
-  const gameFrameCount = game.GetFrameCount();
   const sprite = player.GetSprite();
 
   // We want to explicitly check the length of the death animation because we might be playing on a
@@ -131,10 +132,17 @@ export function willMysteriousPaperRevive(player: EntityPlayer): boolean {
   const character = player.GetPlayerType();
   const animation = getCharacterDeathAnimationName(character);
   const deathAnimationFrames = getLastFrameOfAnimation(sprite, animation);
-  const frameOfDeath = gameFrameCount + deathAnimationFrames + 1;
-  // (We add 1 because it takes one frame for the death animation to begin.)
+  const frameOfDeath = player.FrameCount + deathAnimationFrames;
+
+  const mysteriousPaperEffect = getMysteriousPaperEffectForFrame(
+    player,
+    frameOfDeath,
+  );
+  if (mysteriousPaperEffect === undefined) {
+    return false;
+  }
 
-  return frameOfDeath % 4 === 3;
+  return mysteriousPaperEffect === MysteriousPaperEffect.MISSING_POSTER;
 }
 
 /**

package/src/functions/trinkets.ts

@@ -10,6 +10,7 @@ import {
   FIRST_TRINKET_TYPE,
   LAST_VANILLA_TRINKET_TYPE,
 } from "../core/constantsFirstLast";
+import { MysteriousPaperEffect } from "../enums/MysteriousPaperEffect";
 import {
   DEFAULT_TRINKET_DESCRIPTION,
   TRINKET_DESCRIPTION_MAP,
@@ -19,6 +20,7 @@ import {
   TRINKET_TYPE_TO_NAME_MAP,
 } from "../maps/trinketTypeToNameMap";
 import { getEntityID } from "./entities";
+import { getEnumLength } from "./enums";
 import { hasFlag } from "./flag";
 import { isTrinket } from "./pickupVariants";
 import { isCharacter } from "./players";
@@ -35,6 +37,8 @@ import { iRange } from "./utils";
  */
 const GOLDEN_TRINKET_ADJUSTMENT = 32768;
 
+const NUM_MYSTERIOUS_PAPER_EFFECTS = getEnumLength(MysteriousPaperEffect);
+
 const TRINKET_ANM2_PATH = "gfx/005.350_trinket.anm2";
 const TRINKET_SPRITE_LAYER = 0;
 
@@ -48,6 +52,41 @@ export function getGoldenTrinketType(trinketType: TrinketType): TrinketType {
   return asNumber(trinketType) + GOLDEN_TRINKET_ADJUSTMENT;
 }
 
+/**
+ * Helper function to get the current effect that the Mysterious Paper trinket is providing to the
+ * player. Returns undefined if the player does not have the Mysterious Paper trinket.
+ *
+ * The Mysterious Paper trinket has four different effects:
+ *
+ * - The Polaroid (collectible)
+ * - The Negative (collectible)
+ * - A Missing Page (trinket)
+ * - Missing Poster (trinket)
+ *
+ * It rotates between these four effects on every frame. Note that Mysterious Paper will cause the
+ * `EntityPlayer.HasCollectible` and `EntityPlayer.HasTrinket` methods to return true for the
+ * respective items on the particular frame, with the exception of the Missing Poster. (The player
+ * will never "have" the Missing Poster, even on the correct corresponding frame.)
+ *
+ * @param player The player to look at.
+ * @param frameCount Optional. The frame count that corresponds to time the effect will be active.
+ *                   Default is the current frame.
+ */
+export function getMysteriousPaperEffectForFrame(
+  player: EntityPlayer,
+  frameCount?: int,
+): MysteriousPaperEffect | undefined {
+  if (frameCount === undefined) {
+    frameCount = player.FrameCount;
+  }
+
+  if (!player.HasTrinket(TrinketType.MYSTERIOUS_PAPER)) {
+    return undefined;
+  }
+
+  return frameCount % NUM_MYSTERIOUS_PAPER_EFFECTS;
+}
+
 /**
  * Returns the slot number corresponding to where a trinket can be safely inserted.
  *

package/src/index.ts

@@ -11,6 +11,7 @@ export * from "./enums/HealthType";
 export * from "./enums/ISCFeature";
 export * from "./enums/LadderSubTypeCustom";
 export * from "./enums/ModCallbackCustom";
+export * from "./enums/MysteriousPaperEffect";
 export * from "./enums/PocketItemType";
 export * from "./enums/RockAltType";
 export * from "./enums/SaveDataKey";