isaacscript-common 20.11.3 → 20.11.4

package/dist/index.d.ts

@@ -2494,6 +2494,7 @@ declare class CustomTrapdoors extends Feature {
     private postPEffectUpdateReordered;
     private checkJumpComplete;
     private shouldTrapdoorSpawnOpen;
+    private logStateChanged;
     /**
      * Helper function to specify where your custom trapdoor should take the player. Call this once at
      * the beginning of your mod for each kind of custom trapdoor that you want to have. The provided

package/dist/isaacscript-common.lua

@@ -1,6 +1,6 @@
 --[[
 
-isaacscript-common 20.11.3
+isaacscript-common 20.11.4
 
 This is the "isaacscript-common" library, which was created with the IsaacScript tool.
 
@@ -39206,6 +39206,8 @@ local ____TrapdoorAnimation = require("src.enums.private.TrapdoorAnimation")
 local TrapdoorAnimation = ____TrapdoorAnimation.TrapdoorAnimation
 local ____easing = require("src.functions.easing")
 local easeOutSine = ____easing.easeOutSine
+local ____log = require("src.functions.log")
+local log = ____log.log
 local ____playerCenter = require("src.functions.playerCenter")
 local movePlayersToCenter = ____playerCenter.movePlayersToCenter
 local ____playerIndex = require("src.functions.playerIndex")
@@ -39272,12 +39274,13 @@ end
 function goToVanillaStage(self, destinationStage, destinationStageType)
     setStage(nil, destinationStage, destinationStageType)
 end
+local DEBUG = false
 local TRAPDOOR_OPEN_DISTANCE = 60
 local TRAPDOOR_OPEN_DISTANCE_AFTER_BOSS = TRAPDOOR_OPEN_DISTANCE * 2.5
 local TRAPDOOR_BOSS_REACTION_FRAMES = 30
 local TRAPDOOR_TOUCH_DISTANCE = 16.5
 ANIMATIONS_THAT_PREVENT_STAGE_TRAVEL = __TS__New(Set, {"Death", "Happy", "Sad", "Jump"})
-local PIXELATION_TO_BLACK_FRAMES = 52
+local PIXELATION_TO_BLACK_FRAMES = 60
 local OTHER_PLAYER_TRAPDOOR_JUMP_DELAY_GAME_FRAMES = 6
 local OTHER_PLAYER_TRAPDOOR_JUMP_DURATION_GAME_FRAMES = 5
 ____exports.CustomTrapdoors = __TS__Class()
@@ -39346,6 +39349,7 @@ function CustomTrapdoors.prototype.checkAllPlayersJumpComplete(self)
     local roomGridIndex = getRoomGridIndex(nil)
     self.v.run.state = StageTravelState.PIXELATION_TO_BLACK
     self.v.run.stateRenderFrame = renderFrameCount
+    self:logStateChanged()
     teleport(nil, roomGridIndex, Direction.NO_DIRECTION, RoomTransitionAnim.PIXELATION)
 end
 function CustomTrapdoors.prototype.checkPixelationToBlackComplete(self)
@@ -39359,6 +39363,7 @@ function CustomTrapdoors.prototype.checkPixelationToBlackComplete(self)
         return
     end
     self.v.run.state = StageTravelState.WAITING_FOR_FIRST_PIXELATION_TO_END
+    self:logStateChanged()
     hud:SetVisible(false)
     self.runInNFrames:runNextGameFrame(function()
         local level = game:GetLevel()
@@ -39404,9 +39409,11 @@ function CustomTrapdoors.prototype.checkSecondPixelationHalfWay(self)
         return
     end
     self.v.run.state = StageTravelState.PIXELATION_TO_ROOM
+    self:logStateChanged()
     hud:SetVisible(true)
     self.runNextRoom:runNextRoom(function()
         self.v.run.state = StageTravelState.PLAYERS_LAYING_DOWN
+        self:logStateChanged()
         movePlayersToCenter(nil)
         for ____, player in ipairs(getAllPlayers(nil)) do
             player:AnimateAppear()
@@ -39423,6 +39430,7 @@ function CustomTrapdoors.prototype.checkAllPlayersLayingDownComplete(self)
         return
     end
     self.v.run.state = StageTravelState.NONE
+    self:logStateChanged()
     local tstlClassName = getTSTLClassName(nil, self)
     if tstlClassName == nil then
         error("Failed to find get the class name for the custom trapdoor feature.")
@@ -39488,6 +39496,7 @@ end
 function CustomTrapdoors.prototype.playerTouchedCustomTrapdoor(self, gridEntity, trapdoorDescription, player)
     self.v.run.state = StageTravelState.PLAYERS_JUMPING_DOWN
     self.v.run.customTrapdoorActivated = trapdoorDescription
+    self:logStateChanged()
     local tstlClassName = getTSTLClassName(nil, self)
     if tstlClassName == nil then
         error("Failed to find get the class name for the custom trapdoor feature.")
@@ -39580,6 +39589,14 @@ function CustomTrapdoors.prototype.shouldTrapdoorSpawnOpen(self, gridEntity, fir
     end
     return self:shouldTrapdoorOpen(gridEntity, firstSpawn)
 end
+function CustomTrapdoors.prototype.logStateChanged(self)
+    if DEBUG then
+        log(
+            nil,
+            ((("Custom trapdoors state changed: " .. StageTravelState[self.v.run.state]) .. " (") .. tostring(self.v.run.state)) .. ")"
+        )
+    end
+end
 function CustomTrapdoors.prototype.registerCustomTrapdoorDestination(self, destinationName, destinationFunc)
     if self.destinationFuncMap:has(destinationName) then
         error(("Failed to register a custom trapdoor type of " .. destinationName) .. " since this custom trapdoor type has already been registered.")

package/dist/src/classes/features/other/CustomTrapdoors.d.ts

@@ -36,6 +36,7 @@ export declare class CustomTrapdoors extends Feature {
     private postPEffectUpdateReordered;
     private checkJumpComplete;
     private shouldTrapdoorSpawnOpen;
+    private logStateChanged;
     /**
      * Helper function to specify where your custom trapdoor should take the player. Call this once at
      * the beginning of your mod for each kind of custom trapdoor that you want to have. The provided

package/dist/src/classes/features/other/CustomTrapdoors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CustomTrapdoors.d.ts","sourceRoot":"","sources":["../../../../../src/classes/features/other/CustomTrapdoors.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,UAAU,EAKV,SAAS,EACV,MAAM,8BAA8B,CAAC;AA4BtC,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AA6BhD,qBAAa,eAAgB,SAAQ,OAAO;IAC1C,qCAAqC;IACrC,OAAO,CAAC,kBAAkB,CAGtB;IAqBJ;;;;;OAKG;IACH,OAAO,CAAC,WAAW,CAAY;IAE/B,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,YAAY,CAAe;IAmDnC,OAAO,CAAC,UAAU,CAMhB;IAEF,OAAO,CAAC,2BAA2B;IA8BnC,OAAO,CAAC,8BAA8B;IAkDtC,OAAO,CAAC,6BAA6B;IAqBrC,OAAO,CAAC,kBAAkB;IAiB1B,OAAO,CAAC,4BAA4B;IAuCpC,OAAO,CAAC,iCAAiC;IAqBzC,OAAO,CAAC,eAAe;IAqBvB,OAAO,CAAC,kCAAkC,CAaxC;IAEF,OAAO,CAAC,4BAA4B;IAcpC,OAAO,CAAC,kBAAkB;IAc1B,OAAO,CAAC,sBAAsB;IAmB9B,OAAO,CAAC,gCAAgC;IAuCxC,OAAO,CAAC,2BAA2B;IAoCnC,OAAO,CAAC,gBAAgB;IAoBxB,OAAO,CAAC,8BAA8B;IAmDtC,OAAO,CAAC,0BAA0B,CAEhC;IAEF,OAAO,CAAC,iBAAiB;IAezB,OAAO,CAAC,uBAAuB;IA4B/B;;;;;;;;;;;;;;;;;;OAkBG;IAEI,iCAAiC,CACtC,eAAe,EAAE,MAAM,EACvB,eAAe,EAAE,CACf,gBAAgB,EAAE,UAAU,EAC5B,oBAAoB,EAAE,SAAS,KAC5B,IAAI,GACR,IAAI;IAUP;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqCG;IAEI,mBAAmB,CACxB,mBAAmB,EAAE,GAAG,GAAG,MAAM,EACjC,eAAe,CAAC,EAAE,MAAM,EACxB,gBAAgB,CAAC,EAAE,UAAU,EAC7B,oBAAoB,CAAC,EAAE,SAAS,EAChC,QAAQ,SAAmC,EAC3C,SAAS,CAAC,EAAE,OAAO,GAClB,UAAU;CA0Dd"}
+{"version":3,"file":"CustomTrapdoors.d.ts","sourceRoot":"","sources":["../../../../../src/classes/features/other/CustomTrapdoors.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,UAAU,EAKV,SAAS,EACV,MAAM,8BAA8B,CAAC;AA6BtC,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AA+BhD,qBAAa,eAAgB,SAAQ,OAAO;IAC1C,qCAAqC;IACrC,OAAO,CAAC,kBAAkB,CAGtB;IAqBJ;;;;;OAKG;IACH,OAAO,CAAC,WAAW,CAAY;IAE/B,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,YAAY,CAAe;IAmDnC,OAAO,CAAC,UAAU,CAMhB;IAEF,OAAO,CAAC,2BAA2B;IA+BnC,OAAO,CAAC,8BAA8B;IAmDtC,OAAO,CAAC,6BAA6B;IAqBrC,OAAO,CAAC,kBAAkB;IAiB1B,OAAO,CAAC,4BAA4B;IAyCpC,OAAO,CAAC,iCAAiC;IAsBzC,OAAO,CAAC,eAAe;IAqBvB,OAAO,CAAC,kCAAkC,CAaxC;IAEF,OAAO,CAAC,4BAA4B;IAcpC,OAAO,CAAC,kBAAkB;IAc1B,OAAO,CAAC,sBAAsB;IAmB9B,OAAO,CAAC,gCAAgC;IAuCxC,OAAO,CAAC,2BAA2B;IAqCnC,OAAO,CAAC,gBAAgB;IAoBxB,OAAO,CAAC,8BAA8B;IAmDtC,OAAO,CAAC,0BAA0B,CAEhC;IAEF,OAAO,CAAC,iBAAiB;IAezB,OAAO,CAAC,uBAAuB;IA4B/B,OAAO,CAAC,eAAe;IAUvB;;;;;;;;;;;;;;;;;;OAkBG;IAEI,iCAAiC,CACtC,eAAe,EAAE,MAAM,EACvB,eAAe,EAAE,CACf,gBAAgB,EAAE,UAAU,EAC5B,oBAAoB,EAAE,SAAS,KAC5B,IAAI,GACR,IAAI;IAUP;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqCG;IAEI,mBAAmB,CACxB,mBAAmB,EAAE,GAAG,GAAG,MAAM,EACjC,eAAe,CAAC,EAAE,MAAM,EACxB,gBAAgB,CAAC,EAAE,UAAU,EAC7B,oBAAoB,CAAC,EAAE,SAAS,EAChC,QAAQ,SAAmC,EAC3C,SAAS,CAAC,EAAE,OAAO,GAClB,UAAU;CA0Dd"}

package/dist/src/classes/features/other/CustomTrapdoors.lua

@@ -40,6 +40,8 @@ local ____TrapdoorAnimation = require("src.enums.private.TrapdoorAnimation")
 local TrapdoorAnimation = ____TrapdoorAnimation.TrapdoorAnimation
 local ____easing = require("src.functions.easing")
 local easeOutSine = ____easing.easeOutSine
+local ____log = require("src.functions.log")
+local log = ____log.log
 local ____playerCenter = require("src.functions.playerCenter")
 local movePlayersToCenter = ____playerCenter.movePlayersToCenter
 local ____playerIndex = require("src.functions.playerIndex")
@@ -106,13 +108,14 @@ end
 function goToVanillaStage(self, destinationStage, destinationStageType)
     setStage(nil, destinationStage, destinationStageType)
 end
+local DEBUG = false
 --- This also applies to crawl spaces. The value was determined through trial and error.
 local TRAPDOOR_OPEN_DISTANCE = 60
 local TRAPDOOR_OPEN_DISTANCE_AFTER_BOSS = TRAPDOOR_OPEN_DISTANCE * 2.5
 local TRAPDOOR_BOSS_REACTION_FRAMES = 30
 local TRAPDOOR_TOUCH_DISTANCE = 16.5
 ANIMATIONS_THAT_PREVENT_STAGE_TRAVEL = __TS__New(Set, {"Death", "Happy", "Sad", "Jump"})
-local PIXELATION_TO_BLACK_FRAMES = 52
+local PIXELATION_TO_BLACK_FRAMES = 60
 local OTHER_PLAYER_TRAPDOOR_JUMP_DELAY_GAME_FRAMES = 6
 local OTHER_PLAYER_TRAPDOOR_JUMP_DURATION_GAME_FRAMES = 5
 ____exports.CustomTrapdoors = __TS__Class()
@@ -181,6 +184,7 @@ function CustomTrapdoors.prototype.checkAllPlayersJumpComplete(self)
     local roomGridIndex = getRoomGridIndex(nil)
     self.v.run.state = StageTravelState.PIXELATION_TO_BLACK
     self.v.run.stateRenderFrame = renderFrameCount
+    self:logStateChanged()
     teleport(nil, roomGridIndex, Direction.NO_DIRECTION, RoomTransitionAnim.PIXELATION)
 end
 function CustomTrapdoors.prototype.checkPixelationToBlackComplete(self)
@@ -194,6 +198,7 @@ function CustomTrapdoors.prototype.checkPixelationToBlackComplete(self)
         return
     end
     self.v.run.state = StageTravelState.WAITING_FOR_FIRST_PIXELATION_TO_END
+    self:logStateChanged()
     hud:SetVisible(false)
     self.runInNFrames:runNextGameFrame(function()
         local level = game:GetLevel()
@@ -239,9 +244,11 @@ function CustomTrapdoors.prototype.checkSecondPixelationHalfWay(self)
         return
     end
     self.v.run.state = StageTravelState.PIXELATION_TO_ROOM
+    self:logStateChanged()
     hud:SetVisible(true)
     self.runNextRoom:runNextRoom(function()
         self.v.run.state = StageTravelState.PLAYERS_LAYING_DOWN
+        self:logStateChanged()
         movePlayersToCenter(nil)
         for ____, player in ipairs(getAllPlayers(nil)) do
             player:AnimateAppear()
@@ -258,6 +265,7 @@ function CustomTrapdoors.prototype.checkAllPlayersLayingDownComplete(self)
         return
     end
     self.v.run.state = StageTravelState.NONE
+    self:logStateChanged()
     local tstlClassName = getTSTLClassName(nil, self)
     if tstlClassName == nil then
         error("Failed to find get the class name for the custom trapdoor feature.")
@@ -323,6 +331,7 @@ end
 function CustomTrapdoors.prototype.playerTouchedCustomTrapdoor(self, gridEntity, trapdoorDescription, player)
     self.v.run.state = StageTravelState.PLAYERS_JUMPING_DOWN
     self.v.run.customTrapdoorActivated = trapdoorDescription
+    self:logStateChanged()
     local tstlClassName = getTSTLClassName(nil, self)
     if tstlClassName == nil then
         error("Failed to find get the class name for the custom trapdoor feature.")
@@ -415,6 +424,14 @@ function CustomTrapdoors.prototype.shouldTrapdoorSpawnOpen(self, gridEntity, fir
     end
     return self:shouldTrapdoorOpen(gridEntity, firstSpawn)
 end
+function CustomTrapdoors.prototype.logStateChanged(self)
+    if DEBUG then
+        log(
+            nil,
+            ((("Custom trapdoors state changed: " .. StageTravelState[self.v.run.state]) .. " (") .. tostring(self.v.run.state)) .. ")"
+        )
+    end
+end
 function CustomTrapdoors.prototype.registerCustomTrapdoorDestination(self, destinationName, destinationFunc)
     if self.destinationFuncMap:has(destinationName) then
         error(("Failed to register a custom trapdoor type of " .. destinationName) .. " since this custom trapdoor type has already been registered.")

package/package.json

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

package/src/classes/features/other/CustomTrapdoors.ts

@@ -21,6 +21,7 @@ import { GridEntityTypeCustom } from "../../../enums/private/GridEntityTypeCusto
 import { StageTravelState } from "../../../enums/private/StageTravelState";
 import { TrapdoorAnimation } from "../../../enums/private/TrapdoorAnimation";
 import { easeOutSine } from "../../../functions/easing";
+import { log } from "../../../functions/log";
 import { movePlayersToCenter } from "../../../functions/playerCenter";
 import {
   getAllPlayers,
@@ -48,6 +49,8 @@ import { RunInNFrames } from "./RunInNFrames";
 import { RunNextRoom } from "./RunNextRoom";
 import { StageHistory } from "./StageHistory";
 
+const DEBUG = false as boolean;
+
 /** This also applies to crawl spaces. The value was determined through trial and error. */
 const TRAPDOOR_OPEN_DISTANCE = 60;
 
@@ -63,7 +66,7 @@ const ANIMATIONS_THAT_PREVENT_STAGE_TRAVEL: ReadonlySet<string> = new Set([
   "Jump",
 ]);
 
-const PIXELATION_TO_BLACK_FRAMES = 52;
+const PIXELATION_TO_BLACK_FRAMES = 60;
 
 const OTHER_PLAYER_TRAPDOOR_JUMP_DELAY_GAME_FRAMES = 6;
 const OTHER_PLAYER_TRAPDOOR_JUMP_DURATION_GAME_FRAMES = 5;
@@ -181,6 +184,7 @@ export class CustomTrapdoors extends Feature {
 
     this.v.run.state = StageTravelState.PIXELATION_TO_BLACK;
     this.v.run.stateRenderFrame = renderFrameCount;
+    this.logStateChanged();
 
     // In order to display the pixelation effect that should happen when we go to a new floor, we
     // need to start a room transition. We arbitrarily pick the current room for this purpose. (We
@@ -215,6 +219,7 @@ export class CustomTrapdoors extends Feature {
     }
 
     this.v.run.state = StageTravelState.WAITING_FOR_FIRST_PIXELATION_TO_END;
+    this.logStateChanged();
 
     // Now, we display a black sprite on top of the pixelation effect, to prevent showing the rest
     // of the animation.
@@ -304,11 +309,13 @@ export class CustomTrapdoors extends Feature {
     }
 
     this.v.run.state = StageTravelState.PIXELATION_TO_ROOM;
+    this.logStateChanged();
 
     hud.SetVisible(true);
 
     this.runNextRoom.runNextRoom(() => {
       this.v.run.state = StageTravelState.PLAYERS_LAYING_DOWN;
+      this.logStateChanged();
 
       // After the room transition, the players will be placed next to a door, but they should be in
       // the center of the room to emulate what happens on a vanilla stage.
@@ -334,6 +341,7 @@ export class CustomTrapdoors extends Feature {
     }
 
     this.v.run.state = StageTravelState.NONE;
+    this.logStateChanged();
 
     const tstlClassName = getTSTLClassName(this);
     if (tstlClassName === undefined) {
@@ -474,6 +482,7 @@ export class CustomTrapdoors extends Feature {
   ) {
     this.v.run.state = StageTravelState.PLAYERS_JUMPING_DOWN;
     this.v.run.customTrapdoorActivated = trapdoorDescription;
+    this.logStateChanged();
 
     const tstlClassName = getTSTLClassName(this);
     if (tstlClassName === undefined) {
@@ -621,6 +630,16 @@ export class CustomTrapdoors extends Feature {
     return this.shouldTrapdoorOpen(gridEntity, firstSpawn);
   }
 
+  private logStateChanged(): void {
+    if (DEBUG) {
+      log(
+        `Custom trapdoors state changed: ${
+          StageTravelState[this.v.run.state]
+        } (${this.v.run.state})`,
+      );
+    }
+  }
+
   /**
    * Helper function to specify where your custom trapdoor should take the player. Call this once at
    * the beginning of your mod for each kind of custom trapdoor that you want to have. The provided