isaacscript-common 3.14.0 → 3.15.2

package/callbacks/postPlayerFatalDamage.lua

@@ -2,8 +2,11 @@ local ____lualib = require("lualib_bundle")
 local Map = ____lualib.Map
 local __TS__New = ____lualib.__TS__New
 local ____exports = {}
-local hasSubscriptions, entityTakeDmgPlayer, v
+local hasSubscriptions, entityTakeDmgPlayer, preUseItemBible, v
 local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local BossID = ____isaac_2Dtypescript_2Ddefinitions.BossID
+local CollectibleType = ____isaac_2Dtypescript_2Ddefinitions.CollectibleType
+local DamageFlagZero = ____isaac_2Dtypescript_2Ddefinitions.DamageFlagZero
 local EntityType = ____isaac_2Dtypescript_2Ddefinitions.EntityType
 local ModCallback = ____isaac_2Dtypescript_2Ddefinitions.ModCallback
 local ____cachedClasses = require("cachedClasses")
@@ -18,6 +21,8 @@ local isChildPlayer = ____playerIndex.isChildPlayer
 local ____revive = require("functions.revive")
 local isDamageToPlayerFatal = ____revive.isDamageToPlayerFatal
 local willPlayerRevive = ____revive.willPlayerRevive
+local ____rooms = require("functions.rooms")
+local inBossRoomOf = ____rooms.inBossRoomOf
 local ____postPlayerFatalDamage = require("callbacks.subscriptions.postPlayerFatalDamage")
 local postPlayerFatalDamageFire = ____postPlayerFatalDamage.postPlayerFatalDamageFire
 local postPlayerFatalDamageHasSubscriptions = ____postPlayerFatalDamage.postPlayerFatalDamageHasSubscriptions
@@ -63,11 +68,32 @@ function entityTakeDmgPlayer(self, tookDamage, damageAmount, damageFlags, damage
     end
     return nil
 end
+function preUseItemBible(self, _collectibleType, _rng, player)
+    if not hasSubscriptions(nil) then
+        return false
+    end
+    if not inBossRoomOf(nil, BossID.SATAN) then
+        return false
+    end
+    local shouldSustainDeath = postPlayerFatalDamageFire(
+        nil,
+        player,
+        0,
+        DamageFlagZero,
+        EntityRef(player),
+        0
+    )
+    if shouldSustainDeath ~= nil then
+        return not shouldSustainDeath
+    end
+    return false
+end
 v = {run = {playersLastDamageGameFrame = __TS__New(Map)}}
 ---
 -- @internal
 function ____exports.postPlayerFatalDamageInit(self, mod)
     saveDataManager(nil, "postPlayerFatalDamage", v)
     mod:AddCallback(ModCallback.ENTITY_TAKE_DMG, entityTakeDmgPlayer, EntityType.PLAYER)
+    mod:AddCallback(ModCallback.PRE_USE_ITEM, preUseItemBible, CollectibleType.BIBLE)
 end
 return ____exports

package/functions/ambush.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Helper function to start a Challenge Room or the Boss Rush.
+ *
+ * Specifically, this is performed by spawning a sack on top of the player, waiting a game frame,
+ * and then removing the sack and the pickups that the sack dropped.
+ */
+export declare function startAmbush(): void;

package/functions/ambush.lua

@@ -0,0 +1,50 @@
+local ____lualib = require("lualib_bundle")
+local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local PickupVariant = ____isaac_2Dtypescript_2Ddefinitions.PickupVariant
+local ____runInNFrames = require("features.runInNFrames")
+local runNextGameFrame = ____runInNFrames.runNextGameFrame
+local ____entity = require("functions.entity")
+local removeEntities = ____entity.removeEntities
+local ____entitySpecific = require("functions.entitySpecific")
+local spawnPickupWithSeed = ____entitySpecific.spawnPickupWithSeed
+local ____pickups = require("functions.pickups")
+local getCoins = ____pickups.getCoins
+--- Hard-coding this makes it easier to clean up the pickups afterwards.
+local SACK_SEED_THAT_SPAWNS_TWO_COINS = 6
+--- Helper function to start a Challenge Room or the Boss Rush.
+-- 
+-- Specifically, this is performed by spawning a sack on top of the player, waiting a game frame,
+-- and then removing the sack and the pickups that the sack dropped.
+function ____exports.startAmbush(self)
+    local player = Isaac.GetPlayer()
+    local sack = spawnPickupWithSeed(
+        nil,
+        PickupVariant.SACK,
+        0,
+        player.Position,
+        SACK_SEED_THAT_SPAWNS_TWO_COINS
+    )
+    local sprite = sack:GetSprite()
+    sprite:Stop()
+    local sackPtr = EntityPtr(sack)
+    runNextGameFrame(
+        nil,
+        function()
+            local futureSack = sackPtr.Ref
+            if futureSack == nil then
+                return
+            end
+            futureSack:Remove()
+            local sackPtrHash = GetPtrHash(futureSack)
+            local coins = getCoins(nil)
+            local coinsFromSack = __TS__ArrayFilter(
+                coins,
+                function(____, pickup) return pickup.SpawnerEntity ~= nil and GetPtrHash(pickup.SpawnerEntity) == sackPtrHash end
+            )
+            removeEntities(nil, coinsFromSack)
+        end
+    )
+end
+return ____exports

package/index.d.ts

@@ -28,6 +28,7 @@ export { runInNGameFrames, runInNRenderFrames, runNextGameFrame, runNextRenderFr
 export * from "./features/saveDataManager/exports";
 export { hasSirenStolenFamiliar, setFamiliarNoSirenSteal, } from "./features/sirenHelpers";
 export { getTaintedLazarusSubPlayer } from "./features/taintedLazarusPlayers";
+export * from "./functions/ambush";
 export * from "./functions/array";
 export * from "./functions/benchmark";
 export * from "./functions/bitwise";

package/index.lua

@@ -223,6 +223,14 @@ do
     local getTaintedLazarusSubPlayer = ____taintedLazarusPlayers.getTaintedLazarusSubPlayer
     ____exports.getTaintedLazarusSubPlayer = getTaintedLazarusSubPlayer
 end
+do
+    local ____export = require("functions.ambush")
+    for ____exportKey, ____exportValue in pairs(____export) do
+        if ____exportKey ~= "default" then
+            ____exports[____exportKey] = ____exportValue
+        end
+    end
+end
 do
     local ____export = require("functions.array")
     for ____exportKey, ____exportValue in pairs(____export) do

package/package.json

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