isaacscript-common 3.1.0 → 3.1.1

package/callbacks/postPickupInitFirst.d.ts

@@ -0,0 +1 @@
+export {};

package/callbacks/postPickupInitFirst.lua

@@ -0,0 +1,55 @@
+local ____lualib = require("lualib_bundle")
+local Set = ____lualib.Set
+local __TS__New = ____lualib.__TS__New
+local ____exports = {}
+local hasSubscriptions, postPickupInit, POST_ASCENT_ROOM_TYPES, v
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local GameStateFlag = ____isaac_2Dtypescript_2Ddefinitions.GameStateFlag
+local ModCallback = ____isaac_2Dtypescript_2Ddefinitions.ModCallback
+local RoomType = ____isaac_2Dtypescript_2Ddefinitions.RoomType
+local ____cachedClasses = require("cachedClasses")
+local game = ____cachedClasses.game
+local ____exports = require("features.saveDataManager.exports")
+local saveDataManager = ____exports.saveDataManager
+local ____roomData = require("functions.roomData")
+local getRoomVisitedCount = ____roomData.getRoomVisitedCount
+local ____postPickupInitFirst = require("callbacks.subscriptions.postPickupInitFirst")
+local postPickupInitFirstFire = ____postPickupInitFirst.postPickupInitFirstFire
+local postPickupInitFirstHasSubscriptions = ____postPickupInitFirst.postPickupInitFirstHasSubscriptions
+function hasSubscriptions(self)
+    return postPickupInitFirstHasSubscriptions(nil)
+end
+function postPickupInit(self, pickup)
+    if not hasSubscriptions(nil) then
+        return
+    end
+    local room = game:GetRoom()
+    local roomType = room:GetType()
+    local roomFrameCount = room:GetFrameCount()
+    local previouslySeen = v.run.postAscentPickupInitSeeds:has(pickup.InitSeed)
+    if POST_ASCENT_ROOM_TYPES:has(roomType) then
+        v.run.postAscentPickupInitSeeds:add(pickup.InitSeed)
+    end
+    if roomFrameCount > 0 then
+        postPickupInitFirstFire(nil, pickup)
+        return
+    end
+    local roomVisitedCount = getRoomVisitedCount(nil)
+    if roomVisitedCount > 0 then
+        return
+    end
+    local onAscent = game:GetStateFlag(GameStateFlag.BACKWARDS_PATH)
+    if onAscent and POST_ASCENT_ROOM_TYPES:has(roomType) and previouslySeen then
+        return
+    end
+    postPickupInitFirstFire(nil, pickup)
+end
+POST_ASCENT_ROOM_TYPES = __TS__New(Set, {RoomType.TREASURE, RoomType.BOSS})
+v = {run = {postAscentPickupInitSeeds = __TS__New(Set)}}
+---
+-- @internal
+function ____exports.postPickupInitFirstCallbackInit(self, mod)
+    saveDataManager(nil, "postPickupInitFirst", v, hasSubscriptions)
+    mod:AddCallback(ModCallback.POST_PICKUP_INIT, postPickupInit)
+end
+return ____exports

package/callbacks/subscriptions/postPickupInitFirst.d.ts

@@ -0,0 +1,3 @@
+/// <reference types="isaac-typescript-definitions" />
+export declare type PostPickupInitFirstRegisterParameters = PickupRegisterParameters<[
+], void>;

package/callbacks/subscriptions/postPickupInitFirst.lua

@@ -0,0 +1,29 @@
+local ____exports = {}
+local subscriptions = {}
+---
+-- @internal
+function ____exports.postPickupInitFirstHasSubscriptions(self)
+    return #subscriptions > 0
+end
+---
+-- @internal
+function ____exports.postPickupInitFirstRegister(self, ...)
+    local args = {...}
+    subscriptions[#subscriptions + 1] = args
+end
+---
+-- @internal
+function ____exports.postPickupInitFirstFire(self, pickup)
+    for ____, ____value in ipairs(subscriptions) do
+        local callback = ____value[1]
+        local pickupVariant = ____value[2]
+        do
+            if pickupVariant ~= nil and pickupVariant ~= pickup.Variant then
+                goto __continue5
+            end
+            callback(nil, pickup)
+        end
+        ::__continue5::
+    end
+end
+return ____exports

package/enums/ModCallbackCustom.d.ts

@@ -143,7 +143,7 @@ export declare enum ModCallbackCustom {
      * only fire if the familiar variant matches the `FamiliarVariant` provided.
      *
      * ```ts
-     * function postTearInitLate(familiar: EntityFamiliar): void {}
+     * function postFamiliarInitLate(familiar: EntityFamiliar): void {}
      * ```
      */
     POST_FAMILIAR_INIT_LATE = 11,
@@ -490,6 +490,28 @@ export declare enum ModCallbackCustom {
      * ```
      */
     POST_PICKUP_COLLECT = 36,
+    /**
+     * Fires from the `MC_POST_PICKUP_INIT` callback on the first time that a player has seen the
+     * respective pickup on the run.
+     *
+     * This callback is useful because pickups will despawn upon leaving the room and respawn upon
+     * re-entering the room.
+     *
+     * For most cases, this callback will simply fire when `MC_POST_PICKUP_INIT` fires and the player
+     * is not re-entering a previously visited room.
+     *
+     * The special case is when a player enters a post-Ascent Treasure Room or Boss Room. For these
+     * cases, the `InitSeed` of any pickups seen from previous floors is kept track of to prevent the
+     * callback from firing when re-entering the room.
+     *
+     * When registering the callback, takes an optional second argument that will make the callback
+     * only fire if the collectible type matches the `PickupVariant` provided.
+     *
+     * ```ts
+     * function postPickupInitFirst(pickup: EntityPickup): void {}
+     * ```
+     */
+    POST_PICKUP_INIT_FIRST = 37,
     /**
      * Fires on the first `MC_POST_PICKUP_UPDATE` frame for each pickup.
      *
@@ -503,7 +525,7 @@ export declare enum ModCallbackCustom {
      * function postPickupInitLate(pickup: EntityPickup): void {}
      * ```
      */
-    POST_PICKUP_INIT_LATE = 37,
+    POST_PICKUP_INIT_LATE = 38,
     /**
      * Fires from the `MC_POST_PICKUP_UPDATE` callback when a pickup's state has changed from what it
      * was on the previous frame.
@@ -519,9 +541,9 @@ export declare enum ModCallbackCustom {
      * ): void {}
      * ```
      */
-    POST_PICKUP_STATE_CHANGED = 38,
-    POST_PIT_RENDER = 39,
-    POST_PIT_UPDATE = 40,
+    POST_PICKUP_STATE_CHANGED = 39,
+    POST_PIT_RENDER = 40,
+    POST_PIT_UPDATE = 41,
     /**
      * Fires from the `MC_POST_PEFFECT_UPDATE` callback when a player entity gains or loses any health
      * (i.e. hearts). For more information, see the `PlayerHealth` enum.
@@ -537,7 +559,7 @@ export declare enum ModCallbackCustom {
      * ) {}
      * ```
      */
-    POST_PLAYER_CHANGE_HEALTH = 41,
+    POST_PLAYER_CHANGE_HEALTH = 42,
     /**
      * Fires from the `MC_POST_PEFFECT_UPDATE` callback when a player entity changes its player type
      * (i.e. character). For example, it will fire after using Clicker, after dying with the Judas'
@@ -555,7 +577,7 @@ export declare enum ModCallbackCustom {
      * ) {}
      * ```
      */
-    POST_PLAYER_CHANGE_TYPE = 42,
+    POST_PLAYER_CHANGE_TYPE = 43,
     /**
      * Fires from the `MC_ENTITY_TAKE_DMG` callback when a player takes fatal damage. Return false to
      * prevent the fatal damage.
@@ -572,7 +594,7 @@ export declare enum ModCallbackCustom {
      * function postPlayerFatalDamage(player: EntityPlayer) {}
      * ```
      */
-    POST_PLAYER_FATAL_DAMAGE = 43,
+    POST_PLAYER_FATAL_DAMAGE = 44,
     /**
      * Fires on the first `MC_POST_PLAYER_UPDATE` frame for each player.
      *
@@ -586,7 +608,7 @@ export declare enum ModCallbackCustom {
      * function postPlayerInitLate(pickup: EntityPickup): void {}
      * ```
      */
-    POST_PLAYER_INIT_LATE = 44,
+    POST_PLAYER_INIT_LATE = 45,
     /**
      * Similar to the vanilla callback of the same name, but fires after the `MC_POST_GAME_STARTED`
      * callback fires (if the player is spawning on the 0th game frame of the run).
@@ -607,8 +629,8 @@ export declare enum ModCallbackCustom {
      * function postPlayerInitReordered(player: EntityPlayer): void {}
      * ```
      */
-    POST_PLAYER_INIT_REORDERED = 45,
-    POST_PLAYER_RENDER_REORDERED = 46,
+    POST_PLAYER_INIT_REORDERED = 46,
+    POST_PLAYER_RENDER_REORDERED = 47,
     /**
      * Similar to the vanilla callback of the same name, but fires after the `MC_POST_GAME_STARTED`
      * callback fires (if the player is being updated on the 0th game frame of the run).
@@ -629,11 +651,11 @@ export declare enum ModCallbackCustom {
      * function postPlayerUpdateReordered(player: EntityPlayer): void {}
      * ```
      */
-    POST_PLAYER_UPDATE_REORDERED = 47,
-    POST_POOP_RENDER = 48,
-    POST_POOP_UPDATE = 49,
-    POST_PRESSURE_PLATE_RENDER = 50,
-    POST_PRESSURE_PLATE_UPDATE = 51,
+    POST_PLAYER_UPDATE_REORDERED = 48,
+    POST_POOP_RENDER = 49,
+    POST_POOP_UPDATE = 50,
+    POST_PRESSURE_PLATE_RENDER = 51,
+    POST_PRESSURE_PLATE_UPDATE = 52,
     /**
      * Fires on the first `MC_POST_PROJECTILE_UPDATE` frame for each projectile.
      *
@@ -647,7 +669,7 @@ export declare enum ModCallbackCustom {
      * function postProjectileInitLate(projectile: EntityProjectile): void {}
      * ```
      */
-    POST_PROJECTILE_INIT_LATE = 52,
+    POST_PROJECTILE_INIT_LATE = 53,
     /**
      * Fires from the `MC_POST_PEFFECT_UPDATE` callback when a player first picks up a new item. The
      * pickup returned in the callback is assumed to be the first pickup that no longer exists.
@@ -661,10 +683,10 @@ export declare enum ModCallbackCustom {
      * function postPurchase(player: EntityPlayer, pickup: EntityPickup): void {}
      * ```
      */
-    POST_PURCHASE = 53,
-    POST_ROCK_RENDER = 54,
-    POST_ROCK_UPDATE = 55,
-    POST_ROOM_CLEAR_CHANGED = 56,
+    POST_PURCHASE = 54,
+    POST_ROCK_RENDER = 55,
+    POST_ROCK_UPDATE = 56,
+    POST_ROOM_CLEAR_CHANGED = 57,
     /**
      * Fires from the `MC_ENTITY_TAKE_DMG` callback when a player takes damage from spikes in a
      * Sacrifice Room.
@@ -673,7 +695,7 @@ export declare enum ModCallbackCustom {
      * function postSacrifice(player: EntityPlayer, numSacrifices: int): void {}
      * ```
      */
-    POST_SACRIFICE = 57,
+    POST_SACRIFICE = 58,
     /**
      * Fires from the `MC_POST_RENDER` callback when a slot entity's animation changes.
      *
@@ -684,7 +706,7 @@ export declare enum ModCallbackCustom {
      * function postSlotAnimationChanged(slot: Entity): void {}
      * ```
      */
-    POST_SLOT_ANIMATION_CHANGED = 58,
+    POST_SLOT_ANIMATION_CHANGED = 59,
     /**
      * Fires from the `MC_POST_RENDER` callback when a slot plays the animation that indicates that it
      * has broken.
@@ -696,7 +718,7 @@ export declare enum ModCallbackCustom {
      * function postSlotDestroyed(slot: Entity): void {}
      * ```
      */
-    POST_SLOT_DESTROYED = 59,
+    POST_SLOT_DESTROYED = 60,
     /**
      * Fires when a new slot entity is initialized. Specifically, this is either:
      *
@@ -712,7 +734,7 @@ export declare enum ModCallbackCustom {
      * function postSlotInit(slot: Entity): void {}
      * ```
      */
-    POST_SLOT_INIT = 60,
+    POST_SLOT_INIT = 61,
     /**
      * Fires from the `MC_POST_RENDER` callback on every frame that a slot entity exists.
      *
@@ -723,7 +745,7 @@ export declare enum ModCallbackCustom {
      * function postSlotRender(slot: Entity): void {}
      * ```
      */
-    POST_SLOT_RENDER = 61,
+    POST_SLOT_RENDER = 62,
     /**
      * Fires from the `MC_POST_UPDATE` callback on every frame that a slot entity exists.
      *
@@ -734,9 +756,9 @@ export declare enum ModCallbackCustom {
      * function postSlotUpdate(slot: Entity): void {}
      * ```
      */
-    POST_SLOT_UPDATE = 62,
-    POST_SPIKES_RENDER = 63,
-    POST_SPIKES_UPDATE = 64,
+    POST_SLOT_UPDATE = 63,
+    POST_SPIKES_RENDER = 64,
+    POST_SPIKES_UPDATE = 65,
     /**
      * Fires on the first `MC_POST_TEAR_UPDATE` frame for each tear.
      *
@@ -750,7 +772,7 @@ export declare enum ModCallbackCustom {
      * function postTearInitLate(tear: EntityTear): void {}
      * ```
      */
-    POST_TEAR_INIT_LATE = 65,
+    POST_TEAR_INIT_LATE = 66,
     /**
      * Fires on the second `MC_POST_TEAR_UPDATE` frame for each tear (i.e. frame 1).
      *
@@ -763,9 +785,9 @@ export declare enum ModCallbackCustom {
      * function postTearInitVeryLate(tear: EntityTear): void {}
      * ```
      */
-    POST_TEAR_INIT_VERY_LATE = 66,
-    POST_TNT_RENDER = 67,
-    POST_TNT_UPDATE = 68,
+    POST_TEAR_INIT_VERY_LATE = 67,
+    POST_TNT_RENDER = 68,
+    POST_TNT_UPDATE = 69,
     /**
      * Fires from the `MC_POST_PEFFECT_UPDATE` callback when a player gains or loses a new
      * transformation.
@@ -783,7 +805,7 @@ export declare enum ModCallbackCustom {
      * ): void {}
      * ```
      */
-    POST_TRANSFORMATION = 69,
+    POST_TRANSFORMATION = 70,
     /**
      * Fires from `MC_ENTITY_TAKE_DMG` callback when a Wishbone or a Walnut breaks.
      *
@@ -797,7 +819,7 @@ export declare enum ModCallbackCustom {
      * ): void {}
      * ```
      */
-    POST_TRINKET_BREAK = 70,
+    POST_TRINKET_BREAK = 71,
     /**
      * Fires from the `MC_POST_PEFFECT_UPDATE` callback on the frame before a Berserk! effect ends
      * when the player is predicted to die (e.g. they currently have no health left or they took
@@ -810,7 +832,7 @@ export declare enum ModCallbackCustom {
      * function preBerserkDeath(player: EntityPlayer) {}
      * ```
      */
-    PRE_BERSERK_DEATH = 71,
+    PRE_BERSERK_DEATH = 72,
     /**
      * Fires from the `MC_POST_PLAYER_FATAL_DAMAGE` callback when a player is about to die. If you
      * want to initiate a custom revival, return an integer that corresponds to the item or type of
@@ -823,7 +845,7 @@ export declare enum ModCallbackCustom {
      * function preCustomRevive(player: EntityPlayer) {}
      * ```
      */
-    PRE_CUSTOM_REVIVE = 72,
+    PRE_CUSTOM_REVIVE = 73,
     /**
      * Fires from the `MC_POST_PEFFECT_UPDATE` callback when an item becomes queued (i.e. when the
      * player begins to hold the item above their head).
@@ -842,7 +864,7 @@ export declare enum ModCallbackCustom {
      * ): void {}
      * ```
      */
-    PRE_ITEM_PICKUP = 73,
+    PRE_ITEM_PICKUP = 74,
     /**
      * Fires on the `MC_POST_RENDER` frame before the player is taken to a new floor. Only fires when
      * a player jumps into a trapdoor or enters a heaven door (beam of light). Does not fire on the
@@ -856,5 +878,5 @@ export declare enum ModCallbackCustom {
      * function preNewLevel(player: EntityPlayer): void {}
      * ```
      */
-    PRE_NEW_LEVEL = 74
+    PRE_NEW_LEVEL = 75
 }

package/enums/ModCallbackCustom.lua

@@ -80,80 +80,82 @@ ____exports.ModCallbackCustom.POST_PEFFECT_UPDATE_REORDERED = 35
 ____exports.ModCallbackCustom[____exports.ModCallbackCustom.POST_PEFFECT_UPDATE_REORDERED] = "POST_PEFFECT_UPDATE_REORDERED"
 ____exports.ModCallbackCustom.POST_PICKUP_COLLECT = 36
 ____exports.ModCallbackCustom[____exports.ModCallbackCustom.POST_PICKUP_COLLECT] = "POST_PICKUP_COLLECT"
-____exports.ModCallbackCustom.POST_PICKUP_INIT_LATE = 37
+____exports.ModCallbackCustom.POST_PICKUP_INIT_FIRST = 37
+____exports.ModCallbackCustom[____exports.ModCallbackCustom.POST_PICKUP_INIT_FIRST] = "POST_PICKUP_INIT_FIRST"
+____exports.ModCallbackCustom.POST_PICKUP_INIT_LATE = 38
 ____exports.ModCallbackCustom[____exports.ModCallbackCustom.POST_PICKUP_INIT_LATE] = "POST_PICKUP_INIT_LATE"
-____exports.ModCallbackCustom.POST_PICKUP_STATE_CHANGED = 38
+____exports.ModCallbackCustom.POST_PICKUP_STATE_CHANGED = 39
 ____exports.ModCallbackCustom[____exports.ModCallbackCustom.POST_PICKUP_STATE_CHANGED] = "POST_PICKUP_STATE_CHANGED"
-____exports.ModCallbackCustom.POST_PIT_RENDER = 39
+____exports.ModCallbackCustom.POST_PIT_RENDER = 40
 ____exports.ModCallbackCustom[____exports.ModCallbackCustom.POST_PIT_RENDER] = "POST_PIT_RENDER"
-____exports.ModCallbackCustom.POST_PIT_UPDATE = 40
+____exports.ModCallbackCustom.POST_PIT_UPDATE = 41
 ____exports.ModCallbackCustom[____exports.ModCallbackCustom.POST_PIT_UPDATE] = "POST_PIT_UPDATE"
-____exports.ModCallbackCustom.POST_PLAYER_CHANGE_HEALTH = 41
+____exports.ModCallbackCustom.POST_PLAYER_CHANGE_HEALTH = 42
 ____exports.ModCallbackCustom[____exports.ModCallbackCustom.POST_PLAYER_CHANGE_HEALTH] = "POST_PLAYER_CHANGE_HEALTH"
-____exports.ModCallbackCustom.POST_PLAYER_CHANGE_TYPE = 42
+____exports.ModCallbackCustom.POST_PLAYER_CHANGE_TYPE = 43
 ____exports.ModCallbackCustom[____exports.ModCallbackCustom.POST_PLAYER_CHANGE_TYPE] = "POST_PLAYER_CHANGE_TYPE"
-____exports.ModCallbackCustom.POST_PLAYER_FATAL_DAMAGE = 43
+____exports.ModCallbackCustom.POST_PLAYER_FATAL_DAMAGE = 44
 ____exports.ModCallbackCustom[____exports.ModCallbackCustom.POST_PLAYER_FATAL_DAMAGE] = "POST_PLAYER_FATAL_DAMAGE"
-____exports.ModCallbackCustom.POST_PLAYER_INIT_LATE = 44
+____exports.ModCallbackCustom.POST_PLAYER_INIT_LATE = 45
 ____exports.ModCallbackCustom[____exports.ModCallbackCustom.POST_PLAYER_INIT_LATE] = "POST_PLAYER_INIT_LATE"
-____exports.ModCallbackCustom.POST_PLAYER_INIT_REORDERED = 45
+____exports.ModCallbackCustom.POST_PLAYER_INIT_REORDERED = 46
 ____exports.ModCallbackCustom[____exports.ModCallbackCustom.POST_PLAYER_INIT_REORDERED] = "POST_PLAYER_INIT_REORDERED"
-____exports.ModCallbackCustom.POST_PLAYER_RENDER_REORDERED = 46
+____exports.ModCallbackCustom.POST_PLAYER_RENDER_REORDERED = 47
 ____exports.ModCallbackCustom[____exports.ModCallbackCustom.POST_PLAYER_RENDER_REORDERED] = "POST_PLAYER_RENDER_REORDERED"
-____exports.ModCallbackCustom.POST_PLAYER_UPDATE_REORDERED = 47
+____exports.ModCallbackCustom.POST_PLAYER_UPDATE_REORDERED = 48
 ____exports.ModCallbackCustom[____exports.ModCallbackCustom.POST_PLAYER_UPDATE_REORDERED] = "POST_PLAYER_UPDATE_REORDERED"
-____exports.ModCallbackCustom.POST_POOP_RENDER = 48
+____exports.ModCallbackCustom.POST_POOP_RENDER = 49
 ____exports.ModCallbackCustom[____exports.ModCallbackCustom.POST_POOP_RENDER] = "POST_POOP_RENDER"
-____exports.ModCallbackCustom.POST_POOP_UPDATE = 49
+____exports.ModCallbackCustom.POST_POOP_UPDATE = 50
 ____exports.ModCallbackCustom[____exports.ModCallbackCustom.POST_POOP_UPDATE] = "POST_POOP_UPDATE"
-____exports.ModCallbackCustom.POST_PRESSURE_PLATE_RENDER = 50
+____exports.ModCallbackCustom.POST_PRESSURE_PLATE_RENDER = 51
 ____exports.ModCallbackCustom[____exports.ModCallbackCustom.POST_PRESSURE_PLATE_RENDER] = "POST_PRESSURE_PLATE_RENDER"
-____exports.ModCallbackCustom.POST_PRESSURE_PLATE_UPDATE = 51
+____exports.ModCallbackCustom.POST_PRESSURE_PLATE_UPDATE = 52
 ____exports.ModCallbackCustom[____exports.ModCallbackCustom.POST_PRESSURE_PLATE_UPDATE] = "POST_PRESSURE_PLATE_UPDATE"
-____exports.ModCallbackCustom.POST_PROJECTILE_INIT_LATE = 52
+____exports.ModCallbackCustom.POST_PROJECTILE_INIT_LATE = 53
 ____exports.ModCallbackCustom[____exports.ModCallbackCustom.POST_PROJECTILE_INIT_LATE] = "POST_PROJECTILE_INIT_LATE"
-____exports.ModCallbackCustom.POST_PURCHASE = 53
+____exports.ModCallbackCustom.POST_PURCHASE = 54
 ____exports.ModCallbackCustom[____exports.ModCallbackCustom.POST_PURCHASE] = "POST_PURCHASE"
-____exports.ModCallbackCustom.POST_ROCK_RENDER = 54
+____exports.ModCallbackCustom.POST_ROCK_RENDER = 55
 ____exports.ModCallbackCustom[____exports.ModCallbackCustom.POST_ROCK_RENDER] = "POST_ROCK_RENDER"
-____exports.ModCallbackCustom.POST_ROCK_UPDATE = 55
+____exports.ModCallbackCustom.POST_ROCK_UPDATE = 56
 ____exports.ModCallbackCustom[____exports.ModCallbackCustom.POST_ROCK_UPDATE] = "POST_ROCK_UPDATE"
-____exports.ModCallbackCustom.POST_ROOM_CLEAR_CHANGED = 56
+____exports.ModCallbackCustom.POST_ROOM_CLEAR_CHANGED = 57
 ____exports.ModCallbackCustom[____exports.ModCallbackCustom.POST_ROOM_CLEAR_CHANGED] = "POST_ROOM_CLEAR_CHANGED"
-____exports.ModCallbackCustom.POST_SACRIFICE = 57
+____exports.ModCallbackCustom.POST_SACRIFICE = 58
 ____exports.ModCallbackCustom[____exports.ModCallbackCustom.POST_SACRIFICE] = "POST_SACRIFICE"
-____exports.ModCallbackCustom.POST_SLOT_ANIMATION_CHANGED = 58
+____exports.ModCallbackCustom.POST_SLOT_ANIMATION_CHANGED = 59
 ____exports.ModCallbackCustom[____exports.ModCallbackCustom.POST_SLOT_ANIMATION_CHANGED] = "POST_SLOT_ANIMATION_CHANGED"
-____exports.ModCallbackCustom.POST_SLOT_DESTROYED = 59
+____exports.ModCallbackCustom.POST_SLOT_DESTROYED = 60
 ____exports.ModCallbackCustom[____exports.ModCallbackCustom.POST_SLOT_DESTROYED] = "POST_SLOT_DESTROYED"
-____exports.ModCallbackCustom.POST_SLOT_INIT = 60
+____exports.ModCallbackCustom.POST_SLOT_INIT = 61
 ____exports.ModCallbackCustom[____exports.ModCallbackCustom.POST_SLOT_INIT] = "POST_SLOT_INIT"
-____exports.ModCallbackCustom.POST_SLOT_RENDER = 61
+____exports.ModCallbackCustom.POST_SLOT_RENDER = 62
 ____exports.ModCallbackCustom[____exports.ModCallbackCustom.POST_SLOT_RENDER] = "POST_SLOT_RENDER"
-____exports.ModCallbackCustom.POST_SLOT_UPDATE = 62
+____exports.ModCallbackCustom.POST_SLOT_UPDATE = 63
 ____exports.ModCallbackCustom[____exports.ModCallbackCustom.POST_SLOT_UPDATE] = "POST_SLOT_UPDATE"
-____exports.ModCallbackCustom.POST_SPIKES_RENDER = 63
+____exports.ModCallbackCustom.POST_SPIKES_RENDER = 64
 ____exports.ModCallbackCustom[____exports.ModCallbackCustom.POST_SPIKES_RENDER] = "POST_SPIKES_RENDER"
-____exports.ModCallbackCustom.POST_SPIKES_UPDATE = 64
+____exports.ModCallbackCustom.POST_SPIKES_UPDATE = 65
 ____exports.ModCallbackCustom[____exports.ModCallbackCustom.POST_SPIKES_UPDATE] = "POST_SPIKES_UPDATE"
-____exports.ModCallbackCustom.POST_TEAR_INIT_LATE = 65
+____exports.ModCallbackCustom.POST_TEAR_INIT_LATE = 66
 ____exports.ModCallbackCustom[____exports.ModCallbackCustom.POST_TEAR_INIT_LATE] = "POST_TEAR_INIT_LATE"
-____exports.ModCallbackCustom.POST_TEAR_INIT_VERY_LATE = 66
+____exports.ModCallbackCustom.POST_TEAR_INIT_VERY_LATE = 67
 ____exports.ModCallbackCustom[____exports.ModCallbackCustom.POST_TEAR_INIT_VERY_LATE] = "POST_TEAR_INIT_VERY_LATE"
-____exports.ModCallbackCustom.POST_TNT_RENDER = 67
+____exports.ModCallbackCustom.POST_TNT_RENDER = 68
 ____exports.ModCallbackCustom[____exports.ModCallbackCustom.POST_TNT_RENDER] = "POST_TNT_RENDER"
-____exports.ModCallbackCustom.POST_TNT_UPDATE = 68
+____exports.ModCallbackCustom.POST_TNT_UPDATE = 69
 ____exports.ModCallbackCustom[____exports.ModCallbackCustom.POST_TNT_UPDATE] = "POST_TNT_UPDATE"
-____exports.ModCallbackCustom.POST_TRANSFORMATION = 69
+____exports.ModCallbackCustom.POST_TRANSFORMATION = 70
 ____exports.ModCallbackCustom[____exports.ModCallbackCustom.POST_TRANSFORMATION] = "POST_TRANSFORMATION"
-____exports.ModCallbackCustom.POST_TRINKET_BREAK = 70
+____exports.ModCallbackCustom.POST_TRINKET_BREAK = 71
 ____exports.ModCallbackCustom[____exports.ModCallbackCustom.POST_TRINKET_BREAK] = "POST_TRINKET_BREAK"
-____exports.ModCallbackCustom.PRE_BERSERK_DEATH = 71
+____exports.ModCallbackCustom.PRE_BERSERK_DEATH = 72
 ____exports.ModCallbackCustom[____exports.ModCallbackCustom.PRE_BERSERK_DEATH] = "PRE_BERSERK_DEATH"
-____exports.ModCallbackCustom.PRE_CUSTOM_REVIVE = 72
+____exports.ModCallbackCustom.PRE_CUSTOM_REVIVE = 73
 ____exports.ModCallbackCustom[____exports.ModCallbackCustom.PRE_CUSTOM_REVIVE] = "PRE_CUSTOM_REVIVE"
-____exports.ModCallbackCustom.PRE_ITEM_PICKUP = 73
+____exports.ModCallbackCustom.PRE_ITEM_PICKUP = 74
 ____exports.ModCallbackCustom[____exports.ModCallbackCustom.PRE_ITEM_PICKUP] = "PRE_ITEM_PICKUP"
-____exports.ModCallbackCustom.PRE_NEW_LEVEL = 74
+____exports.ModCallbackCustom.PRE_NEW_LEVEL = 75
 ____exports.ModCallbackCustom[____exports.ModCallbackCustom.PRE_NEW_LEVEL] = "PRE_NEW_LEVEL"
 return ____exports

package/functions/bombs.d.ts

@@ -0,0 +1,3 @@
+/// <reference types="isaac-typescript-definitions" />
+/** Helper function to find out how large a bomb explosion is based on the damage inflicted. */
+export declare function getBombRadiusFromDamage(damage: float): float;

package/functions/bombs.lua

@@ -0,0 +1,12 @@
+local ____exports = {}
+--- Helper function to find out how large a bomb explosion is based on the damage inflicted.
+function ____exports.getBombRadiusFromDamage(self, damage)
+    if damage > 175 then
+        return 105
+    end
+    if damage <= 140 then
+        return 75
+    end
+    return 90
+end
+return ____exports

package/functions/collectibles.d.ts

@@ -52,13 +52,13 @@ export declare function getCollectibleGfxFilename(collectibleType: CollectibleTy
  *   and the pedestal pushed to an adjacent tile, but this case should be extremely rare.)
  * - Mega Chests spawn two collectibles on the exact same position. However, both of them will have
  *   different InitSeeds, so this is not a problem for this indexing scheme.
- * - The indexing scheme used is different for collectibles that are inside of a Treasure Room, in
- *   order to handle the case of the player seeing the same collectible again in a post-Ascent
- *   Treasure Room. A 5-tuple of stage, stage type, grid index, SubType, and InitSeed is used in
- *   this case. (Using the room list index or the room grid index is not suitable for this purpose,
- *   since both of these values can change in the post-Ascent Treasure Room.) Even though there can
- *   be two Treasure Rooms on an XL floor, both Treasure Rooms should not have collectibles with the
- *   same grid index, Subtype, and InitSeed.
+ * - The indexing scheme used is different for collectibles that are inside of a Treasure Room or
+ *   Boss Room, in order to handle the case of the player seeing the same collectible again in a
+ *   post-Ascent Treasure Room or Boss Room. A 5-tuple of stage, stage type, grid index, SubType,
+ *   and InitSeed is used in this case. (Using the room list index or the room grid index is not
+ *   suitable for this purpose, since both of these values can change in the post-Ascent rooms.)
+ *   Even though Treasure Rooms and Boss Rooms are grouped together in this scheme, there probably
+ *   will not be collectibles with the same grid index, SubType, and InitSeed.
  */
 export declare function getCollectibleIndex(collectible: EntityPickup): CollectibleIndex;
 /**

package/functions/collectibles.lua

@@ -176,13 +176,13 @@ end
 --   and the pedestal pushed to an adjacent tile, but this case should be extremely rare.)
 -- - Mega Chests spawn two collectibles on the exact same position. However, both of them will have
 --   different InitSeeds, so this is not a problem for this indexing scheme.
--- - The indexing scheme used is different for collectibles that are inside of a Treasure Room, in
---   order to handle the case of the player seeing the same collectible again in a post-Ascent
---   Treasure Room. A 5-tuple of stage, stage type, grid index, SubType, and InitSeed is used in
---   this case. (Using the room list index or the room grid index is not suitable for this purpose,
---   since both of these values can change in the post-Ascent Treasure Room.) Even though there can
---   be two Treasure Rooms on an XL floor, both Treasure Rooms should not have collectibles with the
---   same grid index, Subtype, and InitSeed.
+-- - The indexing scheme used is different for collectibles that are inside of a Treasure Room or
+--   Boss Room, in order to handle the case of the player seeing the same collectible again in a
+--   post-Ascent Treasure Room or Boss Room. A 5-tuple of stage, stage type, grid index, SubType,
+--   and InitSeed is used in this case. (Using the room list index or the room grid index is not
+--   suitable for this purpose, since both of these values can change in the post-Ascent rooms.)
+--   Even though Treasure Rooms and Boss Rooms are grouped together in this scheme, there probably
+--   will not be collectibles with the same grid index, SubType, and InitSeed.
 function ____exports.getCollectibleIndex(self, collectible)
     if not isCollectible(nil, collectible) then
         local entityID = getEntityID(nil, collectible)
@@ -195,7 +195,7 @@ function ____exports.getCollectibleIndex(self, collectible)
     local roomType = room:GetType()
     local gridIndex = room:GetGridIndex(collectible.Position)
     local roomListIndex = getRoomListIndex(nil)
-    if roomType == RoomType.TREASURE then
+    if roomType == RoomType.TREASURE or roomType == RoomType.BOSS then
         return (((((((tostring(stage) .. ",") .. tostring(stageType)) .. ",") .. tostring(gridIndex)) .. ",") .. tostring(collectible.SubType)) .. ",") .. tostring(collectible.InitSeed)
     end
     return (((((tostring(roomListIndex) .. ",") .. tostring(gridIndex)) .. ",") .. tostring(collectible.SubType)) .. ",") .. tostring(collectible.InitSeed)

package/functions/direction.d.ts

@@ -1,4 +1,11 @@
 import { Direction } from "isaac-typescript-definitions";
+/**
+ * Helper function to convert the degrees of an angle to the `Direction` enum.
+ *
+ * Note that this function considers 0 degrees to be pointing to the right, which is unusual because
+ * 0 normally corresponds to up. (This corresponds to how the `Vector.GetAngleDegrees` method
+ * works.)
+ */
 export declare function angleToDirection(angleDegrees: int): Direction;
 export declare function directionToDegrees(direction: Direction): int;
 export declare function directionToVector(direction: Direction): Vector;

package/functions/direction.lua

@@ -7,6 +7,11 @@ local ____directionToDegrees = require("objects.directionToDegrees")
 local DIRECTION_TO_DEGREES = ____directionToDegrees.DIRECTION_TO_DEGREES
 local ____directionToVector = require("objects.directionToVector")
 local DIRECTION_TO_VECTOR = ____directionToVector.DIRECTION_TO_VECTOR
+--- Helper function to convert the degrees of an angle to the `Direction` enum.
+-- 
+-- Note that this function considers 0 degrees to be pointing to the right, which is unusual because
+-- 0 normally corresponds to up. (This corresponds to how the `Vector.GetAngleDegrees` method
+-- works.)
 function ____exports.angleToDirection(self, angleDegrees)
     local positiveDegrees = angleDegrees
     while positiveDegrees < 0 do
@@ -14,18 +19,18 @@ function ____exports.angleToDirection(self, angleDegrees)
     end
     local normalizedDegrees = positiveDegrees % 360
     if normalizedDegrees < 45 then
-        return Direction.UP
+        return Direction.RIGHT
     end
     if normalizedDegrees < 135 then
-        return Direction.RIGHT
+        return Direction.DOWN
     end
     if normalizedDegrees < 225 then
-        return Direction.DOWN
+        return Direction.LEFT
     end
     if normalizedDegrees < 315 then
-        return Direction.RIGHT
+        return Direction.UP
     end
-    return Direction.UP
+    return Direction.RIGHT
 end
 function ____exports.directionToDegrees(self, direction)
     return DIRECTION_TO_DEGREES[direction]

package/functions/player.d.ts

@@ -100,6 +100,8 @@ export declare function getPlayerCollectibleCount(player: EntityPlayer, ...colle
  * the player has.
  */
 export declare function getPlayerCollectibleMap(player: EntityPlayer): Map<CollectibleType, int>;
+/** Helper function to get the player from a tear, laser, bomb, etc. */
+export declare function getPlayerFromTear(entity: Entity): EntityPlayer | undefined;
 /**
  * Returns the number of red hearts that the player has, excluding any rotten hearts. For example,
  * if the player has one full black heart, one full soul heart, and one half black heart, this
@@ -207,6 +209,11 @@ export declare function isBethany(player: EntityPlayer): boolean;
  * for. Returns true if the player is any of the supplied characters.
  */
 export declare function isCharacter(player: EntityPlayer, ...characters: PlayerType[]): boolean;
+/**
+ * Helper function to see if a damage source is from a player. Use this instead of comparing to the
+ * entity directly because it takes familiars into account.
+ */
+export declare function isDamageFromPlayer(damageSource: Entity): boolean;
 /**
  * Helper function for detecting when a player is Eden or Tainted Eden. Useful for situations where
  * you want to know if the starting stats were randomized, for example.

package/functions/player.lua

@@ -15,6 +15,7 @@ local ActiveSlot = ____isaac_2Dtypescript_2Ddefinitions.ActiveSlot
 local CacheFlag = ____isaac_2Dtypescript_2Ddefinitions.CacheFlag
 local Challenge = ____isaac_2Dtypescript_2Ddefinitions.Challenge
 local CollectibleType = ____isaac_2Dtypescript_2Ddefinitions.CollectibleType
+local FamiliarVariant = ____isaac_2Dtypescript_2Ddefinitions.FamiliarVariant
 local NullItemID = ____isaac_2Dtypescript_2Ddefinitions.NullItemID
 local PlayerForm = ____isaac_2Dtypescript_2Ddefinitions.PlayerForm
 local PlayerType = ____isaac_2Dtypescript_2Ddefinitions.PlayerType
@@ -377,6 +378,30 @@ function ____exports.getPlayerCollectibleMap(self, player)
     end
     return collectibleMap
 end
+--- Helper function to get the player from a tear, laser, bomb, etc.
+function ____exports.getPlayerFromTear(self, entity)
+    if entity.Parent ~= nil then
+        local player = entity.Parent:ToPlayer()
+        if player ~= nil then
+            return player
+        end
+        local familiar = entity.Parent:ToFamiliar()
+        if familiar ~= nil and familiar.Variant == FamiliarVariant.INCUBUS then
+            return familiar.Player
+        end
+    end
+    if entity.SpawnerEntity ~= nil then
+        local player = entity.SpawnerEntity:ToPlayer()
+        if player ~= nil then
+            return player
+        end
+        local familiar = entity.SpawnerEntity:ToFamiliar()
+        if familiar ~= nil and familiar.Variant == FamiliarVariant.INCUBUS then
+            return familiar.Player
+        end
+    end
+    return nil
+end
 --- Returns the number of red hearts that the player has, excluding any rotten hearts. For example,
 -- if the player has one full black heart, one full soul heart, and one half black heart, this
 -- function returns 3.
@@ -567,6 +592,16 @@ function ____exports.isBethany(self, player)
     local character = player:GetPlayerType()
     return character == PlayerType.BETHANY or character == PlayerType.BETHANY_B
 end
+--- Helper function to see if a damage source is from a player. Use this instead of comparing to the
+-- entity directly because it takes familiars into account.
+function ____exports.isDamageFromPlayer(self, damageSource)
+    local player = damageSource:ToPlayer()
+    if player ~= nil then
+        return true
+    end
+    local indirectPlayer = ____exports.getPlayerFromTear(nil, damageSource)
+    return indirectPlayer ~= nil
+end
 --- Helper function for detecting when a player is Eden or Tainted Eden. Useful for situations where
 -- you want to know if the starting stats were randomized, for example.
 function ____exports.isEden(self, player)
@@ -684,9 +719,9 @@ function ____exports.setActiveItem(self, player, collectibleType, activeSlot, ch
         itemPool:RemoveCollectible(collectibleType)
     end
     repeat
-        local ____switch113 = activeSlot
-        local ____cond113 = ____switch113 == ActiveSlot.PRIMARY
-        if ____cond113 then
+        local ____switch122 = activeSlot
+        local ____cond122 = ____switch122 == ActiveSlot.PRIMARY
+        if ____cond122 then
             do
                 if primaryCollectibleType ~= CollectibleType.NULL then
                     player:RemoveCollectible(primaryCollectibleType)
@@ -695,8 +730,8 @@ function ____exports.setActiveItem(self, player, collectibleType, activeSlot, ch
                 break
             end
         end
-        ____cond113 = ____cond113 or ____switch113 == ActiveSlot.SECONDARY
-        if ____cond113 then
+        ____cond122 = ____cond122 or ____switch122 == ActiveSlot.SECONDARY
+        if ____cond122 then
             do
                 if primaryCollectibleType ~= CollectibleType.NULL then
                     player:RemoveCollectible(primaryCollectibleType)
@@ -711,16 +746,16 @@ function ____exports.setActiveItem(self, player, collectibleType, activeSlot, ch
                 break
             end
         end
-        ____cond113 = ____cond113 or ____switch113 == ActiveSlot.POCKET
-        if ____cond113 then
+        ____cond122 = ____cond122 or ____switch122 == ActiveSlot.POCKET
+        if ____cond122 then
             do
                 player:SetPocketActiveItem(collectibleType, activeSlot, keepInPools)
                 player:SetActiveCharge(charge, activeSlot)
                 break
             end
         end
-        ____cond113 = ____cond113 or ____switch113 == ActiveSlot.POCKET_SINGLE_USE
-        if ____cond113 then
+        ____cond122 = ____cond122 or ____switch122 == ActiveSlot.POCKET_SINGLE_USE
+        if ____cond122 then
             do
                 player:SetPocketActiveItem(collectibleType, activeSlot, keepInPools)
                 break

package/functions/playerHealth.d.ts

@@ -12,6 +12,8 @@ export declare function addPlayerHealthType(player: EntityPlayer, healthType: He
  */
 export declare function getPlayerHealth(player: EntityPlayer): PlayerHealth;
 export declare function getPlayerHealthType(player: EntityPlayer, healthType: HealthType): int;
+export declare function playerConvertBlackHeartsToSoulHearts(player: EntityPlayer): void;
+export declare function playerConvertSoulHeartsToBlackHearts(player: EntityPlayer): void;
 export declare function removeAllPlayerHealth(player: EntityPlayer): void;
 /**
  * Helper function to set a player's health to a specific state. You can use this in combination

package/functions/playerHealth.lua

@@ -1,4 +1,5 @@
 local ____lualib = require("lualib_bundle")
+local __TS__ArrayMap = ____lualib.__TS__ArrayMap
 local __TS__ArrayForEach = ____lualib.__TS__ArrayForEach
 local ____exports = {}
 local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
@@ -16,6 +17,79 @@ local isCharacter = ____player.isCharacter
 local ____utils = require("functions.utils")
 local ensureAllCases = ____utils.ensureAllCases
 local ____repeat = ____utils["repeat"]
+function ____exports.removeAllPlayerHealth(self, player)
+    local goldenHearts = player:GetGoldenHearts()
+    local eternalHearts = player:GetEternalHearts()
+    local boneHearts = player:GetBoneHearts()
+    local brokenHearts = player:GetBrokenHearts()
+    player:AddGoldenHearts(goldenHearts * -1)
+    player:AddEternalHearts(eternalHearts * -1)
+    player:AddBoneHearts(boneHearts * -1)
+    player:AddBrokenHearts(brokenHearts * -1)
+    player:AddMaxHearts(MAX_PLAYER_HEART_CONTAINERS * -2, true)
+    player:AddSoulHearts(MAX_PLAYER_HEART_CONTAINERS * -2)
+    if isCharacter(nil, player, PlayerType.THE_SOUL) then
+        local forgotten = player:GetSubPlayer()
+        if forgotten ~= nil then
+            local forgottenBoneHearts = forgotten:GetBoneHearts()
+            forgotten:AddBoneHearts(forgottenBoneHearts * -1)
+        end
+    end
+end
+--- Helper function to set a player's health to a specific state. You can use this in combination
+-- with the `getPlayerHealth` function to restore the player's health back to a certain
+-- configuration at a later time.
+-- 
+-- Based on the `REVEL.LoadHealth` function in the Revelations mod.
+function ____exports.setPlayerHealth(self, player, playerHealth)
+    local character = player:GetPlayerType()
+    local subPlayer = player:GetSubPlayer()
+    ____exports.removeAllPlayerHealth(nil, player)
+    if character == PlayerType.THE_SOUL and subPlayer ~= nil then
+        subPlayer:AddMaxHearts(playerHealth.maxHearts, false)
+    else
+        player:AddMaxHearts(playerHealth.maxHearts, false)
+    end
+    player:AddEternalHearts(playerHealth.eternalHearts)
+    local soulHeartsRemaining = playerHealth.soulHearts
+    __TS__ArrayForEach(
+        playerHealth.soulHeartTypes,
+        function(____, heartType, i)
+            local isHalf = playerHealth.soulHearts + playerHealth.boneHearts * 2 < (i + 1) * 2
+            local addAmount = 2
+            if isHalf or heartType == HeartSubType.BONE or soulHeartsRemaining < 2 then
+                addAmount = 1
+            end
+            if heartType == HeartSubType.SOUL then
+                player:AddSoulHearts(addAmount)
+                soulHeartsRemaining = soulHeartsRemaining - addAmount
+            elseif heartType == HeartSubType.BLACK then
+                player:AddBlackHearts(addAmount)
+                soulHeartsRemaining = soulHeartsRemaining - addAmount
+            elseif heartType == HeartSubType.BONE then
+                player:AddBoneHearts(addAmount)
+            end
+        end
+    )
+    player:AddRottenHearts(playerHealth.rottenHearts)
+    ____repeat(
+        nil,
+        playerHealth.hearts,
+        function()
+            player:AddHearts(1)
+            if character == PlayerType.MAGDALENE_B then
+                player:AddHearts(-1)
+            end
+        end
+    )
+    player:AddGoldenHearts(playerHealth.goldenHearts)
+    player:AddBrokenHearts(playerHealth.brokenHearts)
+    if character == PlayerType.BETHANY then
+        player:SetSoulCharge(playerHealth.soulCharges)
+    elseif character == PlayerType.BETHANY_B then
+        player:SetBloodCharge(playerHealth.bloodCharges)
+    end
+end
 function ____exports.addPlayerHealthType(self, player, healthType, numHearts)
     repeat
         local ____switch3 = healthType
@@ -220,77 +294,22 @@ function ____exports.getPlayerHealthType(self, player, healthType)
         end
     until true
 end
-function ____exports.removeAllPlayerHealth(self, player)
-    local goldenHearts = player:GetGoldenHearts()
-    local eternalHearts = player:GetEternalHearts()
-    local boneHearts = player:GetBoneHearts()
-    local brokenHearts = player:GetBrokenHearts()
-    player:AddGoldenHearts(goldenHearts * -1)
-    player:AddEternalHearts(eternalHearts * -1)
-    player:AddBoneHearts(boneHearts * -1)
-    player:AddBrokenHearts(brokenHearts * -1)
-    player:AddMaxHearts(MAX_PLAYER_HEART_CONTAINERS * -2, true)
-    player:AddSoulHearts(MAX_PLAYER_HEART_CONTAINERS * -2)
-    if isCharacter(nil, player, PlayerType.THE_SOUL) then
-        local forgotten = player:GetSubPlayer()
-        if forgotten ~= nil then
-            local forgottenBoneHearts = forgotten:GetBoneHearts()
-            forgotten:AddBoneHearts(forgottenBoneHearts * -1)
-        end
-    end
-end
---- Helper function to set a player's health to a specific state. You can use this in combination
--- with the `getPlayerHealth` function to restore the player's health back to a certain
--- configuration at a later time.
--- 
--- Based on the `REVEL.LoadHealth` function in the Revelations mod.
-function ____exports.setPlayerHealth(self, player, playerHealth)
-    local character = player:GetPlayerType()
-    local subPlayer = player:GetSubPlayer()
+function ____exports.playerConvertBlackHeartsToSoulHearts(self, player)
+    local playerHealth = ____exports.getPlayerHealth(nil, player)
     ____exports.removeAllPlayerHealth(nil, player)
-    if character == PlayerType.THE_SOUL and subPlayer ~= nil then
-        subPlayer:AddMaxHearts(playerHealth.maxHearts, false)
-    else
-        player:AddMaxHearts(playerHealth.maxHearts, false)
-    end
-    player:AddEternalHearts(playerHealth.eternalHearts)
-    local soulHeartsRemaining = playerHealth.soulHearts
-    __TS__ArrayForEach(
+    playerHealth.soulHeartTypes = __TS__ArrayMap(
         playerHealth.soulHeartTypes,
-        function(____, heartType, i)
-            local isHalf = playerHealth.soulHearts + playerHealth.boneHearts * 2 < (i + 1) * 2
-            local addAmount = 2
-            if isHalf or heartType == HeartSubType.BONE or soulHeartsRemaining < 2 then
-                addAmount = 1
-            end
-            if heartType == HeartSubType.SOUL then
-                player:AddSoulHearts(addAmount)
-                soulHeartsRemaining = soulHeartsRemaining - addAmount
-            elseif heartType == HeartSubType.BLACK then
-                player:AddBlackHearts(addAmount)
-                soulHeartsRemaining = soulHeartsRemaining - addAmount
-            elseif heartType == HeartSubType.BONE then
-                player:AddBoneHearts(addAmount)
-            end
-        end
+        function(____, soulHeartType) return soulHeartType == HeartSubType.BLACK and HeartSubType.SOUL or soulHeartType end
     )
-    player:AddRottenHearts(playerHealth.rottenHearts)
-    ____repeat(
-        nil,
-        playerHealth.hearts,
-        function()
-            player:AddHearts(1)
-            if character == PlayerType.MAGDALENE_B then
-                player:AddHearts(-1)
-            end
-        end
+    ____exports.setPlayerHealth(nil, player, playerHealth)
+end
+function ____exports.playerConvertSoulHeartsToBlackHearts(self, player)
+    local playerHealth = ____exports.getPlayerHealth(nil, player)
+    ____exports.removeAllPlayerHealth(nil, player)
+    playerHealth.soulHeartTypes = __TS__ArrayMap(
+        playerHealth.soulHeartTypes,
+        function(____, soulHeartType) return soulHeartType == HeartSubType.SOUL and HeartSubType.BLACK or soulHeartType end
     )
-    player:AddGoldenHearts(playerHealth.goldenHearts)
-    player:AddBrokenHearts(playerHealth.brokenHearts)
-    if character == PlayerType.BETHANY then
-        player:SetSoulCharge(playerHealth.soulCharges)
-    elseif character == PlayerType.BETHANY_B then
-        player:SetBloodCharge(playerHealth.bloodCharges)
-    end
+    ____exports.setPlayerHealth(nil, player, playerHealth)
 end
 return ____exports

package/index.d.ts

@@ -30,6 +30,7 @@ export { getTaintedLazarusSubPlayer } from "./features/taintedLazarusPlayers";
 export * from "./functions/array";
 export * from "./functions/benchmark";
 export * from "./functions/bitwise";
+export * from "./functions/bombs";
 export * from "./functions/boss";
 export * from "./functions/cacheFlag";
 export * from "./functions/cards";

package/index.lua

@@ -242,6 +242,14 @@ do
         end
     end
 end
+do
+    local ____export = require("functions.bombs")
+    for ____exportKey, ____exportValue in pairs(____export) do
+        if ____exportKey ~= "default" then
+            ____exports[____exportKey] = ____exportValue
+        end
+    end
+end
 do
     local ____export = require("functions.boss")
     for ____exportKey, ____exportValue in pairs(____export) do

package/initCustomCallbacks.lua

@@ -51,6 +51,8 @@ local ____postNPCStateChanged = require("callbacks.postNPCStateChanged")
 local postNPCStateChangedCallbackInit = ____postNPCStateChanged.postNPCStateChangedCallbackInit
 local ____postPickupCollect = require("callbacks.postPickupCollect")
 local postPickupCollectCallbackInit = ____postPickupCollect.postPickupCollectCallbackInit
+local ____postPickupInitFirst = require("callbacks.postPickupInitFirst")
+local postPickupInitFirstCallbackInit = ____postPickupInitFirst.postPickupInitFirstCallbackInit
 local ____postPickupInitLate = require("callbacks.postPickupInitLate")
 local postPickupInitLateCallbackInit = ____postPickupInitLate.postPickupInitLateCallbackInit
 local ____postPickupStateChanged = require("callbacks.postPickupStateChanged")
@@ -144,6 +146,7 @@ function ____exports.initCustomCallbacks(self, mod)
     postNPCInitLateCallbackInit(nil, mod)
     postNPCStateChangedCallbackInit(nil, mod)
     postPickupCollectCallbackInit(nil, mod)
+    postPickupInitFirstCallbackInit(nil, mod)
     postPickupInitLateCallbackInit(nil, mod)
     postPickupStateChangedCallbackInit(nil, mod)
     postPitRenderInit(nil, mod)

package/interfaces/AddCallbackParameterCustom.d.ts

@@ -35,6 +35,7 @@ import { PostNPCInitLateRegisterParameters } from "../callbacks/subscriptions/po
 import { PostNPCStateChangedRegisterParameters } from "../callbacks/subscriptions/postNPCStateChanged";
 import { PostPEffectUpdateReorderedRegisterParameters } from "../callbacks/subscriptions/postPEffectUpdateReordered";
 import { PostPickupCollectRegisterParameters } from "../callbacks/subscriptions/postPickupCollect";
+import { PostPickupInitFirstRegisterParameters } from "../callbacks/subscriptions/postPickupInitFirst";
 import { PostPickupInitLateRegisterParameters } from "../callbacks/subscriptions/postPickupInitLate";
 import { PostPickupStateChangedRegisterParameters } from "../callbacks/subscriptions/postPickupStateChanged";
 import { PostPitRenderRegisterParameters } from "../callbacks/subscriptions/postPitRender";
@@ -112,6 +113,7 @@ export interface AddCallbackParameterCustom {
     [ModCallbackCustom.POST_NPC_STATE_CHANGED]: PostNPCStateChangedRegisterParameters;
     [ModCallbackCustom.POST_PEFFECT_UPDATE_REORDERED]: PostPEffectUpdateReorderedRegisterParameters;
     [ModCallbackCustom.POST_PICKUP_COLLECT]: PostPickupCollectRegisterParameters;
+    [ModCallbackCustom.POST_PICKUP_INIT_FIRST]: PostPickupInitFirstRegisterParameters;
     [ModCallbackCustom.POST_PICKUP_INIT_LATE]: PostPickupInitLateRegisterParameters;
     [ModCallbackCustom.POST_PICKUP_STATE_CHANGED]: PostPickupStateChangedRegisterParameters;
     [ModCallbackCustom.POST_PIT_RENDER]: PostPitRenderRegisterParameters;

package/objects/callbackRegisterFunctions.lua

@@ -73,6 +73,8 @@ local ____postPEffectUpdateReordered = require("callbacks.subscriptions.postPEff
 local postPEffectUpdateReorderedRegister = ____postPEffectUpdateReordered.postPEffectUpdateReorderedRegister
 local ____postPickupCollect = require("callbacks.subscriptions.postPickupCollect")
 local postPickupCollectRegister = ____postPickupCollect.postPickupCollectRegister
+local ____postPickupInitFirst = require("callbacks.subscriptions.postPickupInitFirst")
+local postPickupInitFirstRegister = ____postPickupInitFirst.postPickupInitFirstRegister
 local ____postPickupInitLate = require("callbacks.subscriptions.postPickupInitLate")
 local postPickupInitLateRegister = ____postPickupInitLate.postPickupInitLateRegister
 local ____postPickupStateChanged = require("callbacks.subscriptions.postPickupStateChanged")
@@ -189,6 +191,7 @@ ____exports.CALLBACK_REGISTER_FUNCTIONS = {
     [ModCallbackCustom.POST_NPC_STATE_CHANGED] = postNPCStateChangedRegister,
     [ModCallbackCustom.POST_PEFFECT_UPDATE_REORDERED] = postPEffectUpdateReorderedRegister,
     [ModCallbackCustom.POST_PICKUP_COLLECT] = postPickupCollectRegister,
+    [ModCallbackCustom.POST_PICKUP_INIT_FIRST] = postPickupInitFirstRegister,
     [ModCallbackCustom.POST_PICKUP_INIT_LATE] = postPickupInitLateRegister,
     [ModCallbackCustom.POST_PICKUP_STATE_CHANGED] = postPickupStateChangedRegister,
     [ModCallbackCustom.POST_PIT_RENDER] = postPitRenderRegister,

package/package.json

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