isaacscript-common 1.2.153 → 1.2.156

package/dist/callbacks/postCustomDoorEnter.d.ts

@@ -24,9 +24,21 @@
  */
 export declare function initCustomDoor(mod: Mod, effectVariant: int): void;
 /**
- * Helper function to spawn a custom door. Handle when a player enters the door by hooking the
- * custom `MC_POST_CUSTOM_DOOR_ENTER` callback.
+ * Helper function to spawn a custom door. This is intended to be called from the `MC_POST_NEW_ROOM`
+ * callback when the player enters a room that should have a custom door. (You could also call it
+ * from another callback if you want the door to appear e.g. after clearing all enemies.)
  *
- * Before using this function, you must first initialize it with the `initCustomDoor` function.
+ * Handle when a player enters the door by hooking the custom `MC_POST_CUSTOM_DOOR_ENTER` callback.
+ *
+ * The custom door is an `EntityEffect`. You can manually open or close the door by modifying its
+ * state. (The values to use correspond to the `DoorState` enum.)
+ *
+ * This function will throw a runtime error if:
+ * - the door slot already has a vanilla door
+ * - the door slot already has a custom door
+ * - the tile at the door slot does not have a wall
+ *
+ * Before using this function, you must first initialize the effect/door variant with the
+ * `initCustomDoor` function.
  */
-export declare function spawnCustomDoor(effectVariant: int, doorSlot: DoorSlot): void;
+export declare function spawnCustomDoor(effectVariant: int, doorSlot: DoorSlot): EntityEffect;

package/dist/callbacks/postCustomDoorEnter.lua

@@ -4,14 +4,17 @@ local Set = ____lualib.Set
 local __TS__New = ____lualib.__TS__New
 local Map = ____lualib.Map
 local ____exports = {}
-local hasSubscriptions, postEffectRenderCustomEntity, getPositionOffset, getAnimation, POSITION_OFFSET_MULTIPLIER
+local hasSubscriptions, postEffectUpdaterCustomEntity, doorChangedState, getAnimationForCustomDoor, postEffectRenderCustomEntity, isPlayerPastDoorThreshold, getPositionOffset, POSITION_OFFSET_MULTIPLIER, v
 local ____cachedClasses = require("cachedClasses")
 local game = ____cachedClasses.game
 local ____exports = require("features.saveDataManager.exports")
 local saveDataManager = ____exports.saveDataManager
 local ____doors = require("functions.doors")
 local doorSlotToDirection = ____doors.doorSlotToDirection
-local getDoors = ____doors.getDoors
+local ____player = require("functions.player")
+local getClosestPlayer = ____player.getClosestPlayer
+local ____utils = require("functions.utils")
+local ensureAllCases = ____utils.ensureAllCases
 local ____vector = require("functions.vector")
 local directionToVector = ____vector.directionToVector
 local ____postCustomDoorEnter = require("callbacks.subscriptions.postCustomDoorEnter")
@@ -20,35 +23,43 @@ local postCustomDoorEnterHasSubscriptions = ____postCustomDoorEnter.postCustomDo
 function hasSubscriptions(self)
     return postCustomDoorEnterHasSubscriptions(nil)
 end
-function postEffectRenderCustomEntity(self)
-    if not hasSubscriptions(nil) then
+function postEffectUpdaterCustomEntity(self, effect)
+    local ptrHash = GetPtrHash(effect)
+    local doorData = v.room.customDoors:get(ptrHash)
+    if doorData == nil then
         return
     end
-    local doors = getDoors(nil)
-    if #doors == 0 then
+    if doorData.state == effect.State then
         return
     end
-    local door = doors[1]
-    postCustomDoorEnterFire(nil, door)
+    doorData.state = effect.State
+    doorChangedState(nil, effect)
 end
-function getPositionOffset(self, doorSlot)
-    local direction = doorSlotToDirection(nil, doorSlot)
-    local vector = directionToVector(nil, direction)
-    return vector * POSITION_OFFSET_MULTIPLIER
+function doorChangedState(self, effect)
+    local room = game:GetRoom()
+    local sprite = effect:GetSprite()
+    local animation = getAnimationForCustomDoor(nil, effect)
+    sprite:Play(animation, true)
+    local gridIndex = room:GetGridIndex(effect.Position)
+    local wall = room:GetGridEntity(gridIndex)
+    if wall ~= nil then
+        wall.CollisionClass = effect.State == DoorState.STATE_OPEN and GridCollisionClass.COLLISION_WALL_EXCEPT_PLAYER or GridCollisionClass.COLLISION_WALL
+    end
 end
-function getAnimation(self, effect)
+function getAnimationForCustomDoor(self, effect)
+    local freshlySpawned = effect.FrameCount == 0
     repeat
-        local ____switch15 = effect.State
-        local ____cond15 = ____switch15 == DoorState.STATE_OPEN
-        if ____cond15 then
+        local ____switch11 = effect.State
+        local ____cond11 = ____switch11 == DoorState.STATE_OPEN
+        if ____cond11 then
             do
-                return "Opened"
+                return freshlySpawned and "Opened" or "Open"
             end
         end
-        ____cond15 = ____cond15 or ____switch15 == DoorState.STATE_CLOSED
-        if ____cond15 then
+        ____cond11 = ____cond11 or ____switch11 == DoorState.STATE_CLOSED
+        if ____cond11 then
             do
-                return "Closed"
+                return freshlySpawned and "Closed" or "Close"
             end
         end
         do
@@ -58,23 +69,101 @@ function getAnimation(self, effect)
         end
     until true
 end
-POSITION_OFFSET_MULTIPLIER = 23
+function postEffectRenderCustomEntity(self, effect)
+    local ptrHash = GetPtrHash(effect)
+    local doorData = v.room.customDoors:get(ptrHash)
+    if doorData == nil then
+        return
+    end
+    local direction = doorSlotToDirection(nil, doorData.slot)
+    local player = getClosestPlayer(nil, effect.Position)
+    if isPlayerPastDoorThreshold(nil, effect, player, direction) then
+        postCustomDoorEnterFire(
+            nil,
+            player,
+            effect.Variant,
+            doorData.slot,
+            direction
+        )
+    end
+end
+function isPlayerPastDoorThreshold(self, effect, player, direction)
+    repeat
+        local ____switch19 = direction
+        local ____cond19 = ____switch19 == Direction.NO_DIRECTION
+        if ____cond19 then
+            do
+                return false
+            end
+        end
+        ____cond19 = ____cond19 or ____switch19 == Direction.UP
+        if ____cond19 then
+            do
+                return player.Position.Y <= effect.Position.Y
+            end
+        end
+        ____cond19 = ____cond19 or ____switch19 == Direction.RIGHT
+        if ____cond19 then
+            do
+                return player.Position.X >= effect.Position.X
+            end
+        end
+        ____cond19 = ____cond19 or ____switch19 == Direction.DOWN
+        if ____cond19 then
+            do
+                return player.Position.Y >= effect.Position.Y
+            end
+        end
+        ____cond19 = ____cond19 or ____switch19 == Direction.LEFT
+        if ____cond19 then
+            do
+                return player.Position.X <= effect.Position.X
+            end
+        end
+        do
+            do
+                return ensureAllCases(nil, direction)
+            end
+        end
+    until true
+end
+function getPositionOffset(self, doorSlot)
+    local direction = doorSlotToDirection(nil, doorSlot)
+    local vector = directionToVector(nil, direction)
+    return vector * POSITION_OFFSET_MULTIPLIER
+end
+POSITION_OFFSET_MULTIPLIER = -23
 local initializedEffectVariants = __TS__New(Set)
-local v = {room = {doors = __TS__New(Map)}}
+v = {room = {
+    customDoors = __TS__New(Map),
+    customDoorSlots = __TS__New(Set)
+}}
 function ____exports.postCustomDoorEnterCallbackInit(self)
     saveDataManager(nil, "postCustomDoorEnter", v, hasSubscriptions)
 end
 function ____exports.initCustomDoor(self, mod, effectVariant)
     initializedEffectVariants:add(effectVariant)
+    mod:AddCallback(ModCallbacks.MC_POST_EFFECT_UPDATE, postEffectUpdaterCustomEntity, effectVariant)
     mod:AddCallback(ModCallbacks.MC_POST_EFFECT_RENDER, postEffectRenderCustomEntity, effectVariant)
 end
 function ____exports.spawnCustomDoor(self, effectVariant, doorSlot)
     if not initializedEffectVariants:has(effectVariant) then
         error("In order to spawn custom doors, you must first initialize them with the \"initCustomDoor\" function at the beginning of your mod.")
     end
+    if v.room.customDoorSlots:has(doorSlot) then
+        error("There is already a custom door initialized on door slot: " .. tostring(doorSlot))
+    end
     local room = game:GetRoom()
     local roomClear = room:IsClear()
     local position = room:GetDoorSlotPosition(doorSlot)
+    local gridEntity = room:GetGridEntityFromPos(position)
+    if gridEntity == nil then
+        error(("Failed to initialize a custom door at slot " .. tostring(doorSlot)) .. " because the wall on that tile does not exist.")
+    end
+    local gridEntityType = gridEntity:GetType()
+    if gridEntityType ~= GridEntityType.GRID_WALL then
+        error((("Failed to initialize a custom door at slot " .. tostring(doorSlot)) .. " because there is another grid entity on that tile with a type of: ") .. tostring(gridEntityType))
+    end
     local effect = Isaac.Spawn(
         EntityType.ENTITY_EFFECT,
         effectVariant,
@@ -90,15 +179,12 @@ function ____exports.spawnCustomDoor(self, effectVariant, doorSlot)
     effect.RenderZOffset = -10000
     effect.PositionOffset = getPositionOffset(nil, doorSlot)
     local sprite = effect:GetSprite()
-    local animation = getAnimation(nil, effect)
-    sprite:Play(animation, true)
     sprite.Rotation = doorSlot * 90 - 90
-    if effect.State == DoorState.STATE_OPEN then
-        local gridIndex = room:GetGridIndex(position)
-        local wall = room:GetGridEntity(gridIndex)
-        if wall ~= nil then
-            wall.CollisionClass = GridCollisionClass.COLLISION_WALL_EXCEPT_PLAYER
-        end
-    end
+    local ptrHash = GetPtrHash(effect)
+    local doorData = {slot = doorSlot, state = effect.State}
+    v.room.customDoors:set(ptrHash, doorData)
+    v.room.customDoorSlots:add(doorSlot)
+    doorChangedState(nil, effect)
+    return effect
 end
 return ____exports

package/dist/callbacks/subscriptions/postCustomDoorEnter.d.ts

@@ -1,2 +1,2 @@
 /// <reference types="isaac-typescript-definitions" />
-export declare type PostCustomDoorEnterCallbackType = (door: GridEntityDoor) => void;
+export declare type PostCustomDoorEnterCallbackType = (player: EntityPlayer, effectVariant: int, doorSlot: DoorSlot, direction: Direction) => void;

package/dist/callbacks/subscriptions/postCustomDoorEnter.lua

@@ -6,18 +6,24 @@ local subscriptions = {}
 function ____exports.postCustomDoorEnterHasSubscriptions(self)
     return #subscriptions > 0
 end
-function ____exports.postCustomDoorEnterRegister(self, callback, doorVariant)
-    __TS__ArrayPush(subscriptions, {callback, doorVariant})
+function ____exports.postCustomDoorEnterRegister(self, callback, effectVariant)
+    __TS__ArrayPush(subscriptions, {callback, effectVariant})
 end
-function ____exports.postCustomDoorEnterFire(self, door)
+function ____exports.postCustomDoorEnterFire(self, player, effectVariant, doorSlot, direction)
     for ____, ____value in ipairs(subscriptions) do
         local callback = ____value[1]
-        local doorVariant = ____value[2]
+        local callbackEffectVariant = ____value[2]
         do
-            if doorVariant ~= nil and doorVariant ~= door:GetVariant() then
+            if callbackEffectVariant ~= nil and callbackEffectVariant ~= effectVariant then
                 goto __continue5
             end
-            callback(nil, door)
+            callback(
+                nil,
+                player,
+                effectVariant,
+                doorSlot,
+                direction
+            )
         end
         ::__continue5::
     end

package/dist/features/extraConsoleCommands/commands.d.ts

@@ -264,7 +264,9 @@ export declare function sacrifice(): void;
 /** Warps to the first Secret Room on the floor. */
 export declare function secret(): void;
 /** Logs all of the current run's seed effects to the "log.txt" file. */
-export declare function seeds(): void;
+export declare function seedsCommand(): void;
+/** Changes to a seeded run, using the seed of the current run. */
+export declare function seedStick(): void;
 /**
  * Sets a charge to the player's specified active item. You must provide the active slot number and
  * the number of charges to set.

package/dist/features/extraConsoleCommands/commands.lua

@@ -755,10 +755,15 @@ end
 function ____exports.secret(self)
     warpToRoomType(nil, RoomType.ROOM_SECRET)
 end
-function ____exports.seeds(self)
+function ____exports.seedsCommand(self)
     logAllSeedEffects()
     printConsole(nil, "Logged the seed effects to the \"log.txt\" file.")
 end
+function ____exports.seedStick(self)
+    local seeds = game:GetSeeds()
+    local startSeedString = seeds:GetStartSeedString()
+    Isaac.ExecuteCommand("seed " .. startSeedString)
+end
 function ____exports.setCharges(self, params)
     if params == "" then
         printConsole(nil, "You must specify a slot number and a charge amount. (Use 0 for the primary slot, 1 for the Schoolbag slot, 2 for the pocket item slot, and 3 for the Dice Bag slot.)")

package/dist/features/extraConsoleCommands/init.lua

@@ -173,7 +173,8 @@ commandFunctionsMap:set("rottenhearts", commands.rottenHearts)
 commandFunctionsMap:set("s", commands.s)
 commandFunctionsMap:set("sacrifice", commands.sacrifice)
 commandFunctionsMap:set("secret", commands.secret)
-commandFunctionsMap:set("seeds", commands.seeds)
+commandFunctionsMap:set("seeds", commands.seedsCommand)
+commandFunctionsMap:set("seedstick", commands.seedStick)
 commandFunctionsMap:set("setcharges", commands.setCharges)
 commandFunctionsMap:set("setposition", commands.setPosition)
 commandFunctionsMap:set("sh", commands.sh)

package/dist/index.d.ts

@@ -74,8 +74,8 @@ export * from "./maps/cardMap";
 export * from "./maps/characterMap";
 export * from "./maps/pillEffectMap";
 export * from "./maps/roomTypeMap";
+export * from "./types/AddCallbackParametersCustom";
 export * from "./types/AnyEntity";
-export * from "./types/CallbackParametersCustom";
 export * from "./types/CardType";
 export * from "./types/DefaultMap";
 export * from "./types/HealthType";

package/dist/objects/callbackRegisterFunctions.d.ts

@@ -1,4 +1,5 @@
+import { AddCallbackParametersCustom } from "../types/AddCallbackParametersCustom";
 import { ModCallbacksCustom } from "../types/ModCallbacksCustom";
 export declare const CALLBACK_REGISTER_FUNCTIONS: {
-    readonly [key in ModCallbacksCustom]: Function;
+    readonly [key in ModCallbacksCustom]: (...args: AddCallbackParametersCustom[key]) => void;
 };

package/dist/types/AddCallbackParametersCustom.d.ts

@@ -0,0 +1,239 @@
+/// <reference types="isaac-typescript-definitions" />
+import { PostBombInitLateCallbackType } from "../callbacks/subscriptions/postBombInitLate";
+import { PostBoneSwingCallbackType } from "../callbacks/subscriptions/postBoneSwing";
+import { PostCursedTeleportCallbackType } from "../callbacks/subscriptions/postCursedTeleport";
+import { PostCustomDoorEnterCallbackType } from "../callbacks/subscriptions/postCustomDoorEnter";
+import { PostCustomReviveCallbackType } from "../callbacks/subscriptions/postCustomRevive";
+import { PostEffectInitLateCallbackType } from "../callbacks/subscriptions/postEffectInitLate";
+import { PostEsauJrCallbackType } from "../callbacks/subscriptions/postEsauJr";
+import { PostFamiliarInitLateCallbackType } from "../callbacks/subscriptions/postFamiliarInitLate";
+import { PostFirstEsauJrCallbackType } from "../callbacks/subscriptions/postFirstEsauJr";
+import { PostFirstFlipCallbackType } from "../callbacks/subscriptions/postFirstFlip";
+import { PostFlipCallbackType } from "../callbacks/subscriptions/postFlip";
+import { PostGameStartedReorderedCallbackType } from "../callbacks/subscriptions/postGameStartedReordered";
+import { PostGridEntityBrokenCallbackType } from "../callbacks/subscriptions/postGridEntityBroken";
+import { PostGridEntityCollisionCallbackType } from "../callbacks/subscriptions/postGridEntityCollision";
+import { PostGridEntityInitCallbackType } from "../callbacks/subscriptions/postGridEntityInit";
+import { PostGridEntityRemoveCallbackType } from "../callbacks/subscriptions/postGridEntityRemove";
+import { PostGridEntityStateChangeCallbackType } from "../callbacks/subscriptions/postGridEntityStateChange";
+import { PostGridEntityUpdateCallbackType } from "../callbacks/subscriptions/postGridEntityUpdate";
+import { PostItemPickupCallbackType } from "../callbacks/subscriptions/postItemPickup";
+import { PostKnifeInitLateCallbackType } from "../callbacks/subscriptions/postKnifeInitLate";
+import { PostLaserInitLateCallbackType } from "../callbacks/subscriptions/postLaserInitLate";
+import { PostNewLevelReorderedCallbackType } from "../callbacks/subscriptions/postNewLevelReordered";
+import { PostNewRoomEarlyCallbackType } from "../callbacks/subscriptions/postNewRoomEarly";
+import { PostNewRoomReorderedCallbackType } from "../callbacks/subscriptions/postNewRoomReordered";
+import { PostNPCInitLateCallbackType } from "../callbacks/subscriptions/postNPCInitLate";
+import { PostPEffectUpdateReorderedCallbackType } from "../callbacks/subscriptions/postPEffectUpdateReordered";
+import { PostPickupCollectCallbackType } from "../callbacks/subscriptions/postPickupCollect";
+import { PostPickupInitLateCallbackType } from "../callbacks/subscriptions/postPickupInitLate";
+import { PostPlayerChangeHealthCallbackType } from "../callbacks/subscriptions/postPlayerChangeHealth";
+import { PostPlayerChangeTypeCallbackType } from "../callbacks/subscriptions/postPlayerChangeType";
+import { PostPlayerFatalDamageCallbackType } from "../callbacks/subscriptions/postPlayerFatalDamage";
+import { PostPlayerInitLateCallbackType } from "../callbacks/subscriptions/postPlayerInitLate";
+import { PostPlayerInitReorderedCallbackType } from "../callbacks/subscriptions/postPlayerInitReordered";
+import { PostPlayerRenderReorderedCallbackType } from "../callbacks/subscriptions/postPlayerRenderReordered";
+import { PostPlayerUpdateReorderedCallbackType } from "../callbacks/subscriptions/postPlayerUpdateReordered";
+import { PostProjectileInitLateCallbackType } from "../callbacks/subscriptions/postProjectileInitLate";
+import { PostPurchaseCallbackType } from "../callbacks/subscriptions/postPurchase";
+import { PostSacrificeCallbackType } from "../callbacks/subscriptions/postSacrifice";
+import { PostSlotAnimationChangedCallbackType } from "../callbacks/subscriptions/postSlotAnimationChanged";
+import { PostSlotDestroyedCallbackType } from "../callbacks/subscriptions/postSlotDestroyed";
+import { PostSlotInitCallbackType } from "../callbacks/subscriptions/postSlotInit";
+import { PostSlotRenderCallbackType } from "../callbacks/subscriptions/postSlotRender";
+import { PostSlotUpdateCallbackType } from "../callbacks/subscriptions/postSlotUpdate";
+import { PostTearInitLateCallbackType } from "../callbacks/subscriptions/postTearInitLate";
+import { PostTearInitVeryLateCallbackType } from "../callbacks/subscriptions/postTearInitVeryLate";
+import { PostTransformationCallbackType } from "../callbacks/subscriptions/postTransformation";
+import { PostTrinketBreakCallbackType } from "../callbacks/subscriptions/postTrinketBreak";
+import { PreBerserkDeathCallbackType } from "../callbacks/subscriptions/preBerserkDeath";
+import { PreCustomReviveCallbackType } from "../callbacks/subscriptions/preCustomRevive";
+import { PreItemPickupCallbackType } from "../callbacks/subscriptions/preItemPickup";
+import { PreNewLevelCallbackType } from "../callbacks/subscriptions/preNewLevel";
+import { ModCallbacksCustom } from "./ModCallbacksCustom";
+export interface AddCallbackParametersCustom {
+    [ModCallbacksCustom.MC_POST_GAME_STARTED_REORDERED]: [
+        callback: PostGameStartedReorderedCallbackType
+    ];
+    [ModCallbacksCustom.MC_POST_NEW_LEVEL_REORDERED]: [
+        callback: PostNewLevelReorderedCallbackType
+    ];
+    [ModCallbacksCustom.MC_POST_NEW_ROOM_REORDERED]: [
+        callback: PostNewRoomReorderedCallbackType
+    ];
+    [ModCallbacksCustom.MC_POST_PLAYER_INIT_REORDERED]: [
+        callback: PostPlayerInitReorderedCallbackType,
+        playerVariant?: PlayerVariant
+    ];
+    [ModCallbacksCustom.MC_POST_PEFFECT_UPDATE_REORDERED]: [
+        callback: PostPEffectUpdateReorderedCallbackType,
+        character?: PlayerType | int
+    ];
+    [ModCallbacksCustom.MC_POST_PLAYER_UPDATE_REORDERED]: [
+        callback: PostPlayerUpdateReorderedCallbackType,
+        playerVariant?: PlayerVariant
+    ];
+    [ModCallbacksCustom.MC_POST_PLAYER_RENDER_REORDERED]: [
+        callback: PostPlayerRenderReorderedCallbackType,
+        playerVariant?: PlayerVariant
+    ];
+    [ModCallbacksCustom.MC_POST_NEW_ROOM_EARLY]: [
+        callback: PostNewRoomEarlyCallbackType
+    ];
+    [ModCallbacksCustom.MC_PRE_NEW_LEVEL]: [callback: PreNewLevelCallbackType];
+    [ModCallbacksCustom.MC_POST_PLAYER_INIT_LATE]: [
+        callback: PostPlayerInitLateCallbackType,
+        playerVariant?: PlayerVariant
+    ];
+    [ModCallbacksCustom.MC_POST_TEAR_INIT_LATE]: [
+        callback: PostTearInitLateCallbackType,
+        tearVariant?: TearVariant | int
+    ];
+    [ModCallbacksCustom.MC_POST_TEAR_INIT_VERY_LATE]: [
+        callback: PostTearInitVeryLateCallbackType,
+        tearVariant?: TearVariant | int
+    ];
+    [ModCallbacksCustom.MC_POST_FAMILIAR_INIT_LATE]: [
+        callback: PostFamiliarInitLateCallbackType,
+        familiarVariant?: FamiliarVariant | int
+    ];
+    [ModCallbacksCustom.MC_POST_BOMB_INIT_LATE]: [
+        callback: PostBombInitLateCallbackType,
+        bombVariant?: BombVariant | int
+    ];
+    [ModCallbacksCustom.MC_POST_PICKUP_INIT_LATE]: [
+        callback: PostPickupInitLateCallbackType,
+        pickupVariant?: PickupVariant | int
+    ];
+    [ModCallbacksCustom.MC_POST_LASER_INIT_LATE]: [
+        callback: PostLaserInitLateCallbackType,
+        laserVariant?: LaserVariant | int
+    ];
+    [ModCallbacksCustom.MC_POST_KNIFE_INIT_LATE]: [
+        callback: PostKnifeInitLateCallbackType,
+        knifeVariant?: KnifeVariant | int
+    ];
+    [ModCallbacksCustom.MC_POST_PROJECTILE_INIT_LATE]: [
+        callback: PostProjectileInitLateCallbackType,
+        projectileVariant?: ProjectileVariant | int
+    ];
+    [ModCallbacksCustom.MC_POST_NPC_INIT_LATE]: [
+        callback: PostNPCInitLateCallbackType,
+        entityType?: EntityType | int
+    ];
+    [ModCallbacksCustom.MC_POST_EFFECT_INIT_LATE]: [
+        callback: PostEffectInitLateCallbackType,
+        effectVariant?: EffectVariant
+    ];
+    [ModCallbacksCustom.MC_POST_PICKUP_COLLECT]: [
+        callback: PostPickupCollectCallbackType,
+        pickupVariant?: PickupVariant | int
+    ];
+    [ModCallbacksCustom.MC_PRE_ITEM_PICKUP]: [
+        callback: PreItemPickupCallbackType,
+        itemType?: ItemType,
+        itemID?: CollectibleType | TrinketType | int
+    ];
+    [ModCallbacksCustom.MC_POST_ITEM_PICKUP]: [
+        callback: PostItemPickupCallbackType,
+        itemType?: ItemType,
+        itemID?: CollectibleType | TrinketType | int
+    ];
+    [ModCallbacksCustom.MC_POST_PLAYER_CHANGE_TYPE]: [
+        callback: PostPlayerChangeTypeCallbackType
+    ];
+    [ModCallbacksCustom.MC_POST_PLAYER_CHANGE_HEALTH]: [
+        callback: PostPlayerChangeHealthCallbackType,
+        playerVariant?: PlayerVariant
+    ];
+    [ModCallbacksCustom.MC_POST_PLAYER_FATAL_DAMAGE]: [
+        callback: PostPlayerFatalDamageCallbackType,
+        playerVariant?: PlayerVariant
+    ];
+    [ModCallbacksCustom.MC_PRE_BERSERK_DEATH]: [
+        callback: PreBerserkDeathCallbackType,
+        playerVariant?: PlayerVariant
+    ];
+    [ModCallbacksCustom.MC_PRE_CUSTOM_REVIVE]: [
+        callback: PreCustomReviveCallbackType
+    ];
+    [ModCallbacksCustom.MC_POST_CUSTOM_REVIVE]: [
+        callback: PostCustomReviveCallbackType,
+        revivalType?: int
+    ];
+    [ModCallbacksCustom.MC_POST_FLIP]: [callback: PostFlipCallbackType];
+    [ModCallbacksCustom.MC_POST_FIRST_FLIP]: [
+        callback: PostFirstFlipCallbackType
+    ];
+    [ModCallbacksCustom.MC_POST_ESAU_JR]: [callback: PostEsauJrCallbackType];
+    [ModCallbacksCustom.MC_POST_FIRST_ESAU_JR]: [
+        callback: PostFirstEsauJrCallbackType
+    ];
+    [ModCallbacksCustom.MC_POST_TRANSFORMATION]: [
+        callback: PostTransformationCallbackType
+    ];
+    [ModCallbacksCustom.MC_POST_PURCHASE]: [
+        callback: PostPurchaseCallbackType,
+        pickupVariant?: PickupVariant | int,
+        pickupSubType?: int
+    ];
+    [ModCallbacksCustom.MC_POST_SACRIFICE]: [callback: PostSacrificeCallbackType];
+    [ModCallbacksCustom.MC_POST_CURSED_TELEPORT]: [
+        callback: PostCursedTeleportCallbackType
+    ];
+    [ModCallbacksCustom.MC_POST_TRINKET_BREAK]: [
+        callback: PostTrinketBreakCallbackType,
+        trinketType?: TrinketType | int
+    ];
+    [ModCallbacksCustom.MC_POST_SLOT_INIT]: [
+        callback: PostSlotInitCallbackType,
+        slotVariant?: SlotVariant
+    ];
+    [ModCallbacksCustom.MC_POST_SLOT_UPDATE]: [
+        callback: PostSlotUpdateCallbackType,
+        slotVariant?: SlotVariant
+    ];
+    [ModCallbacksCustom.MC_POST_SLOT_RENDER]: [
+        callback: PostSlotRenderCallbackType,
+        slotVariant?: SlotVariant
+    ];
+    [ModCallbacksCustom.MC_POST_SLOT_ANIMATION_CHANGED]: [
+        callback: PostSlotAnimationChangedCallbackType,
+        slotVariant?: SlotVariant
+    ];
+    [ModCallbacksCustom.MC_POST_SLOT_DESTROYED]: [
+        callback: PostSlotDestroyedCallbackType,
+        slotVariant?: SlotVariant
+    ];
+    [ModCallbacksCustom.MC_POST_GRID_ENTITY_INIT]: [
+        callback: PostGridEntityInitCallbackType,
+        gridEntityType?: GridEntityType
+    ];
+    [ModCallbacksCustom.MC_POST_GRID_ENTITY_UPDATE]: [
+        callback: PostGridEntityUpdateCallbackType,
+        gridEntityType?: GridEntityType
+    ];
+    [ModCallbacksCustom.MC_POST_GRID_ENTITY_REMOVE]: [
+        callback: PostGridEntityRemoveCallbackType,
+        gridEntityType?: GridEntityType
+    ];
+    [ModCallbacksCustom.MC_POST_GRID_ENTITY_STATE_CHANGE]: [
+        callback: PostGridEntityStateChangeCallbackType,
+        gridEntityType?: GridEntityType
+    ];
+    [ModCallbacksCustom.MC_POST_GRID_ENTITY_BROKEN]: [
+        callback: PostGridEntityBrokenCallbackType,
+        gridEntityType?: GridEntityType
+    ];
+    [ModCallbacksCustom.MC_POST_GRID_ENTITY_COLLISION]: [
+        callback: PostGridEntityCollisionCallbackType,
+        gridEntityType?: GridEntityType
+    ];
+    [ModCallbacksCustom.MC_POST_BONE_SWING]: [
+        callback: PostBoneSwingCallbackType
+    ];
+    [ModCallbacksCustom.MC_POST_CUSTOM_DOOR_ENTER]: [
+        callback: PostCustomDoorEnterCallbackType,
+        effectVariant?: int
+    ];
+}

package/dist/types/AddCallbackParametersCustom.lua

@@ -0,0 +1,5 @@
+--[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+local ____exports = {}
+local ____ModCallbacksCustom = require("types.ModCallbacksCustom")
+local ModCallbacksCustom = ____ModCallbacksCustom.ModCallbacksCustom
+return ____exports

package/dist/types/CallbackParametersCustom.d.ts

@@ -233,6 +233,7 @@ export interface CallbackParametersCustom {
         callback: PostBoneSwingCallbackType
     ];
     [ModCallbacksCustom.MC_POST_CUSTOM_DOOR_ENTER]: [
-        callback: PostCustomDoorEnterCallbackType
+        callback: PostCustomDoorEnterCallbackType,
+        effectVariant?: int
     ];
 }

package/dist/types/ModUpgraded.d.ts

@@ -1,5 +1,6 @@
 /// <reference types="isaac-typescript-definitions" />
-import { CallbackParametersCustom } from "./CallbackParametersCustom";
+import { AddCallbackParametersCustom } from "./AddCallbackParametersCustom";
+import { ModCallbacksCustom } from "./ModCallbacksCustom";
 /** `isaacscript-common` allows for custom callbacks, so it provides an upgraded Mod object. */
 export declare class ModUpgraded implements Mod {
     Name: string;
@@ -8,11 +9,11 @@ export declare class ModUpgraded implements Mod {
     /** End-users can optionally enable verbose-mode, which helps troubleshoot crashes. */
     Verbose: boolean;
     constructor(mod: Mod, verbose: boolean);
-    AddCallback<T extends keyof CallbackParameters>(callbackID: T, ...args: CallbackParameters[T]): void;
+    AddCallback<T extends ModCallbacks>(modCallbacks: T, ...args: AddCallbackParameters[T]): void;
     HasData(): boolean;
     LoadData(): string;
     RemoveCallback(callbackID: ModCallbacks, callback: () => void): void;
     RemoveData(): void;
     SaveData(data: string): void;
-    AddCallbackCustom<T extends keyof CallbackParametersCustom>(callbackID: T, ...args: CallbackParametersCustom[T]): void;
+    AddCallbackCustom<T extends ModCallbacksCustom>(modCallbacksCustom: T, ...args: AddCallbackParametersCustom[T]): void;
 }

package/dist/types/ModUpgraded.lua

@@ -27,12 +27,12 @@ function ModUpgraded.prototype.____constructor(self, mod, verbose)
     self.Mod = mod
     self.Verbose = verbose
 end
-function ModUpgraded.prototype.AddCallback(self, callbackID, ...)
+function ModUpgraded.prototype.AddCallback(self, modCallbacks, ...)
     local args = {...}
     if self.Verbose then
         local callback = args[1]
         local optionalArg = args[2]
-        local callbackName = getCallbackName(nil, callbackID)
+        local callbackName = getCallbackName(nil, modCallbacks)
         local debugMsg = getDebugPrependString(nil, callbackName)
         local function callbackWithLogger(____, ...)
             Isaac.DebugString(debugMsg .. " - START")
@@ -40,10 +40,10 @@ function ModUpgraded.prototype.AddCallback(self, callbackID, ...)
             Isaac.DebugString((debugMsg .. " - END - ") .. tostring(value))
             return value
         end
-        self.Mod:AddCallback(callbackID, callbackWithLogger, optionalArg)
+        self.Mod:AddCallback(modCallbacks, callbackWithLogger, optionalArg)
     else
         self.Mod:AddCallback(
-            callbackID,
+            modCallbacks,
             __TS__Spread(args)
         )
     end
@@ -63,10 +63,10 @@ end
 function ModUpgraded.prototype.SaveData(self, data)
     self.Mod:SaveData(data)
 end
-function ModUpgraded.prototype.AddCallbackCustom(self, callbackID, ...)
-    local callbackRegisterFunction = CALLBACK_REGISTER_FUNCTIONS[callbackID]
+function ModUpgraded.prototype.AddCallbackCustom(self, modCallbacksCustom, ...)
+    local callbackRegisterFunction = CALLBACK_REGISTER_FUNCTIONS[modCallbacksCustom]
     if callbackRegisterFunction == nil then
-        error("Failed to find a callback registration function for custom callback: " .. tostring(callbackID))
+        error("Failed to find a callback registration function for custom callback: " .. tostring(modCallbacksCustom))
     end
     callbackRegisterFunction(nil, ...)
 end

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "1.2.153",
+  "version": "1.2.156",
   "description": "Helper functions for IsaacScript mods",
   "keywords": [
     "isaac",
@@ -26,8 +26,8 @@
   ],
   "devDependencies": {
     "@zamiell/typescript-to-lua": "^1.4.2",
-    "isaac-typescript-definitions": "^1.0.366",
-    "isaacscript-lint": "^1.0.89",
+    "isaac-typescript-definitions": "^1.0.369",
+    "isaacscript-lint": "^1.0.90",
     "isaacscript-tsconfig": "^1.1.8",
     "typedoc": "^0.22.13",
     "typescript": "4.5.5"