isaacscript-common 20.4.0 → 20.5.0

package/dist/index.d.ts

@@ -3123,12 +3123,6 @@ export declare function deserializeRNG(rng: SerializedRNG): RNG;
  */
 export declare function deserializeVector(vector: SerializedVector): Vector;
 
-declare type DespawnedSlotTuple = [
-gameFrame: int,
-position: Vector,
-entityPtr: EntityPtr
-];
-
 /** For `EntityType.EFFECT` (1000), `EffectVariant.DICE_FLOOR` (76). */
 export declare const DICE_FLOOR_TRIGGER_SQUARE_SIZE = 75;
 
@@ -10211,8 +10205,35 @@ export declare enum ModCallbackCustom {
      */
     POST_SLOT_COLLISION = 87,
     /**
-     * Fires from the `POST_RENDER` callback when a slot plays the animation that indicates that it
-     * has broken.
+     * Fires from the `POST_SLOT_UPDATE` or the `POST_ENTITY_REMOVE` callback when a slot machine is
+     * destroyed or a beggar is removed.
+     *
+     * This callback will fire in four different kinds of situations:
+     *
+     * 1. When slot machine entities (e.g. `SlotVariant.SLOT_MACHINE` and
+     *    `SlotVariant.BLOOD_DONATION_MACHINE`) are destroyed with an explosion. When this happens,
+     *    they typically stay in the room and can be pushed around. This state is detected via a
+     *    change in the `GridCollisionClass`.
+     * 2. When slot machine entities pay out with a collectible item. When this happens, they
+     *    immediately despawn without playing any special animation.
+     * 3. When beggar entities (e.g. `SlotVariant.BEGGAR` and `SlotVariant.SHELL_GAME`) are destroyed
+     *    with an explosion. When this happens, they immediately despawn without playing any special
+     *    animation.
+     * 4. When beggar entities pay out with a collectible item. When this happens, they despawn after
+     *    playing the "Teleport" animation. (This is not technically a "destruction" event, but the
+     *    callback will fire for this to remain consistent with the other types of slot entities.)
+     *
+     * Depending on the specific types of slot removal that you need to detect, you can filter using:
+     *
+     * 1. The `isSlotMachine` helper function to differentiate between slot machines and beggars.
+     * 2. The passed callback argument of `SlotDestructionType` to differentiate between bombed slots
+     *    and slots that paid out with a collectible item.
+     *
+     * Note that when a Crane Game explodes after paying out three collectibles, the
+     * `SlotDestructionType` will be equal to `SlotDestructionType.NORMAL` instead of
+     * `SlotDestructionType.COLLECTIBLE_PAYOUT` like you might expect. (This is because it only
+     * explodes after a short delay, and when doing so, it produces rewards in the same way that would
+     * happen if you bombed it.)
      *
      * When registering the callback with the `ModUpgraded.AddCallbackCustom` method:
      * - You can provide an optional third argument that will make the callback only fire if it
@@ -13896,6 +13917,15 @@ export declare function setDisplayFlags(displayFlagsMap: Map<int, BitFlags<Displ
  */
 export declare function setEntityDamageFlash(entity: Entity): void;
 
+/**
+ * Helper function to keep an entity's color the same values as it already is but set the opacity to
+ * a specific value.
+ *
+ * @param entity The entity to set.
+ * @param alpha A value between 0 and 1 that represents the fade amount.
+ */
+export declare function setEntityOpacity(entity: Entity, alpha: float): void;
+
 /**
  * Helper function to set the position of every entity in the room based on a map of positions. If
  * an entity is found that does not have matching element in the provided map, then that entity will
@@ -14005,6 +14035,15 @@ export declare function setRoomVisible(roomGridIndex: int | undefined, updateVis
 /** Helper function to set a seed to an RNG object using Blade's recommended shift index. */
 export declare function setSeed(rng: RNG, seed: Seed): void;
 
+/**
+ * Helper function to keep a sprite's color the same values as it already is but set the opacity to
+ * a specific value.
+ *
+ * @param sprite The sprite to set.
+ * @param alpha A value between 0 and 1 that represents the fade amount.
+ */
+export declare function setSpriteOpacity(sprite: Sprite, alpha: float): void;
+
 /**
  * Helper function to warp to a new stage/level.
  *
@@ -14121,13 +14160,11 @@ declare class SlotDestroyedDetection extends Feature {
     v: {
         room: {
             destroyedSlotSet: Set<PtrHash>;
-            despawnedSlots: DespawnedSlotTuple[];
         };
     };
     private postSlotDestroyed;
     private roomHistory;
     constructor(postSlotDestroyed: PostSlotDestroyed, roomHistory: RoomHistory);
-    private postPickupInitCollectible;
     private postEntityRemoveSlot;
     private postEntityRemoveSlotMachine;
     private postEntityRemoveBeggar;

package/dist/isaacscript-common.lua

@@ -1,6 +1,6 @@
 --[[
 
-isaacscript-common 20.4.0
+isaacscript-common 20.5.0
 
 This is the "isaacscript-common" library, which was created with the IsaacScript tool.
 
@@ -19640,6 +19640,79 @@ return ____exports
  end,
 ["src.types.EntityID"] = function(...) 
 local ____exports = {}
+return ____exports
+ end,
+["src.functions.sprites"] = function(...) 
+local ____exports = {}
+local ____constants = require("src.core.constants")
+local EMPTY_PNG_PATH = ____constants.EMPTY_PNG_PATH
+local VectorZero = ____constants.VectorZero
+local ____color = require("src.functions.color")
+local copyColor = ____color.copyColor
+local ____kColor = require("src.functions.kColor")
+local kColorEquals = ____kColor.kColorEquals
+local ____utils = require("src.functions.utils")
+local eRange = ____utils.eRange
+function ____exports.texelEquals(self, sprite1, sprite2, position, layerID)
+    local kColor1 = sprite1:GetTexel(position, VectorZero, 1, layerID)
+    local kColor2 = sprite2:GetTexel(position, VectorZero, 1, layerID)
+    return kColorEquals(nil, kColor1, kColor2)
+end
+function ____exports.clearSprite(self, sprite, ...)
+    local layerIDs = {...}
+    if #layerIDs == 0 then
+        local numLayers = sprite:GetLayerCount()
+        layerIDs = eRange(nil, numLayers)
+    end
+    for ____, layerID in ipairs(layerIDs) do
+        sprite:ReplaceSpritesheet(layerID, EMPTY_PNG_PATH)
+    end
+    sprite:LoadGraphics()
+end
+function ____exports.getLastFrameOfAnimation(self, sprite, animation)
+    local currentAnimation = sprite:GetAnimation()
+    local currentFrame = sprite:GetFrame()
+    if animation ~= nil and animation ~= currentAnimation then
+        sprite:SetAnimation(animation)
+    end
+    sprite:SetLastFrame()
+    local finalFrame = sprite:GetFrame()
+    if animation ~= nil and animation ~= currentAnimation then
+        sprite:Play(currentAnimation, true)
+    end
+    sprite:SetFrame(currentFrame)
+    return finalFrame
+end
+function ____exports.setSpriteOpacity(self, sprite, alpha)
+    local fadedColor = copyColor(nil, sprite.Color)
+    fadedColor.A = alpha
+    sprite.Color = fadedColor
+end
+function ____exports.spriteEquals(self, sprite1, sprite2, layerID, xStart, xFinish, xIncrement, yStart, yFinish, yIncrement)
+    do
+        local x = xStart
+        while x <= xFinish do
+            do
+                local y = yStart
+                while y <= yFinish do
+                    local position = Vector(x, y)
+                    if not ____exports.texelEquals(
+                        nil,
+                        sprite1,
+                        sprite2,
+                        position,
+                        layerID
+                    ) then
+                        return false
+                    end
+                    y = y + yIncrement
+                end
+            end
+            x = x + xIncrement
+        end
+    end
+    return true
+end
 return ____exports
  end,
 ["src.functions.entities"] = function(...) 
@@ -19666,6 +19739,8 @@ local getRandom = ____random.getRandom
 local ____rng = require("src.functions.rng")
 local isRNG = ____rng.isRNG
 local newRNG = ____rng.newRNG
+local ____sprites = require("src.functions.sprites")
+local setSpriteOpacity = ____sprites.setSpriteOpacity
 local ____types = require("src.functions.types")
 local asNumber = ____types.asNumber
 local isPrimitive = ____types.isPrimitive
@@ -19930,6 +20005,10 @@ end
 function ____exports.setEntityDamageFlash(self, entity)
     entity:SetColor(DAMAGE_FLASH_COLOR, 2, 0)
 end
+function ____exports.setEntityOpacity(self, entity, alpha)
+    local sprite = entity:GetSprite()
+    setSpriteOpacity(nil, sprite, alpha)
+end
 function ____exports.setEntityRandomColor(self, entity)
     local rng = newRNG(nil, entity.InitSeed)
     local r = getRandom(nil, rng)
@@ -20899,72 +20978,6 @@ function ____exports.setRoomData(self, roomGridIndex, roomData)
     local roomDescriptor = ____exports.getRoomDescriptor(nil, roomGridIndex)
     roomDescriptor.Data = roomData
 end
-return ____exports
- end,
-["src.functions.sprites"] = function(...) 
-local ____exports = {}
-local ____constants = require("src.core.constants")
-local EMPTY_PNG_PATH = ____constants.EMPTY_PNG_PATH
-local VectorZero = ____constants.VectorZero
-local ____kColor = require("src.functions.kColor")
-local kColorEquals = ____kColor.kColorEquals
-local ____utils = require("src.functions.utils")
-local eRange = ____utils.eRange
-function ____exports.texelEquals(self, sprite1, sprite2, position, layerID)
-    local kColor1 = sprite1:GetTexel(position, VectorZero, 1, layerID)
-    local kColor2 = sprite2:GetTexel(position, VectorZero, 1, layerID)
-    return kColorEquals(nil, kColor1, kColor2)
-end
-function ____exports.clearSprite(self, sprite, ...)
-    local layerIDs = {...}
-    if #layerIDs == 0 then
-        local numLayers = sprite:GetLayerCount()
-        layerIDs = eRange(nil, numLayers)
-    end
-    for ____, layerID in ipairs(layerIDs) do
-        sprite:ReplaceSpritesheet(layerID, EMPTY_PNG_PATH)
-    end
-    sprite:LoadGraphics()
-end
-function ____exports.getLastFrameOfAnimation(self, sprite, animation)
-    local currentAnimation = sprite:GetAnimation()
-    local currentFrame = sprite:GetFrame()
-    if animation ~= nil and animation ~= currentAnimation then
-        sprite:SetAnimation(animation)
-    end
-    sprite:SetLastFrame()
-    local finalFrame = sprite:GetFrame()
-    if animation ~= nil and animation ~= currentAnimation then
-        sprite:Play(currentAnimation, true)
-    end
-    sprite:SetFrame(currentFrame)
-    return finalFrame
-end
-function ____exports.spriteEquals(self, sprite1, sprite2, layerID, xStart, xFinish, xIncrement, yStart, yFinish, yIncrement)
-    do
-        local x = xStart
-        while x <= xFinish do
-            do
-                local y = yStart
-                while y <= yFinish do
-                    local position = Vector(x, y)
-                    if not ____exports.texelEquals(
-                        nil,
-                        sprite1,
-                        sprite2,
-                        position,
-                        layerID
-                    ) then
-                        return false
-                    end
-                    y = y + yIncrement
-                end
-            end
-            x = x + xIncrement
-        end
-    end
-    return true
-end
 return ____exports
  end,
 ["src.functions.collectibles"] = function(...) 
@@ -34209,17 +34222,12 @@ local ____isaac_2Dtypescript_2Ddefinitions = require("lua_modules.isaac-typescri
 local EntityGridCollisionClass = ____isaac_2Dtypescript_2Ddefinitions.EntityGridCollisionClass
 local EntityType = ____isaac_2Dtypescript_2Ddefinitions.EntityType
 local ModCallback = ____isaac_2Dtypescript_2Ddefinitions.ModCallback
-local PickupVariant = ____isaac_2Dtypescript_2Ddefinitions.PickupVariant
-local ____cachedClasses = require("src.core.cachedClasses")
-local game = ____cachedClasses.game
 local ____ModCallbackCustom = require("src.enums.ModCallbackCustom")
 local ModCallbackCustom = ____ModCallbackCustom.ModCallbackCustom
 local ____SlotDestructionType = require("src.enums.SlotDestructionType")
 local SlotDestructionType = ____SlotDestructionType.SlotDestructionType
 local ____slots = require("src.functions.slots")
 local isSlotMachine = ____slots.isSlotMachine
-local ____vector = require("src.functions.vector")
-local vectorEquals = ____vector.vectorEquals
 local ____Feature = require("src.classes.private.Feature")
 local Feature = ____Feature.Feature
 ____exports.SlotDestroyedDetection = __TS__Class()
@@ -34228,23 +34236,7 @@ SlotDestroyedDetection.name = "SlotDestroyedDetection"
 __TS__ClassExtends(SlotDestroyedDetection, Feature)
 function SlotDestroyedDetection.prototype.____constructor(self, postSlotDestroyed, roomHistory)
     Feature.prototype.____constructor(self)
-    self.v = {room = {
-        destroyedSlotSet = __TS__New(Set),
-        despawnedSlots = {}
-    }}
-    self.postPickupInitCollectible = function(____, pickup)
-        local gameFrameCount = game:GetFrameCount()
-        for ____, despawnedSlotTuple in ipairs(self.v.room.despawnedSlots) do
-            local gameFrame, position, entityPtr = table.unpack(despawnedSlotTuple)
-            if gameFrame == gameFrameCount and vectorEquals(nil, position, pickup.Position) then
-                local entity = entityPtr.Ref
-                if entity ~= nil then
-                    local slot = entity
-                    self.postSlotDestroyed:fire(slot, SlotDestructionType.COLLECTIBLE_PAYOUT)
-                end
-            end
-        end
-    end
+    self.v = {room = {destroyedSlotSet = __TS__New(Set)}}
     self.postEntityRemoveSlot = function(____, entity)
         local slot = entity
         if self.roomHistory:isLeavingRoom() then
@@ -34264,17 +34256,13 @@ function SlotDestroyedDetection.prototype.____constructor(self, postSlotDestroye
         end
         self:checkDestroyedFromCollisionClass(slot)
     end
-    self.callbacksUsed = {{ModCallback.POST_PICKUP_INIT, self.postPickupInitCollectible, {PickupVariant.COLLECTIBLE}}, {ModCallback.POST_ENTITY_REMOVE, self.postEntityRemoveSlot, {EntityType.SLOT}}}
+    self.callbacksUsed = {{ModCallback.POST_ENTITY_REMOVE, self.postEntityRemoveSlot, {EntityType.SLOT}}}
     self.customCallbacksUsed = {{ModCallbackCustom.POST_SLOT_UPDATE, self.postSlotUpdate}}
     self.postSlotDestroyed = postSlotDestroyed
     self.roomHistory = roomHistory
 end
 function SlotDestroyedDetection.prototype.postEntityRemoveSlotMachine(self, slot)
-    local gameFrameCount = game:GetFrameCount()
-    local entityPtr = EntityPtr(slot)
-    local despawnedSlotTuple = {gameFrameCount, slot.Position, entityPtr}
-    local ____self_v_room_despawnedSlots_0 = self.v.room.despawnedSlots
-    ____self_v_room_despawnedSlots_0[#____self_v_room_despawnedSlots_0 + 1] = despawnedSlotTuple
+    self.postSlotDestroyed:fire(slot, SlotDestructionType.COLLECTIBLE_PAYOUT)
 end
 function SlotDestroyedDetection.prototype.postEntityRemoveBeggar(self, slot)
     local sprite = slot:GetSprite()

package/dist/src/classes/features/callbackLogic/SlotDestroyedDetection.d.ts

@@ -1,25 +1,15 @@
-/// <reference types="isaac-typescript-definitions" />
-/// <reference types="isaac-typescript-definitions" />
-/// <reference types="isaac-typescript-definitions" />
 import { PostSlotDestroyed } from "../../callbacks/PostSlotDestroyed";
 import { Feature } from "../../private/Feature";
 import { RoomHistory } from "../other/RoomHistory";
-type DespawnedSlotTuple = [
-    gameFrame: int,
-    position: Vector,
-    entityPtr: EntityPtr
-];
 export declare class SlotDestroyedDetection extends Feature {
     v: {
         room: {
             destroyedSlotSet: Set<PtrHash>;
-            despawnedSlots: DespawnedSlotTuple[];
         };
     };
     private postSlotDestroyed;
     private roomHistory;
     constructor(postSlotDestroyed: PostSlotDestroyed, roomHistory: RoomHistory);
-    private postPickupInitCollectible;
     private postEntityRemoveSlot;
     private postEntityRemoveSlotMachine;
     private postEntityRemoveBeggar;
@@ -32,5 +22,4 @@ export declare class SlotDestroyedDetection extends Feature {
      */
     private checkDestroyedFromCollisionClass;
 }
-export {};
 //# sourceMappingURL=SlotDestroyedDetection.d.ts.map

package/dist/src/classes/features/callbackLogic/SlotDestroyedDetection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SlotDestroyedDetection.d.ts","sourceRoot":"","sources":["../../../../../src/classes/features/callbackLogic/SlotDestroyedDetection.ts"],"names":[],"mappings":";;;AA0BA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,KAAK,kBAAkB,GAAG;IACxB,SAAS,EAAE,GAAG;IACd,QAAQ,EAAE,MAAM;IAChB,SAAS,EAAE,SAAS;CACrB,CAAC;AAEF,qBAAa,sBAAuB,SAAQ,OAAO;IACjC,CAAC;;;;;MAKf;IAEF,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,WAAW,CAAc;gBAErB,iBAAiB,EAAE,iBAAiB,EAAE,WAAW,EAAE,WAAW;IA6B1E,OAAO,CAAC,yBAAyB,CAoB/B;IAIF,OAAO,CAAC,oBAAoB,CAc1B;IAEF,OAAO,CAAC,2BAA2B;IAWnC,OAAO,CAAC,sBAAsB;IAW9B,OAAO,CAAC,cAAc,CASpB;IAEF;;;;;OAKG;IACH,OAAO,CAAC,gCAAgC;CAOzC"}
+{"version":3,"file":"SlotDestroyedDetection.d.ts","sourceRoot":"","sources":["../../../../../src/classes/features/callbackLogic/SlotDestroyedDetection.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,qBAAa,sBAAuB,SAAQ,OAAO;IACjC,CAAC;;;;MAIf;IAEF,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,WAAW,CAAc;gBAErB,iBAAiB,EAAE,iBAAiB,EAAE,WAAW,EAAE,WAAW;IAsB1E,OAAO,CAAC,oBAAoB,CAc1B;IAEF,OAAO,CAAC,2BAA2B;IAInC,OAAO,CAAC,sBAAsB;IAW9B,OAAO,CAAC,cAAc,CASpB;IAEF;;;;;OAKG;IACH,OAAO,CAAC,gCAAgC;CAOzC"}

package/dist/src/classes/features/callbackLogic/SlotDestroyedDetection.lua

@@ -8,17 +8,12 @@ local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitio
 local EntityGridCollisionClass = ____isaac_2Dtypescript_2Ddefinitions.EntityGridCollisionClass
 local EntityType = ____isaac_2Dtypescript_2Ddefinitions.EntityType
 local ModCallback = ____isaac_2Dtypescript_2Ddefinitions.ModCallback
-local PickupVariant = ____isaac_2Dtypescript_2Ddefinitions.PickupVariant
-local ____cachedClasses = require("src.core.cachedClasses")
-local game = ____cachedClasses.game
 local ____ModCallbackCustom = require("src.enums.ModCallbackCustom")
 local ModCallbackCustom = ____ModCallbackCustom.ModCallbackCustom
 local ____SlotDestructionType = require("src.enums.SlotDestructionType")
 local SlotDestructionType = ____SlotDestructionType.SlotDestructionType
 local ____slots = require("src.functions.slots")
 local isSlotMachine = ____slots.isSlotMachine
-local ____vector = require("src.functions.vector")
-local vectorEquals = ____vector.vectorEquals
 local ____Feature = require("src.classes.private.Feature")
 local Feature = ____Feature.Feature
 ____exports.SlotDestroyedDetection = __TS__Class()
@@ -27,23 +22,7 @@ SlotDestroyedDetection.name = "SlotDestroyedDetection"
 __TS__ClassExtends(SlotDestroyedDetection, Feature)
 function SlotDestroyedDetection.prototype.____constructor(self, postSlotDestroyed, roomHistory)
     Feature.prototype.____constructor(self)
-    self.v = {room = {
-        destroyedSlotSet = __TS__New(Set),
-        despawnedSlots = {}
-    }}
-    self.postPickupInitCollectible = function(____, pickup)
-        local gameFrameCount = game:GetFrameCount()
-        for ____, despawnedSlotTuple in ipairs(self.v.room.despawnedSlots) do
-            local gameFrame, position, entityPtr = table.unpack(despawnedSlotTuple)
-            if gameFrame == gameFrameCount and vectorEquals(nil, position, pickup.Position) then
-                local entity = entityPtr.Ref
-                if entity ~= nil then
-                    local slot = entity
-                    self.postSlotDestroyed:fire(slot, SlotDestructionType.COLLECTIBLE_PAYOUT)
-                end
-            end
-        end
-    end
+    self.v = {room = {destroyedSlotSet = __TS__New(Set)}}
     self.postEntityRemoveSlot = function(____, entity)
         local slot = entity
         if self.roomHistory:isLeavingRoom() then
@@ -63,17 +42,13 @@ function SlotDestroyedDetection.prototype.____constructor(self, postSlotDestroye
         end
         self:checkDestroyedFromCollisionClass(slot)
     end
-    self.callbacksUsed = {{ModCallback.POST_PICKUP_INIT, self.postPickupInitCollectible, {PickupVariant.COLLECTIBLE}}, {ModCallback.POST_ENTITY_REMOVE, self.postEntityRemoveSlot, {EntityType.SLOT}}}
+    self.callbacksUsed = {{ModCallback.POST_ENTITY_REMOVE, self.postEntityRemoveSlot, {EntityType.SLOT}}}
     self.customCallbacksUsed = {{ModCallbackCustom.POST_SLOT_UPDATE, self.postSlotUpdate}}
     self.postSlotDestroyed = postSlotDestroyed
     self.roomHistory = roomHistory
 end
 function SlotDestroyedDetection.prototype.postEntityRemoveSlotMachine(self, slot)
-    local gameFrameCount = game:GetFrameCount()
-    local entityPtr = EntityPtr(slot)
-    local despawnedSlotTuple = {gameFrameCount, slot.Position, entityPtr}
-    local ____self_v_room_despawnedSlots_0 = self.v.room.despawnedSlots
-    ____self_v_room_despawnedSlots_0[#____self_v_room_despawnedSlots_0 + 1] = despawnedSlotTuple
+    self.postSlotDestroyed:fire(slot, SlotDestructionType.COLLECTIBLE_PAYOUT)
 end
 function SlotDestroyedDetection.prototype.postEntityRemoveBeggar(self, slot)
     local sprite = slot:GetSprite()

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

@@ -1536,8 +1536,35 @@ export declare enum ModCallbackCustom {
      */
     POST_SLOT_COLLISION = 87,
     /**
-     * Fires from the `POST_RENDER` callback when a slot plays the animation that indicates that it
-     * has broken.
+     * Fires from the `POST_SLOT_UPDATE` or the `POST_ENTITY_REMOVE` callback when a slot machine is
+     * destroyed or a beggar is removed.
+     *
+     * This callback will fire in four different kinds of situations:
+     *
+     * 1. When slot machine entities (e.g. `SlotVariant.SLOT_MACHINE` and
+     *    `SlotVariant.BLOOD_DONATION_MACHINE`) are destroyed with an explosion. When this happens,
+     *    they typically stay in the room and can be pushed around. This state is detected via a
+     *    change in the `GridCollisionClass`.
+     * 2. When slot machine entities pay out with a collectible item. When this happens, they
+     *    immediately despawn without playing any special animation.
+     * 3. When beggar entities (e.g. `SlotVariant.BEGGAR` and `SlotVariant.SHELL_GAME`) are destroyed
+     *    with an explosion. When this happens, they immediately despawn without playing any special
+     *    animation.
+     * 4. When beggar entities pay out with a collectible item. When this happens, they despawn after
+     *    playing the "Teleport" animation. (This is not technically a "destruction" event, but the
+     *    callback will fire for this to remain consistent with the other types of slot entities.)
+     *
+     * Depending on the specific types of slot removal that you need to detect, you can filter using:
+     *
+     * 1. The `isSlotMachine` helper function to differentiate between slot machines and beggars.
+     * 2. The passed callback argument of `SlotDestructionType` to differentiate between bombed slots
+     *    and slots that paid out with a collectible item.
+     *
+     * Note that when a Crane Game explodes after paying out three collectibles, the
+     * `SlotDestructionType` will be equal to `SlotDestructionType.NORMAL` instead of
+     * `SlotDestructionType.COLLECTIBLE_PAYOUT` like you might expect. (This is because it only
+     * explodes after a short delay, and when doing so, it produces rewards in the same way that would
+     * happen if you bombed it.)
      *
      * When registering the callback with the `ModUpgraded.AddCallbackCustom` method:
      * - You can provide an optional third argument that will make the callback only fire if it

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

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

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

@@ -172,6 +172,14 @@ export declare function rerollEnemy(entity: Entity): Entity | undefined;
  * it.
  */
 export declare function setEntityDamageFlash(entity: Entity): void;
+/**
+ * Helper function to keep an entity's color the same values as it already is but set the opacity to
+ * a specific value.
+ *
+ * @param entity The entity to set.
+ * @param alpha A value between 0 and 1 that represents the fade amount.
+ */
+export declare function setEntityOpacity(entity: Entity, alpha: float): void;
 export declare function setEntityRandomColor(entity: Entity): void;
 /**
  * Helper function to spawn an entity. Use this instead of the `Isaac.Spawn` method if you do not

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

@@ -1 +1 @@
-{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../../../src/functions/entities.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAK1D,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAkB7C;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,UAAU,GAAE,UAAe,EAC3B,OAAO,SAAK,EACZ,OAAO,SAAK,EACZ,cAAc,UAAQ,GACrB,GAAG,CAcL;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,UAAU,GAAE,UAAe,EAC3B,OAAO,SAAK,EACZ,OAAO,SAAK,EACZ,cAAc,UAAQ,GACrB,OAAO,CAGT;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,SAAS,EACpD,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,CAAC,EAAE,EACb,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,GAClC,CAAC,GAAG,SAAS,CAgBf;AAED,wFAAwF;AACxF,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,QAAQ,GACjB,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,CA0BtD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,WAAW,CACzB,UAAU,GAAE,UAAe,EAC3B,OAAO,SAAK,EACZ,OAAO,SAAK,EACZ,cAAc,UAAQ,GACrB,MAAM,EAAE,CAMV;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,GACb,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC,CA8B3C;AA0BD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAGzE;AAED,2FAA2F;AAC3F,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAEpD;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,GAAG,EACZ,OAAO,EAAE,GAAG,GACX,QAAQ,CAEV;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,SAAS,EACxD,WAAW,EAAE,CAAC,EAAE,EAChB,WAAW,EAAE,CAAC,EAAE,GACf,CAAC,EAAE,CAWL;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAGhD;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,SAAO,GAAG,OAAO,CAExE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAE3D;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,GACf,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,GAAG,SAAS,CAwBlE;AAED;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAC1C,uBAAuB,EAAE,MAAM,GAC9B,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,CAAC,GAAG,SAAS,CAmBpD;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,UAAU,EACtB,aAAa,SAAK,EAClB,aAAa,SAAK,EAClB,GAAG,GAAE,GAAG,GAAG,SAAqB,GAC/B,MAAM,EAAE,CAGV;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,SAAS,EAChD,QAAQ,EAAE,CAAC,EAAE,EACb,GAAG,CAAC,EAAE,GAAG,GACR,CAAC,EAAE,CAgBL;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAgB9D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEzD;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CASzD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,KAAK,CACnB,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,GAAG,EACZ,OAAO,EAAE,GAAG,EACZ,mBAAmB,EAAE,MAAM,GAAG,GAAG,EACjC,QAAQ,GAAE,MAAmB,EAC7B,OAAO,GAAE,MAAM,GAAG,SAAqB,EACvC,SAAS,GAAE,IAAI,GAAG,GAAG,GAAG,SAAqB,GAC5C,MAAM,CA4CR;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,QAAQ,EAClB,mBAAmB,EAAE,MAAM,GAAG,GAAG,EACjC,QAAQ,GAAE,MAAmB,EAC7B,OAAO,GAAE,MAAM,GAAG,SAAqB,EACvC,SAAS,GAAE,IAAI,GAAG,GAAG,GAAG,SAAqB,GAC5C,MAAM,CAWR;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,GAAG,EACZ,OAAO,EAAE,GAAG,EACZ,mBAAmB,EAAE,MAAM,GAAG,GAAG,EACjC,SAAS,EAAE,IAAI,GAAG,GAAG,EACrB,QAAQ,GAAE,MAAmB,EAC7B,OAAO,GAAE,MAAM,GAAG,SAAqB,GACtC,MAAM,CAUR"}
+{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../../../src/functions/entities.ts"],"names":[],"mappings":"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"}

package/dist/src/functions/entities.lua

@@ -21,6 +21,8 @@ local getRandom = ____random.getRandom
 local ____rng = require("src.functions.rng")
 local isRNG = ____rng.isRNG
 local newRNG = ____rng.newRNG
+local ____sprites = require("src.functions.sprites")
+local setSpriteOpacity = ____sprites.setSpriteOpacity
 local ____types = require("src.functions.types")
 local asNumber = ____types.asNumber
 local isPrimitive = ____types.isPrimitive
@@ -403,6 +405,15 @@ end
 function ____exports.setEntityDamageFlash(self, entity)
     entity:SetColor(DAMAGE_FLASH_COLOR, 2, 0)
 end
+--- Helper function to keep an entity's color the same values as it already is but set the opacity to
+-- a specific value.
+-- 
+-- @param entity The entity to set.
+-- @param alpha A value between 0 and 1 that represents the fade amount.
+function ____exports.setEntityOpacity(self, entity, alpha)
+    local sprite = entity:GetSprite()
+    setSpriteOpacity(nil, sprite, alpha)
+end
 function ____exports.setEntityRandomColor(self, entity)
     local rng = newRNG(nil, entity.InitSeed)
     local r = getRandom(nil, rng)

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

@@ -32,6 +32,14 @@ export declare function clearSprite(sprite: Sprite, ...layerIDs: int[]): void;
  * player animations.
  */
 export declare function getLastFrameOfAnimation(sprite: Sprite, animation?: string): int;
+/**
+ * Helper function to keep a sprite's color the same values as it already is but set the opacity to
+ * a specific value.
+ *
+ * @param sprite The sprite to set.
+ * @param alpha A value between 0 and 1 that represents the fade amount.
+ */
+export declare function setSpriteOpacity(sprite: Sprite, alpha: float): void;
 /**
  * Helper function to check if two sprite layers have the same sprite sheet by using the
  * `Sprite.GetTexel` method.

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

@@ -1 +1 @@
-{"version":3,"file":"sprites.d.ts","sourceRoot":"","sources":["../../../src/functions/sprites.ts"],"names":[],"mappings":";;;AAIA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI,CAWpE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,GACjB,GAAG,CAmBL;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,GAAG,EACZ,MAAM,EAAE,GAAG,EACX,OAAO,EAAE,GAAG,EACZ,UAAU,EAAE,GAAG,EACf,MAAM,EAAE,GAAG,EACX,OAAO,EAAE,GAAG,EACZ,UAAU,EAAE,GAAG,GACd,OAAO,CAaT;AAED,uFAAuF;AACvF,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,GAAG,GACX,OAAO,CAIT"}
+{"version":3,"file":"sprites.d.ts","sourceRoot":"","sources":["../../../src/functions/sprites.ts"],"names":[],"mappings":";;;AAKA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI,CAWpE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,GACjB,GAAG,CAmBL;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAInE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,GAAG,EACZ,MAAM,EAAE,GAAG,EACX,OAAO,EAAE,GAAG,EACZ,UAAU,EAAE,GAAG,EACf,MAAM,EAAE,GAAG,EACX,OAAO,EAAE,GAAG,EACZ,UAAU,EAAE,GAAG,GACd,OAAO,CAaT;AAED,uFAAuF;AACvF,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,GAAG,GACX,OAAO,CAIT"}

package/dist/src/functions/sprites.lua

@@ -2,6 +2,8 @@ local ____exports = {}
 local ____constants = require("src.core.constants")
 local EMPTY_PNG_PATH = ____constants.EMPTY_PNG_PATH
 local VectorZero = ____constants.VectorZero
+local ____color = require("src.functions.color")
+local copyColor = ____color.copyColor
 local ____kColor = require("src.functions.kColor")
 local kColorEquals = ____kColor.kColorEquals
 local ____utils = require("src.functions.utils")
@@ -62,6 +64,16 @@ function ____exports.getLastFrameOfAnimation(self, sprite, animation)
     sprite:SetFrame(currentFrame)
     return finalFrame
 end
+--- Helper function to keep a sprite's color the same values as it already is but set the opacity to
+-- a specific value.
+-- 
+-- @param sprite The sprite to set.
+-- @param alpha A value between 0 and 1 that represents the fade amount.
+function ____exports.setSpriteOpacity(self, sprite, alpha)
+    local fadedColor = copyColor(nil, sprite.Color)
+    fadedColor.A = alpha
+    sprite.Color = fadedColor
+end
 --- Helper function to check if two sprite layers have the same sprite sheet by using the
 -- `Sprite.GetTexel` method.
 -- 

package/package.json

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

package/src/classes/features/callbackLogic/SlotDestroyedDetection.ts

@@ -5,9 +5,7 @@
 //    room.
 
 // 2) In the specific case of a machine spawning a collectible, the machine will be immediately
-//    removed. The collectible will not have the `SpawnerEntity` or `Parent` in this case. Thus, we
-//    store all despawning slots in an array and then cross reference the array when a new pickup
-//    spawns.
+//    removed. Thus, we assume that any despawning slot machine is destroyed in this way.
 
 // For beggars, destruction is detected by monitoring for when a beggar despawns mid-room. Beggars
 // that are paying out with a collectible will always be playing the "Teleport" animation.
@@ -17,28 +15,18 @@ import {
   EntityGridCollisionClass,
   EntityType,
   ModCallback,
-  PickupVariant,
 } from "isaac-typescript-definitions";
-import { game } from "../../../core/cachedClasses";
 import { ModCallbackCustom } from "../../../enums/ModCallbackCustom";
 import { SlotDestructionType } from "../../../enums/SlotDestructionType";
 import { isSlotMachine } from "../../../functions/slots";
-import { vectorEquals } from "../../../functions/vector";
 import { PostSlotDestroyed } from "../../callbacks/PostSlotDestroyed";
 import { Feature } from "../../private/Feature";
 import { RoomHistory } from "../other/RoomHistory";
 
-type DespawnedSlotTuple = [
-  gameFrame: int,
-  position: Vector,
-  entityPtr: EntityPtr,
-];
-
 export class SlotDestroyedDetection extends Feature {
   public override v = {
     room: {
       destroyedSlotSet: new Set<PtrHash>(),
-      despawnedSlots: [] as DespawnedSlotTuple[],
     },
   };
 
@@ -49,13 +37,6 @@ export class SlotDestroyedDetection extends Feature {
     super();
 
     this.callbacksUsed = [
-      // 34
-      [
-        ModCallback.POST_PICKUP_INIT,
-        this.postPickupInitCollectible,
-        [PickupVariant.COLLECTIBLE],
-      ],
-
       // 67
       [
         ModCallback.POST_ENTITY_REMOVE,
@@ -72,30 +53,6 @@ export class SlotDestroyedDetection extends Feature {
     this.roomHistory = roomHistory;
   }
 
-  // ModCallback.POST_PICKUP_INIT (34)
-  // PickupVariant.COLLECTIBLE (100)
-  private postPickupInitCollectible = (pickup: EntityPickup) => {
-    const gameFrameCount = game.GetFrameCount();
-
-    // Go through the despawning slots to see if they match this pickup.
-    for (const despawnedSlotTuple of this.v.room.despawnedSlots) {
-      const [gameFrame, position, entityPtr] = despawnedSlotTuple;
-      if (
-        gameFrame === gameFrameCount &&
-        vectorEquals(position, pickup.Position)
-      ) {
-        const entity = entityPtr.Ref;
-        if (entity !== undefined) {
-          const slot = entity as EntitySlot;
-          this.postSlotDestroyed.fire(
-            slot,
-            SlotDestructionType.COLLECTIBLE_PAYOUT,
-          );
-        }
-      }
-    }
-  };
-
   // ModCallback.POST_ENTITY_REMOVE (67)
   // EntityType.SLOT (6)
   private postEntityRemoveSlot = (entity: Entity) => {
@@ -115,14 +72,7 @@ export class SlotDestroyedDetection extends Feature {
   };
 
   private postEntityRemoveSlotMachine(slot: EntitySlot) {
-    const gameFrameCount = game.GetFrameCount();
-    const entityPtr = EntityPtr(slot);
-    const despawnedSlotTuple: DespawnedSlotTuple = [
-      gameFrameCount,
-      slot.Position,
-      entityPtr,
-    ];
-    this.v.room.despawnedSlots.push(despawnedSlotTuple);
+    this.postSlotDestroyed.fire(slot, SlotDestructionType.COLLECTIBLE_PAYOUT);
   }
 
   private postEntityRemoveBeggar(slot: EntitySlot) {

package/src/enums/ModCallbackCustom.ts

@@ -1636,8 +1636,35 @@ export enum ModCallbackCustom {
   POST_SLOT_COLLISION,
 
   /**
-   * Fires from the `POST_RENDER` callback when a slot plays the animation that indicates that it
-   * has broken.
+   * Fires from the `POST_SLOT_UPDATE` or the `POST_ENTITY_REMOVE` callback when a slot machine is
+   * destroyed or a beggar is removed.
+   *
+   * This callback will fire in four different kinds of situations:
+   *
+   * 1. When slot machine entities (e.g. `SlotVariant.SLOT_MACHINE` and
+   *    `SlotVariant.BLOOD_DONATION_MACHINE`) are destroyed with an explosion. When this happens,
+   *    they typically stay in the room and can be pushed around. This state is detected via a
+   *    change in the `GridCollisionClass`.
+   * 2. When slot machine entities pay out with a collectible item. When this happens, they
+   *    immediately despawn without playing any special animation.
+   * 3. When beggar entities (e.g. `SlotVariant.BEGGAR` and `SlotVariant.SHELL_GAME`) are destroyed
+   *    with an explosion. When this happens, they immediately despawn without playing any special
+   *    animation.
+   * 4. When beggar entities pay out with a collectible item. When this happens, they despawn after
+   *    playing the "Teleport" animation. (This is not technically a "destruction" event, but the
+   *    callback will fire for this to remain consistent with the other types of slot entities.)
+   *
+   * Depending on the specific types of slot removal that you need to detect, you can filter using:
+   *
+   * 1. The `isSlotMachine` helper function to differentiate between slot machines and beggars.
+   * 2. The passed callback argument of `SlotDestructionType` to differentiate between bombed slots
+   *    and slots that paid out with a collectible item.
+   *
+   * Note that when a Crane Game explodes after paying out three collectibles, the
+   * `SlotDestructionType` will be equal to `SlotDestructionType.NORMAL` instead of
+   * `SlotDestructionType.COLLECTIBLE_PAYOUT` like you might expect. (This is because it only
+   * explodes after a short delay, and when doing so, it produces rewards in the same way that would
+   * happen if you bombed it.)
    *
    * When registering the callback with the `ModUpgraded.AddCallbackCustom` method:
    * - You can provide an optional third argument that will make the callback only fire if it

package/src/functions/entities.ts

@@ -8,6 +8,7 @@ import { EntityID } from "../types/EntityID";
 import { getIsaacAPIClassName } from "./isaacAPIClass";
 import { getRandom } from "./random";
 import { isRNG, newRNG } from "./rng";
+import { setSpriteOpacity } from "./sprites";
 import { asNumber, isPrimitive } from "./types";
 import { isVector, vectorToString } from "./vector";
 
@@ -477,6 +478,18 @@ export function setEntityDamageFlash(entity: Entity): void {
   entity.SetColor(DAMAGE_FLASH_COLOR, 2, 0);
 }
 
+/**
+ * Helper function to keep an entity's color the same values as it already is but set the opacity to
+ * a specific value.
+ *
+ * @param entity The entity to set.
+ * @param alpha A value between 0 and 1 that represents the fade amount.
+ */
+export function setEntityOpacity(entity: Entity, alpha: float): void {
+  const sprite = entity.GetSprite();
+  setSpriteOpacity(sprite, alpha);
+}
+
 export function setEntityRandomColor(entity: Entity): void {
   const rng = newRNG(entity.InitSeed);
 

package/src/functions/sprites.ts

@@ -1,4 +1,5 @@
 import { EMPTY_PNG_PATH, VectorZero } from "../core/constants";
+import { copyColor } from "./color";
 import { kColorEquals } from "./kColor";
 import { eRange } from "./utils";
 
@@ -68,6 +69,19 @@ export function getLastFrameOfAnimation(
   return finalFrame;
 }
 
+/**
+ * Helper function to keep a sprite's color the same values as it already is but set the opacity to
+ * a specific value.
+ *
+ * @param sprite The sprite to set.
+ * @param alpha A value between 0 and 1 that represents the fade amount.
+ */
+export function setSpriteOpacity(sprite: Sprite, alpha: float): void {
+  const fadedColor = copyColor(sprite.Color);
+  fadedColor.A = alpha;
+  sprite.Color = fadedColor;
+}
+
 /**
  * Helper function to check if two sprite layers have the same sprite sheet by using the
  * `Sprite.GetTexel` method.