isaacscript-common 6.4.0 → 6.6.0

package/interfaces/CustomStageLua.d.ts

@@ -9,119 +9,303 @@
  *
  * The `CustomStageLua` interface extends this, adding room metadata.
  */
-export interface CustomStageTSConfig {
+export declare type CustomStageTSConfig = Readonly<{
     /** The name of the custom stage. Mandatory. */
-    readonly name: string;
+    name: string;
     /**
      * Path to the XML file that contains the rooms for the custom stage (created with Basement
      * Renovator). Mandatory.
      */
-    readonly xmlPath: string;
+    xmlPath: string;
     /** An arbitrarily chosen prefix in the range of 101-999. Mandatory. */
-    readonly roomVariantPrefix: number;
+    roomVariantPrefix: number;
     /**
      * An integer between 2 and 13, corresponding to the `LevelStage` enum. This is the number of the
      * stage that will be warped to and used as a basis for the stage by the level generation
      * algorithm. Mandatory.
      *
-     * (It is not possible to use Basement 1 as a base due to conflicts with the `Game.SetStage`
+     * (It is not possible to use Basement 1 as a base stage due to conflicts with the `Game.SetStage`
      * method.)
      */
-    readonly baseStage: number;
+    baseStage: number;
     /**
      * An integer between 0 and 5, corresponding to the `StageType` enum. This is the number of the
      * stage type that will be warped to and used as a basis for the stage by the level generation
      * algorithm. Mandatory.
      */
-    readonly baseStageType: number;
+    baseStageType: number;
     /**
-     * An object containing the paths to the backdrop for the stage. (A backdrop is the graphics for
-     * the walls and floor.) Mandatory.
+     * Optional. An object containing the paths to the backdrop graphics for the stage. (A backdrop is
+     * the graphics for the walls and floor.) If not specified, the graphics for Basement will be
+     * used.
      */
-    readonly backdrop: CustomStageBackdrop;
+    backdropPNGPaths?: Readonly<{
+        /**
+         * An array that contains the full paths to the graphic files that are used for the floor in
+         * narrow rooms. (The "n" stands for "narrow").
+         *
+         * You must have at least one path in this array, but you can specify more than one to randomly
+         * add extra variety (like the vanilla stages do).
+         *
+         * For an example of this, see the vanilla file "resources/gfx/backdrop/01_basement_nfloor.png".
+         */
+        nFloors: readonly string[];
+        /**
+         * An array that contains the full paths to the graphic files that are used for the floor in L
+         * rooms.
+         *
+         * You must have at least one path in this array, but you can specify more than one to randomly
+         * add extra variety (like the vanilla stages do).
+         *
+         * For an example of this, see the vanilla file "resources/gfx/backdrop/01_lbasementfloor.png".
+         */
+        lFloors: readonly string[];
+        /**
+         * An array that contains the full paths to the graphic files that are used for the walls of the
+         * floor.
+         *
+         * You must have at least one path in this array, but you can specify more than one to randomly
+         * add extra variety (like the vanilla stages do).
+         *
+         * For an example of this, see the vanilla file "resources/gfx/backdrop/01_basement.png". (In
+         * the vanilla file, they concatenate all four variations together into one PNG file. However,
+         * for the custom stages feature, you must separate each wall variation into a separate file.)
+         */
+        walls: readonly string[];
+        /**
+         * An array that contains the full paths to the graphic files for the stage's corners.
+         *
+         * You must have at least one path in this array, but you can specify more than one to randomly
+         * add extra variety (like the vanilla stages do).
+         *
+         * For an example of this, see the vanilla file "resources/gfx/backdrop/01_basement.png". (In
+         * the vanilla file, they concatenate both variations together into one PNG file and put it in
+         * the top right hand corner. The corners are shown in the top right hand corner of the file,
+         * with two different variations concatenated together. However, for the custom stages feature,
+         * you must separate each corner variation into a separate file (and put it in a different file
+         * from the walls).
+         */
+        corners: readonly string[];
+    }>;
     /**
-     * Optional. An object representing the color to use for the background of the boss "versus"
-     * screen. If not specified, the color for Basement 1 will be used.
+     * Optional. The full path to the spritesheet that contains the graphics of the decorations for
+     * the floor.
      *
-     * For a list of the colors that correspond to the vanilla stages, see
-     * `versusScreenBackgroundColors.ts`.
+     * If not specified, the vanilla Basement decorations spritesheet will be used. For reference,
+     * this is located at: `C:\Program Files (x86)\Steam\steamapps\common\The Binding of Isaac
+     * Rebirth\resources\gfx\grid\props_01_basement.png`
      */
-    readonly versusScreenBackgroundColor?: {
-        r: number;
-        g: number;
-        b: number;
-    };
+    decorationsPNGPath?: string;
     /**
-     * Optional. An object representing the color to use for the dirt spots in the boss "versus"
-     * screen. (There are two dirt spots; one for the player and one for the boss.) If not specified,
-     * the color for Basement 1 will be used.
+     * Optional. The full path to the spritesheet that contains the graphics of the rocks/blocks/urns
+     * for the floor.
      *
-     * For a list of the colors that correspond to the vanilla stages, see
-     * `versusScreenDirtSpotColors.ts`.
-     */
-    readonly versusScreenDirtSpotColor?: {
-        r: number;
-        g: number;
-        b: number;
-    };
-}
-interface CustomStageBackdrop {
-    /**
-     * The beginning of the path that leads to the backdrop graphics. For example:
+     * If specified, it is assumed that you have your own custom rock alt type, and all vanilla
+     * rewards/enemies that spawn from urns will be automatically removed. Use the
+     * `POST_GRID_ENTITY_BROKEN` callback to make your own custom rewards. Or, if you want to emulate
+     * a vanilla urn/mushroom/skull/polyp/bucket, use the `spawnRockAltReward` helper function.
      *
-     * ```sh
-     * gfx/backdrop/revelations/revelations_
-     * ```
-     */
-    prefix: string;
-    /**
-     * The end of the path that leads to the backdrop graphics. In most cases, this will be ".png".
+     * If not specified, the vanilla Basement rocks spritesheet will be used. For reference, this is
+     * located at: `C:\Program Files (x86)\Steam\steamapps\common\The Binding of Isaac
+     * Rebirth\resources-dlc3\gfx\grid\rocks_basement.png`
      */
-    suffix: string;
+    rocksPNGPath?: string;
     /**
-     * An array of strings that represent the graphic files that are used for the floors in narrow
-     * rooms. (The "n" stands for "narrow").
-     *
-     * You must have at least one string in this array, but you can specify more than one to randomly
-     * add extra variety (like the vanilla stages do).
+     * Optional. The full path to the spritesheet that contains the graphics of the pits for the
+     * floor.
      *
-     * For an example of this, see the vanilla file "resources/gfx/backdrop/01_basement_nfloor.png".
+     * If not specified, the vanilla Basement pits spritesheet will be used. For reference, this is
+     * located at: `C:\Program Files (x86)\Steam\steamapps\common\The Binding of Isaac
+     * Rebirth\resources\gfx\grid\grid_pit.png`
      */
-    nFloors: string[];
+    pitsPNGPath?: string;
     /**
-     * An array of strings that represent the graphic files that are used for the floors in L rooms.
-     *
-     * You must have at least one string in this array, but you can specify more than one to randomly
-     * add extra variety (like the vanilla stages do).
-     *
-     * For an example of this, see the vanilla file "resources/gfx/backdrop/01_lbasementfloor.png".
+     * Optional. A collection of paths that contain graphics for the doors of the floor. If not
+     * specified, the doors for Basement will be used.
      */
-    lFloors: string[];
+    doorPNGPaths?: Readonly<{
+        /**
+         * Optional. The full path to the spritesheet that contains the graphics of the normal doors for
+         * the floor.
+         *
+         * If not specified, the vanilla Basement door spritesheet will be used. For reference, this is
+         * located at: `C:\Program Files (x86)\Steam\steamapps\common\The Binding of Isaac
+         * Rebirth\resources\gfx\grid\door_01_normaldoor.png`
+         */
+        normal?: string;
+        /**
+         * Optional. The full path to the spritesheet that contains the graphics of the Treasure Room
+         * doors for the floor.
+         *
+         * If not specified, the vanilla Basement door spritesheet will be used. For reference, this is
+         * located at: `C:\Program Files (x86)\Steam\steamapps\common\The Binding of Isaac
+         * Rebirth\resources\gfx\grid\door_02_treasureroomdoor.png`
+         */
+        treasureRoom?: string;
+        /**
+         * Optional. The full path to the spritesheet that contains the graphics of the Boss Room doors
+         * for the floor.
+         *
+         * If not specified, the vanilla Basement door spritesheet will be used. For reference, this is
+         * located at: `C:\Program Files (x86)\Steam\steamapps\common\The Binding of Isaac
+         * Rebirth\resources\gfx\grid\door_10_bossroomdoor.png`
+         */
+        bossRoom?: string;
+        /**
+         * Optional. The full path to the spritesheet that contains the graphics of the Secret Room and
+         * Super Secret Room doors for the floor.
+         *
+         * If not specified, the vanilla Basement door spritesheet will be used. For reference, this is
+         * located at: `C:\Program Files (x86)\Steam\steamapps\common\The Binding of Isaac
+         * Rebirth\resources\gfx\grid\door_08_holeinwall.png`
+         */
+        secretRoom?: string;
+        /**
+         * Optional. The full path to the spritesheet that contains the graphics of the arcade doors for
+         * the floor.
+         *
+         * If not specified, the vanilla Basement door spritesheet will be used. For reference, this is
+         * located at: `C:\Program Files (x86)\Steam\steamapps\common\The Binding of Isaac
+         * Rebirth\resources\gfx\grid\door_05_arcaderoomdoor.png`
+         */
+        arcade?: string;
+        /**
+         * Optional. The full path to the spritesheet that contains the graphics of the Curse Room doors
+         * for the floor.
+         *
+         * If not specified, the vanilla Basement door spritesheet will be used. For reference, this is
+         * located at: `C:\Program Files (x86)\Steam\steamapps\common\The Binding of Isaac
+         * Rebirth\resources\gfx\grid\door_04_selfsacrificeroomdoor.png`
+         */
+        curseRoom?: string;
+        /**
+         * Optional. The full path to the spritesheet that contains the graphics of the normal Challenge
+         * Room doors for the floor.
+         *
+         * If not specified, the vanilla Basement door spritesheet will be used. For reference, this is
+         * located at: `C:\Program Files (x86)\Steam\steamapps\common\The Binding of Isaac
+         * Rebirth\resources\gfx\grid\door_03_ambushroomdoor.png`
+         */
+        normalChallengeRoom?: string;
+        /**
+         * Optional. The full path to the spritesheet that contains the graphics of the Boss Challenge
+         * Room doors for the floor.
+         *
+         * If not specified, the vanilla Basement door spritesheet will be used. For reference, this is
+         * located at: `C:\Program Files (x86)\Steam\steamapps\common\The Binding of Isaac
+         * Rebirth\resources\gfx\grid\door_09_bossambushroomdoor.png`
+         */
+        bossChallengeRoom?: string;
+        /**
+         * Optional. The full path to the spritesheet that contains the graphics of the Devil Room doors
+         * for the floor.
+         *
+         * If not specified, the vanilla Basement door spritesheet will be used. For reference, this is
+         * located at: `C:\Program Files (x86)\Steam\steamapps\common\The Binding of Isaac
+         * Rebirth\resources\gfx\grid\door_07_devilroomdoor.png`
+         */
+        devilRoom?: string;
+        /**
+         * Optional. The full path to the spritesheet that contains the graphics of the Angel Room doors
+         * for the floor.
+         *
+         * If not specified, the vanilla Basement door spritesheet will be used. For reference, this is
+         * located at: `C:\Program Files (x86)\Steam\steamapps\common\The Binding of Isaac
+         * Rebirth\resources\gfx\grid\door_07_holyroomdoor.png`
+         */
+        angelRoom?: string;
+        /**
+         * Optional. The full path to the spritesheet that contains the graphics of the Boss Rush doors
+         * for the floor.
+         *
+         * If not specified, the vanilla Basement door spritesheet will be used. For reference, this is
+         * located at: `C:\Program Files (x86)\Steam\steamapps\common\The Binding of Isaac
+         * Rebirth\resources\gfx\grid\door_15_bossrushdoor.png`
+         */
+        bossRush?: string;
+        /**
+         * Optional. The full path to the spritesheet that contains the graphics of the Chest Room doors
+         * for the floor.
+         *
+         * If not specified, the vanilla Basement door spritesheet will be used. For reference, this is
+         * located at: `C:\Program Files (x86)\Steam\steamapps\common\The Binding of Isaac
+         * Rebirth\resources\gfx\grid\door_02b_chestroomdoor.png`
+         */
+        chestRoom?: string;
+    }>;
     /**
-     * An array of strings that represent the graphic files for the stage's walls.
-     *
-     * You must have at least one string in this array, but you can specify more than one to randomly
-     * add extra variety (like the vanilla stages do).
-     *
-     * For an example of this, see the vanilla file "resources/gfx/backdrop/01_basement.png". (In the
-     * vanilla file, they concatenate all four variations together into one PNG file. However, for the
-     * custom stages feature, you must separate each wall variation into a separate file.)
+     * Optional. A collection of paths that contain graphics for the custom shadows of the floor. (In
+     * this context, "shadows" are the outlines from things on the roof. For example, in Basement, a
+     * shadow of a sideways V is used.) If not specified, no extra shadows will be drawn.
      */
-    walls: string[];
-    /**
-     * An array of strings that represent the graphic files for the stage's corners. You must have at
-     * least one string in this array, but you can specify more than one to randomly add extra variety
-     * (like the vanilla stages do).
-     *
-     * For an example of this, see the vanilla file "resources/gfx/backdrop/01_basement.png". (In the
-     * vanilla file, they concatenate both variations together into one PNG file and put it in the top
-     * right hand corner. The corners are shown in the top right hand corner of the file, with two
-     * different variations concatenated together. However, for the custom stages feature, you must
-     * separate each corner variation into a separate file (and put it in a different file from the
-     * walls).
-     */
-    corners: string[];
-}
+    shadowPNGPaths?: Readonly<{
+        /**
+         * An array containing the full paths to the shadows that are used in rooms of shape
+         * `RoomShape.SHAPE_1x1` (1), `RoomShape.IH` (2), and `RoomShape.IV` (3).
+         *
+         * If more than one shadow is specified, one will be randomly chosen for each room.
+         *
+         * If not specified, no extra shadows will be drawn in these room shapes.
+         */
+        "1x1"?: readonly string[];
+        /**
+         * An array containing the full paths to the shadows that are used in rooms of shape
+         * `RoomShape.SHAPE_1x2` (4) and `RoomShape.IIV` (5).
+         *
+         * If more than one shadow is specified, one will be randomly chosen for each room.
+         *
+         * If not specified, no extra shadows will be drawn in these room shapes.
+         */
+        "1x2"?: readonly string[];
+        /**
+         * An array containing the full paths to the shadows that are used in rooms of shape
+         * `RoomShape.SHAPE_2x1` (6) and `RoomShape.IIH` (7).
+         *
+         * If more than one shadow is specified, one will be randomly chosen for each room.
+         *
+         * If not specified, no extra shadows will be drawn in these room shapes.
+         */
+        "2x1"?: readonly string[];
+        /**
+         * An array containing the full paths to the shadows that are used in rooms of shape
+         * `RoomShape.SHAPE_2x2` (8), `RoomShape.LTL` (9), `RoomShape.LTR` (10), `RoomShape.LBL` (11),
+         * and `RoomShape.LBR` (12).
+         *
+         * If more than one shadow is specified, one will be randomly chosen for each room.
+         *
+         * If not specified, no extra shadows will be drawn in these room shapes.
+         */
+        "2x2"?: readonly string[];
+    }>;
+    /** Optional. A collection of colors used in the boss "versus" screen. */
+    versusScreen?: Readonly<{
+        /**
+         * Optional. An object representing the color to use for the background of the boss "versus"
+         * screen. If not specified, the color for Basement 1 will be used.
+         *
+         * For a list of the colors that correspond to the vanilla stages, see
+         * `versusScreenBackgroundColors.ts`.
+         */
+        backgroundColor?: Readonly<{
+            r: number;
+            g: number;
+            b: number;
+        }>;
+        /**
+         * Optional. An object representing the color to use for the dirt spots in the boss "versus"
+         * screen. (There are two dirt spots; one for the player and one for the boss.) If not
+         * specified, the color for Basement 1 will be used.
+         *
+         * For a list of the colors that correspond to the vanilla stages, see
+         * `versusScreenDirtSpotColors.ts`.
+         */
+        dirtSpotColor?: Readonly<{
+            r: number;
+            g: number;
+            b: number;
+        }>;
+    }>;
+}>;
 /**
  * An object that represents a custom stage. The "metadata.lua" file contains an array of these
  * objects. Besides the room metadata, the data is the same as what is specified inside the
@@ -136,12 +320,11 @@ export interface CustomStageLua extends CustomStageTSConfig {
  * Metadata about a custom stage room. Each custom stage object contains an array with metadata for
  * each room.
  */
-export interface CustomStageRoomMetadata {
-    readonly type: number;
-    readonly variant: number;
-    readonly subType: number;
-    readonly shape: number;
-    readonly doorSlotFlags: number;
-    readonly weight: number;
-}
-export {};
+export declare type CustomStageRoomMetadata = Readonly<{
+    type: number;
+    variant: number;
+    subType: number;
+    shape: number;
+    doorSlotFlags: number;
+    weight: number;
+}>;

package/objects/backdropTypeToRockAltType.d.ts

@@ -0,0 +1,6 @@
+import { BackdropType } from "isaac-typescript-definitions";
+import { RockAltType } from "../enums/RockAltType";
+/** Used by the `getRockAltType` function. */
+export declare const BACKDROP_TYPE_TO_ROCK_ALT_TYPE: {
+    readonly [key in BackdropType]: RockAltType;
+};

package/objects/backdropTypeToRockAltType.lua

@@ -0,0 +1,69 @@
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local BackdropType = ____isaac_2Dtypescript_2Ddefinitions.BackdropType
+local ____RockAltType = require("enums.RockAltType")
+local RockAltType = ____RockAltType.RockAltType
+--- Used by the `getRockAltType` function.
+____exports.BACKDROP_TYPE_TO_ROCK_ALT_TYPE = {
+    [BackdropType.BASEMENT] = RockAltType.URN,
+    [BackdropType.CELLAR] = RockAltType.URN,
+    [BackdropType.BURNT_BASEMENT] = RockAltType.URN,
+    [BackdropType.CAVES] = RockAltType.MUSHROOM,
+    [BackdropType.CATACOMBS] = RockAltType.MUSHROOM,
+    [BackdropType.FLOODED_CAVES] = RockAltType.MUSHROOM,
+    [BackdropType.DEPTHS] = RockAltType.SKULL,
+    [BackdropType.NECROPOLIS] = RockAltType.SKULL,
+    [BackdropType.DANK_DEPTHS] = RockAltType.SKULL,
+    [BackdropType.WOMB] = RockAltType.POLYP,
+    [BackdropType.UTERO] = RockAltType.POLYP,
+    [BackdropType.SCARRED_WOMB] = RockAltType.POLYP,
+    [BackdropType.BLUE_WOMB] = RockAltType.POLYP,
+    [BackdropType.SHEOL] = RockAltType.SKULL,
+    [BackdropType.CATHEDRAL] = RockAltType.URN,
+    [BackdropType.DARK_ROOM] = RockAltType.SKULL,
+    [BackdropType.CHEST] = RockAltType.URN,
+    [BackdropType.MEGA_SATAN] = RockAltType.URN,
+    [BackdropType.LIBRARY] = RockAltType.URN,
+    [BackdropType.SHOP] = RockAltType.URN,
+    [BackdropType.CLEAN_BEDROOM] = RockAltType.URN,
+    [BackdropType.DIRTY_BEDROOM] = RockAltType.URN,
+    [BackdropType.SECRET] = RockAltType.MUSHROOM,
+    [BackdropType.DICE] = RockAltType.URN,
+    [BackdropType.ARCADE] = RockAltType.URN,
+    [BackdropType.ERROR_ROOM] = RockAltType.URN,
+    [BackdropType.BLUE_WOMB_PASS] = RockAltType.POLYP,
+    [BackdropType.GREED_SHOP] = RockAltType.URN,
+    [BackdropType.DUNGEON] = RockAltType.URN,
+    [BackdropType.SACRIFICE] = RockAltType.SKULL,
+    [BackdropType.DOWNPOUR] = RockAltType.BUCKET,
+    [BackdropType.MINES] = RockAltType.MUSHROOM,
+    [BackdropType.MAUSOLEUM] = RockAltType.SKULL,
+    [BackdropType.CORPSE] = RockAltType.POLYP,
+    [BackdropType.PLANETARIUM] = RockAltType.URN,
+    [BackdropType.DOWNPOUR_ENTRANCE] = RockAltType.BUCKET,
+    [BackdropType.MINES_ENTRANCE] = RockAltType.MUSHROOM,
+    [BackdropType.MAUSOLEUM_ENTRANCE] = RockAltType.SKULL,
+    [BackdropType.CORPSE_ENTRANCE] = RockAltType.SKULL,
+    [BackdropType.MAUSOLEUM_2] = RockAltType.SKULL,
+    [BackdropType.MAUSOLEUM_3] = RockAltType.SKULL,
+    [BackdropType.MAUSOLEUM_4] = RockAltType.SKULL,
+    [BackdropType.CORPSE_2] = RockAltType.POLYP,
+    [BackdropType.CORPSE_3] = RockAltType.POLYP,
+    [BackdropType.DROSS] = RockAltType.BUCKET,
+    [BackdropType.ASHPIT] = RockAltType.MUSHROOM,
+    [BackdropType.GEHENNA] = RockAltType.SKULL,
+    [BackdropType.MORTIS] = RockAltType.POLYP,
+    [BackdropType.ISAACS_BEDROOM] = RockAltType.URN,
+    [BackdropType.HALLWAY] = RockAltType.URN,
+    [BackdropType.MOMS_BEDROOM] = RockAltType.URN,
+    [BackdropType.CLOSET] = RockAltType.URN,
+    [BackdropType.CLOSET_B] = RockAltType.URN,
+    [BackdropType.DOGMA] = RockAltType.URN,
+    [BackdropType.DUNGEON_GIDEON] = RockAltType.URN,
+    [BackdropType.DUNGEON_ROTGUT] = RockAltType.URN,
+    [BackdropType.DUNGEON_BEAST] = RockAltType.URN,
+    [BackdropType.MINES_SHAFT] = RockAltType.MUSHROOM,
+    [BackdropType.ASHPIT_SHAFT] = RockAltType.MUSHROOM,
+    [BackdropType.DARK_CLOSET] = RockAltType.SKULL
+}
+return ____exports

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "6.4.0",
+  "version": "6.6.0",
   "description": "Helper functions and features for IsaacScript mods.",
   "keywords": [
     "isaac",
@@ -22,6 +22,6 @@
   "main": "index",
   "types": "index.d.ts",
   "dependencies": {
-    "isaac-typescript-definitions": "^3.0.22"
+    "isaac-typescript-definitions": "^3.0.24"
   }
 }

package/shaderCrashFix.d.ts

@@ -0,0 +1,7 @@
+/// <reference types="isaac-typescript-definitions" />
+/**
+ * Using the "luamod" console command with a mod that has custom shaders can crash the game. A
+ * simple fix for this is automatically applied to any upgraded mods. This method was originally
+ * discovered by AgentCucco.
+ */
+export declare function loadShaderCrashFix(mod: Mod): void;

package/shaderCrashFix.lua

@@ -0,0 +1,18 @@
+local ____exports = {}
+local postPlayerInit
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local EntityType = ____isaac_2Dtypescript_2Ddefinitions.EntityType
+local ModCallback = ____isaac_2Dtypescript_2Ddefinitions.ModCallback
+function postPlayerInit(self)
+    local players = Isaac.FindByType(EntityType.PLAYER)
+    if #players == 0 then
+        Isaac.ExecuteCommand("reloadshaders")
+    end
+end
+--- Using the "luamod" console command with a mod that has custom shaders can crash the game. A
+-- simple fix for this is automatically applied to any upgraded mods. This method was originally
+-- discovered by AgentCucco.
+function ____exports.loadShaderCrashFix(self, mod)
+    mod:AddCallback(ModCallback.POST_PLAYER_INIT, postPlayerInit)
+end
+return ____exports

package/upgradeMod.lua

@@ -17,6 +17,8 @@ local initFeaturesMajor = ____initFeatures.initFeaturesMajor
 local initFeaturesMinor = ____initFeatures.initFeaturesMinor
 local ____patchErrorFunctions = require("patchErrorFunctions")
 local patchErrorFunction = ____patchErrorFunctions.patchErrorFunction
+local ____shaderCrashFix = require("shaderCrashFix")
+local loadShaderCrashFix = ____shaderCrashFix.loadShaderCrashFix
 --- Use this function to enable the custom callbacks and other optional features provided by
 -- `isaacscript-common`.
 -- 
@@ -36,10 +38,11 @@ local patchErrorFunction = ____patchErrorFunctions.patchErrorFunction
 -- @param modVanilla The mod object returned by the `RegisterMod` function.
 -- @returns The upgraded mod object.
 function ____exports.upgradeMod(self, modVanilla)
-    patchErrorFunction(nil)
     local mod = __TS__New(ModUpgraded, modVanilla)
     if not areFeaturesInitialized(nil) then
         setFeaturesInitialized(nil)
+        patchErrorFunction(nil)
+        loadShaderCrashFix(nil, modVanilla)
         postNewRoomEarlyCallbackInit(nil, mod)
         saveDataManagerInit(nil, mod)
         initCustomCallbacks(nil, mod)