isaacscript-common 1.2.198 → 1.2.201

package/dist/callbacks/customRevive.lua

@@ -15,6 +15,7 @@ local ____familiars = require("functions.familiars")
 local removeAllFamiliars = ____familiars.removeAllFamiliars
 local ____log = require("functions.log")
 local log = ____log.log
+local logError = ____log.logError
 local ____playerIndex = require("functions.playerIndex")
 local getPlayerFromIndex = ____playerIndex.getPlayerFromIndex
 local getPlayerIndex = ____playerIndex.getPlayerIndex
@@ -97,25 +98,19 @@ function playerIsAboutToDie(self, player)
     player:AddCollectible(CollectibleType.COLLECTIBLE_1UP, 0, false)
     removeAllFamiliars(nil, FamiliarVariant.ONE_UP)
     removeCollectibleFromItemTracker(nil, CollectibleType.COLLECTIBLE_1UP)
-    local character = player:GetPlayerType()
-    if character ~= PlayerType.PLAYER_SAMSON_B then
-        return
-    end
     local playerIndex = getPlayerIndex(nil, player)
     runNextGameFrame(
         nil,
         function()
-            local taintedSamson = getPlayerFromIndex(nil, playerIndex)
-            if taintedSamson == nil then
+            local futurePlayer = getPlayerFromIndex(nil, playerIndex)
+            if futurePlayer == nil then
                 return
             end
-            local effects = player:GetEffects()
-            local isBerserk = effects:HasCollectibleEffect(CollectibleType.COLLECTIBLE_BERSERK)
-            if not isBerserk then
+            if futurePlayer:IsDead() then
                 return
             end
-            effects:RemoveCollectibleEffect(CollectibleType.COLLECTIBLE_BERSERK, -1)
-            removeAllFamiliars(nil, FamiliarVariant.ONE_UP)
+            logError("The player is still alive after initializing a custom revive. Explicitly killing the player.")
+            futurePlayer:Kill()
         end
     )
 end

package/dist/callbacks/postNewRoomEarly.lua

@@ -7,7 +7,7 @@ local ____gridEntity = require("functions.gridEntity")
 local getTopLeftWallGridIndex = ____gridEntity.getTopLeftWallGridIndex
 local spawnGridEntity = ____gridEntity.spawnGridEntity
 local ____log = require("functions.log")
-local log = ____log.log
+local logError = ____log.logError
 local ____postNewRoomEarly = require("callbacks.subscriptions.postNewRoomEarly")
 local postNewRoomEarlyFire = ____postNewRoomEarly.postNewRoomEarlyFire
 local postNewRoomEarlyHasSubscriptions = ____postNewRoomEarly.postNewRoomEarlyHasSubscriptions
@@ -35,18 +35,16 @@ function checkRoomChanged(self)
     if topLeftWall == nil then
         topLeftWall = spawnGridEntity(nil, GridEntityType.GRID_WALL, topLeftWallGridIndex)
         if topLeftWall == nil then
-            log("Error: Failed to spawn a new wall (1) for the PostNewRoomEarly callback.")
+            logError("Failed to spawn a new wall (1) for the PostNewRoomEarly callback.")
             return
         end
-        log("Spawned a new wall (1) for the PostNewRoomEarly callback.")
     end
     if topLeftWall2 == nil then
         topLeftWall2 = spawnGridEntity(nil, GridEntityType.GRID_WALL, rightOfTopWallGridIndex)
         if topLeftWall2 == nil then
-            log("Error: Failed to spawn a new wall (2) for the PostNewRoomEarly callback.")
+            logError("Failed to spawn a new wall (2) for the PostNewRoomEarly callback.")
             return
         end
-        log("Spawned a new wall (2) for the PostNewRoomEarly callback.")
     end
     local topLeftWallPtrHash = GetPtrHash(topLeftWall)
     local topLeftWallPtrHash2 = GetPtrHash(topLeftWall2)

package/dist/constants.d.ts

@@ -69,6 +69,8 @@ export declare const MAX_ROOM_INDEX = 168;
  * effect.
  */
 export declare const MAX_SPEED_STAT = 2;
+/** Corresponds to the maximum value for `EntityPlayer.SamsonBerserkCharge`. */
+export declare const MAX_TAINTED_SAMSON_BERSERK_CHARGE = 100000;
 export declare const MAX_VANILLA_CHARACTER: number;
 export declare const MAX_VANILLA_COLLECTIBLE_TYPE: number;
 export declare const NUM_DIMENSIONS = 3;
@@ -89,6 +91,8 @@ export declare const PILL_COLOR_MASK = 2047;
  * 1 << 11
  */
 export declare const PILL_GIANT_FLAG = 2048;
+/** After taking damage, `EntityPlayer.SamsonBerserkCharge` is incremented by this amount. */
+export declare const TAINTED_SAMSON_BERSERK_CHARGE_FROM_TAKING_DAMAGE = 10000;
 /**
  * Add this to a `TrinketType` to get the corresponding golden trinket type.
  *

package/dist/constants.lua

@@ -22,6 +22,7 @@ ____exports.MAX_PLAYER_SPEED_IN_UNITS = 9.8
 ____exports.MAX_PLAYER_TRINKET_SLOTS = 2
 ____exports.MAX_ROOM_INDEX = 168
 ____exports.MAX_SPEED_STAT = 2
+____exports.MAX_TAINTED_SAMSON_BERSERK_CHARGE = 100000
 ____exports.MAX_VANILLA_CHARACTER = PlayerType.NUM_PLAYER_TYPES - 1
 ____exports.MAX_VANILLA_COLLECTIBLE_TYPE = CollectibleType.NUM_COLLECTIBLES - 1
 ____exports.NUM_DIMENSIONS = 3
@@ -30,6 +31,7 @@ ____exports.MINUTE_IN_MILLISECONDS = 60 * ____exports.SECOND_IN_MILLISECONDS
 ____exports.ONE_BY_ONE_ROOM_GRID_SIZE = 135
 ____exports.PILL_COLOR_MASK = 2047
 ____exports.PILL_GIANT_FLAG = 2048
+____exports.TAINTED_SAMSON_BERSERK_CHARGE_FROM_TAKING_DAMAGE = 10000
 ____exports.TRINKET_GOLDEN_FLAG = 32768
 ____exports.TRINKET_ID_MASK = 32767
 ____exports.UI_HEART_WIDTH = 12

package/dist/features/deployJSONRoom.d.ts

@@ -15,7 +15,7 @@ import { JSONRoom } from "../types/JSONRoom";
  * deployJSONRoom(firstJSONRoom);
  * ```
  * @param seed Optional. Specifies the seed that will be used for spawning every entity in the room.
- * Default is `Random()`.
+ * Default is `getRandomSeed()`.
  * @param verbose Optional. If specified, will write entries to the "log.txt" file that describe
  * what the function is doing. Default is false.
  * @returns Before using the seed for spawning each entity, it is iterated with `nextSeed`. The
@@ -43,7 +43,7 @@ export declare function deployJSONRoom(jsonRoom: JSONRoom, seed?: Seed, verbose?
  * deployRandomJSONRoom(jsonRooms);
  * ```
  * @param seed Optional. Specifies the seed that will be used for determining the random room. After
- * that, it is also used for spawning every entity in the room. Default is `Random()`.
+ * that, it is also used for spawning every entity in the room. Default is `getRandomSeed()`.
  * @param verbose Optional. If specified, will write entries to the "log.txt" file that describe
  * what the function is doing. Default is false.
  * @returns Before using the seed for spawning each entity, it is iterated with `nextSeed`. The

package/dist/features/deployJSONRoom.lua

@@ -33,6 +33,7 @@ local getNPCs = ____npc.getNPCs
 local ____pickups = require("functions.pickups")
 local removeAllPickups = ____pickups.removeAllPickups
 local ____random = require("functions.random")
+local getRandomSeed = ____random.getRandomSeed
 local nextSeed = ____random.nextSeed
 local ____roomData = require("functions.roomData")
 local getRoomListIndex = ____roomData.getRoomListIndex
@@ -405,7 +406,7 @@ function ____exports.deployJSONRoomInit(self, mod)
 end
 function ____exports.deployJSONRoom(self, jsonRoom, seed, verbose)
     if seed == nil then
-        seed = Random()
+        seed = getRandomSeed(nil)
     end
     if verbose == nil then
         verbose = false
@@ -431,7 +432,7 @@ function ____exports.deployJSONRoom(self, jsonRoom, seed, verbose)
 end
 function ____exports.deployRandomJSONRoom(self, jsonRooms, seed, verbose)
     if seed == nil then
-        seed = Random()
+        seed = getRandomSeed(nil)
     end
     if verbose == nil then
         verbose = false

package/dist/features/saveDataManager/load.lua

@@ -6,6 +6,7 @@ local ____jsonHelpers = require("functions.jsonHelpers")
 local jsonDecode = ____jsonHelpers.jsonDecode
 local ____log = require("functions.log")
 local log = ____log.log
+local logError = ____log.logError
 local ____constants = require("features.saveDataManager.constants")
 local SAVE_DATA_MANAGER_DEBUG = ____constants.SAVE_DATA_MANAGER_DEBUG
 local SAVE_DATA_MANAGER_FEATURE_NAME = ____constants.SAVE_DATA_MANAGER_FEATURE_NAME
@@ -15,7 +16,7 @@ function readSaveDatFile(self, mod)
     local renderFrameCount = Isaac.GetFrameCount()
     local ok, jsonStringOrErrMsg = pcall(tryLoadModData, mod)
     if not ok then
-        log((("Error: Failed to read from the \"save#.dat\" file on render frame " .. tostring(renderFrameCount)) .. ": ") .. jsonStringOrErrMsg)
+        logError((("Failed to read from the \"save#.dat\" file on render frame " .. tostring(renderFrameCount)) .. ": ") .. jsonStringOrErrMsg)
         return DEFAULT_MOD_DATA
     end
     if jsonStringOrErrMsg == nil then

package/dist/features/saveDataManager/main.lua

@@ -12,6 +12,8 @@ local ____SerializationType = require("enums.SerializationType")
 local SerializationType = ____SerializationType.SerializationType
 local ____deepCopy = require("functions.deepCopy")
 local deepCopy = ____deepCopy.deepCopy
+local ____log = require("functions.log")
+local logError = ____log.logError
 local ____table = require("functions.table")
 local clearTable = ____table.clearTable
 local ____constants = require("features.saveDataManager.constants")
@@ -70,11 +72,13 @@ function restoreDefaults(self, childTableName)
             end
             local saveDataDefaults = saveDataDefaultsMap[subscriberName]
             if saveDataDefaults == nil then
-                error("Failed to find the default copy of the save data for subscriber: " .. subscriberName)
+                logError("Failed to find the default copy of the save data for subscriber: " .. subscriberName)
+                goto __continue14
             end
             local childTableDefaults = saveDataDefaults[childTableName]
             if childTableDefaults == nil then
-                error((("Failed to find the default copy of the child table \"" .. childTableName) .. "\" for subscriber: ") .. subscriberName)
+                logError((("Failed to find the default copy of the child table \"" .. childTableName) .. "\" for subscriber: ") .. subscriberName)
+                goto __continue14
             end
             local childTableDefaultsTable = childTableDefaults
             local childTableDefaultsTableCopy = deepCopy(nil, childTableDefaultsTable, SerializationType.NONE, (subscriberName .. " --> ") .. childTableName)

package/dist/functions/array.d.ts

@@ -43,7 +43,7 @@ export declare function getLastElement<T>(array: T[]): T;
  * Helper function to get a random element from the provided array.
  *
  * @param array The array to get an element from.
- * @param seed Optional. The seed used to select the random element. Default is `Random()`.
+ * @param seed Optional. The seed used to select the random element. Default is `getRandomSeed()`.
  * @param exceptions Optional. An array of elements to skip over if selected.
  */
 export declare function getRandomArrayElement<T>(array: T[] | readonly T[], seed?: Seed, exceptions?: T[] | readonly T[]): T;
@@ -52,7 +52,7 @@ export declare function getRandomArrayElement<T>(array: T[] | readonly T[], seed
  * decided, it is then removed from the array (in-place).
  *
  * @param array The array to get an element from.
- * @param seed Optional. The seed used to select the random element. Default is `Random()`.
+ * @param seed Optional. The seed used to select the random element. Default is `getRandomSeed()`.
  * @param exceptions Optional. An array of elements to skip over if selected.
  */
 export declare function getRandomArrayElementAndRemove<T>(array: T[], seed?: Seed, exceptions?: T[] | readonly T[]): T;

package/dist/functions/array.lua

@@ -11,12 +11,13 @@ local __TS__ArrayReduce = ____lualib.__TS__ArrayReduce
 local ____exports = {}
 local ____random = require("functions.random")
 local getRandomInt = ____random.getRandomInt
+local getRandomSeed = ____random.getRandomSeed
 local nextSeed = ____random.nextSeed
 local ____utils = require("functions.utils")
 local ____repeat = ____utils["repeat"]
 function ____exports.getRandomArrayIndex(self, array, seed)
     if seed == nil then
-        seed = Random()
+        seed = getRandomSeed(nil)
     end
     if #array == 0 then
         error("Failed to get a random array index since the provided array is empty.")
@@ -25,7 +26,7 @@ function ____exports.getRandomArrayIndex(self, array, seed)
 end
 function ____exports.shuffleArrayInPlace(self, array, seed)
     if seed == nil then
-        seed = Random()
+        seed = getRandomSeed(nil)
     end
     local currentIndex = #array
     local randomIndex
@@ -117,7 +118,7 @@ function ____exports.getLastElement(self, array)
 end
 function ____exports.getRandomArrayElement(self, array, seed, exceptions)
     if seed == nil then
-        seed = Random()
+        seed = getRandomSeed(nil)
     end
     if exceptions == nil then
         exceptions = {}
@@ -135,7 +136,7 @@ function ____exports.getRandomArrayElement(self, array, seed, exceptions)
 end
 function ____exports.getRandomArrayElementAndRemove(self, array, seed, exceptions)
     if seed == nil then
-        seed = Random()
+        seed = getRandomSeed(nil)
     end
     if exceptions == nil then
         exceptions = {}
@@ -194,7 +195,7 @@ function ____exports.isArrayInArray(self, arrayToMatch, parentArray)
 end
 function ____exports.shuffleArray(self, originalArray, seed)
     if seed == nil then
-        seed = Random()
+        seed = getRandomSeed(nil)
     end
     local array = ____exports.copyArray(nil, originalArray)
     ____exports.shuffleArrayInPlace(nil, array, seed)

package/dist/functions/cards.d.ts

@@ -43,13 +43,13 @@ export declare function getMaxCards(): int;
  * - any objects like Dice Shard
  * - any modded cards.
  *
- * @param seed Optional. The seed with which to select the random card. Default is `Random()`.
+ * @param seed Optional. The seed with which to select the random card. Default is `getRandomSeed()`.
  * @param exceptions Optional. An array of cards to not select.
  */
 export declare function getRandomCard(seed?: Seed, exceptions?: Card[]): Card;
 /**
  * @param cardType The card type that represents the pool of cards to select from.
- * @param seed Optional. The seed with which to select the random card. Default is `Random()`.
+ * @param seed Optional. The seed with which to select the random card. Default is `getRandomSeed()`.
  * @param exceptions Optional. An array of cards to not select.
  */
 export declare function getRandomCardOfType(cardType: CardType, seed?: Seed, exceptions?: Card[]): Card;
@@ -57,7 +57,8 @@ export declare function getRandomCardOfType(cardType: CardType, seed?: Seed, exc
  * Has an equal chance of returning any rune (e.g. Rune of Hagalaz, Blank Rune, Black Rune, Soul of
  * Isaac, etc.). This will never return a Rune Shard.
  *
- * @param seed Optional. The seed with which to select the random rune. Default is `Random()`.
+ * @param seed Optional. The seed with which to select the random rune. Default is
+ * `getRandomSeed()`.
  * @param exceptions Optional. An array of runes to not select.
  */
 export declare function getRandomRune(seed?: Seed, exceptions?: Card[]): Card;

package/dist/functions/cards.lua

@@ -20,6 +20,8 @@ local CARD_TYPES = ____cardTypes.CARD_TYPES
 local DEFAULT_CARD_TYPE = ____cardTypes.DEFAULT_CARD_TYPE
 local ____math = require("functions.math")
 local range = ____math.range
+local ____random = require("functions.random")
+local getRandomSeed = ____random.getRandomSeed
 local ____set = require("functions.set")
 local addSetsToSet = ____set.addSetsToSet
 local getRandomSetElement = ____set.getRandomSetElement
@@ -100,7 +102,7 @@ function ____exports.getCardName(self, card)
 end
 function ____exports.getRandomCard(self, seed, exceptions)
     if seed == nil then
-        seed = Random()
+        seed = getRandomSeed(nil)
     end
     if exceptions == nil then
         exceptions = {}
@@ -109,7 +111,7 @@ function ____exports.getRandomCard(self, seed, exceptions)
 end
 function ____exports.getRandomCardOfType(self, cardType, seed, exceptions)
     if seed == nil then
-        seed = Random()
+        seed = getRandomSeed(nil)
     end
     if exceptions == nil then
         exceptions = {}
@@ -119,7 +121,7 @@ function ____exports.getRandomCardOfType(self, cardType, seed, exceptions)
 end
 function ____exports.getRandomRune(self, seed, exceptions)
     if seed == nil then
-        seed = Random()
+        seed = getRandomSeed(nil)
     end
     if exceptions == nil then
         exceptions = {}

package/dist/functions/jsonHelpers.lua

@@ -2,7 +2,7 @@
 local ____exports = {}
 local json = require("@NoResolution:json")
 local ____log = require("functions.log")
-local log = ____log.log
+local logError = ____log.logError
 local function tryDecode(jsonString)
     return json.decode(jsonString)
 end
@@ -12,7 +12,7 @@ end
 function ____exports.jsonDecode(self, jsonString)
     local ok, luaTableOrErrMsg = pcall(tryDecode, jsonString)
     if not ok then
-        log("Error: Failed to convert the JSON string to a Lua table: " .. jsonString)
+        logError("Failed to convert the JSON string to a Lua table: " .. jsonString)
         return {}
     end
     return luaTableOrErrMsg

package/dist/functions/jsonRoom.lua

@@ -9,6 +9,7 @@ local ____log = require("functions.log")
 local log = ____log.log
 local ____random = require("functions.random")
 local getRandomFloat = ____random.getRandomFloat
+local getRandomSeed = ____random.getRandomSeed
 function getTotalWeightOfJSONRooms(self, jsonRooms)
     local weights = __TS__ArrayMap(
         jsonRooms,
@@ -66,7 +67,7 @@ function ____exports.getJSONRoomsOfSubType(self, jsonRooms, subType)
 end
 function ____exports.getRandomJSONRoom(self, jsonRooms, seed, verbose)
     if seed == nil then
-        seed = Random()
+        seed = getRandomSeed(nil)
     end
     if verbose == nil then
         verbose = false

package/dist/functions/log.d.ts

@@ -14,16 +14,27 @@ export declare function logArray<T>(this: void, array: T[]): void;
 export declare function logColor(this: void, color: Color): void;
 /** Helper function for printing out every damage flag that is turned on. Useful when debugging. */
 export declare function logDamageFlags(this: void, flags: int): void;
+/** Helper function for printing out every entity (or filtered entity) in the current room. */
 export declare function logEntities(this: void, includeBackgroundEffects: boolean, entityTypeFilter?: EntityType | int): void;
 export declare function logEntity(this: void, entity: Entity): void;
 /** Helper function for printing out every entity flag that is turned on. Useful when debugging. */
 export declare function logEntityFlags(this: void, flags: int): void;
+/**
+ * Helper function to log an error message and also print it to the console for better visibility.
+ * This is useful in combination with an early return when invoking the `error` function would be
+ * dangerous (since it prevents all of the subsequent code in the callback from running).
+ */
+export declare function logError(this: void, msg: string): void;
 /** Helper function for printing out every flag that is turned on. Useful when debugging. */
 export declare function logFlags(this: void, flags: int, flagEnum?: LuaTable, description?: string): void;
 /**
  * Helper function for printing out every game state flag that is turned on. Useful when debugging.
  */
 export declare function logGameStateFlags(this: void): void;
+/**
+ * Helper function for printing out every grid entity (or filtered grid entity) in the current
+ * room.
+ */
 export declare function logGridEntities(this: void, includeWalls: boolean, gridEntityTypeFilter?: GridEntityType | int): void;
 export declare function logKColor(this: void, kColor: KColor): void;
 export declare function logMap(this: void, map: Map<AnyNotNil, unknown>): void;
@@ -47,7 +58,7 @@ export declare function logTable(this: void, table: unknown, parentTables?: numb
 export declare function logTearFlags(this: void, flags: int): void;
 export declare function logTemporaryEffects(this: void, player: EntityPlayer): void;
 /** Helper function for printing out every use flag that is turned on. Useful when debugging. */
-export declare function logUseFlags(this: void, _flags: int): void;
+export declare function logUseFlags(this: void, flags: int): void;
 export declare function logVector(this: void, vector: Vector): void;
 /**
  * Converts every `isaacscript-common` function that begins with "log" to a global function.

package/dist/functions/log.lua

@@ -35,6 +35,8 @@ local ____set = require("functions.set")
 local getSortedSetValues = ____set.getSortedSetValues
 local ____trinkets = require("functions.trinkets")
 local getTrinketName = ____trinkets.getTrinketName
+local ____utils = require("functions.utils")
+local printConsole = ____utils.printConsole
 function ____exports.getDebugPrependString(self, msg, numParentFunctions)
     if numParentFunctions == nil then
         numParentFunctions = 3
@@ -76,14 +78,14 @@ function ____exports.logFlags(flags, flagEnum, description)
     for key, value in pairs(flagEnum) do
         do
             if type(value) ~= "number" then
-                goto __continue34
+                goto __continue35
             end
             if hasFlag(nil, flags, value) then
                 ____exports.log(((("  Has flag: " .. tostring(key)) .. " (") .. tostring(value)) .. ")")
                 hasNoFlags = false
             end
         end
-        ::__continue34::
+        ::__continue35::
     end
     if hasNoFlags then
         ____exports.log("  n/a (no flags)")
@@ -194,6 +196,11 @@ end
 function ____exports.logEntityFlags(flags)
     ____exports.logFlags(flags, EntityFlag, "entity")
 end
+function ____exports.logError(msg)
+    local errorMsg = "Error: " .. msg
+    ____exports.log(errorMsg)
+    printConsole(nil, errorMsg)
+end
 function ____exports.logGameStateFlags()
     ____exports.log("Logging game state flags:")
     local hasNoFlags = true
@@ -405,8 +412,8 @@ function ____exports.logTemporaryEffects(player)
         end
     )
 end
-function ____exports.logUseFlags(_flags)
-    ____exports.log("The \"logUseFlags\" helper function is temporarily disabled while the UseFlag enum remains unpatched in vanilla.")
+function ____exports.logUseFlags(flags)
+    ____exports.logFlags(flags, UseFlag, "use")
 end
 function ____exports.logVector(vector)
     ____exports.log(((("Vector: (" .. tostring(vector.X)) .. ", ") .. tostring(vector.Y)) .. ")")
@@ -420,6 +427,7 @@ function ____exports.setLogFunctionsGlobal(self)
     globals.logEntities = ____exports.logEntities
     globals.logEntity = ____exports.logEntity
     globals.logEntityFlags = ____exports.logEntityFlags
+    globals.logError = ____exports.logError
     globals.logFlags = ____exports.logFlags
     globals.logGameStateFlags = ____exports.logGameStateFlags
     globals.logGridEntities = ____exports.logGridEntities

package/dist/functions/random.d.ts

@@ -25,6 +25,12 @@ export declare function getRandomFloat(min: int, max: int, seed?: Seed): float;
  * ```
  */
 export declare function getRandomInt(min: int, max: int, seed?: Seed): int;
+/**
+ * Helper function to get a random `Seed` value to be used in spawning entities and so on. Use this
+ * instead of calling the `Random` function directly since that can return a value of 0 and crash
+ * the game.
+ */
+export declare function getRandomSeed(): Seed;
 /**
  * Helper function to initialize an RNG object.
  *
@@ -38,7 +44,7 @@ export declare function getRandomInt(min: int, max: int, seed?: Seed): int;
  * It is recommended to not deal with RNG objects directly and instead use seeds. Also see the
  * `getRandom`, `getRandomInt`, and `getRandomFloat` helper functions.
  *
- * @param seed The seed to initialize it with. Default is `Random()`.
+ * @param seed The seed to initialize it with. Default is `getRandomSeed()`.
  */
 export declare function initRNG(seed?: Seed): RNG;
 /**

package/dist/functions/random.lua

@@ -1,9 +1,14 @@
 --[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
 local ____exports = {}
 local RECOMMENDED_SHIFT_IDX
+function ____exports.getRandomSeed(self)
+    local random = Random()
+    local safeRandomValue = random == 0 and 1 or random
+    return safeRandomValue
+end
 function ____exports.initRNG(self, seed)
     if seed == nil then
-        seed = Random()
+        seed = ____exports.getRandomSeed(nil)
     end
     if seed == 0 then
         error("You cannot initialize an RNG object with a seed of 0, or the game will crash.")
@@ -15,20 +20,20 @@ end
 RECOMMENDED_SHIFT_IDX = 35
 function ____exports.getRandom(self, seed)
     if seed == nil then
-        seed = Random()
+        seed = ____exports.getRandomSeed(nil)
     end
     local rng = ____exports.initRNG(nil, seed)
     return rng:RandomFloat()
 end
 function ____exports.getRandomFloat(self, min, max, seed)
     if seed == nil then
-        seed = Random()
+        seed = ____exports.getRandomSeed(nil)
     end
     return min + ____exports.getRandom(nil, seed) * (max - min)
 end
 function ____exports.getRandomInt(self, min, max, seed)
     if seed == nil then
-        seed = Random()
+        seed = ____exports.getRandomSeed(nil)
     end
     local rng = ____exports.initRNG(nil, seed)
     return rng:RandomInt(max - min + 1) + min

package/dist/functions/revive.lua

@@ -2,6 +2,9 @@
 local ____exports = {}
 local ____cachedClasses = require("cachedClasses")
 local game = ____cachedClasses.game
+local ____constants = require("constants")
+local MAX_TAINTED_SAMSON_BERSERK_CHARGE = ____constants.MAX_TAINTED_SAMSON_BERSERK_CHARGE
+local TAINTED_SAMSON_BERSERK_CHARGE_FROM_TAKING_DAMAGE = ____constants.TAINTED_SAMSON_BERSERK_CHARGE_FROM_TAKING_DAMAGE
 local ____character = require("functions.character")
 local getCharacterDeathAnimationName = ____character.getCharacterDeathAnimationName
 local ____player = require("functions.player")
@@ -44,6 +47,10 @@ function ____exports.isDamageToPlayerFatal(self, player, damageAmount, damageSou
     if isBerserk then
         return false
     end
+    local berserkChargeAfterHit = player.SamsonBerserkCharge + TAINTED_SAMSON_BERSERK_CHARGE_FROM_TAKING_DAMAGE
+    if character == PlayerType.PLAYER_SAMSON_B and berserkChargeAfterHit >= MAX_TAINTED_SAMSON_BERSERK_CHARGE then
+        return false
+    end
     if ____exports.willReviveFromSpiritShackles(nil, player) then
         return false
     end

package/dist/functions/set.d.ts

@@ -25,7 +25,7 @@ export declare function deleteSetsFromSet<T>(mainSet: Set<T>, ...setsToRemove: A
  * Helper function to get a random element from the provided set.
  *
  * @param set The set to get an element from.
- * @param seed Optional. The seed used to select the random element. Default is `Random()`.
+ * @param seed Optional. The seed used to select the random element. Default is `getRandomSeed()`.
  * @param exceptions Optional. An array of elements to skip over if selected.
  */
 export declare function getRandomSetElement<T>(set: Set<T> | ReadonlySet<T>, seed?: Seed, exceptions?: T[] | readonly T[]): T;

package/dist/functions/set.lua

@@ -7,6 +7,8 @@ local __TS__ArraySort = ____lualib.__TS__ArraySort
 local ____exports = {}
 local ____array = require("functions.array")
 local getRandomArrayElement = ____array.getRandomArrayElement
+local ____random = require("functions.random")
+local getRandomSeed = ____random.getRandomSeed
 function ____exports.getSortedSetValues(self, set)
     local values = set:values()
     local array = {__TS__Spread(values)}
@@ -48,7 +50,7 @@ function ____exports.deleteSetsFromSet(self, mainSet, ...)
 end
 function ____exports.getRandomSetElement(self, set, seed, exceptions)
     if seed == nil then
-        seed = Random()
+        seed = getRandomSeed(nil)
     end
     if exceptions == nil then
         exceptions = {}

package/dist/functions/spawnCollectible.d.ts

@@ -7,7 +7,7 @@
  *
  * @param collectibleType The collectible type to spawn.
  * @param position The position to spawn the collectible at.
- * @param seed Optional. Default is `Random()`.
+ * @param seed Optional. Default is `getRandomSeed()`.
  * @param options Optional. Set to true to make the collectible a "There's Options" style
  * collectible. Default is false.
  * @param forceFreeItem Optional. Set to true to disable the logic that gives the item a price for

package/dist/functions/spawnCollectible.lua

@@ -11,9 +11,11 @@ local isQuestCollectible = ____collectibles.isQuestCollectible
 local setCollectibleEmpty = ____collectibles.setCollectibleEmpty
 local ____player = require("functions.player")
 local anyPlayerIs = ____player.anyPlayerIs
+local ____random = require("functions.random")
+local getRandomSeed = ____random.getRandomSeed
 function ____exports.spawnCollectible(self, collectibleType, position, seed, options, forceFreeItem)
     if seed == nil then
-        seed = Random()
+        seed = getRandomSeed(nil)
     end
     if options == nil then
         options = false
@@ -50,7 +52,7 @@ function ____exports.spawnCollectible(self, collectibleType, position, seed, opt
 end
 function ____exports.spawnEmptyCollectible(self, position, seed)
     if seed == nil then
-        seed = Random()
+        seed = getRandomSeed(nil)
     end
     local collectible = ____exports.spawnCollectible(
         nil,

package/dist/functions/utils.d.ts

@@ -123,4 +123,4 @@ export declare function repeat(n: int, func: (i: int) => void): void;
  * Helper function to check every value of a custom enum for -1. This is helpful as a run-time check
  * because many methods of the Isaac class return -1 if they fail.
  */
-export declare function validateCustomEnum(customEnumName: string, customEnum: unknown): void;
+export declare function validateCustomEnum(transpiledEnumName: string, transpiledEnum: unknown): void;

package/dist/functions/utils.lua

@@ -4,6 +4,7 @@ local __TS__ArraySort = ____lualib.__TS__ArraySort
 local __TS__StringReplace = ____lualib.__TS__StringReplace
 local __TS__StringSubstr = ____lualib.__TS__StringSubstr
 local __TS__ObjectKeys = ____lualib.__TS__ObjectKeys
+local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
 local ____exports = {}
 local ____directionNames = require("objects.directionNames")
 local DIRECTION_NAMES = ____directionNames.DIRECTION_NAMES
@@ -77,18 +78,21 @@ ____exports["repeat"] = function(self, n, func)
         end
     end
 end
-function ____exports.validateCustomEnum(self, customEnumName, customEnum)
-    local customEnumType = type(customEnum)
+function ____exports.validateCustomEnum(self, transpiledEnumName, transpiledEnum)
+    local customEnumType = type(transpiledEnum)
     if customEnumType ~= "table" then
         return
     end
-    local ____table = customEnum
-    local keys = __TS__ObjectKeys(____table)
+    local ____table = transpiledEnum
+    local keys = __TS__ArrayFilter(
+        __TS__ObjectKeys(____table),
+        function(____, key) return type(key) == "string" end
+    )
     __TS__ArraySort(keys)
     for ____, key in ipairs(keys) do
         local value = ____table[key]
         if value == -1 then
-            error((("Failed to find: " .. customEnumName) .. ".") .. key)
+            error((("Failed to find: " .. transpiledEnumName) .. ".") .. key)
         end
     end
 end

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "1.2.198",
+  "version": "1.2.201",
   "description": "Helper functions for IsaacScript mods",
   "keywords": [
     "isaac",
@@ -25,8 +25,8 @@
     "dist/**/*.d.ts"
   ],
   "devDependencies": {
-    "isaac-typescript-definitions": "^1.0.376",
-    "isaacscript-lint": "^1.0.93",
+    "isaac-typescript-definitions": "^1.0.379",
+    "isaacscript-lint": "^1.0.95",
     "isaacscript-tsconfig": "^1.1.8",
     "typedoc": "^0.22.13",
     "typescript": "4.6.2",