isaacscript-common 15.6.2 → 16.0.0

package/dist/index.d.ts

@@ -1501,8 +1501,8 @@ declare abstract class CustomCallback<T extends ModCallbackCustom> extends Featu
 
 declare class CustomGridEntities extends Feature {
     private runInNFrames;
-    private postNewRoom;
     private preUseItemWeNeedToGoDeeper;
+    private postNewRoomReordered;
     /**
      * Helper function to spawn a custom grid entity. Custom grid entities are persistent in that they
      * will reappear if the player leaves and re-enters the room. (It will be manually respawned in
@@ -1804,7 +1804,7 @@ declare class CustomRevive extends Feature {
     private postRender;
     private postPEffectUpdate;
     private checkWaitingForItemAnimation;
-    private postNewRoom;
+    private postNewRoomReordered;
     private postPlayerFatalDamage;
     private preBerserkDeath;
     /**
@@ -6613,7 +6613,7 @@ declare class GridEntityUpdateDetection extends Feature {
     private checkGridEntityStateChanged;
     private checkNewGridEntity;
     private updateTupleInMap;
-    private postNewRoom;
+    private postNewRoomReordered;
 }
 
 /**
@@ -10974,6 +10974,11 @@ export declare class ModUpgradedBase implements Mod {
      * don't have access to it..
      */
     private initOptionalFeature;
+    /**
+     * This is mostly the same as the `AddCustomCallback` method, but we initialize the custom
+     * callback without actually registering a subscription.
+     */
+    private initCustomCallbackEarly;
 }
 
 export declare const MOVEMENT_ACTIONS_SET: ReadonlySet<ButtonAction>;
@@ -14434,6 +14439,14 @@ export declare type UnionToIntersection<U> = (U extends U ? (u: U) => 0 : never)
  * @param modVanilla The mod object returned by the `RegisterMod` function.
  * @param features Optional. An array containing the optional standard library features that you
  *                 want to enable, if any. Default is an empty array.
+ * @param customCallbacksUsed Optional. An array containing the custom callbacks that you will be
+ *                            subscribing to after you upgrade your mod. Specifying this will
+ *                            immediately initialize the callbacks (as opposed to lazy-initializing
+ *                            them when you first subscribe to the callback). This is only necessary
+ *                            if you the order of callback firing is important for your mod. (For
+ *                            example, you may want the `POST_NEW_ROOM` part of the
+ *                            `POST_GRID_ENTITY_INIT` callback to fire before your own
+ *                            `POST_NEW_ROOM` callbacks.)
  * @param debug Optional. Whether to log additional output when a callback is fired. Default is
  *              false.
  * @param timeThreshold Optional. If provided, will only log callbacks that take longer than the
@@ -14441,7 +14454,7 @@ export declare type UnionToIntersection<U> = (U extends U ? (u: U) => 0 : never)
  *                      or milliseconds (if the "--luadebug" launch flag is turned off).
  * @returns The upgraded mod object.
  */
-export declare function upgradeMod<T extends readonly ISCFeature[] = never[]>(modVanilla: Mod, features?: ISCFeatureTuple<T>, debug?: boolean, timeThreshold?: float): ModUpgraded<T>;
+export declare function upgradeMod<T extends readonly ISCFeature[] = never[]>(modVanilla: Mod, features?: ISCFeatureTuple<T>, customCallbacksUsed?: ModCallbackCustom[] | readonly ModCallbackCustom[], debug?: boolean, timeThreshold?: float): ModUpgraded<T>;
 
 /** Helper type to match all of the uppercase keys of an object. */
 export declare type UppercaseKeys<T> = StartsWithUppercase<keyof T>;

package/dist/isaacscript-common.lua

@@ -1,6 +1,6 @@
 --[[
 
-isaacscript-common 15.6.2
+isaacscript-common 16.0.0
 
 This is the "isaacscript-common" library, which was created with the IsaacScript tool.
 
@@ -1031,8 +1031,7 @@ do
         if not rawget(metatable, "_descriptors") then
             metatable._descriptors = {}
         end
-        local descriptor = __TS__CloneDescriptor(desc)
-        metatable._descriptors[key] = descriptor
+        metatable._descriptors[key] = __TS__CloneDescriptor(desc)
         metatable.__index = descriptorIndex
         metatable.__newindex = descriptorNewIndex
     end
@@ -1668,22 +1667,6 @@ local function __TS__ParseFloat(numberString)
     return ____number_1
 end
 
-local function __TS__StringSubstr(self, from, length)
-    if from ~= from then
-        from = 0
-    end
-    if length ~= nil then
-        if length ~= length or length <= 0 then
-            return ""
-        end
-        length = length + from
-    end
-    if from >= 0 then
-        from = from + 1
-    end
-    return string.sub(self, from, length)
-end
-
 local function __TS__StringSubstring(self, start, ____end)
     if ____end ~= ____end then
         ____end = 0
@@ -1713,9 +1696,9 @@ do
                 base = 16
                 local ____TS__Match_result__0_0
                 if __TS__Match(hexMatch, "-") then
-                    ____TS__Match_result__0_0 = "-" .. __TS__StringSubstr(numberString, #hexMatch)
+                    ____TS__Match_result__0_0 = "-" .. __TS__StringSubstring(numberString, #hexMatch)
                 else
-                    ____TS__Match_result__0_0 = __TS__StringSubstr(numberString, #hexMatch)
+                    ____TS__Match_result__0_0 = __TS__StringSubstring(numberString, #hexMatch)
                 end
                 numberString = ____TS__Match_result__0_0
             end
@@ -1727,7 +1710,7 @@ do
         if base <= 10 then
             ____temp_1 = __TS__StringSubstring(parseIntBasePattern, 0, base)
         else
-            ____temp_1 = __TS__StringSubstr(parseIntBasePattern, 0, 10 + 2 * (base - 10))
+            ____temp_1 = __TS__StringSubstring(parseIntBasePattern, 0, 10 + 2 * (base - 10))
         end
         local allowedDigits = ____temp_1
         local pattern = ("^%s*(-?[" .. allowedDigits) .. "]*)"
@@ -2437,6 +2420,22 @@ local function __TS__StringStartsWith(self, searchString, position)
     return string.sub(self, position + 1, #searchString + position) == searchString
 end
 
+local function __TS__StringSubstr(self, from, length)
+    if from ~= from then
+        from = 0
+    end
+    if length ~= nil then
+        if length ~= length or length <= 0 then
+            return ""
+        end
+        length = length + from
+    end
+    if from >= 0 then
+        from = from + 1
+    end
+    return string.sub(self, from, length)
+end
+
 local function __TS__StringTrim(self)
     local result = string.gsub(self, "^[%s ]*(.-)[%s ]*$", "%1")
     return result
@@ -31008,6 +31007,8 @@ local ____decorators = require("src.decorators")
 local Exported = ____decorators.Exported
 local ____ISCFeature = require("src.enums.ISCFeature")
 local ISCFeature = ____ISCFeature.ISCFeature
+local ____ModCallbackCustom = require("src.enums.ModCallbackCustom")
+local ModCallbackCustom = ____ModCallbackCustom.ModCallbackCustom
 local ____gridEntities = require("src.functions.gridEntities")
 local removeGridEntity = ____gridEntities.removeGridEntity
 local spawnGridEntityWithVariant = ____gridEntities.spawnGridEntityWithVariant
@@ -31039,32 +31040,6 @@ function CustomGridEntities.prototype.____constructor(self, runInNFrames)
             manuallyUsingShovel = false
         }
     }
-    self.postNewRoom = function()
-        local roomListIndex = getRoomListIndex(nil)
-        local roomCustomGridEntities = self.v.level.customGridEntities:get(roomListIndex)
-        if roomCustomGridEntities == nil then
-            return
-        end
-        local room = game:GetRoom()
-        for ____, ____value in __TS__Iterator(roomCustomGridEntities:entries()) do
-            local gridIndex = ____value[1]
-            local data = ____value[2]
-            do
-                local decoration = room:GetGridEntity(gridIndex)
-                if decoration == nil then
-                    roomCustomGridEntities:delete(gridIndex)
-                    goto __continue6
-                end
-                if data.anm2Path ~= nil then
-                    local sprite = decoration:GetSprite()
-                    sprite:Load(data.anm2Path, true)
-                    local animationToPlay = data.defaultAnimation == nil and sprite:GetDefaultAnimation() or data.defaultAnimation
-                    sprite:Play(animationToPlay, true)
-                end
-            end
-            ::__continue6::
-        end
-    end
     self.preUseItemWeNeedToGoDeeper = function(____, _collectibleType, _rng, player, _useFlags, _activeSlot, _customVarData)
         local room = game:GetRoom()
         local roomListIndex = getRoomListIndex(nil)
@@ -31093,8 +31068,35 @@ function CustomGridEntities.prototype.____constructor(self, runInNFrames)
         end)
         return true
     end
+    self.postNewRoomReordered = function()
+        local roomListIndex = getRoomListIndex(nil)
+        local roomCustomGridEntities = self.v.level.customGridEntities:get(roomListIndex)
+        if roomCustomGridEntities == nil then
+            return
+        end
+        local room = game:GetRoom()
+        for ____, ____value in __TS__Iterator(roomCustomGridEntities:entries()) do
+            local gridIndex = ____value[1]
+            local data = ____value[2]
+            do
+                local decoration = room:GetGridEntity(gridIndex)
+                if decoration == nil then
+                    roomCustomGridEntities:delete(gridIndex)
+                    goto __continue12
+                end
+                if data.anm2Path ~= nil then
+                    local sprite = decoration:GetSprite()
+                    sprite:Load(data.anm2Path, true)
+                    local animationToPlay = data.defaultAnimation == nil and sprite:GetDefaultAnimation() or data.defaultAnimation
+                    sprite:Play(animationToPlay, true)
+                end
+            end
+            ::__continue12::
+        end
+    end
     self.featuresUsed = {ISCFeature.RUN_IN_N_FRAMES}
-    self.callbacksUsed = {{ModCallback.POST_NEW_ROOM, {self.postNewRoom}}, {ModCallback.PRE_USE_ITEM, {self.preUseItemWeNeedToGoDeeper, CollectibleType.WE_NEED_TO_GO_DEEPER}}}
+    self.callbacksUsed = {{ModCallback.PRE_USE_ITEM, {self.preUseItemWeNeedToGoDeeper, CollectibleType.WE_NEED_TO_GO_DEEPER}}}
+    self.customCallbacksUsed = {{ModCallbackCustom.POST_NEW_ROOM_REORDERED, {self.postNewRoomReordered}}}
     self.runInNFrames = runInNFrames
 end
 function CustomGridEntities.prototype.spawnCustomGridEntity(self, gridEntityTypeCustom, gridIndexOrPosition, gridCollisionClass, anm2Path, defaultAnimation, baseGridEntityType, baseGridEntityVariant)
@@ -31270,7 +31272,7 @@ function CustomRevive.prototype.____constructor(self, preCustomRevive, postCusto
     self.postPEffectUpdate = function(____, player)
         self:checkWaitingForItemAnimation(player)
     end
-    self.postNewRoom = function()
+    self.postNewRoomReordered = function()
         if self.v.run.state ~= CustomReviveState.WAITING_FOR_ROOM_TRANSITION then
             return
         end
@@ -31285,8 +31287,8 @@ function CustomRevive.prototype.____constructor(self, preCustomRevive, postCusto
         self:playerIsAboutToDie(player)
     end
     self.featuresUsed = {ISCFeature.RUN_IN_N_FRAMES}
-    self.callbacksUsed = {{ModCallback.POST_RENDER, {self.postRender}}, {ModCallback.POST_PEFFECT_UPDATE, {self.postPEffectUpdate}}, {ModCallback.POST_NEW_ROOM, {self.postNewRoom}}}
-    self.customCallbacksUsed = {{ModCallbackCustom.POST_PLAYER_FATAL_DAMAGE, {self.postPlayerFatalDamage}}, {ModCallbackCustom.PRE_BERSERK_DEATH, {self.preBerserkDeath}}}
+    self.callbacksUsed = {{ModCallback.POST_RENDER, {self.postRender}}, {ModCallback.POST_PEFFECT_UPDATE, {self.postPEffectUpdate}}}
+    self.customCallbacksUsed = {{ModCallbackCustom.POST_NEW_ROOM_REORDERED, {self.postNewRoomReordered}}, {ModCallbackCustom.POST_PLAYER_FATAL_DAMAGE, {self.postPlayerFatalDamage}}, {ModCallbackCustom.PRE_BERSERK_DEATH, {self.preBerserkDeath}}}
     self.preCustomRevive = preCustomRevive
     self.postCustomRevive = postCustomRevive
     self.runInNFrames = runInNFrames
@@ -31682,6 +31684,8 @@ local ____isaac_2Dtypescript_2Ddefinitions = require("lua_modules.isaac-typescri
 local ModCallback = ____isaac_2Dtypescript_2Ddefinitions.ModCallback
 local ____ISCFeature = require("src.enums.ISCFeature")
 local ISCFeature = ____ISCFeature.ISCFeature
+local ____ModCallbackCustom = require("src.enums.ModCallbackCustom")
+local ModCallbackCustom = ____ModCallbackCustom.ModCallbackCustom
 local ____gridEntities = require("src.functions.gridEntities")
 local getGridEntitiesMap = ____gridEntities.getGridEntitiesMap
 local isGridEntityBroken = ____gridEntities.isGridEntityBroken
@@ -31710,7 +31714,7 @@ function GridEntityUpdateDetection.prototype.____constructor(self, postGridEntit
             end
         end
     end
-    self.postNewRoom = function()
+    self.postNewRoomReordered = function()
         local gridEntitiesMap = getGridEntitiesMap(nil)
         for ____, ____value in __TS__Iterator(gridEntitiesMap:entries()) do
             local gridIndex = ____value[1]
@@ -31719,7 +31723,8 @@ function GridEntityUpdateDetection.prototype.____constructor(self, postGridEntit
         end
     end
     self.featuresUsed = {ISCFeature.RUN_IN_N_FRAMES}
-    self.callbacksUsed = {{ModCallback.POST_UPDATE, {self.postUpdate}}, {ModCallback.POST_NEW_ROOM, {self.postNewRoom}}}
+    self.callbacksUsed = {{ModCallback.POST_UPDATE, {self.postUpdate}}}
+    self.customCallbacksUsed = {{ModCallbackCustom.POST_NEW_ROOM_REORDERED, {self.postNewRoomReordered}}}
     self.postGridEntityInit = postGridEntityInit
     self.postGridEntityCustomInit = postGridEntityCustomInit
     self.postGridEntityUpdate = postGridEntityUpdate
@@ -48942,6 +48947,10 @@ function ModUpgradedBase.prototype.initOptionalFeature(self, feature)
     self:initFeature(featureClass)
     return getExportedMethodsFromFeature(nil, featureClass)
 end
+function ModUpgradedBase.prototype.initCustomCallbackEarly(self, modCallbackCustom)
+    local callbackClass = self.callbacks[modCallbackCustom]
+    self:initFeature(callbackClass)
+end
 return ____exports
  end,
 ["src.classes.ModFeature"] = function(...) 
@@ -49232,7 +49241,7 @@ return ____exports
 local ____lualib = require("lualib_bundle")
 local __TS__New = ____lualib.__TS__New
 local ____exports = {}
-local initOptionalFeatures
+local initOptionalFeatures, initCallbacksEarly
 local ____ModUpgradedBase = require("src.classes.ModUpgradedBase")
 local ModUpgradedBase = ____ModUpgradedBase.ModUpgradedBase
 local ____patchErrorFunctions = require("src.patchErrorFunctions")
@@ -49250,10 +49259,18 @@ function initOptionalFeatures(self, mod, features)
         end
     end
 end
-function ____exports.upgradeMod(self, modVanilla, features, ____debug, timeThreshold)
+function initCallbacksEarly(self, mod, callbacks)
+    for ____, modCallbackCustom in ipairs(callbacks) do
+        mod.initCustomCallbackEarly(mod, modCallbackCustom)
+    end
+end
+function ____exports.upgradeMod(self, modVanilla, features, customCallbacksUsed, ____debug, timeThreshold)
     if features == nil then
         features = {}
     end
+    if customCallbacksUsed == nil then
+        customCallbacksUsed = {}
+    end
     if ____debug == nil then
         ____debug = false
     end
@@ -49261,6 +49278,7 @@ function ____exports.upgradeMod(self, modVanilla, features, ____debug, timeThres
     local mod = __TS__New(ModUpgradedBase, modVanilla, ____debug, timeThreshold)
     applyShaderCrashFix(nil, mod)
     initOptionalFeatures(nil, mod, features)
+    initCallbacksEarly(nil, mod, customCallbacksUsed)
     return mod
 end
 return ____exports

package/dist/lualib_bundle.lua

@@ -972,8 +972,7 @@ do
         if not rawget(metatable, "_descriptors") then
             metatable._descriptors = {}
         end
-        local descriptor = __TS__CloneDescriptor(desc)
-        metatable._descriptors[key] = descriptor
+        metatable._descriptors[key] = __TS__CloneDescriptor(desc)
         metatable.__index = descriptorIndex
         metatable.__newindex = descriptorNewIndex
     end
@@ -1609,22 +1608,6 @@ local function __TS__ParseFloat(numberString)
     return ____number_1
 end
 
-local function __TS__StringSubstr(self, from, length)
-    if from ~= from then
-        from = 0
-    end
-    if length ~= nil then
-        if length ~= length or length <= 0 then
-            return ""
-        end
-        length = length + from
-    end
-    if from >= 0 then
-        from = from + 1
-    end
-    return string.sub(self, from, length)
-end
-
 local function __TS__StringSubstring(self, start, ____end)
     if ____end ~= ____end then
         ____end = 0
@@ -1654,9 +1637,9 @@ do
                 base = 16
                 local ____TS__Match_result__0_0
                 if __TS__Match(hexMatch, "-") then
-                    ____TS__Match_result__0_0 = "-" .. __TS__StringSubstr(numberString, #hexMatch)
+                    ____TS__Match_result__0_0 = "-" .. __TS__StringSubstring(numberString, #hexMatch)
                 else
-                    ____TS__Match_result__0_0 = __TS__StringSubstr(numberString, #hexMatch)
+                    ____TS__Match_result__0_0 = __TS__StringSubstring(numberString, #hexMatch)
                 end
                 numberString = ____TS__Match_result__0_0
             end
@@ -1668,7 +1651,7 @@ do
         if base <= 10 then
             ____temp_1 = __TS__StringSubstring(parseIntBasePattern, 0, base)
         else
-            ____temp_1 = __TS__StringSubstr(parseIntBasePattern, 0, 10 + 2 * (base - 10))
+            ____temp_1 = __TS__StringSubstring(parseIntBasePattern, 0, 10 + 2 * (base - 10))
         end
         local allowedDigits = ____temp_1
         local pattern = ("^%s*(-?[" .. allowedDigits) .. "]*)"
@@ -2378,6 +2361,22 @@ local function __TS__StringStartsWith(self, searchString, position)
     return string.sub(self, position + 1, #searchString + position) == searchString
 end
 
+local function __TS__StringSubstr(self, from, length)
+    if from ~= from then
+        from = 0
+    end
+    if length ~= nil then
+        if length ~= length or length <= 0 then
+            return ""
+        end
+        length = length + from
+    end
+    if from >= 0 then
+        from = from + 1
+    end
+    return string.sub(self, from, length)
+end
+
 local function __TS__StringTrim(self)
     local result = string.gsub(self, "^[%s ]*(.-)[%s ]*$", "%1")
     return result

package/dist/src/classes/ModUpgradedBase.d.ts

@@ -82,5 +82,10 @@ export declare class ModUpgradedBase implements Mod {
      * don't have access to it..
      */
     private initOptionalFeature;
+    /**
+     * This is mostly the same as the `AddCustomCallback` method, but we initialize the custom
+     * callback without actually registering a subscription.
+     */
+    private initCustomCallbackEarly;
 }
 //# sourceMappingURL=ModUpgradedBase.d.ts.map

package/dist/src/classes/ModUpgradedBase.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ModUpgradedBase.d.ts","sourceRoot":"","sources":["../../../src/classes/ModUpgradedBase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAI3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAQ/D,OAAO,EAAE,2BAA2B,EAAE,MAAM,mDAAmD,CAAC;AAMhG;;;;;;;;;GASG;AACH,qBAAa,eAAgB,YAAW,GAAG;IAKlC,IAAI,EAAE,MAAM,CAAC;IAMpB,4FAA4F;IAC5F,OAAO,CAAC,GAAG,CAAM;IAEjB,OAAO,CAAC,KAAK,CAAU;IACvB,OAAO,CAAC,aAAa,CAAoB;IAEzC,OAAO,CAAC,SAAS,CAAC;IAGlB,OAAO,CAAC,QAAQ,CAAC;gBAML,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,CAAC,EAAE,KAAK;IAgB3D;;;;OAIG;IACI,WAAW,CAAC,CAAC,SAAS,WAAW,EACtC,WAAW,EAAE,CAAC,EACd,GAAG,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAChC,IAAI;IAkDP,0FAA0F;IACnF,OAAO,IAAI,OAAO;IAIzB;;;OAGG;IACI,QAAQ,IAAI,MAAM;IAIzB;;;;;OAKG;IACI,cAAc,CAAC,CAAC,SAAS,WAAW,EACzC,WAAW,EAAE,CAAC,EACd,QAAQ,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACpC,IAAI;IAIP,6EAA6E;IACtE,UAAU,IAAI,IAAI;IAIzB;;OAEG;IACI,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQnC;;;;OAIG;IACI,iBAAiB,CAAC,CAAC,SAAS,iBAAiB,EAClD,iBAAiB,EAAE,CAAC,EACpB,GAAG,IAAI,EAAE,2BAA2B,CAAC,CAAC,CAAC,GACtC,IAAI;IAOP;;;;;OAKG;IACI,oBAAoB,CAAC,CAAC,SAAS,iBAAiB,EACrD,iBAAiB,EAAE,CAAC,EACpB,QAAQ,EAAE,2BAA2B,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAC1C,IAAI;IAOP;;;OAGG;IACI,eAAe,IAAI,IAAI;IA0C9B;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAqDnB;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAwDrB;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;CAM5B"}
+{"version":3,"file":"ModUpgradedBase.d.ts","sourceRoot":"","sources":["../../../src/classes/ModUpgradedBase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAI3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAQ/D,OAAO,EAAE,2BAA2B,EAAE,MAAM,mDAAmD,CAAC;AAMhG;;;;;;;;;GASG;AACH,qBAAa,eAAgB,YAAW,GAAG;IAKlC,IAAI,EAAE,MAAM,CAAC;IAMpB,4FAA4F;IAC5F,OAAO,CAAC,GAAG,CAAM;IAEjB,OAAO,CAAC,KAAK,CAAU;IACvB,OAAO,CAAC,aAAa,CAAoB;IAEzC,OAAO,CAAC,SAAS,CAAC;IAGlB,OAAO,CAAC,QAAQ,CAAC;gBAML,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,CAAC,EAAE,KAAK;IAgB3D;;;;OAIG;IACI,WAAW,CAAC,CAAC,SAAS,WAAW,EACtC,WAAW,EAAE,CAAC,EACd,GAAG,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAChC,IAAI;IAkDP,0FAA0F;IACnF,OAAO,IAAI,OAAO;IAIzB;;;OAGG;IACI,QAAQ,IAAI,MAAM;IAIzB;;;;;OAKG;IACI,cAAc,CAAC,CAAC,SAAS,WAAW,EACzC,WAAW,EAAE,CAAC,EACd,QAAQ,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACpC,IAAI;IAIP,6EAA6E;IACtE,UAAU,IAAI,IAAI;IAIzB;;OAEG;IACI,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQnC;;;;OAIG;IACI,iBAAiB,CAAC,CAAC,SAAS,iBAAiB,EAClD,iBAAiB,EAAE,CAAC,EACpB,GAAG,IAAI,EAAE,2BAA2B,CAAC,CAAC,CAAC,GACtC,IAAI;IAOP;;;;;OAKG;IACI,oBAAoB,CAAC,CAAC,SAAS,iBAAiB,EACrD,iBAAiB,EAAE,CAAC,EACpB,QAAQ,EAAE,2BAA2B,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAC1C,IAAI;IAOP;;;OAGG;IACI,eAAe,IAAI,IAAI;IA0C9B;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAqDnB;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAwDrB;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAO3B;;;OAGG;IACH,OAAO,CAAC,uBAAuB;CAIhC"}

package/dist/src/classes/ModUpgradedBase.lua

@@ -259,4 +259,8 @@ function ModUpgradedBase.prototype.initOptionalFeature(self, feature)
     self:initFeature(featureClass)
     return getExportedMethodsFromFeature(nil, featureClass)
 end
+function ModUpgradedBase.prototype.initCustomCallbackEarly(self, modCallbackCustom)
+    local callbackClass = self.callbacks[modCallbackCustom]
+    self:initFeature(callbackClass)
+end
 return ____exports

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

@@ -3,8 +3,8 @@ import { GridEntityCustomData } from "../../../interfaces/GridEntityCustomData";
 import { Feature } from "../../private/Feature";
 export declare class CustomGridEntities extends Feature {
     private runInNFrames;
-    private postNewRoom;
     private preUseItemWeNeedToGoDeeper;
+    private postNewRoomReordered;
     /**
      * Helper function to spawn a custom grid entity. Custom grid entities are persistent in that they
      * will reappear if the player leaves and re-enters the room. (It will be manually respawned in

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

@@ -1 +1 @@
-{"version":3,"file":"CustomGridEntities.d.ts","sourceRoot":"","sources":["../../../../../src/classes/features/callbackLogic/CustomGridEntities.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,kBAAkB,EAClB,cAAc,EAGf,MAAM,8BAA8B,CAAC;AAYtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AAEhF,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAGhD,qBAAa,kBAAmB,SAAQ,OAAO;IAgB7C,OAAO,CAAC,YAAY,CAAe;IAoBnC,OAAO,CAAC,WAAW,CA4BjB;IAIF,OAAO,CAAC,0BAA0B,CA+ChC;IAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+EG;IAEI,qBAAqB,CAC1B,oBAAoB,EAAE,cAAc,EACpC,mBAAmB,EAAE,GAAG,GAAG,MAAM,EACjC,kBAAkB,CAAC,EAAE,kBAAkB,EACvC,QAAQ,CAAC,EAAE,MAAM,EACjB,gBAAgB,CAAC,EAAE,MAAM,EACzB,kBAAkB,iBAA4B,EAC9C,qBAAqB,SAAI,GACxB,UAAU;IA8Cb;;;;;;;;;;;;;;;;;OAiBG;IAEI,sBAAsB,CAC3B,+BAA+B,EAAE,GAAG,GAAG,MAAM,GAAG,UAAU,EAC1D,UAAU,UAAO,GAChB,UAAU,GAAG,SAAS;IAuCzB;;;;;;OAMG;IAEI,qBAAqB,IAAI,KAAK,CACnC;QAAC,UAAU,EAAE,UAAU;QAAE,IAAI,EAAE,oBAAoB;KAAC,CACrD;IAoBD;;;;;;;OAOG;IAEI,uBAAuB,CAC5B,qBAAqB,EAAE,UAAU,GAAG,GAAG,GACtC,cAAc,GAAG,SAAS;IAyB7B;;;;;;OAMG;IAEI,kBAAkB,CAAC,qBAAqB,EAAE,UAAU,GAAG,GAAG,GAAG,OAAO;CAM5E"}
+{"version":3,"file":"CustomGridEntities.d.ts","sourceRoot":"","sources":["../../../../../src/classes/features/callbackLogic/CustomGridEntities.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,kBAAkB,EAClB,cAAc,EAGf,MAAM,8BAA8B,CAAC;AAatC,OAAO,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AAEhF,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAGhD,qBAAa,kBAAmB,SAAQ,OAAO;IAgB7C,OAAO,CAAC,YAAY,CAAe;IAwBnC,OAAO,CAAC,0BAA0B,CA+ChC;IAGF,OAAO,CAAC,oBAAoB,CA4B1B;IAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+EG;IAEI,qBAAqB,CAC1B,oBAAoB,EAAE,cAAc,EACpC,mBAAmB,EAAE,GAAG,GAAG,MAAM,EACjC,kBAAkB,CAAC,EAAE,kBAAkB,EACvC,QAAQ,CAAC,EAAE,MAAM,EACjB,gBAAgB,CAAC,EAAE,MAAM,EACzB,kBAAkB,iBAA4B,EAC9C,qBAAqB,SAAI,GACxB,UAAU;IA8Cb;;;;;;;;;;;;;;;;;OAiBG;IAEI,sBAAsB,CAC3B,+BAA+B,EAAE,GAAG,GAAG,MAAM,GAAG,UAAU,EAC1D,UAAU,UAAO,GAChB,UAAU,GAAG,SAAS;IAuCzB;;;;;;OAMG;IAEI,qBAAqB,IAAI,KAAK,CACnC;QAAC,UAAU,EAAE,UAAU;QAAE,IAAI,EAAE,oBAAoB;KAAC,CACrD;IAoBD;;;;;;;OAOG;IAEI,uBAAuB,CAC5B,qBAAqB,EAAE,UAAU,GAAG,GAAG,GACtC,cAAc,GAAG,SAAS;IAyB7B;;;;;;OAMG;IAEI,kBAAkB,CAAC,qBAAqB,EAAE,UAAU,GAAG,GAAG,GAAG,OAAO;CAM5E"}

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

@@ -18,6 +18,8 @@ local ____decorators = require("src.decorators")
 local Exported = ____decorators.Exported
 local ____ISCFeature = require("src.enums.ISCFeature")
 local ISCFeature = ____ISCFeature.ISCFeature
+local ____ModCallbackCustom = require("src.enums.ModCallbackCustom")
+local ModCallbackCustom = ____ModCallbackCustom.ModCallbackCustom
 local ____gridEntities = require("src.functions.gridEntities")
 local removeGridEntity = ____gridEntities.removeGridEntity
 local spawnGridEntityWithVariant = ____gridEntities.spawnGridEntityWithVariant
@@ -49,32 +51,6 @@ function CustomGridEntities.prototype.____constructor(self, runInNFrames)
             manuallyUsingShovel = false
         }
     }
-    self.postNewRoom = function()
-        local roomListIndex = getRoomListIndex(nil)
-        local roomCustomGridEntities = self.v.level.customGridEntities:get(roomListIndex)
-        if roomCustomGridEntities == nil then
-            return
-        end
-        local room = game:GetRoom()
-        for ____, ____value in __TS__Iterator(roomCustomGridEntities:entries()) do
-            local gridIndex = ____value[1]
-            local data = ____value[2]
-            do
-                local decoration = room:GetGridEntity(gridIndex)
-                if decoration == nil then
-                    roomCustomGridEntities:delete(gridIndex)
-                    goto __continue6
-                end
-                if data.anm2Path ~= nil then
-                    local sprite = decoration:GetSprite()
-                    sprite:Load(data.anm2Path, true)
-                    local animationToPlay = data.defaultAnimation == nil and sprite:GetDefaultAnimation() or data.defaultAnimation
-                    sprite:Play(animationToPlay, true)
-                end
-            end
-            ::__continue6::
-        end
-    end
     self.preUseItemWeNeedToGoDeeper = function(____, _collectibleType, _rng, player, _useFlags, _activeSlot, _customVarData)
         local room = game:GetRoom()
         local roomListIndex = getRoomListIndex(nil)
@@ -103,8 +79,35 @@ function CustomGridEntities.prototype.____constructor(self, runInNFrames)
         end)
         return true
     end
+    self.postNewRoomReordered = function()
+        local roomListIndex = getRoomListIndex(nil)
+        local roomCustomGridEntities = self.v.level.customGridEntities:get(roomListIndex)
+        if roomCustomGridEntities == nil then
+            return
+        end
+        local room = game:GetRoom()
+        for ____, ____value in __TS__Iterator(roomCustomGridEntities:entries()) do
+            local gridIndex = ____value[1]
+            local data = ____value[2]
+            do
+                local decoration = room:GetGridEntity(gridIndex)
+                if decoration == nil then
+                    roomCustomGridEntities:delete(gridIndex)
+                    goto __continue12
+                end
+                if data.anm2Path ~= nil then
+                    local sprite = decoration:GetSprite()
+                    sprite:Load(data.anm2Path, true)
+                    local animationToPlay = data.defaultAnimation == nil and sprite:GetDefaultAnimation() or data.defaultAnimation
+                    sprite:Play(animationToPlay, true)
+                end
+            end
+            ::__continue12::
+        end
+    end
     self.featuresUsed = {ISCFeature.RUN_IN_N_FRAMES}
-    self.callbacksUsed = {{ModCallback.POST_NEW_ROOM, {self.postNewRoom}}, {ModCallback.PRE_USE_ITEM, {self.preUseItemWeNeedToGoDeeper, CollectibleType.WE_NEED_TO_GO_DEEPER}}}
+    self.callbacksUsed = {{ModCallback.PRE_USE_ITEM, {self.preUseItemWeNeedToGoDeeper, CollectibleType.WE_NEED_TO_GO_DEEPER}}}
+    self.customCallbacksUsed = {{ModCallbackCustom.POST_NEW_ROOM_REORDERED, {self.postNewRoomReordered}}}
     self.runInNFrames = runInNFrames
 end
 function CustomGridEntities.prototype.spawnCustomGridEntity(self, gridEntityTypeCustom, gridIndexOrPosition, gridCollisionClass, anm2Path, defaultAnimation, baseGridEntityType, baseGridEntityVariant)

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

@@ -27,7 +27,7 @@ export declare class CustomRevive extends Feature {
     private postRender;
     private postPEffectUpdate;
     private checkWaitingForItemAnimation;
-    private postNewRoom;
+    private postNewRoomReordered;
     private postPlayerFatalDamage;
     private preBerserkDeath;
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"CustomRevive.d.ts","sourceRoot":"","sources":["../../../../../src/classes/features/callbackLogic/CustomRevive.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAIrD,aAAK,iBAAiB;IACpB,QAAQ,IAAA;IAER;;;OAGG;IACH,2BAA2B,IAAA;IAE3B,0BAA0B,IAAA;CAC3B;AAED,qBAAa,YAAa,SAAQ,OAAO;IACvB,CAAC;;;;;;MAMf;IAEF,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,YAAY,CAAe;gBAGjC,eAAe,EAAE,eAAe,EAChC,gBAAgB,EAAE,gBAAgB,EAClC,YAAY,EAAE,YAAY;IA0B5B,OAAO,CAAC,UAAU,CAQhB;IAGF,OAAO,CAAC,iBAAiB,CAEvB;IAEF,OAAO,CAAC,4BAA4B;IA6CpC,OAAO,CAAC,WAAW,CAOjB;IAGF,OAAO,CAAC,qBAAqB,CAK3B;IAGF,OAAO,CAAC,eAAe,CAErB;IAEF;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAoC1B,OAAO,CAAC,eAAe;CASxB"}
+{"version":3,"file":"CustomRevive.d.ts","sourceRoot":"","sources":["../../../../../src/classes/features/callbackLogic/CustomRevive.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAIrD,aAAK,iBAAiB;IACpB,QAAQ,IAAA;IAER;;;OAGG;IACH,2BAA2B,IAAA;IAE3B,0BAA0B,IAAA;CAC3B;AAED,qBAAa,YAAa,SAAQ,OAAO;IACvB,CAAC;;;;;;MAMf;IAEF,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,YAAY,CAAe;gBAGjC,eAAe,EAAE,eAAe,EAChC,gBAAgB,EAAE,gBAAgB,EAClC,YAAY,EAAE,YAAY;IA0B5B,OAAO,CAAC,UAAU,CAQhB;IAGF,OAAO,CAAC,iBAAiB,CAEvB;IAEF,OAAO,CAAC,4BAA4B;IA6CpC,OAAO,CAAC,oBAAoB,CAO1B;IAGF,OAAO,CAAC,qBAAqB,CAK3B;IAGF,OAAO,CAAC,eAAe,CAErB;IAEF;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAoC1B,OAAO,CAAC,eAAe;CASxB"}

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

@@ -53,7 +53,7 @@ function CustomRevive.prototype.____constructor(self, preCustomRevive, postCusto
     self.postPEffectUpdate = function(____, player)
         self:checkWaitingForItemAnimation(player)
     end
-    self.postNewRoom = function()
+    self.postNewRoomReordered = function()
         if self.v.run.state ~= CustomReviveState.WAITING_FOR_ROOM_TRANSITION then
             return
         end
@@ -68,8 +68,8 @@ function CustomRevive.prototype.____constructor(self, preCustomRevive, postCusto
         self:playerIsAboutToDie(player)
     end
     self.featuresUsed = {ISCFeature.RUN_IN_N_FRAMES}
-    self.callbacksUsed = {{ModCallback.POST_RENDER, {self.postRender}}, {ModCallback.POST_PEFFECT_UPDATE, {self.postPEffectUpdate}}, {ModCallback.POST_NEW_ROOM, {self.postNewRoom}}}
-    self.customCallbacksUsed = {{ModCallbackCustom.POST_PLAYER_FATAL_DAMAGE, {self.postPlayerFatalDamage}}, {ModCallbackCustom.PRE_BERSERK_DEATH, {self.preBerserkDeath}}}
+    self.callbacksUsed = {{ModCallback.POST_RENDER, {self.postRender}}, {ModCallback.POST_PEFFECT_UPDATE, {self.postPEffectUpdate}}}
+    self.customCallbacksUsed = {{ModCallbackCustom.POST_NEW_ROOM_REORDERED, {self.postNewRoomReordered}}, {ModCallbackCustom.POST_PLAYER_FATAL_DAMAGE, {self.postPlayerFatalDamage}}, {ModCallbackCustom.PRE_BERSERK_DEATH, {self.preBerserkDeath}}}
     self.preCustomRevive = preCustomRevive
     self.postCustomRevive = postCustomRevive
     self.runInNFrames = runInNFrames

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

@@ -40,7 +40,7 @@ export declare class GridEntityUpdateDetection extends Feature {
     private checkGridEntityStateChanged;
     private checkNewGridEntity;
     private updateTupleInMap;
-    private postNewRoom;
+    private postNewRoomReordered;
 }
 export {};
 //# sourceMappingURL=GridEntityUpdateDetection.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"GridEntityUpdateDetection.d.ts","sourceRoot":"","sources":["../../../../../src/classes/features/callbackLogic/GridEntityUpdateDetection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAe,MAAM,8BAA8B,CAAC;AAM3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AACxF,OAAO,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AACpF,OAAO,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AACxF,OAAO,EAAE,gCAAgC,EAAE,MAAM,kDAAkD,CAAC;AACpG,OAAO,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AACxF,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AACxF,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,KAAK,eAAe,GAAG;IACrB,cAAc,EAAE,cAAc;IAC9B,OAAO,EAAE,GAAG;IACZ,KAAK,EAAE,GAAG;CACX,CAAC;AAEF,qBAAa,yBAA0B,SAAQ,OAAO;IACpC,CAAC;;YAEb,6BAA6B;;;MAG/B;IAEF,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,wBAAwB,CAA2B;IAC3D,OAAO,CAAC,oBAAoB,CAAuB;IACnD,OAAO,CAAC,0BAA0B,CAA6B;IAC/D,OAAO,CAAC,oBAAoB,CAAuB;IACnD,OAAO,CAAC,0BAA0B,CAA6B;IAC/D,OAAO,CAAC,0BAA0B,CAA6B;IAC/D,OAAO,CAAC,gCAAgC,CAAmC;IAC3E,OAAO,CAAC,oBAAoB,CAAuB;IACnD,OAAO,CAAC,0BAA0B,CAA6B;IAC/D,OAAO,CAAC,kBAAkB,CAAqB;gBAG7C,kBAAkB,EAAE,kBAAkB,EACtC,wBAAwB,EAAE,wBAAwB,EAClD,oBAAoB,EAAE,oBAAoB,EAC1C,0BAA0B,EAAE,0BAA0B,EACtD,oBAAoB,EAAE,oBAAoB,EAC1C,0BAA0B,EAAE,0BAA0B,EACtD,0BAA0B,EAAE,0BAA0B,EACtD,gCAAgC,EAAE,gCAAgC,EAClE,oBAAoB,EAAE,oBAAoB,EAC1C,0BAA0B,EAAE,0BAA0B,EACtD,kBAAkB,EAAE,kBAAkB;IAyBxC,OAAO,CAAC,UAAU,CAmBhB;IAEF,OAAO,CAAC,wBAAwB;IA8BhC,OAAO,CAAC,2BAA2B;IA0CnC,OAAO,CAAC,kBAAkB;IAoB1B,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,WAAW,CAMjB;CACH"}
+{"version":3,"file":"GridEntityUpdateDetection.d.ts","sourceRoot":"","sources":["../../../../../src/classes/features/callbackLogic/GridEntityUpdateDetection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAe,MAAM,8BAA8B,CAAC;AAO3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AACxF,OAAO,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AACpF,OAAO,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AACxF,OAAO,EAAE,gCAAgC,EAAE,MAAM,kDAAkD,CAAC;AACpG,OAAO,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AACxF,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AACxF,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,KAAK,eAAe,GAAG;IACrB,cAAc,EAAE,cAAc;IAC9B,OAAO,EAAE,GAAG;IACZ,KAAK,EAAE,GAAG;CACX,CAAC;AAEF,qBAAa,yBAA0B,SAAQ,OAAO;IACpC,CAAC;;YAEb,6BAA6B;;;MAG/B;IAEF,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,wBAAwB,CAA2B;IAC3D,OAAO,CAAC,oBAAoB,CAAuB;IACnD,OAAO,CAAC,0BAA0B,CAA6B;IAC/D,OAAO,CAAC,oBAAoB,CAAuB;IACnD,OAAO,CAAC,0BAA0B,CAA6B;IAC/D,OAAO,CAAC,0BAA0B,CAA6B;IAC/D,OAAO,CAAC,gCAAgC,CAAmC;IAC3E,OAAO,CAAC,oBAAoB,CAAuB;IACnD,OAAO,CAAC,0BAA0B,CAA6B;IAC/D,OAAO,CAAC,kBAAkB,CAAqB;gBAG7C,kBAAkB,EAAE,kBAAkB,EACtC,wBAAwB,EAAE,wBAAwB,EAClD,oBAAoB,EAAE,oBAAoB,EAC1C,0BAA0B,EAAE,0BAA0B,EACtD,oBAAoB,EAAE,oBAAoB,EAC1C,0BAA0B,EAAE,0BAA0B,EACtD,0BAA0B,EAAE,0BAA0B,EACtD,gCAAgC,EAAE,gCAAgC,EAClE,oBAAoB,EAAE,oBAAoB,EAC1C,0BAA0B,EAAE,0BAA0B,EACtD,kBAAkB,EAAE,kBAAkB;IA4BxC,OAAO,CAAC,UAAU,CAmBhB;IAEF,OAAO,CAAC,wBAAwB;IA8BhC,OAAO,CAAC,2BAA2B;IA0CnC,OAAO,CAAC,kBAAkB;IAoB1B,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,oBAAoB,CAM1B;CACH"}

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

@@ -9,6 +9,8 @@ local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitio
 local ModCallback = ____isaac_2Dtypescript_2Ddefinitions.ModCallback
 local ____ISCFeature = require("src.enums.ISCFeature")
 local ISCFeature = ____ISCFeature.ISCFeature
+local ____ModCallbackCustom = require("src.enums.ModCallbackCustom")
+local ModCallbackCustom = ____ModCallbackCustom.ModCallbackCustom
 local ____gridEntities = require("src.functions.gridEntities")
 local getGridEntitiesMap = ____gridEntities.getGridEntitiesMap
 local isGridEntityBroken = ____gridEntities.isGridEntityBroken
@@ -37,7 +39,7 @@ function GridEntityUpdateDetection.prototype.____constructor(self, postGridEntit
             end
         end
     end
-    self.postNewRoom = function()
+    self.postNewRoomReordered = function()
         local gridEntitiesMap = getGridEntitiesMap(nil)
         for ____, ____value in __TS__Iterator(gridEntitiesMap:entries()) do
             local gridIndex = ____value[1]
@@ -46,7 +48,8 @@ function GridEntityUpdateDetection.prototype.____constructor(self, postGridEntit
         end
     end
     self.featuresUsed = {ISCFeature.RUN_IN_N_FRAMES}
-    self.callbacksUsed = {{ModCallback.POST_UPDATE, {self.postUpdate}}, {ModCallback.POST_NEW_ROOM, {self.postNewRoom}}}
+    self.callbacksUsed = {{ModCallback.POST_UPDATE, {self.postUpdate}}}
+    self.customCallbacksUsed = {{ModCallbackCustom.POST_NEW_ROOM_REORDERED, {self.postNewRoomReordered}}}
     self.postGridEntityInit = postGridEntityInit
     self.postGridEntityCustomInit = postGridEntityCustomInit
     self.postGridEntityUpdate = postGridEntityUpdate

package/dist/src/core/upgradeMod.d.ts

@@ -1,6 +1,7 @@
 /// <reference types="isaac-typescript-definitions" />
 /// <reference types="isaac-typescript-definitions" />
 import { ISCFeature } from "../enums/ISCFeature";
+import { ModCallbackCustom } from "../enums/ModCallbackCustom";
 import { ModUpgraded } from "../types/ModUpgraded";
 type ISCFeatureTuple<T extends readonly ISCFeature[]> = ISCFeature extends T["length"] ? 'The list of features must be a tuple. Use the "as const" assertion when declaring the array.' : T;
 /**
@@ -23,6 +24,14 @@ type ISCFeatureTuple<T extends readonly ISCFeature[]> = ISCFeature extends T["le
  * @param modVanilla The mod object returned by the `RegisterMod` function.
  * @param features Optional. An array containing the optional standard library features that you
  *                 want to enable, if any. Default is an empty array.
+ * @param customCallbacksUsed Optional. An array containing the custom callbacks that you will be
+ *                            subscribing to after you upgrade your mod. Specifying this will
+ *                            immediately initialize the callbacks (as opposed to lazy-initializing
+ *                            them when you first subscribe to the callback). This is only necessary
+ *                            if you the order of callback firing is important for your mod. (For
+ *                            example, you may want the `POST_NEW_ROOM` part of the
+ *                            `POST_GRID_ENTITY_INIT` callback to fire before your own
+ *                            `POST_NEW_ROOM` callbacks.)
  * @param debug Optional. Whether to log additional output when a callback is fired. Default is
  *              false.
  * @param timeThreshold Optional. If provided, will only log callbacks that take longer than the
@@ -30,6 +39,6 @@ type ISCFeatureTuple<T extends readonly ISCFeature[]> = ISCFeature extends T["le
  *                      or milliseconds (if the "--luadebug" launch flag is turned off).
  * @returns The upgraded mod object.
  */
-export declare function upgradeMod<T extends readonly ISCFeature[] = never[]>(modVanilla: Mod, features?: ISCFeatureTuple<T>, debug?: boolean, timeThreshold?: float): ModUpgraded<T>;
+export declare function upgradeMod<T extends readonly ISCFeature[] = never[]>(modVanilla: Mod, features?: ISCFeatureTuple<T>, customCallbacksUsed?: ModCallbackCustom[] | readonly ModCallbackCustom[], debug?: boolean, timeThreshold?: float): ModUpgraded<T>;
 export {};
 //# sourceMappingURL=upgradeMod.d.ts.map

package/dist/src/core/upgradeMod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"upgradeMod.d.ts","sourceRoot":"","sources":["../../../src/core/upgradeMod.ts"],"names":[],"mappings":";;AACA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAIjD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,KAAK,eAAe,CAAC,CAAC,SAAS,SAAS,UAAU,EAAE,IAClD,UAAU,SAAS,CAAC,CAAC,QAAQ,CAAC,GAC1B,8FAA8F,GAC9F,CAAC,CAAC;AAER;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,SAAS,UAAU,EAAE,GAAG,KAAK,EAAE,EAClE,UAAU,EAAE,GAAG,EACf,QAAQ,GAAE,eAAe,CAAC,CAAC,CAAuC,EAClE,KAAK,UAAQ,EACb,aAAa,CAAC,EAAE,KAAK,GACpB,WAAW,CAAC,CAAC,CAAC,CAQhB"}
+{"version":3,"file":"upgradeMod.d.ts","sourceRoot":"","sources":["../../../src/core/upgradeMod.ts"],"names":[],"mappings":";;AACA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAI/D,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,KAAK,eAAe,CAAC,CAAC,SAAS,SAAS,UAAU,EAAE,IAClD,UAAU,SAAS,CAAC,CAAC,QAAQ,CAAC,GAC1B,8FAA8F,GAC9F,CAAC,CAAC;AAER;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,SAAS,UAAU,EAAE,GAAG,KAAK,EAAE,EAClE,UAAU,EAAE,GAAG,EACf,QAAQ,GAAE,eAAe,CAAC,CAAC,CAAuC,EAClE,mBAAmB,GAAE,iBAAiB,EAAE,GAAG,SAAS,iBAAiB,EAAO,EAC5E,KAAK,UAAQ,EACb,aAAa,CAAC,EAAE,KAAK,GACpB,WAAW,CAAC,CAAC,CAAC,CAShB"}

package/dist/src/core/upgradeMod.lua

@@ -1,7 +1,7 @@
 local ____lualib = require("lualib_bundle")
 local __TS__New = ____lualib.__TS__New
 local ____exports = {}
-local initOptionalFeatures
+local initOptionalFeatures, initCallbacksEarly
 local ____ModUpgradedBase = require("src.classes.ModUpgradedBase")
 local ModUpgradedBase = ____ModUpgradedBase.ModUpgradedBase
 local ____patchErrorFunctions = require("src.patchErrorFunctions")
@@ -19,6 +19,11 @@ function initOptionalFeatures(self, mod, features)
         end
     end
 end
+function initCallbacksEarly(self, mod, callbacks)
+    for ____, modCallbackCustom in ipairs(callbacks) do
+        mod.initCustomCallbackEarly(mod, modCallbackCustom)
+    end
+end
 --- Use this function to enable the custom callbacks and other optional features provided by
 -- `isaacscript-common`.
 -- 
@@ -38,16 +43,27 @@ end
 -- @param modVanilla The mod object returned by the `RegisterMod` function.
 -- @param features Optional. An array containing the optional standard library features that you
 -- want to enable, if any. Default is an empty array.
+-- @param customCallbacksUsed Optional. An array containing the custom callbacks that you will be
+-- subscribing to after you upgrade your mod. Specifying this will
+-- immediately initialize the callbacks (as opposed to lazy-initializing
+-- them when you first subscribe to the callback). This is only necessary
+-- if you the order of callback firing is important for your mod. (For
+-- example, you may want the `POST_NEW_ROOM` part of the
+-- `POST_GRID_ENTITY_INIT` callback to fire before your own
+-- `POST_NEW_ROOM` callbacks.)
 -- @param debug Optional. Whether to log additional output when a callback is fired. Default is
 -- false.
 -- @param timeThreshold Optional. If provided, will only log callbacks that take longer than the
 -- specified number of seconds (if the "--luadebug" launch flag is turned on)
 -- or milliseconds (if the "--luadebug" launch flag is turned off).
 -- @returns The upgraded mod object.
-function ____exports.upgradeMod(self, modVanilla, features, ____debug, timeThreshold)
+function ____exports.upgradeMod(self, modVanilla, features, customCallbacksUsed, ____debug, timeThreshold)
     if features == nil then
         features = {}
     end
+    if customCallbacksUsed == nil then
+        customCallbacksUsed = {}
+    end
     if ____debug == nil then
         ____debug = false
     end
@@ -55,6 +71,7 @@ function ____exports.upgradeMod(self, modVanilla, features, ____debug, timeThres
     local mod = __TS__New(ModUpgradedBase, modVanilla, ____debug, timeThreshold)
     applyShaderCrashFix(nil, mod)
     initOptionalFeatures(nil, mod, features)
+    initCallbacksEarly(nil, mod, customCallbacksUsed)
     return mod
 end
 return ____exports

package/package.json

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

package/src/classes/ModUpgradedBase.ts

@@ -375,6 +375,15 @@ export class ModUpgradedBase implements Mod {
 
     return getExportedMethodsFromFeature(featureClass);
   }
+
+  /**
+   * This is mostly the same as the `AddCustomCallback` method, but we initialize the custom
+   * callback without actually registering a subscription.
+   */
+  private initCustomCallbackEarly(modCallbackCustom: ModCallbackCustom) {
+    const callbackClass = this.callbacks[modCallbackCustom];
+    this.initFeature(callbackClass);
+  }
 }
 
 /**

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

@@ -9,6 +9,7 @@ import {
 import { game } from "../../../core/cachedClasses";
 import { Exported } from "../../../decorators";
 import { ISCFeature } from "../../../enums/ISCFeature";
+import { ModCallbackCustom } from "../../../enums/ModCallbackCustom";
 import {
   removeGridEntity,
   spawnGridEntityWithVariant,
@@ -47,47 +48,19 @@ export class CustomGridEntities extends Feature {
     this.featuresUsed = [ISCFeature.RUN_IN_N_FRAMES];
 
     this.callbacksUsed = [
-      [ModCallback.POST_NEW_ROOM, [this.postNewRoom]], // 19
       [
         ModCallback.PRE_USE_ITEM,
         [this.preUseItemWeNeedToGoDeeper, CollectibleType.WE_NEED_TO_GO_DEEPER],
       ], // 23
     ];
 
+    this.customCallbacksUsed = [
+      [ModCallbackCustom.POST_NEW_ROOM_REORDERED, [this.postNewRoomReordered]],
+    ];
+
     this.runInNFrames = runInNFrames;
   }
 
-  // ModCallback.POST_NEW_ROOM (19)
-  private postNewRoom = (): void => {
-    // When we re-enter a room, the graphics for any custom entities will be reverted back to that
-    // of a normal decoration. Thus, we must re-apply the anm2.
-    const roomListIndex = getRoomListIndex();
-    const roomCustomGridEntities =
-      this.v.level.customGridEntities.get(roomListIndex);
-    if (roomCustomGridEntities === undefined) {
-      return;
-    }
-
-    const room = game.GetRoom();
-    for (const [gridIndex, data] of roomCustomGridEntities.entries()) {
-      const decoration = room.GetGridEntity(gridIndex);
-      if (decoration === undefined) {
-        roomCustomGridEntities.delete(gridIndex);
-        continue;
-      }
-
-      if (data.anm2Path !== undefined) {
-        const sprite = decoration.GetSprite();
-        sprite.Load(data.anm2Path, true);
-        const animationToPlay =
-          data.defaultAnimation === undefined
-            ? sprite.GetDefaultAnimation()
-            : data.defaultAnimation;
-        sprite.Play(animationToPlay, true);
-      }
-    }
-  };
-
   // ModCallback.PRE_USE_ITEM (23)
   // CollectibleType.WE_NEED_TO_GO_DEEPER (84)
   private preUseItemWeNeedToGoDeeper = (
@@ -139,6 +112,37 @@ export class CustomGridEntities extends Feature {
     return true;
   };
 
+  // ModCallbackCustom.POST_NEW_ROOM_REORDERED
+  private postNewRoomReordered = (): void => {
+    // When we re-enter a room, the graphics for any custom entities will be reverted back to that
+    // of a normal decoration. Thus, we must re-apply the anm2.
+    const roomListIndex = getRoomListIndex();
+    const roomCustomGridEntities =
+      this.v.level.customGridEntities.get(roomListIndex);
+    if (roomCustomGridEntities === undefined) {
+      return;
+    }
+
+    const room = game.GetRoom();
+    for (const [gridIndex, data] of roomCustomGridEntities.entries()) {
+      const decoration = room.GetGridEntity(gridIndex);
+      if (decoration === undefined) {
+        roomCustomGridEntities.delete(gridIndex);
+        continue;
+      }
+
+      if (data.anm2Path !== undefined) {
+        const sprite = decoration.GetSprite();
+        sprite.Load(data.anm2Path, true);
+        const animationToPlay =
+          data.defaultAnimation === undefined
+            ? sprite.GetDefaultAnimation()
+            : data.defaultAnimation;
+        sprite.Play(animationToPlay, true);
+      }
+    }
+  };
+
   /**
    * Helper function to spawn a custom grid entity. Custom grid entities are persistent in that they
    * will reappear if the player leaves and re-enters the room. (It will be manually respawned in

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

@@ -62,10 +62,10 @@ export class CustomRevive extends Feature {
     this.callbacksUsed = [
       [ModCallback.POST_RENDER, [this.postRender]], // 2
       [ModCallback.POST_PEFFECT_UPDATE, [this.postPEffectUpdate]], // 4
-      [ModCallback.POST_NEW_ROOM, [this.postNewRoom]], // 19
     ];
 
     this.customCallbacksUsed = [
+      [ModCallbackCustom.POST_NEW_ROOM_REORDERED, [this.postNewRoomReordered]],
       [
         ModCallbackCustom.POST_PLAYER_FATAL_DAMAGE,
         [this.postPlayerFatalDamage],
@@ -138,8 +138,8 @@ export class CustomRevive extends Feature {
     this.logStateChanged();
   }
 
-  // ModCallback.POST_NEW_ROOM (19)
-  private postNewRoom = (): void => {
+  // ModCallbackCustom.POST_NEW_ROOM_REORDERED
+  private postNewRoomReordered = (): void => {
     if (this.v.run.state !== CustomReviveState.WAITING_FOR_ROOM_TRANSITION) {
       return;
     }

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

@@ -1,5 +1,6 @@
 import { GridEntityType, ModCallback } from "isaac-typescript-definitions";
 import { ISCFeature } from "../../../enums/ISCFeature";
+import { ModCallbackCustom } from "../../../enums/ModCallbackCustom";
 import {
   getGridEntitiesMap,
   isGridEntityBroken,
@@ -62,7 +63,10 @@ export class GridEntityUpdateDetection extends Feature {
 
     this.callbacksUsed = [
       [ModCallback.POST_UPDATE, [this.postUpdate]], // 1
-      [ModCallback.POST_NEW_ROOM, [this.postNewRoom]], // 19
+    ];
+
+    this.customCallbacksUsed = [
+      [ModCallbackCustom.POST_NEW_ROOM_REORDERED, [this.postNewRoomReordered]],
     ];
 
     this.postGridEntityInit = postGridEntityInit;
@@ -204,8 +208,8 @@ export class GridEntityUpdateDetection extends Feature {
     this.v.room.initializedGridEntities.set(gridIndex, newTuple);
   }
 
-  // ModCallback.POST_NEW_ROOM (19)
-  private postNewRoom = (): void => {
+  // ModCallbackCustom.POST_NEW_ROOM_REORDERED
+  private postNewRoomReordered = (): void => {
     const gridEntitiesMap = getGridEntitiesMap();
 
     for (const [gridIndex, gridEntity] of gridEntitiesMap.entries()) {

package/src/core/upgradeMod.ts

@@ -1,5 +1,6 @@
 import { ModUpgradedBase } from "../classes/ModUpgradedBase";
 import { ISCFeature } from "../enums/ISCFeature";
+import { ModCallbackCustom } from "../enums/ModCallbackCustom";
 import { patchErrorFunction } from "../patchErrorFunctions";
 import { applyShaderCrashFix } from "../shaderCrashFix";
 import { AnyFunction } from "../types/AnyFunction";
@@ -30,6 +31,14 @@ type ISCFeatureTuple<T extends readonly ISCFeature[]> =
  * @param modVanilla The mod object returned by the `RegisterMod` function.
  * @param features Optional. An array containing the optional standard library features that you
  *                 want to enable, if any. Default is an empty array.
+ * @param customCallbacksUsed Optional. An array containing the custom callbacks that you will be
+ *                            subscribing to after you upgrade your mod. Specifying this will
+ *                            immediately initialize the callbacks (as opposed to lazy-initializing
+ *                            them when you first subscribe to the callback). This is only necessary
+ *                            if you the order of callback firing is important for your mod. (For
+ *                            example, you may want the `POST_NEW_ROOM` part of the
+ *                            `POST_GRID_ENTITY_INIT` callback to fire before your own
+ *                            `POST_NEW_ROOM` callbacks.)
  * @param debug Optional. Whether to log additional output when a callback is fired. Default is
  *              false.
  * @param timeThreshold Optional. If provided, will only log callbacks that take longer than the
@@ -40,6 +49,7 @@ type ISCFeatureTuple<T extends readonly ISCFeature[]> =
 export function upgradeMod<T extends readonly ISCFeature[] = never[]>(
   modVanilla: Mod,
   features: ISCFeatureTuple<T> = [] as unknown as ISCFeatureTuple<T>,
+  customCallbacksUsed: ModCallbackCustom[] | readonly ModCallbackCustom[] = [],
   debug = false,
   timeThreshold?: float,
 ): ModUpgraded<T> {
@@ -48,6 +58,7 @@ export function upgradeMod<T extends readonly ISCFeature[] = never[]>(
   const mod = new ModUpgradedBase(modVanilla, debug, timeThreshold);
   applyShaderCrashFix(mod);
   initOptionalFeatures(mod, features as ISCFeature[]);
+  initCallbacksEarly(mod, customCallbacksUsed);
 
   return mod as ModUpgraded<T>;
 }
@@ -68,3 +79,15 @@ function initOptionalFeatures(mod: ModUpgradedBase, features: ISCFeature[]) {
     }
   }
 }
+
+function initCallbacksEarly(
+  mod: ModUpgradedBase,
+  callbacks: ModCallbackCustom[] | readonly ModCallbackCustom[],
+) {
+  for (const modCallbackCustom of callbacks) {
+    // We intentionally access the private method here, so we use the string index escape hatch:
+    // https://github.com/microsoft/TypeScript/issues/19335
+    // eslint-disable-next-line @typescript-eslint/dot-notation
+    mod["initCustomCallbackEarly"](modCallbackCustom);
+  }
+}