isaacscript-common 1.2.135 → 1.2.138

package/dist/features/extraConsoleCommands/init.lua

@@ -0,0 +1,153 @@
+--[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+local ____lualib = require("lualib_bundle")
+local Map = ____lualib.Map
+local __TS__New = ____lualib.__TS__New
+local ____exports = {}
+local postUpdate, evaluateCacheSpeed, entityTakeDmgPlayer, executeCmd, postFireTear, commandFunctionsMap
+local ____constants = require("constants")
+local MAX_SPEED_STAT = ____constants.MAX_SPEED_STAT
+local ____map = require("functions.map")
+local getMapPartialMatch = ____map.getMapPartialMatch
+local ____utils = require("functions.utils")
+local printConsole = ____utils.printConsole
+local ____exports = require("features.saveDataManager.exports")
+local saveDataManager = ____exports.saveDataManager
+local commands = require("features.extraConsoleCommands.commands")
+local ____v = require("features.extraConsoleCommands.v")
+local v = ____v.default
+function postUpdate(self)
+    if v.run.spamBloodRights then
+        local player = Isaac.GetPlayer()
+        player:UseActiveItem(CollectibleType.COLLECTIBLE_BLOOD_RIGHTS)
+    end
+end
+function evaluateCacheSpeed(self, player)
+    if v.run.maxSpeed then
+        player.MoveSpeed = MAX_SPEED_STAT
+    end
+end
+function entityTakeDmgPlayer(self)
+    if v.run.spamBloodRights then
+        return false
+    end
+    return nil
+end
+function executeCmd(self, command, params)
+    local commandFunction = getMapPartialMatch(nil, command, commandFunctionsMap)
+    if commandFunction == nil then
+        printConsole(nil, "That is an invalid console command.")
+    else
+        commandFunction(nil, params)
+    end
+end
+function postFireTear(self, tear)
+    if v.run.chaosCardTears then
+        tear:ChangeVariant(TearVariant.CHAOS_CARD)
+    end
+    if v.run.maxDamage then
+        tear.CollisionDamage = tear.CollisionDamage * 1000
+        tear:ChangeVariant(TearVariant.TOOTH)
+    end
+end
+commandFunctionsMap = __TS__New(Map)
+local initialized = false
+function ____exports.enableExtraConsoleCommands(self, mod)
+    initialized = true
+    saveDataManager(nil, "extraConsoleCommands", v)
+    mod:AddCallback(ModCallbacks.MC_POST_UPDATE, postUpdate)
+    mod:AddCallback(ModCallbacks.MC_EVALUATE_CACHE, evaluateCacheSpeed, CacheFlag.CACHE_SPEED)
+    mod:AddCallback(ModCallbacks.MC_ENTITY_TAKE_DMG, entityTakeDmgPlayer, EntityType.ENTITY_PLAYER)
+    mod:AddCallback(ModCallbacks.MC_EXECUTE_CMD, executeCmd)
+    mod:AddCallback(ModCallbacks.MC_POST_FIRE_TEAR, postFireTear)
+end
+function ____exports.addConsoleCommand(self, commandName, commandFunction)
+    if not initialized then
+        error("Before adding extra console commands, you must first enable the feature by invoking the \"enableExtraConsoleCommands\" function.")
+    end
+    if commandFunctionsMap:has(commandName) then
+        error(("You cannot add a new console command of \"" .. commandName) .. "\" because there is already an existing command by that name. If you want to overwrite a command from the standard library, you can use the \"removeExtraConsoleCommand\" function.")
+    end
+    commandFunctionsMap:set(commandName, commandFunction)
+end
+function ____exports.removeConsoleCommand(self, commandName)
+    if not initialized then
+        error("Before removing console commands, you must first enable the feature by invoking the \"enableExtraConsoleCommands\" function.")
+    end
+    if not commandFunctionsMap:has(commandName) then
+        error(("The console command of \"" .. commandName) .. "\" does not exist, so you cannot remove it.")
+    end
+    commandFunctionsMap:delete(commandName)
+end
+commandFunctionsMap:set("angel", commands.angel)
+commandFunctionsMap:set("ascent", commands.ascent)
+commandFunctionsMap:set("bh", commands.bh)
+commandFunctionsMap:set("blackhearts", commands.blackHearts)
+commandFunctionsMap:set("blackmarket", commands.blackMarket)
+commandFunctionsMap:set("bloodcharges", commands.bloodCharges)
+commandFunctionsMap:set("bomb", commands.bomb)
+commandFunctionsMap:set("bombs", commands.bombs)
+commandFunctionsMap:set("bonehearts", commands.boneHearts)
+commandFunctionsMap:set("boss", commands.boss)
+commandFunctionsMap:set("bm", commands.bm)
+commandFunctionsMap:set("brokenhearts", commands.brokenHearts)
+commandFunctionsMap:set("card", commands.card)
+commandFunctionsMap:set("cards", commands.cards)
+commandFunctionsMap:set("cc", commands.cc)
+commandFunctionsMap:set("chaoscardtears", commands.chaosCardTears)
+commandFunctionsMap:set("character", commands.characterCommand)
+commandFunctionsMap:set("coin", commands.coin)
+commandFunctionsMap:set("coins", commands.coins)
+commandFunctionsMap:set("crawlspace", commands.crawlspace)
+commandFunctionsMap:set("d6", commands.d6)
+commandFunctionsMap:set("d20", commands.d20)
+commandFunctionsMap:set("damage", commands.damage)
+commandFunctionsMap:set("dd", commands.dd)
+commandFunctionsMap:set("devil", commands.devil)
+commandFunctionsMap:set("down", commands.down)
+commandFunctionsMap:set("effects", commands.effects)
+commandFunctionsMap:set("eh", commands.eh)
+commandFunctionsMap:set("error", commands.error)
+commandFunctionsMap:set("eternalhearts", commands.eternalHearts)
+commandFunctionsMap:set("fool", commands.fool)
+commandFunctionsMap:set("goldbomb", commands.goldBomb)
+commandFunctionsMap:set("goldenbomb", commands.goldenBomb)
+commandFunctionsMap:set("goldkey", commands.goldKey)
+commandFunctionsMap:set("goldenkey", commands.goldenKey)
+commandFunctionsMap:set("h", commands.h)
+commandFunctionsMap:set("hearts", commands.hearts)
+commandFunctionsMap:set("iamerror", commands.IAMERROR)
+commandFunctionsMap:set("key", commands.key)
+commandFunctionsMap:set("keys", commands.keys)
+commandFunctionsMap:set("list", commands.list)
+commandFunctionsMap:set("listall", commands.listAll)
+commandFunctionsMap:set("listgrid", commands.listGrid)
+commandFunctionsMap:set("listgridall", commands.listGridAll)
+commandFunctionsMap:set("lowhp", commands.lowHP)
+commandFunctionsMap:set("luck", commands.luck)
+commandFunctionsMap:set("maxhearts", commands.maxHearts)
+commandFunctionsMap:set("mh", commands.mh)
+commandFunctionsMap:set("pill", commands.pill)
+commandFunctionsMap:set("pills", commands.pills)
+commandFunctionsMap:set("planetarium", commands.planetarium)
+commandFunctionsMap:set("pocket", commands.pocket)
+commandFunctionsMap:set("position", commands.positionCommand)
+commandFunctionsMap:set("redhearts", commands.redHearts)
+commandFunctionsMap:set("rh", commands.rh)
+commandFunctionsMap:set("room", commands.roomCommand)
+commandFunctionsMap:set("rottenhearts", commands.rottenHearts)
+commandFunctionsMap:set("s", commands.s)
+commandFunctionsMap:set("seeds", commands.seeds)
+commandFunctionsMap:set("sh", commands.sh)
+commandFunctionsMap:set("shop", commands.shop)
+commandFunctionsMap:set("smelt", commands.smelt)
+commandFunctionsMap:set("soulcharges", commands.soulCharges)
+commandFunctionsMap:set("soulhearts", commands.soulHearts)
+commandFunctionsMap:set("sound", commands.sound)
+commandFunctionsMap:set("sounds", commands.sounds)
+commandFunctionsMap:set("spam", commands.spam)
+commandFunctionsMap:set("speed", commands.speed)
+commandFunctionsMap:set("startingroom", commands.startingRoom)
+commandFunctionsMap:set("trapdoor", commands.trapdoorCommand)
+commandFunctionsMap:set("treasure", commands.treasure)
+commandFunctionsMap:set("ultra", commands.ultra)
+return ____exports

package/dist/features/extraConsoleCommands/v.d.ts

@@ -0,0 +1,9 @@
+declare const v: {
+    run: {
+        chaosCardTears: boolean;
+        spamBloodRights: boolean;
+        maxSpeed: boolean;
+        maxDamage: boolean;
+    };
+};
+export default v;

package/dist/features/extraConsoleCommands/v.lua

@@ -0,0 +1,5 @@
+--[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+local ____exports = {}
+local v = {run = {chaosCardTears = false, spamBloodRights = false, maxSpeed = false, maxDamage = false}}
+____exports.default = v
+return ____exports

package/dist/functions/log.d.ts

@@ -36,11 +36,15 @@ export declare function logAllUseFlags(this: void, _flags: int): void;
 export declare function logArray<T>(this: void, array: T[]): void;
 export declare function logColor(this: void, color: Color): void;
 export declare function logEntity(this: void, entity: Entity): void;
+export declare function logEntities(this: void, includeBackgroundEffects: boolean, entityTypeFilter?: EntityType | int): void;
+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;
 export declare function logPlayerHealth(this: void, player: EntityPlayer): void;
-/** Helper function for printing out information about the current room. */
+/** Helper function for logging information about the current room. */
 export declare function logRoom(this: void): void;
+/** Helper function for logging every sound effect that is currently playing. */
+export declare function logSounds(this: void): void;
 export declare function logTable(this: void, table: unknown, parentTables?: number): void;
 export declare function logTemporaryEffects(this: void, player: EntityPlayer): void;
 export declare function logSet(this: void, set: Set<AnyNotNil>): void;

package/dist/functions/log.lua

@@ -1,19 +1,28 @@
 --[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
 local ____lualib = require("lualib_bundle")
+local Set = ____lualib.Set
+local __TS__New = ____lualib.__TS__New
+local __TS__ArrayForEach = ____lualib.__TS__ArrayForEach
 local Map = ____lualib.Map
 local __TS__Spread = ____lualib.__TS__Spread
 local __TS__ArraySort = ____lualib.__TS__ArraySort
-local __TS__ArrayForEach = ____lualib.__TS__ArrayForEach
-local Set = ____lualib.Set
 local ____exports = {}
 local ____cachedClasses = require("cachedClasses")
 local game = ____cachedClasses.game
+local sfxManager = ____cachedClasses.sfxManager
 local ____array = require("functions.array")
 local arrayToString = ____array.arrayToString
 local ____collectibles = require("functions.collectibles")
 local getCollectibleName = ____collectibles.getCollectibleName
+local ____entity = require("functions.entity")
+local getEntities = ____entity.getEntities
+local getEntityID = ____entity.getEntityID
 local ____flag = require("functions.flag")
 local hasFlag = ____flag.hasFlag
+local ____gridEntity = require("functions.gridEntity")
+local getGridEntities = ____gridEntity.getGridEntities
+local ____math = require("functions.math")
+local range = ____math.range
 local ____player = require("functions.player")
 local getEffectsList = ____player.getEffectsList
 local getPlayerName = ____player.getPlayerName
@@ -65,6 +74,17 @@ function ____exports.logAllFlags(flags, flagEnum, description)
         ____exports.log("  n/a (no flags)")
     end
 end
+local IGNORE_EFFECT_VARIANTS = __TS__New(Set, {
+    EffectVariant.BLOOD_EXPLOSION,
+    EffectVariant.BLOOD_PARTICLE,
+    EffectVariant.TINY_BUG,
+    EffectVariant.TINY_FLY,
+    EffectVariant.WATER_DROPLET,
+    EffectVariant.WALL_BUG,
+    EffectVariant.FALLING_EMBER,
+    EffectVariant.LIGHT,
+    EffectVariant.TADPOLE
+})
 function ____exports.logAllDamageFlags(flags)
     ____exports.logAllFlags(flags, DamageFlag, "damage")
 end
@@ -120,6 +140,145 @@ end
 function ____exports.logEntity(entity)
     ____exports.log((((("Entity: " .. tostring(entity.Type)) .. ".") .. tostring(entity.Variant)) .. ".") .. tostring(entity.SubType))
 end
+function ____exports.logEntities(includeBackgroundEffects, entityTypeFilter)
+    local headerMsg = "Entities in the room"
+    if entityTypeFilter ~= nil then
+        headerMsg = headerMsg .. (" (filtered to entity type " .. tostring(entityTypeFilter)) .. ")"
+    end
+    if not includeBackgroundEffects then
+        headerMsg = headerMsg .. " (not excluding background effects)"
+    end
+    headerMsg = headerMsg .. ":"
+    ____exports.log(headerMsg)
+    local entities = getEntities(nil)
+    local numMatchedEntities = 0
+    __TS__ArrayForEach(
+        entities,
+        function(____, entity, i)
+            if entityTypeFilter ~= nil and entity.Type ~= entityTypeFilter then
+                return
+            end
+            if not includeBackgroundEffects and entity.Type == EntityType.ENTITY_EFFECT and IGNORE_EFFECT_VARIANTS:has(entity.Variant) then
+                return
+            end
+            local entityID = getEntityID(nil, entity)
+            local debugString = (tostring(i + 1) .. " - ") .. entityID
+            local bomb = entity:ToBomb()
+            if bomb ~= nil then
+                debugString = debugString .. " (bomb)"
+            end
+            local effect = entity:ToEffect()
+            if effect ~= nil then
+                debugString = debugString .. ("." .. tostring(effect.State)) .. " (effect)"
+            end
+            local familiar = entity:ToFamiliar()
+            if familiar ~= nil then
+                debugString = debugString .. ("." .. tostring(familiar.State)) .. " (familiar)"
+            end
+            local knife = entity:ToKnife()
+            if knife ~= nil then
+                debugString = debugString .. " (knife)"
+            end
+            local laser = entity:ToLaser()
+            if laser ~= nil then
+                debugString = debugString .. " (laser)"
+            end
+            local npc = entity:ToNPC()
+            if npc ~= nil then
+                debugString = debugString .. ((("." .. tostring(npc.State)) .. " (NPC) (CanShutDoors: ") .. tostring(npc.CanShutDoors)) .. ")"
+            end
+            local pickup = entity:ToPickup()
+            if pickup ~= nil then
+                debugString = debugString .. ("." .. tostring(pickup.State)) .. " (pickup)"
+            end
+            local player = entity:ToPlayer()
+            if player ~= nil then
+                debugString = debugString .. " (player)"
+            end
+            local projectile = entity:ToProjectile()
+            if projectile ~= nil then
+                debugString = debugString .. " (projectile)"
+            end
+            local tear = entity:ToTear()
+            if tear ~= nil then
+                debugString = debugString .. " (tear)"
+            end
+            debugString = debugString .. (" (InitSeed: " .. tostring(entity.InitSeed)) .. ")"
+            debugString = debugString .. (" (DropSeed: " .. tostring(entity.DropSeed)) .. ")"
+            debugString = debugString .. (((" (Position: " .. tostring(entity.Position.X)) .. ", ") .. tostring(entity.Position.Y)) .. ")"
+            debugString = debugString .. (((" (Velocity: " .. tostring(entity.Velocity.X)) .. ", ") .. tostring(entity.Velocity.Y)) .. ")"
+            ____exports.log(debugString)
+            numMatchedEntities = numMatchedEntities + 1
+        end
+    )
+    if numMatchedEntities == 0 then
+        ____exports.log("(no entities matched)")
+    end
+end
+function ____exports.logGridEntities(includeWalls, gridEntityTypeFilter)
+    local headerMsg = "Grid entities in the room"
+    if gridEntityTypeFilter ~= nil then
+        headerMsg = headerMsg .. (" (filtered to grid entity type " .. tostring(gridEntityTypeFilter)) .. ")"
+    end
+    if not includeWalls then
+        headerMsg = headerMsg .. " (not including walls)"
+    end
+    ____exports.log(headerMsg)
+    local gridEntities = getGridEntities(nil)
+    local numMatchedEntities = 0
+    __TS__ArrayForEach(
+        gridEntities,
+        function(____, gridEntity)
+            local gridEntityIndex = gridEntity:GetGridIndex()
+            local gridEntityType = gridEntity:GetType()
+            local gridEntityVariant = gridEntity:GetVariant()
+            local gridEntityDesc = gridEntity:GetSaveState()
+            if gridEntityTypeFilter ~= nil and gridEntityType ~= gridEntityTypeFilter then
+                return
+            end
+            if not includeWalls and gridEntityType == GridEntityType.GRID_WALL and gridEntityTypeFilter ~= GridEntityType.GRID_WALL then
+                return
+            end
+            local debugString = (((((tostring(gridEntityIndex) .. " - ") .. tostring(gridEntityType)) .. ".") .. tostring(gridEntityVariant)) .. ".") .. tostring(gridEntity.State)
+            local door = gridEntity:ToDoor()
+            if door ~= nil then
+                debugString = debugString .. (((((((" (door) (Slot: " .. tostring(door.Slot)) .. ", Direction: ") .. tostring(door.Direction)) .. ", TargetRoomIndex: ") .. tostring(door.TargetRoomIndex)) .. ", TargetRoomType: ") .. tostring(door.TargetRoomType)) .. ")"
+            end
+            local pit = gridEntity:ToPit()
+            if pit ~= nil then
+                debugString = debugString .. " (pit)"
+            end
+            local poop = gridEntity:ToPoop()
+            if poop ~= nil then
+                debugString = debugString .. " (poop)"
+            end
+            local pressurePlate = gridEntity:ToPressurePlate()
+            if pressurePlate ~= nil then
+                debugString = debugString .. " (pressurePlate)"
+            end
+            local rock = gridEntity:ToRock()
+            if rock ~= nil then
+                debugString = debugString .. " (rock)"
+            end
+            local spikes = gridEntity:ToSpikes()
+            if spikes ~= nil then
+                debugString = debugString .. " (spikes)"
+            end
+            local tnt = gridEntity:ToTNT()
+            if tnt ~= nil then
+                debugString = debugString .. " (TNT)"
+            end
+            debugString = debugString .. (" (VarData: " .. tostring(gridEntity.VarData)) .. ")"
+            debugString = debugString .. (((" (Position: " .. tostring(gridEntity.Position.X)) .. ", ") .. tostring(gridEntity.Position.Y)) .. ")"
+            debugString = debugString .. (((" (SpawnSeed: " .. tostring(gridEntityDesc.SpawnSeed)) .. ", VariableSeed: ") .. tostring(gridEntityDesc.VariableSeed)) .. ")"
+            ____exports.log(debugString)
+            numMatchedEntities = numMatchedEntities + 1
+        end
+    )
+    if numMatchedEntities == 0 then
+        ____exports.log("(no grid entities matched)")
+    end
+end
 function ____exports.logKColor(kColor)
     ____exports.log((((((("Color: R" .. tostring(kColor.Red)) .. ", G") .. tostring(kColor.Green)) .. ", B") .. tostring(kColor.Blue)) .. ", A") .. tostring(kColor.Alpha))
 end
@@ -161,6 +320,13 @@ function ____exports.logRoom()
     ____exports.log("Current room grid index: " .. tostring(roomGridIndex))
     ____exports.log("Current room list index: " .. tostring(roomListIndex))
 end
+function ____exports.logSounds()
+    for ____, soundEffect in ipairs(range(nil, 0, SoundEffect.NUM_SOUND_EFFECTS - 1)) do
+        if sfxManager:IsPlaying(soundEffect) then
+            ____exports.log("Currently playing sound effect: " .. tostring(soundEffect))
+        end
+    end
+end
 function ____exports.logTable(____table, parentTables)
     if parentTables == nil then
         parentTables = 0
@@ -233,11 +399,15 @@ function ____exports.setLogFunctionsGlobal(self)
     globals.logArray = ____exports.logArray
     globals.logColor = ____exports.logColor
     globals.logEntity = ____exports.logEntity
+    globals.logEntities = ____exports.logEntities
+    globals.logGridEntities = ____exports.logGridEntities
     globals.logKColor = ____exports.logKColor
     globals.logMap = ____exports.logMap
+    globals.logRoom = ____exports.logRoom
     globals.logTable = ____exports.logTable
     globals.logTemporaryEffects = ____exports.logTemporaryEffects
     globals.logSet = ____exports.logSet
+    globals.logSounds = ____exports.logSounds
     globals.logVector = ____exports.logVector
 end
 return ____exports

package/dist/functions/map.d.ts

@@ -7,6 +7,22 @@ export declare function copyMap<K, V>(oldMap: Map<K, V>): Map<K, V>;
  * manually getting the current value, incrementing it, and then setting it.
  */
 export declare function defaultMapGetNextSeed<K, A extends unknown[]>(map: DefaultMap<K, Seed, A>, key: K, ...extraArgs: A): Seed;
+/**
+ * Helper function to get the closest value from a map based on partial search text. For the
+ * purposes of this function, both search text and map keys are converted to lowercase before
+ * attempting to find a match.
+ *
+ * Example:
+ * ```ts
+ * const map = new <string, number>Map([
+ *   ["foo", 123],
+ *   ["bar", 456],
+ * ]);
+ * const searchText = "f";
+ * const match = getMapPartialMatch(map, searchText); // match is now equal to 123
+ * ```
+ */
+export declare function getMapPartialMatch<T>(searchText: string, map: ReadonlyMap<string, T>): T | undefined;
 /**
  * Helper function to make using maps with `Seed` values easier. Use this instead of manually
  * getting the current value, incrementing it, and then setting it.

package/dist/functions/map.lua

@@ -3,6 +3,11 @@ local ____lualib = require("lualib_bundle")
 local Map = ____lualib.Map
 local __TS__New = ____lualib.__TS__New
 local __TS__Iterator = ____lualib.__TS__Iterator
+local __TS__Spread = ____lualib.__TS__Spread
+local __TS__ArraySort = ____lualib.__TS__ArraySort
+local __TS__StringReplaceAll = ____lualib.__TS__StringReplaceAll
+local __TS__StringStartsWith = ____lualib.__TS__StringStartsWith
+local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
 local ____exports = {}
 local ____random = require("functions.random")
 local nextSeed = ____random.nextSeed
@@ -24,6 +29,25 @@ function ____exports.defaultMapGetNextSeed(self, map, key, ...)
     map:set(key, newSeed)
     return newSeed
 end
+function ____exports.getMapPartialMatch(self, searchText, map)
+    local keys = {__TS__Spread(map:keys())}
+    __TS__ArraySort(keys)
+    searchText = string.lower(searchText)
+    searchText = __TS__StringReplaceAll(searchText, " ", "")
+    local matchingKeys = __TS__ArrayFilter(
+        keys,
+        function(____, key) return __TS__StringStartsWith(
+            string.lower(key),
+            searchText
+        ) end
+    )
+    __TS__ArraySort(matchingKeys)
+    local matchingKey = matchingKeys[1]
+    if matchingKey == nil then
+        return nil
+    end
+    return map:get(matchingKey)
+end
 function ____exports.mapGetNextSeed(self, map, key)
     local seed = map:get(key)
     if seed == nil then

package/dist/functions/player.d.ts

@@ -101,8 +101,8 @@ export declare function getFinalPlayer(): EntityPlayer;
  */
 export declare function getHearts(player: EntityPlayer): int;
 /**
- * Helper function that returns the type of the rightmost heart, not including golden hearts since
- * they can't be damaged directly.
+ * Helper function that returns the type of the rightmost heart. This does not including golden
+ * hearts or broken hearts, since they cannot be damaged directly.
  */
 export declare function getLastHeart(player: EntityPlayer): HealthType;
 /**

package/dist/functions/playerHealth.d.ts

@@ -1,5 +1,7 @@
 /// <reference types="isaac-typescript-definitions" />
+import { HealthType } from "../types/HealthType";
 import { PlayerHealth } from "../types/PlayerHealth";
+export declare function addPlayerHealthType(player: EntityPlayer, healthType: HealthType, numHearts: int): void;
 /**
  * Helper function to get an inventory of the player's health. Use this in combination with the
  * `setPlayerHealth` function to restore the player's health back to a certain configuration at a
@@ -8,6 +10,7 @@ import { PlayerHealth } from "../types/PlayerHealth";
  * This is based on the `REVEL.StoreHealth` function in the Revelations mod.
  */
 export declare function getPlayerHealth(player: EntityPlayer): PlayerHealth;
+export declare function getPlayerHealthType(player: EntityPlayer, healthType: HealthType): int;
 /**
  * Helper function to set a player's health to a specific state. You can use this in combination
  * with the `getPlayerHealth` function to restore the player's health back to a certain

package/dist/functions/playerHealth.lua

@@ -5,9 +5,14 @@ local __TS__ArrayForEach = ____lualib.__TS__ArrayForEach
 local ____exports = {}
 local ____constants = require("constants")
 local MAX_PLAYER_HEART_CONTAINERS = ____constants.MAX_PLAYER_HEART_CONTAINERS
+local ____HealthType = require("types.HealthType")
+local HealthType = ____HealthType.HealthType
 local ____player = require("functions.player")
+local getBlackHearts = ____player.getBlackHearts
 local getHearts = ____player.getHearts
+local getSoulHearts = ____player.getSoulHearts
 local ____utils = require("functions.utils")
+local ensureAllCases = ____utils.ensureAllCases
 local ____repeat = ____utils["repeat"]
 function ____exports.removeAllPlayerHealth(self, player)
     local character = player:GetPlayerType()
@@ -29,6 +34,79 @@ function ____exports.removeAllPlayerHealth(self, player)
         end
     end
 end
+function ____exports.addPlayerHealthType(self, player, healthType, numHearts)
+    repeat
+        local ____switch3 = healthType
+        local ____cond3 = ____switch3 == HealthType.RED
+        if ____cond3 then
+            do
+                player:AddHearts(numHearts)
+                return
+            end
+        end
+        ____cond3 = ____cond3 or ____switch3 == HealthType.SOUL
+        if ____cond3 then
+            do
+                player:AddSoulHearts(numHearts)
+                return
+            end
+        end
+        ____cond3 = ____cond3 or ____switch3 == HealthType.ETERNAL
+        if ____cond3 then
+            do
+                player:AddEternalHearts(numHearts)
+                return
+            end
+        end
+        ____cond3 = ____cond3 or ____switch3 == HealthType.BLACK
+        if ____cond3 then
+            do
+                player:AddBlackHearts(numHearts)
+                return
+            end
+        end
+        ____cond3 = ____cond3 or ____switch3 == HealthType.GOLDEN
+        if ____cond3 then
+            do
+                player:AddGoldenHearts(numHearts)
+                return
+            end
+        end
+        ____cond3 = ____cond3 or ____switch3 == HealthType.BONE
+        if ____cond3 then
+            do
+                player:AddBoneHearts(numHearts)
+                return
+            end
+        end
+        ____cond3 = ____cond3 or ____switch3 == HealthType.ROTTEN
+        if ____cond3 then
+            do
+                player:AddRottenHearts(numHearts)
+                return
+            end
+        end
+        ____cond3 = ____cond3 or ____switch3 == HealthType.BROKEN
+        if ____cond3 then
+            do
+                player:AddBrokenHearts(numHearts)
+                return
+            end
+        end
+        ____cond3 = ____cond3 or ____switch3 == HealthType.MAX_HEARTS
+        if ____cond3 then
+            do
+                player:AddMaxHearts(numHearts, false)
+                return
+            end
+        end
+        do
+            do
+                ensureAllCases(nil, healthType)
+            end
+        end
+    until true
+end
 function ____exports.getPlayerHealth(self, player)
     local character = player:GetPlayerType()
     local soulHeartTypes = {}
@@ -91,6 +169,70 @@ function ____exports.getPlayerHealth(self, player)
         soulHeartTypes = soulHeartTypes
     }
 end
+function ____exports.getPlayerHealthType(self, player, healthType)
+    repeat
+        local ____switch25 = healthType
+        local ____cond25 = ____switch25 == HealthType.RED
+        if ____cond25 then
+            do
+                return getHearts(nil, player)
+            end
+        end
+        ____cond25 = ____cond25 or ____switch25 == HealthType.SOUL
+        if ____cond25 then
+            do
+                return getSoulHearts(nil, player)
+            end
+        end
+        ____cond25 = ____cond25 or ____switch25 == HealthType.ETERNAL
+        if ____cond25 then
+            do
+                return player:GetEternalHearts()
+            end
+        end
+        ____cond25 = ____cond25 or ____switch25 == HealthType.BLACK
+        if ____cond25 then
+            do
+                return getBlackHearts(nil, player)
+            end
+        end
+        ____cond25 = ____cond25 or ____switch25 == HealthType.GOLDEN
+        if ____cond25 then
+            do
+                return player:GetGoldenHearts()
+            end
+        end
+        ____cond25 = ____cond25 or ____switch25 == HealthType.BONE
+        if ____cond25 then
+            do
+                return player:GetBoneHearts()
+            end
+        end
+        ____cond25 = ____cond25 or ____switch25 == HealthType.ROTTEN
+        if ____cond25 then
+            do
+                return player:GetRottenHearts()
+            end
+        end
+        ____cond25 = ____cond25 or ____switch25 == HealthType.BROKEN
+        if ____cond25 then
+            do
+                return player:GetBrokenHearts()
+            end
+        end
+        ____cond25 = ____cond25 or ____switch25 == HealthType.MAX_HEARTS
+        if ____cond25 then
+            do
+                return player:GetMaxHearts()
+            end
+        end
+        do
+            do
+                return ensureAllCases(nil, healthType)
+            end
+        end
+    until true
+end
 function ____exports.setPlayerHealth(self, player, playerHealth)
     local character = player:GetPlayerType()
     local subPlayer = player:GetSubPlayer()

package/dist/functions/run.d.ts

@@ -0,0 +1,12 @@
+/// <reference types="isaac-typescript-definitions" />
+/**
+ * Whether or not the player is playing on a set seed (i.e. that they entered in a specific seed by
+ * pressing tab on the character selection screen). When the player resets the game on a set seed,
+ * the game will not switch to a different seed.
+ */
+export declare function onSetSeed(): boolean;
+/**
+ * Helper function to restart the game using the console command of "restart". You can optionally
+ * specify a `PlayerType` to restart the game as that character.
+ */
+export declare function restart(character?: PlayerType): void;