isaacscript-common 6.6.1-dev.0 → 6.6.1-dev.4

package/dist/features/customStage/init.js

@@ -0,0 +1,104 @@
+import { GridEntityType, ModCallback, } from "isaac-typescript-definitions";
+import { ModCallbackCustom } from "../../enums/ModCallbackCustom";
+import { isArray } from "../../functions/array";
+import { saveDataManager } from "../saveDataManager/exports";
+import { setBackdrop } from "./backdrop";
+import { removeUrnRewards, setCustomDecorationGraphics, setCustomDoorGraphics, setCustomPitGraphics, setCustomRockGraphics, } from "./gridEntities";
+import * as metadataJSON from "./metadata.json"; // This will correspond to "metadata.lua" at run-time.
+import { setShadows } from "./shadows";
+import { streakTextGetShaderParams, streakTextPostRender } from "./streakText";
+import v, { customStagesMap } from "./v";
+import { playVersusScreenAnimation, versusScreenPostRender, } from "./versusScreen";
+export function customStageInit(mod) {
+    saveDataManager("customStage", v);
+    initRoomTypeMaps();
+    mod.AddCallback(ModCallback.POST_RENDER, postRender); // 2
+    mod.AddCallback(ModCallback.GET_SHADER_PARAMS, getShaderParams); // 21
+    mod.AddCallbackCustom(ModCallbackCustom.POST_GRID_ENTITY_BROKEN, postGridEntityBrokenRockAlt, GridEntityType.ROCK_ALT);
+    mod.AddCallbackCustom(ModCallbackCustom.POST_GRID_ENTITY_INIT, postGridEntityBrokenInit);
+    mod.AddCallbackCustom(ModCallbackCustom.POST_NEW_ROOM_REORDERED, postNewRoomReordered);
+}
+function initRoomTypeMaps() {
+    if (!isArray(metadataJSON)) {
+        error('The IsaacScript standard library attempted to read the custom stage metadata from the "metadata.lua" file, but it was not an array.');
+    }
+    const customStagesLua = metadataJSON;
+    for (const customStageLua of customStagesLua) {
+        const roomTypeMap = getRoomTypeMap(customStageLua);
+        const customStage = {
+            ...customStageLua,
+            roomTypeMap,
+        };
+        customStagesMap.set(customStage.name, customStage);
+    }
+}
+function getRoomTypeMap(customStageLua) {
+    const roomTypeMap = new Map();
+    for (const roomMetadata of customStageLua.roomsMetadata) {
+        const roomType = roomMetadata.type;
+        let roomShapeMap = roomTypeMap.get(roomType);
+        if (roomShapeMap === undefined) {
+            roomShapeMap = new Map();
+            roomTypeMap.set(roomType, roomShapeMap);
+        }
+        const roomShape = roomMetadata.shape;
+        let roomDoorSlotFlagMap = roomShapeMap.get(roomShape);
+        if (roomDoorSlotFlagMap === undefined) {
+            roomDoorSlotFlagMap = new Map();
+            roomShapeMap.set(roomShape, roomDoorSlotFlagMap);
+        }
+        const doorSlotFlags = roomMetadata.doorSlotFlags;
+        let rooms = roomDoorSlotFlagMap.get(doorSlotFlags);
+        if (rooms === undefined) {
+            rooms = [];
+            roomDoorSlotFlagMap.set(doorSlotFlags, rooms);
+        }
+        rooms.push(roomMetadata);
+    }
+    return roomTypeMap;
+}
+// ModCallback.POST_RENDER (2)
+function postRender() {
+    const customStage = v.run.currentCustomStage;
+    if (customStage === null) {
+        return;
+    }
+    streakTextPostRender(customStage);
+    versusScreenPostRender();
+}
+// ModCallback.GET_SHADER_PARAMS (22)
+function getShaderParams(shaderName) {
+    streakTextGetShaderParams(shaderName);
+    return undefined;
+}
+// ModCallbackCustom.POST_GRID_ENTITY_BROKEN
+// GridEntityType.ROCK_ALT
+function postGridEntityBrokenRockAlt(gridEntity) {
+    const customStage = v.run.currentCustomStage;
+    if (customStage === null) {
+        return;
+    }
+    removeUrnRewards(customStage, gridEntity);
+}
+// ModCallbackCustom.POST_GRID_ENTITY_INIT
+function postGridEntityBrokenInit(gridEntity) {
+    const customStage = v.run.currentCustomStage;
+    if (customStage === null) {
+        return;
+    }
+    setCustomDecorationGraphics(customStage, gridEntity);
+    setCustomRockGraphics(customStage, gridEntity);
+    setCustomPitGraphics(customStage, gridEntity);
+    setCustomDoorGraphics(customStage, gridEntity);
+}
+// ModCallbackCustom.POST_NEW_ROOM_REORDERED
+function postNewRoomReordered() {
+    const customStage = v.run.currentCustomStage;
+    if (customStage === null) {
+        return;
+    }
+    setBackdrop(customStage);
+    setShadows(customStage);
+    playVersusScreenAnimation(customStage);
+}
+//# sourceMappingURL=init.js.map

package/dist/features/customStage/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"../src/","sources":["features/customStage/init.ts"],"names":[],"mappings":"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"}

package/dist/features/customStage/init.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../packages/isaacscript-common/src/features/customStage/init.ts"],"names":[],"mappings":";;;;;MA0DS,kBAkBA,gBA2CA,YAWA,iBASA,6BAUA,0BAaA;AAlKT,6CAMO;AAJL;AACA;AAKF,8BAAkC;AAAzB;AACT,kBAAwB;AAAf;AAMT,oBAAgC;AAAvB;AACT,qBAA4B;AAAnB;AACT,yBAMO;AALL;AACA;AACA;AACA;AACA;AAEF,MAAY,eAAkB;AAC9B,oBAA2B;AAAlB;AACT,uBAAgE;AAAvD;AAA2B;AACpC,cAAmC;AAA5B;AAAK;AACZ,yBAGO;AAFL;AACA;AA4BF,SAAS;WACF,aAAQ;QACX,MACE;;AAGE,4BAAkB;AAExB,cAAW,yBAAkB;AACrB,4BAAc,oBAAe;AAC7B,4BAA2B,uBAC5B,gBAD4B,CAE/B;QAEF,gBAAgB,IAAI,kBAAkB;;;AAI1C,SAAS,qBAAe;AAChB,wBAAc,UAAI;AAKxB,cAAW,uBAAgB;AACnB,yBAAW;AAEb,6BAAe,YAAY,IAAI;WAC/B;AACF,2BAAe,UAAI;YAInB,YAAY,IAAI,UAAU;;AAGtB,0BAAY;AAEd,oCAAsB,aAAa,IAAI;WACvC;AACF,kCAAsB,UAAI;YAI1B,aAAa,IAAI,WAAW;;AAGxB,8BAAgB;AAClB,sBAAQ,oBAAoB,IAAI;WAChC;AACF,oBAAQ;YACR,oBAAoB,IAAI,eAAe;;AAGzC,4BAAW;;AAGb,WAAO;;AAIT,SAAS;AACD,wBAAc;OAChB,eAAgB;AAClB;;IAGF,0BAAqB;IACrB;;AAIF,SAAS,sBACP;IAEA,+BAA0B;AAC1B;;AAKF,SAAS,kCAA4B;AAC7B,wBAAc;OAChB,eAAgB;AAClB;;IAGF,sBAAiB,aAAa;;AAIhC,SAAS,+BAAyB;AAC1B,wBAAc;OAChB,eAAgB;AAClB;;IAGF,iCAA4B,aAAa;IACzC,2BAAsB,aAAa;IACnC,0BAAqB,aAAa;IAClC,2BAAsB,aAAa;;AAIrC,SAAS;AACD,wBAAc;OAChB,eAAgB;AAClB;;IAGF,iBAAY;IACZ,gBAAW;IACX,+BAA0B;;AAzI5B,2CAAgC;IAC9B,qBAAgB,eAAe;IAC/B;IAEA,IAAI,YAAY,yBAAyB;IAEzC,IAAI,YAAY,+BAA+B;IAE/C,IAAI,kBACF,2CACA,6BACA;IAGF,IAAI,kBACF,yCACA;IAGF,IAAI,kBACF,2CACA;AArBJ","file":"init.lua","sourceRoot":"../src/"}

package/dist/features/customStage/metadata.json

@@ -0,0 +1 @@
+[]

package/dist/features/customStage/metadata.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../packages/isaacscript-common/src/features/customStage/metadata.json"],"names":[],"mappings":"OAAA","file":"metadata.lua","sourceRoot":"../src/"}

package/dist/features/customStage/shadows.js

@@ -0,0 +1,63 @@
+import { EffectVariant, RoomShape } from "isaac-typescript-definitions";
+import { game } from "../../cachedClasses";
+import { getRandomArrayElement } from "../../functions/array";
+import { spawnEffectWithSeed } from "../../functions/entitySpecific";
+import { ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH } from "./customStageConstants";
+import v from "./v";
+/**
+ * Normally, we would make a custom entity to represent a shadow effect, but we don't want to
+ * interfere with the "entities2.xml" file in end-user mods. Thus, we must select a vanilla effect
+ * to masquerade as a backdrop effect.
+ *
+ * We arbitrarily choose a ladder for this purpose because it will not automatically despawn after
+ * time passes, like most other effects.
+ */
+const SHADOW_EFFECT_VARIANT = EffectVariant.LADDER;
+/** The animation comes from StageAPI. */
+const ROOM_SHAPE_TO_SHADOW_ANIMATION = {
+    [RoomShape.SHAPE_1x1]: "1x1",
+    [RoomShape.IH]: "1x1",
+    [RoomShape.IV]: "1x1",
+    [RoomShape.SHAPE_1x2]: "1x2",
+    [RoomShape.IIV]: "1x2",
+    [RoomShape.SHAPE_2x1]: "2x1",
+    [RoomShape.IIH]: "2x1",
+    [RoomShape.SHAPE_2x2]: "2x2",
+    [RoomShape.LTL]: "2x2",
+    [RoomShape.LTR]: "2x2",
+    [RoomShape.LBL]: "2x2",
+    [RoomShape.LBR]: "2x2", // 12
+};
+const FADED_BLACK = Color(0, 0, 0, 0.25);
+const shadowSprite = Sprite();
+shadowSprite.Load(`${ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH}/stage-shadow.anm2`, true);
+export function setShadows(customStage) {
+    if (customStage.shadows === undefined) {
+        return;
+    }
+    const room = game.GetRoom();
+    const roomShape = room.GetRoomShape();
+    const centerPos = room.GetCenterPos();
+    const animation = ROOM_SHAPE_TO_SHADOW_ANIMATION[roomShape];
+    const shadows = customStage.shadows[animation];
+    if (shadows === undefined) {
+        return;
+    }
+    // We spawn an effect instead of simply rendering a static sprite so that the effect will properly
+    // slide in during a room transition animation. (It looks stupid if the shadow stays statically
+    // rendering throughout this animation.)
+    const shadowEffect = spawnEffectWithSeed(SHADOW_EFFECT_VARIANT, 0, centerPos, 1);
+    const sprite = shadowEffect.GetSprite();
+    sprite.Load(`${ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH}/stage-shadow.anm2`, false);
+    const decorationSeed = room.GetDecorationSeed();
+    const shadow = getRandomArrayElement(shadows, decorationSeed);
+    sprite.ReplaceSpritesheet(0, shadow.pngPath);
+    sprite.LoadGraphics();
+    sprite.SetFrame(animation, 0);
+    sprite.Color =
+        shadow.color === undefined
+            ? FADED_BLACK
+            : Color(shadow.color.r, shadow.color.g, shadow.color.b, shadow.color.a);
+    v.room.showingShadows = true;
+}
+//# sourceMappingURL=shadows.js.map

package/dist/features/customStage/shadows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadows.js","sourceRoot":"../src/","sources":["features/customStage/shadows.ts"],"names":[],"mappings":"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"}

package/dist/features/customStage/shadows.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../packages/isaacscript-common/src/features/customStage/shadows.ts"],"names":[],"mappings":";AAAA,6CAAyC;AAAhC;AAAe;AACxB,0BAAqB;AAAZ;AACT,kBAAsC;AAA7B;AACT,2BAAoC;AAA3B;AAET,iCAAkD;AAAzC;AACT,cAAc;AAAP;;;;;;;AAYD,8BAAwB;;AAGxB,uCAEF;IACF,CAAC,uBAAsB;IACvB,CAAC,gBAAe;IAChB,CAAC,gBAAe;IAChB,CAAC,uBAAsB;IACvB,CAAC,iBAAgB;IACjB,CAAC,uBAAsB;IACvB,CAAC,iBAAgB;IACjB,CAAC,uBAAsB;IACvB,CAAC,iBAAgB;IACjB,CAAC,iBAAgB;IACjB,CAAC,iBAAgB;IACjB,CAAC,iBAAgB;;AAGb,oBAAc,MAAM,GAAG,GAAG,GAAG;AAE7B,qBAAe;AACrB,aAAa,KACR,qCAAiC,sBACpC;AAGF,sCAA2B;OACrB;AACF;;AAGI,iBAAO,KAAK;AACZ,sBAAY,KAAK;AACjB,sBAAY,KAAK;AACjB,sBAAY,+BAA+B;AAC3C,oBAAU,oBAAoB;OAChC;AACF;;AAMI,yBAAe;;QACnB;QACA;QACA;QACA;;AAGI,mBAAS,aAAa;IAC5B,OAAO,KAAQ,qCAAiC,sBAAsB;AAChE,2BAAiB,KAAK;AACtB,mBAAS,2BAAsB,SAAS;IAC9C,OAAO,mBAAmB,GAAG;IAC7B,OAAO;IACP,OAAO,SAAS,WAAW;AAC3B,mBACE,wBACI,eACA,MAAM,gBAAgB,gBAAgB,gBAAgB;AAE5D,4BAAwB;AApC1B","file":"shadows.lua","sourceRoot":"../src/"}

package/dist/features/customStage/streakText.js

@@ -0,0 +1,35 @@
+import { fonts, game } from "../../cachedClasses";
+import { KColorDefault } from "../../constants";
+import { getScreenBottomCenterPos } from "../../functions/ui";
+import { todo } from "../../functions/utils";
+import v from "./v";
+/** This must match the name of the shader in "shaders.xml". */
+const EMPTY_SHADER_NAME = "IsaacScript-RenderAboveHUD";
+/** This matches the offset that the vanilla game uses. */
+const STREAK_TEXT_BOTTOM_OFFSET = Vector(0, -60);
+// ModCallback.POST_RENDER (2)
+export function streakTextPostRender(customStage) {
+    if (!v.run.showingStreakText) {
+        return;
+    }
+    const isPaused = game.IsPaused();
+    if (isPaused) {
+        return;
+    }
+    const font = fonts.upheaval;
+    const length = font.GetStringWidthUTF8(customStage.name);
+    const bottomCenterPos = getScreenBottomCenterPos();
+    const position = bottomCenterPos.add(STREAK_TEXT_BOTTOM_OFFSET);
+    const adjustedX = position.X - length / 2;
+    font.DrawString(customStage.name, adjustedX, position.Y, KColorDefault);
+}
+// ModCallback.INPUT_ACTION (13)
+// TODO
+// ModCallback.GET_SHADER_PARAMS (22)
+export function streakTextGetShaderParams(shaderName) {
+    if (shaderName !== EMPTY_SHADER_NAME) {
+        return;
+    }
+    todo();
+}
+//# sourceMappingURL=streakText.js.map

package/dist/features/customStage/streakText.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streakText.js","sourceRoot":"../src/","sources":["features/customStage/streakText.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAE7C,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB,+DAA+D;AAC/D,MAAM,iBAAiB,GAAG,4BAA4B,CAAC;AAEvD,0DAA0D;AAC1D,MAAM,yBAAyB,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;AAEjD,8BAA8B;AAC9B,MAAM,UAAU,oBAAoB,CAAC,WAAwB;IAC3D,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,iBAAiB,EAAE;QAC5B,OAAO;KACR;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;IACjC,IAAI,QAAQ,EAAE;QACZ,OAAO;KACR;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC;IAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IACzD,MAAM,eAAe,GAAG,wBAAwB,EAAE,CAAC;IACnD,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;IAChE,MAAM,SAAS,GAAG,QAAQ,CAAC,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC;IAC1C,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;AAC1E,CAAC;AAED,gCAAgC;AAChC,OAAO;AAEP,qCAAqC;AACrC,MAAM,UAAU,yBAAyB,CAAC,UAAkB;IAC1D,IAAI,UAAU,KAAK,iBAAiB,EAAE;QACpC,OAAO;KACR;IAED,IAAI,EAAE,CAAC;AACT,CAAC"}

package/dist/features/customStage/streakText.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../packages/isaacscript-common/src/features/customStage/streakText.ts"],"names":[],"mappings":";AAAA,0BAA4B;AAAnB;AAAO;AAChB,sBAA8B;AAArB;AACT,eAAyC;AAAhC;AACT,kBAAqB;AAAZ;AAET,cAAc;AAAP;;AAGD,0BAAoB;;AAGpB,kCAA4B,OAAO,IAAI;AAG7C,gDAAqC;WAC9B;AACH;;AAGI,qBAAW,KAAK;OAClB;AACF;;AAGI,iBAAO;AACP,mBAAS,KAAK,mBAAmB;AACjC,4BAAkB;AAClB,qBAAW,kBAAoB;AAC/B,sBAAY,aAAa,SAAS;IACxC,KAAK,WAAW,kBAAkB,WAAW,YAAY;AAf3D;AAsBA,qDAA0C;OACpC,cAAe;AACjB;;IAGF;AALF","file":"streakText.lua","sourceRoot":"../src/"}

package/dist/features/customStage/util.js

@@ -0,0 +1,36 @@
+import { sumArray } from "../../functions/array";
+import { log } from "../../functions/log";
+import { getRandomFloat } from "../../functions/random";
+import { getRandomSeed } from "../../functions/rng";
+/**
+ * Helper function to get a random custom stage room from an array of custom stage rooms.
+ *
+ * Note that this function does not simply choose a random element in the provided array; it will
+ * properly account for each room weight using the algorithm from:
+ * https://stackoverflow.com/questions/1761626/weighted-random-numbers
+ */
+export function getRandomCustomStageRoom(roomsMetadata, seedOrRNG = getRandomSeed(), verbose = false) {
+    const totalWeight = getTotalWeightOfCustomStageRooms(roomsMetadata);
+    if (verbose) {
+        log(`Total weight of the custom stage rooms provided: ${totalWeight}`);
+    }
+    const chosenWeight = getRandomFloat(0, totalWeight, seedOrRNG);
+    if (verbose) {
+        log(`Randomly chose weight for custom stage room: ${chosenWeight}`);
+    }
+    return getCustomStageRoomWithChosenWeight(roomsMetadata, chosenWeight);
+}
+function getTotalWeightOfCustomStageRooms(roomsMetadata) {
+    const weights = roomsMetadata.map((roomMetadata) => roomMetadata.weight);
+    return sumArray(weights);
+}
+function getCustomStageRoomWithChosenWeight(roomsMetadata, chosenWeight) {
+    for (const roomMetadata of roomsMetadata) {
+        if (chosenWeight < roomMetadata.weight) {
+            return roomMetadata;
+        }
+        chosenWeight -= roomMetadata.weight;
+    }
+    error(`Failed to get a custom stage room with chosen weight: ${chosenWeight}`);
+}
+//# sourceMappingURL=util.js.map

package/dist/features/customStage/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"../src/","sources":["features/customStage/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CACtC,aAAiD,EACjD,YAAwB,aAAa,EAAE,EACvC,OAAO,GAAG,KAAK;IAEf,MAAM,WAAW,GAAG,gCAAgC,CAAC,aAAa,CAAC,CAAC;IACpE,IAAI,OAAO,EAAE;QACX,GAAG,CAAC,oDAAoD,WAAW,EAAE,CAAC,CAAC;KACxE;IAED,MAAM,YAAY,GAAG,cAAc,CAAC,CAAC,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;IAC/D,IAAI,OAAO,EAAE;QACX,GAAG,CAAC,gDAAgD,YAAY,EAAE,CAAC,CAAC;KACrE;IAED,OAAO,kCAAkC,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;AACzE,CAAC;AAED,SAAS,gCAAgC,CACvC,aAAiD;IAEjD,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IACzE,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC3B,CAAC;AAED,SAAS,kCAAkC,CACzC,aAAiD,EACjD,YAAmB;IAEnB,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE;QACxC,IAAI,YAAY,GAAG,YAAY,CAAC,MAAM,EAAE;YACtC,OAAO,YAAY,CAAC;SACrB;QAED,YAAY,IAAI,YAAY,CAAC,MAAM,CAAC;KACrC;IAED,KAAK,CACH,yDAAyD,YAAY,EAAE,CACxE,CAAC;AACJ,CAAC"}

package/dist/features/customStage/util.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../packages/isaacscript-common/src/features/customStage/util.ts"],"names":[],"mappings":";;;MA+BS,kCAOA;AAtCT,kBAAyB;AAAhB;AACT,gBAAoB;AAAX;AACT,mBAA+B;AAAtB;AACT,gBAA8B;AAArB;AA4BT,SAAS,uCACP;AAEM,oBAAU;QAAA;QAAkB,eAAC,cAAiB,0BAAlB;;AAClC,WAAO,cAAS;;AAGlB,SAAS,yCACP,eACA;AAEA,cAAW,uBAAgB;WACrB,eAAe;AACjB,mBAAO;;AAGT,sCAAgB;;IAGlB,MACE,qEAAyD;;;;;;;AAtC7D,oDACE,eACA,WACA;OADA;QAAA,YAAwB;;OACxB;QAAA,UAAU;;AAEJ,wBAAc,sCAAiC;OACjD;QACF,IAAI,gEAAoD;;AAGpD,yBAAe,oBAAe,GAAG,aAAa;OAChD;QACF,IAAI,4DAAgD;;AAGtD,WAAO,wCAAmC,eAAe;AAf3D","file":"util.lua","sourceRoot":"../src/"}

package/dist/features/customStage/v.js

@@ -0,0 +1,18 @@
+const v = {
+    run: {
+        currentCustomStage: null,
+        showingStreakText: false,
+        showingBossVersusScreen: false,
+    },
+    room: {
+        showingShadows: false,
+    },
+};
+export default v;
+/** Indexed by custom stage name. */
+export const customStagesMap = new Map();
+/** Indexed by room variant. */
+export const customStageCachedRoomData = new Map();
+/** Indexed by entity ID. */
+export const customBossPNGPaths = new Map();
+//# sourceMappingURL=v.js.map

package/dist/features/customStage/v.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"v.js","sourceRoot":"../src/","sources":["features/customStage/v.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,GAAG;IACR,GAAG,EAAE;QACH,kBAAkB,EAAE,IAA0B;QAC9C,iBAAiB,EAAE,KAAK;QACxB,uBAAuB,EAAE,KAAK;KAC/B;IAED,IAAI,EAAE;QACJ,cAAc,EAAE,KAAK;KACtB;CACF,CAAC;AACF,eAAe,CAAC,CAAC;AAEjB,oCAAoC;AACpC,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,GAAG,EAAuB,CAAC;AAE9D,+BAA+B;AAC/B,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,GAAG,EAA6B,CAAC;AAE9E,4BAA4B;AAC5B,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAGtC,CAAC"}

package/dist/features/customStage/v.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../packages/isaacscript-common/src/features/customStage/v.ts"],"names":[],"mappings":";;;;AAEM,UAAI,CACR,MAAK,CACH,qBAAoB,KACpB,oBAAmB,OACnB,0BAAyB,QAG3B,OAAM,CACJ,iBAAgB;AAGpB,sBAAe;;AAGF,8BAAkB,UAAI;;AAGtB,wCAA4B,UAAI;;AAGhC,iCAAqB,UAAI","file":"v.lua","sourceRoot":"../src/"}

package/dist/features/customStage/versusScreen.js

@@ -0,0 +1,184 @@
+import { BossID, PlayerType, RoomType, SoundEffect, StageID, } from "isaac-typescript-definitions";
+import { game, sfxManager } from "../../cachedClasses";
+import { arrayRemove } from "../../functions/array";
+import { getBosses } from "../../functions/boss";
+import { getEntityID } from "../../functions/entity";
+import { erange } from "../../functions/utils";
+import { BOSS_NAME_PNG_FILE_NAMES } from "../../objects/bossNamePNGFileNames";
+import { BOSS_PORTRAIT_PNG_FILE_NAMES } from "../../objects/bossPortraitPNGFileNames";
+import { PLAYER_NAME_PNG_FILE_NAMES } from "../../objects/playerNamePNGFileNames";
+import { PLAYER_PORTRAIT_PNG_FILE_NAMES } from "../../objects/playerPortraitPNGFileNames";
+import { VERSUS_SCREEN_BACKGROUND_COLORS } from "../../objects/versusScreenBackgroundColors";
+import { VERSUS_SCREEN_DIRT_SPOT_COLORS } from "../../objects/versusScreenDirtSpotColors";
+import { pause, unpause } from "../pause";
+import { ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH } from "./customStageConstants";
+import v, { customBossPNGPaths } from "./v";
+const DEFAULT_CHARACTER = PlayerType.ISAAC;
+const DEFAULT_STAGE_ID = StageID.BASEMENT;
+const VERSUS_SCREEN_ANIMATION_NAME = "Scene";
+/** The layers range from 0 to 13. */
+const NUM_VERSUS_SCREEN_ANM2_LAYERS = 14;
+const BACKGROUND_ANM2_LAYER = 0;
+const BOSS_DIRT_SPOT_ANM2_LAYER = 2;
+const PLAYER_DIRT_SPOT_ANM2_LAYER = 3;
+const BOSS_PORTRAIT_ANM2_LAYER = 4;
+const PLAYER_PORTRAIT_ANM2_LAYER = 5;
+const PLAYER_NAME_ANM2_LAYER = 6;
+const BOSS_NAME_ANM2_LAYER = 7;
+const OVERLAY_ANM2_LAYER = 11;
+/**
+ * We only need to render either the normal player portrait layer or the alternate player portrait
+ * layer. Rendering both will cause the player not to shake.
+ */
+const PLAYER_PORTRAIT_ALT_ANM2_LAYER = 12;
+/** These are the non-special layers that we will render last. */
+const OTHER_ANM2_LAYERS = arrayRemove(erange(NUM_VERSUS_SCREEN_ANM2_LAYERS), BACKGROUND_ANM2_LAYER, BOSS_DIRT_SPOT_ANM2_LAYER, PLAYER_DIRT_SPOT_ANM2_LAYER, OVERLAY_ANM2_LAYER, PLAYER_PORTRAIT_ALT_ANM2_LAYER);
+/** Most of the PNG files related to the versus screen are located in this directory. */
+const PNG_PATH_PREFIX = "gfx/ui/boss";
+/**
+ * Player portraits are not located in the same directory as everything else, since they are re-used
+ * from the animation where the player travels to a new stage.
+ */
+const PLAYER_PORTRAIT_PNG_PATH_PREFIX = "gfx/ui/stage";
+const VANILLA_VERSUS_PLAYBACK_SPEED = 0.5;
+const versusScreenSprite = Sprite();
+versusScreenSprite.Load("gfx/ui/boss/versusscreen.anm2", false);
+// In vanilla, the "overlay.png" file has a white background. We must convert it to a PNG that uses
+// a transparent background in order for the background behind it to be visible. We use the same
+// "overlay.png" file as StageAPI uses for this purpose.
+versusScreenSprite.ReplaceSpritesheet(OVERLAY_ANM2_LAYER, `${ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH}/overlay.png`);
+versusScreenSprite.LoadGraphics();
+/**
+ * Unfortunately, we must split the background layer into an entirely different sprite so that we
+ * can color it with the `Color` property.
+ */
+const versusScreenBackgroundSprite = Sprite();
+versusScreenBackgroundSprite.Load("gfx/ui/boss/versusscreen.anm2", true);
+/**
+ * Unfortunately, we must split the dirt layer into an entirely different sprite so that we can
+ * color it with the `Color` property.
+ */
+const versusScreenDirtSpotSprite = Sprite();
+versusScreenDirtSpotSprite.Load("gfx/ui/boss/versusscreen.anm2", true);
+export function playVersusScreenAnimation(customStage, force = false) {
+    const room = game.GetRoom();
+    const roomType = room.GetType();
+    const hud = game.GetHUD();
+    if (roomType !== RoomType.BOSS && !force) {
+        return;
+    }
+    v.run.showingBossVersusScreen = true;
+    pause();
+    hud.SetVisible(false);
+    const [playerNamePNGPath, playerPortraitPNGPath] = getPlayerPNGPaths();
+    versusScreenSprite.ReplaceSpritesheet(PLAYER_NAME_ANM2_LAYER, playerNamePNGPath);
+    versusScreenSprite.ReplaceSpritesheet(PLAYER_PORTRAIT_ANM2_LAYER, playerPortraitPNGPath);
+    const [bossNamePNGPath, bossPortraitPNGPath] = getBossPNGPaths();
+    versusScreenSprite.ReplaceSpritesheet(BOSS_NAME_ANM2_LAYER, bossNamePNGPath);
+    versusScreenSprite.ReplaceSpritesheet(BOSS_PORTRAIT_ANM2_LAYER, bossPortraitPNGPath);
+    versusScreenSprite.LoadGraphics();
+    let backgroundColor = VERSUS_SCREEN_BACKGROUND_COLORS[DEFAULT_STAGE_ID];
+    if (customStage.versusScreen?.backgroundColor !== undefined) {
+        const { r, g, b, a } = customStage.versusScreen.backgroundColor;
+        backgroundColor = Color(r, g, b, a);
+    }
+    versusScreenBackgroundSprite.Color = backgroundColor;
+    let dirtSpotColor = VERSUS_SCREEN_DIRT_SPOT_COLORS[DEFAULT_STAGE_ID];
+    if (customStage.versusScreen?.dirtSpotColor !== undefined) {
+        const { r, g, b } = customStage.versusScreen.dirtSpotColor;
+        dirtSpotColor = Color(r, g, b);
+    }
+    versusScreenDirtSpotSprite.Color = dirtSpotColor;
+    for (const sprite of [
+        versusScreenBackgroundSprite,
+        versusScreenDirtSpotSprite,
+        versusScreenSprite,
+    ]) {
+        sprite.Play(VERSUS_SCREEN_ANIMATION_NAME, true);
+        sprite.PlaybackSpeed = VANILLA_VERSUS_PLAYBACK_SPEED;
+    }
+}
+/** Use the character of the 0th player. */
+function getPlayerPNGPaths() {
+    const player = Isaac.GetPlayer();
+    const character = player.GetPlayerType();
+    let playerNamePNGFileName = PLAYER_NAME_PNG_FILE_NAMES[character];
+    if (playerNamePNGFileName === undefined) {
+        playerNamePNGFileName = PLAYER_NAME_PNG_FILE_NAMES[DEFAULT_CHARACTER];
+    }
+    const playerNamePNGPath = `${PNG_PATH_PREFIX}/${playerNamePNGFileName}`;
+    let playerPortraitFileName = PLAYER_PORTRAIT_PNG_FILE_NAMES[character];
+    if (playerNamePNGFileName === undefined) {
+        playerPortraitFileName = PLAYER_PORTRAIT_PNG_FILE_NAMES[DEFAULT_CHARACTER];
+    }
+    const playerPortraitPNGPath = `${PLAYER_PORTRAIT_PNG_PATH_PREFIX}/${playerPortraitFileName}`;
+    return [playerNamePNGPath, playerPortraitPNGPath];
+}
+/** Use the boss of the first boss found. */
+function getBossPNGPaths() {
+    const bosses = getBosses();
+    const firstBoss = bosses[0];
+    // Prefer the PNG paths specified by the end-user, if any.
+    if (firstBoss !== undefined) {
+        const entityID = getEntityID(firstBoss);
+        const pngPaths = customBossPNGPaths.get(entityID);
+        if (pngPaths !== undefined) {
+            return pngPaths;
+        }
+    }
+    // If this is not a vanilla boss, default to showing question marks.
+    const bossID = firstBoss === undefined ? 0 : firstBoss.GetBossID();
+    if (bossID === 0) {
+        const questionMarkSprite = `${PNG_PATH_PREFIX}/${BOSS_NAME_PNG_FILE_NAMES[BossID.BLUE_BABY]}`;
+        const bossNamePNGPath = questionMarkSprite;
+        const bossPortraitPNGPath = questionMarkSprite;
+        return [bossNamePNGPath, bossPortraitPNGPath];
+    }
+    // If this is a vanilla boss, it will have a boss ID, and we can use the corresponding vanilla
+    // files.
+    const bossNamePNGFileName = BOSS_NAME_PNG_FILE_NAMES[bossID];
+    const bossNamePNGPath = `${PNG_PATH_PREFIX}/${bossNamePNGFileName}`;
+    const bossPortraitPNGFileName = BOSS_PORTRAIT_PNG_FILE_NAMES[bossID];
+    const bossPortraitPNGPath = `${PNG_PATH_PREFIX}/${bossPortraitPNGFileName}`;
+    return [bossNamePNGPath, bossPortraitPNGPath];
+}
+function finishVersusScreenAnimation() {
+    const hud = game.GetHUD();
+    v.run.showingBossVersusScreen = false;
+    unpause();
+    hud.SetVisible(true);
+    // The sound effect only plays once the versus cutscene is over.
+    sfxManager.Play(SoundEffect.CASTLE_PORTCULLIS);
+}
+// ModCallback.POST_RENDER (2)
+export function versusScreenPostRender() {
+    if (!v.run.showingBossVersusScreen) {
+        return;
+    }
+    const isPaused = game.IsPaused();
+    if (isPaused) {
+        return;
+    }
+    if (versusScreenSprite.IsFinished(VERSUS_SCREEN_ANIMATION_NAME)) {
+        finishVersusScreenAnimation();
+        return;
+    }
+    const room = game.GetRoom();
+    const centerPos = room.GetCenterPos();
+    const position = Isaac.WorldToRenderPosition(centerPos);
+    // First, we render the background.
+    versusScreenBackgroundSprite.RenderLayer(BACKGROUND_ANM2_LAYER, position);
+    versusScreenBackgroundSprite.Update();
+    // Second, we render the overlay.
+    versusScreenSprite.RenderLayer(OVERLAY_ANM2_LAYER, position);
+    // Third, we render the dirt.
+    versusScreenDirtSpotSprite.RenderLayer(BOSS_DIRT_SPOT_ANM2_LAYER, position);
+    versusScreenDirtSpotSprite.RenderLayer(PLAYER_DIRT_SPOT_ANM2_LAYER, position);
+    versusScreenDirtSpotSprite.Update();
+    // Lastly, we render everything else.
+    for (const layerID of OTHER_ANM2_LAYERS) {
+        versusScreenSprite.RenderLayer(layerID, position);
+    }
+    versusScreenSprite.Update();
+}
+//# sourceMappingURL=versusScreen.js.map

package/dist/features/customStage/versusScreen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"versusScreen.js","sourceRoot":"../src/","sources":["features/customStage/versusScreen.ts"],"names":[],"mappings":"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"}

package/dist/features/customStage/versusScreen.lua.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../packages/isaacscript-common/src/features/customStage/versusScreen.ts"],"names":[],"mappings":"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","file":"versusScreen.lua","sourceRoot":"../src/"}