isaacscript-common 11.0.1 → 11.2.0

package/dist/isaacscript-common.lua

@@ -1,6 +1,6 @@
 --[[
 
-isaacscript-common 11.0.1
+isaacscript-common 11.2.0
 
 This is the "isaacscript-common" library, which was created with the IsaacScript tool.
 
@@ -4861,7 +4861,7 @@ return ____exports
 ["lua_modules.isaac-typescript-definitions.dist.package"] = function(...) 
 return {
     name = "isaac-typescript-definitions",
-    version = "7.2.1",
+    version = "7.2.3",
     description = "TypeScript definitions for The Binding of Isaac: Repentance.",
     keywords = {"isaac", "rebirth", "afterbirth", "repentance"},
     homepage = "https://isaacscript.github.io/",
@@ -25272,6 +25272,8 @@ function ____exports.getCollectibleChargeType(self, collectibleType)
 end
 --- Helper function to get the in-game description for a collectible. Returns "Unknown" if the
 -- provided collectible type was not valid.
+-- 
+-- This function works for both vanilla and modded collectibles.
 function ____exports.getCollectibleDescription(self, collectibleType)
     local collectibleDescription = COLLECTIBLE_DESCRIPTION_MAP:get(collectibleType)
     if collectibleDescription ~= nil then
@@ -25423,6 +25425,8 @@ end
 -- type is not valid.
 -- 
 -- For example, `getCollectibleName(CollectibleType.SAD_ONION)` would return "Sad Onion".
+-- 
+-- This function works for both vanilla and modded collectibles.
 function ____exports.getCollectibleName(self, collectibleType)
     local collectibleName = COLLECTIBLE_TYPE_TO_NAME_MAP:get(collectibleType)
     if collectibleName ~= nil then
@@ -29016,6 +29020,8 @@ function ____exports.getOpenTrinketSlot(self, player)
 end
 --- Helper function to get the in-game description for a trinket. Returns "Unknown" if the provided
 -- trinket type was not valid.
+-- 
+-- This function works for both vanilla and modded trinkets.
 function ____exports.getTrinketDescription(self, trinketType)
     local trinketDescription = TRINKET_DESCRIPTION_MAP:get(trinketType)
     if trinketDescription ~= nil then
@@ -29044,6 +29050,8 @@ end
 -- not valid.
 -- 
 -- For example, `getTrinketName(TrinketType.SWALLOWED_PENNY)` would return "Swallowed Penny".
+-- 
+-- This function works for both vanilla and modded trinkets.
 function ____exports.getTrinketName(self, trinketType)
     local trinketName = TRINKET_TYPE_TO_NAME_MAP:get(trinketType)
     if trinketName ~= nil then
@@ -31625,8 +31633,9 @@ local ____lualib = require("lualib_bundle")
 local Set = ____lualib.Set
 local __TS__New = ____lualib.__TS__New
 local ____exports = {}
-local postPlayerInit, preGameExit, postNewLevel, postNewRoomEarly, restoreDefaultsAll, restoreDefaults, clearAndCopyAllElements, RESETTABLE_SAVE_DATA_KEYS, mod, loadedDataOnThisRun
+local postUseItemGlowingHourGlass, postPlayerInit, preGameExit, postNewLevel, postNewRoomEarly, restoreDefaultsAll, restoreDefaults, clearAndCopyAllElements, RESETTABLE_SAVE_DATA_KEYS, mod, loadedDataOnThisRun
 local ____isaac_2Dtypescript_2Ddefinitions = require("lua_modules.isaac-typescript-definitions.dist.src.index")
+local CollectibleType = ____isaac_2Dtypescript_2Ddefinitions.CollectibleType
 local ModCallback = ____isaac_2Dtypescript_2Ddefinitions.ModCallback
 local ____cachedClasses = require("src.core.cachedClasses")
 local game = ____cachedClasses.game
@@ -31656,6 +31665,9 @@ local saveToDisk = ____save.saveToDisk
 local ____saveDataManagerConstants = require("src.features.saveDataManager.saveDataManagerConstants")
 local SAVE_DATA_MANAGER_DEBUG = ____saveDataManagerConstants.SAVE_DATA_MANAGER_DEBUG
 local SAVE_DATA_MANAGER_FEATURE_NAME = ____saveDataManagerConstants.SAVE_DATA_MANAGER_FEATURE_NAME
+function postUseItemGlowingHourGlass(self)
+    return nil
+end
 function postPlayerInit(self)
     if mod == nil then
         error(("The mod for the " .. SAVE_DATA_MANAGER_FEATURE_NAME) .. " was not initialized.")
@@ -31738,6 +31750,7 @@ mod = nil
 loadedDataOnThisRun = false
 function ____exports.saveDataManagerInit(self, incomingMod)
     mod = incomingMod
+    mod:AddCallback(ModCallback.POST_USE_ITEM, postUseItemGlowingHourGlass, CollectibleType.GLOWING_HOUR_GLASS)
     mod:AddCallback(ModCallback.POST_PLAYER_INIT, postPlayerInit)
     mod:AddCallback(ModCallback.PRE_GAME_EXIT, preGameExit)
     mod:AddCallback(ModCallback.POST_NEW_LEVEL, postNewLevel)
@@ -39258,6 +39271,9 @@ end
 -- only use this function in the `POST_TEAR_INIT_VERY_LATE` callback or on frame 1+.
 -- 
 -- If this function is called on frame 0, it will throw a run-time error.
+-- 
+-- Note that this function does not work properly when the tear is from a Lead Pencil barrage. In
+-- this case, it will always appear as if the tear is coming from a player.
 function ____exports.isTearFromFamiliar(self, tear)
     if tear.FrameCount == 0 then
         error("Failed to check if the given tear was from a player since the tear's frame count was equal to 0. (The \"isTearFromFamiliar\" function must only be used in the \"POST_TEAR_INIT_VERY_LATE\" callback or on frame 1 and onwards.)")
@@ -39277,6 +39293,9 @@ end
 -- only use this function in the `POST_TEAR_INIT_VERY_LATE` callback or on frame 1+.
 -- 
 -- If this function is called on frame 0, it will throw a run-time error.
+-- 
+-- Note that this function does not work properly when the tear is from a Lead Pencil barrage. In
+-- this case, it will always appear as if the tear is coming from a player.
 function ____exports.isTearFromPlayer(self, tear)
     if tear.FrameCount == 0 then
         error("Failed to check if the given tear was from a player since the tear's frame count was equal to 0. (The \"isTearFromPlayer\" function must only be used in the \"POST_TEAR_INIT_VERY_LATE\" callback or on frame 1 and onwards.)")
@@ -46950,7 +46969,7 @@ return ____exports
 ["package"] = function(...) 
 return {
     name = "isaacscript-common",
-    version = "11.0.1",
+    version = "11.2.0",
     description = "Helper functions and features for IsaacScript mods.",
     keywords = {"isaac", "rebirth", "afterbirth", "repentance"},
     homepage = "https://isaacscript.github.io/",
@@ -46961,7 +46980,7 @@ return {
     type = "commonjs",
     main = "dist/src/index",
     types = "dist/src/index.d.ts",
-    dependencies = {["isaac-typescript-definitions"] = "^7.2.1"}
+    dependencies = {["isaac-typescript-definitions"] = "^7.2.3"}
 }
  end,
 ["src.functions.map"] = function(...) 
@@ -46997,7 +47016,7 @@ end
 --   ["bar", 456],
 -- ]);
 -- const searchText = "f";
--- const match = getMapPartialMatch(map, searchText); // match is now equal to 123
+-- const match = getMapPartialMatch(map, searchText); // match is now equal to ["foo", 123]
 -- 
 -- @returns If a match was found, returns a tuple of the map key and value. If a match was not
 -- found, returns undefined.
@@ -49818,6 +49837,142 @@ end
 function ____exports.isModdedPillEffect(self, pillEffect)
     return not ____exports.isVanillaPillEffect(nil, pillEffect)
 end
+return ____exports
+ end,
+["src.objects.transformationNames"] = function(...) 
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("lua_modules.isaac-typescript-definitions.dist.src.index")
+local PlayerForm = ____isaac_2Dtypescript_2Ddefinitions.PlayerForm
+____exports.TRANSFORMATION_NAMES = {
+    [PlayerForm.GUPPY] = "Guppy",
+    [PlayerForm.BEELZEBUB] = "Beelzebub",
+    [PlayerForm.FUN_GUY] = "Fun Guy",
+    [PlayerForm.SERAPHIM] = "Seraphim",
+    [PlayerForm.BOB] = "Bob",
+    [PlayerForm.SPUN] = "Spun",
+    [PlayerForm.YES_MOTHER] = "Yes Mother?",
+    [PlayerForm.CONJOINED] = "Conjoined",
+    [PlayerForm.LEVIATHAN] = "Leviathan",
+    [PlayerForm.OH_CRAP] = "Oh Crap",
+    [PlayerForm.BOOKWORM] = "Bookworm",
+    [PlayerForm.ADULT] = "Adult",
+    [PlayerForm.SPIDER_BABY] = "Spider Baby",
+    [PlayerForm.STOMPY] = "Stompy"
+}
+return ____exports
+ end,
+["src.functions.transformations"] = function(...) 
+local ____lualib = require("lualib_bundle")
+local Map = ____lualib.Map
+local __TS__New = ____lualib.__TS__New
+local Set = ____lualib.Set
+local __TS__Spread = ____lualib.__TS__Spread
+local __TS__Iterator = ____lualib.__TS__Iterator
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("lua_modules.isaac-typescript-definitions.dist.src.index")
+local ItemConfigTag = ____isaac_2Dtypescript_2Ddefinitions.ItemConfigTag
+local PlayerForm = ____isaac_2Dtypescript_2Ddefinitions.PlayerForm
+local ____transformationNames = require("src.objects.transformationNames")
+local TRANSFORMATION_NAMES = ____transformationNames.TRANSFORMATION_NAMES
+local ____collectibles = require("src.functions.collectibles")
+local getCollectibleTags = ____collectibles.getCollectibleTags
+local ____collectibleTag = require("src.functions.collectibleTag")
+local getCollectibleTypesWithTag = ____collectibleTag.getCollectibleTypesWithTag
+local ____enums = require("src.functions.enums")
+local getEnumValues = ____enums.getEnumValues
+local ____flag = require("src.functions.flag")
+local hasFlag = ____flag.hasFlag
+local ____players = require("src.functions.players")
+local getPlayerCollectibleCount = ____players.getPlayerCollectibleCount
+local TRANSFORMATION_TO_TAG_MAP = __TS__New(Map, {
+    {PlayerForm.GUPPY, ItemConfigTag.GUPPY},
+    {PlayerForm.BEELZEBUB, ItemConfigTag.FLY},
+    {PlayerForm.FUN_GUY, ItemConfigTag.MUSHROOM},
+    {PlayerForm.SERAPHIM, ItemConfigTag.ANGEL},
+    {PlayerForm.BOB, ItemConfigTag.BOB},
+    {PlayerForm.SPUN, ItemConfigTag.SYRINGE},
+    {PlayerForm.YES_MOTHER, ItemConfigTag.MOM},
+    {PlayerForm.CONJOINED, ItemConfigTag.BABY},
+    {PlayerForm.LEVIATHAN, ItemConfigTag.DEVIL},
+    {PlayerForm.OH_CRAP, ItemConfigTag.POOP},
+    {PlayerForm.BOOKWORM, ItemConfigTag.BOOK},
+    {PlayerForm.SPIDER_BABY, ItemConfigTag.SPIDER}
+})
+local TRANSFORMATIONS_THAT_GRANT_FLYING = __TS__New(Set, {PlayerForm.GUPPY, PlayerForm.BEELZEBUB, PlayerForm.SERAPHIM, PlayerForm.LEVIATHAN})
+--- Helper function to get all of the collectible types in the game that count towards a particular
+-- transformation.
+-- 
+-- For example, to get all of the collectible types that count towards Guppy:
+-- 
+-- ```ts
+-- const guppyCollectibleTypes = getCollectibleTypesForTransformation(PlayerForm.GUPPY);
+-- ```
+function ____exports.getCollectibleTypesForTransformation(self, playerForm)
+    local itemConfigTag = TRANSFORMATION_TO_TAG_MAP:get(playerForm)
+    if itemConfigTag == nil then
+        error(("Failed to get the collectible types for the transformation of " .. tostring(playerForm)) .. " because that transformation is not based on collectibles.")
+    end
+    return getCollectibleTypesWithTag(nil, itemConfigTag)
+end
+--- Returns the number of items that a player has towards a particular transformation.
+function ____exports.getPlayerNumCollectiblesForTransformation(self, player, playerForm)
+    local collectibleTypes = ____exports.getCollectibleTypesForTransformation(nil, playerForm)
+    return getPlayerCollectibleCount(
+        nil,
+        player,
+        __TS__Spread(collectibleTypes:values())
+    )
+end
+--- Returns a set of the player's current transformations.
+function ____exports.getPlayerTransformations(self, player)
+    local transformations = __TS__New(Set)
+    for ____, playerForm in ipairs(getEnumValues(nil, PlayerForm)) do
+        if player:HasPlayerForm(playerForm) then
+            transformations:add(playerForm)
+        end
+    end
+    return transformations
+end
+--- Helper function to get a transformation name from a PlayerForm enum.
+-- 
+-- For example:
+-- 
+-- ```ts
+-- const transformationName = getTransformationName(PlayerForm.LORD_OF_THE_FLIES);
+-- // transformationName is "Beelzebub"
+-- ```
+function ____exports.getTransformationName(self, playerForm)
+    return TRANSFORMATION_NAMES[playerForm]
+end
+function ____exports.getTransformationsForCollectibleType(self, collectibleType)
+    local itemConfigTags = getCollectibleTags(nil, collectibleType)
+    local playerForms = getEnumValues(nil, PlayerForm)
+    local transformationSet = __TS__New(Set)
+    for ____, playerForm in ipairs(playerForms) do
+        do
+            local itemConfigTag = TRANSFORMATION_TO_TAG_MAP:get(playerForm)
+            if itemConfigTag == nil then
+                goto __continue11
+            end
+            if hasFlag(nil, itemConfigTags, itemConfigTag) then
+                transformationSet:add(playerForm)
+            end
+        end
+        ::__continue11::
+    end
+    return transformationSet
+end
+function ____exports.hasFlyingTransformation(self, player)
+    for ____, playerForm in __TS__Iterator(TRANSFORMATIONS_THAT_GRANT_FLYING:values()) do
+        if player:HasPlayerForm(playerForm) then
+            return true
+        end
+    end
+    return false
+end
+function ____exports.isTransformationFlying(self, playerForm)
+    return TRANSFORMATIONS_THAT_GRANT_FLYING:has(playerForm)
+end
 return ____exports
  end,
 ["src.maps.cardNameToTypeMap"] = function(...) 
@@ -50287,6 +50442,45 @@ ____exports.ROOM_NAME_TO_TYPE_MAP = __TS__New(Map, {
     {"blue", RoomType.BLUE},
     {"ultraSecret", RoomType.ULTRA_SECRET}
 })
+return ____exports
+ end,
+["src.maps.transformationNameToPlayerForm"] = function(...) 
+local ____lualib = require("lualib_bundle")
+local Map = ____lualib.Map
+local __TS__New = ____lualib.__TS__New
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("lua_modules.isaac-typescript-definitions.dist.src.index")
+local PlayerForm = ____isaac_2Dtypescript_2Ddefinitions.PlayerForm
+--- Maps transformation names to the values of the `PlayerForm` enum.
+____exports.TRANSFORMATION_NAME_TO_PLAYER_FORM_MAP = __TS__New(Map, {
+    {"guppy", PlayerForm.GUPPY},
+    {"cat", PlayerForm.GUPPY},
+    {"beelzebub", PlayerForm.BEELZEBUB},
+    {"fly", PlayerForm.BEELZEBUB},
+    {"funGuy", PlayerForm.FUN_GUY},
+    {"mushroom", PlayerForm.FUN_GUY},
+    {"seraphim", PlayerForm.SERAPHIM},
+    {"angel", PlayerForm.SERAPHIM},
+    {"bob", PlayerForm.BOB},
+    {"poison", PlayerForm.BOB},
+    {"spun", PlayerForm.SPUN},
+    {"drugs", PlayerForm.SPUN},
+    {"needles", PlayerForm.SPUN},
+    {"yesMother", PlayerForm.YES_MOTHER},
+    {"mother", PlayerForm.YES_MOTHER},
+    {"mom", PlayerForm.YES_MOTHER},
+    {"conjoined", PlayerForm.CONJOINED},
+    {"triple", PlayerForm.CONJOINED},
+    {"leviathan", PlayerForm.LEVIATHAN},
+    {"devil", PlayerForm.LEVIATHAN},
+    {"ohCrap", PlayerForm.OH_CRAP},
+    {"crap", PlayerForm.OH_CRAP},
+    {"poop", PlayerForm.OH_CRAP},
+    {"bookWorm", PlayerForm.BOOKWORM},
+    {"adult", PlayerForm.ADULT},
+    {"spiderBaby", PlayerForm.SPIDER_BABY},
+    {"stompy", PlayerForm.STOMPY}
+})
 return ____exports
  end,
 ["src.maps.trinketNameToTypeMap"] = function(...) 
@@ -50726,14 +50920,16 @@ local v = {persistent = {
     maze = false,
     blind = false,
     giant = false,
-    disableCurses = false
-}, run = {
+    disableCurses = false,
+    damage = false,
+    damageAmount = 500,
+    speed = false,
+    speedAmount = 2,
+    tears = false,
+    tearsAmount = 1,
+    flight = false,
     chaosCardTears = false,
-    spamBloodRights = false,
-    maxDamage = false,
-    maxSpeed = false,
-    maxTears = false,
-    flight = false
+    spamBloodRights = false
 }}
 ____exports.default = v
 --- The contents of the map are initialized in the "init.ts" file.
@@ -50766,6 +50962,7 @@ local GridEntityType = ____isaac_2Dtypescript_2Ddefinitions.GridEntityType
 local GridRoom = ____isaac_2Dtypescript_2Ddefinitions.GridRoom
 local LevelStage = ____isaac_2Dtypescript_2Ddefinitions.LevelStage
 local PillColor = ____isaac_2Dtypescript_2Ddefinitions.PillColor
+local PlayerForm = ____isaac_2Dtypescript_2Ddefinitions.PlayerForm
 local RoomType = ____isaac_2Dtypescript_2Ddefinitions.RoomType
 local StageType = ____isaac_2Dtypescript_2Ddefinitions.StageType
 local ____cachedClasses = require("src.core.cachedClasses")
@@ -50798,6 +50995,7 @@ local ____entitiesSpecific = require("src.functions.entitiesSpecific")
 local getNPCs = ____entitiesSpecific.getNPCs
 local ____enums = require("src.functions.enums")
 local getEnumValues = ____enums.getEnumValues
+local getLastEnumValue = ____enums.getLastEnumValue
 local ____flag = require("src.functions.flag")
 local addFlag = ____flag.addFlag
 local ____gridEntities = require("src.functions.gridEntities")
@@ -50836,10 +51034,15 @@ local ____run = require("src.functions.run")
 local onSetSeed = ____run.onSetSeed
 local restart = ____run.restart
 local setUnseeded = ____run.setUnseeded
+local ____set = require("src.functions.set")
+local getSortedSetValues = ____set.getSortedSetValues
 local ____spawnCollectible = require("src.functions.spawnCollectible")
 local spawnCollectibleFunction = ____spawnCollectible.spawnCollectible
 local ____stage = require("src.functions.stage")
 local setStage = ____stage.setStage
+local ____transformations = require("src.functions.transformations")
+local getCollectibleTypesForTransformation = ____transformations.getCollectibleTypesForTransformation
+local getTransformationName = ____transformations.getTransformationName
 local ____trinkets = require("src.functions.trinkets")
 local getGoldenTrinketType = ____trinkets.getGoldenTrinketType
 local ____types = require("src.functions.types")
@@ -50860,6 +51063,8 @@ local ____pillNameToEffectMap = require("src.maps.pillNameToEffectMap")
 local PILL_NAME_TO_EFFECT_MAP = ____pillNameToEffectMap.PILL_NAME_TO_EFFECT_MAP
 local ____roomNameToTypeMap = require("src.maps.roomNameToTypeMap")
 local ROOM_NAME_TO_TYPE_MAP = ____roomNameToTypeMap.ROOM_NAME_TO_TYPE_MAP
+local ____transformationNameToPlayerForm = require("src.maps.transformationNameToPlayerForm")
+local TRANSFORMATION_NAME_TO_PLAYER_FORM_MAP = ____transformationNameToPlayerForm.TRANSFORMATION_NAME_TO_PLAYER_FORM_MAP
 local ____trinketNameToTypeMap = require("src.maps.trinketNameToTypeMap")
 local TRINKET_NAME_TO_TYPE_MAP = ____trinketNameToTypeMap.TRINKET_NAME_TO_TYPE_MAP
 local ____firstLast = require("src.features.firstLast")
@@ -50883,8 +51088,8 @@ end
 --- Toggles Chaos Card tears for the player. Useful for killing enemies very fast without using
 -- "debug 10".
 function ____exports.chaosCardTears(self)
-    v.run.chaosCardTears = not v.run.chaosCardTears
-    printEnabled(nil, v.run.chaosCardTears, "Chaos Card tears")
+    v.persistent.chaosCardTears = not v.persistent.chaosCardTears
+    printEnabled(nil, v.persistent.chaosCardTears, "Chaos Card tears")
 end
 --- Warps to the Devil Room for the floor. If the Angel Room has already been visited or initialized,
 -- this will uninitialize it and make an Devil Room instead.
@@ -50954,6 +51159,56 @@ function ____exports.startingRoom(self)
     local startingRoomIndex = level:GetStartingRoomIndex()
     changeRoom(nil, startingRoomIndex)
 end
+--- Gives the specified transformation. Accepts either the transformation number or the partial name
+-- of the transformation.
+-- 
+-- For example:
+-- - transformation 1 - Gives the Beelzebub transformation.
+-- - transformation gup - Gives the Guppy transformation.
+function ____exports.transformation(self, params)
+    if params == "" then
+        printConsole(nil, "You must specify a transformation name or number.")
+        return
+    end
+    local targetPlayerForm
+    local num = tonumber(params)
+    if num == nil then
+        local match = getMapPartialMatch(nil, params, TRANSFORMATION_NAME_TO_PLAYER_FORM_MAP)
+        if match == nil then
+            printConsole(nil, "Unknown transformation: " .. params)
+            return
+        end
+        targetPlayerForm = match[2]
+    else
+        local lastPlayerForm = getLastEnumValue(nil, PlayerForm)
+        if num < PlayerForm.GUPPY or num > lastPlayerForm then
+            printConsole(
+                nil,
+                "Invalid transformation number: " .. tostring(num)
+            )
+            return
+        end
+        targetPlayerForm = num
+    end
+    local transformationName = getTransformationName(nil, targetPlayerForm)
+    local player = Isaac.GetPlayer()
+    local collectibleTypesSet = getCollectibleTypesForTransformation(nil, targetPlayerForm)
+    local collectiblesTypes = getSortedSetValues(nil, collectibleTypesSet)
+    do
+        local i = 0
+        while i < 3 do
+            local collectibleType = collectiblesTypes[i + 1]
+            if collectibleType ~= nil then
+                player:AddCollectible(collectibleType)
+            end
+            i = i + 1
+        end
+    end
+    printConsole(
+        nil,
+        ((("Gave transformation: " .. transformationName) .. " (") .. tostring(targetPlayerForm)) .. ")"
+    )
+end
 --- Adds a single charge to the player's specified active item. You must provide the active slot
 -- number. Provide a second number to give a custom amount of charges. (You can use negative numbers
 -- to remove charge.)
@@ -51273,10 +51528,19 @@ function ____exports.dadsNote(self)
     setStage(nil, LevelStage.DEPTHS_2, StageType.REPENTANCE)
     ____exports.bossRoom(nil)
 end
---- Toggles extremely high-damage tears for the player.
-function ____exports.damage(self)
-    v.run.maxDamage = not v.run.maxDamage
-    printEnabled(nil, v.run.maxDamage, "debug damage")
+--- Toggles a set damage stat for the player. You can provide an optional argument to this command in
+-- order to set the damage to a specific amount. Default is 500.
+function ____exports.damage(self, params)
+    if params ~= "" then
+        local num = tonumber(params)
+        if num == nil then
+            printConsole(nil, "The provided damage amount is invalid: " .. params)
+            return
+        end
+        v.persistent.damageAmount = num
+    end
+    v.persistent.damage = not v.persistent.damage
+    printEnabled(nil, v.persistent.damage, "debug damage")
 end
 --- Toggles permanent Curse of Darkness.
 function ____exports.darkness(self)
@@ -51322,21 +51586,21 @@ end
 --- Toggles flight for the player.
 function ____exports.flight(self, params)
     local player = Isaac.GetPlayer()
-    v.run.flight = not v.run.flight
+    v.persistent.flight = not v.persistent.flight
     if params == "true" then
-        v.run.flight = true
+        v.persistent.flight = true
     elseif params == "false" then
-        v.run.flight = false
+        v.persistent.flight = false
     end
     player:AddCacheFlags(CacheFlag.FLYING)
     player:EvaluateItems()
     local collectibleUsedToShowFlight = CollectibleType.FATE
-    if v.run.flight then
+    if v.persistent.flight then
         addCollectibleCostume(nil, player, collectibleUsedToShowFlight)
     else
         removeCollectibleCostume(nil, player, collectibleUsedToShowFlight)
     end
-    printEnabled(nil, v.run.maxSpeed, "max speed")
+    printEnabled(nil, v.persistent.speed, "max speed")
 end
 --- Alias for the "startingRoom" command.
 function ____exports.fool(self)
@@ -51626,6 +51890,10 @@ end
 function ____exports.playSound(self, params)
     ____exports.sound(nil, params)
 end
+--- Alias for the "transformation" command.
+function ____exports.playerForm(self, params)
+    ____exports.transformation(nil, params)
+end
 --- Sets the player's pocket item to the specified collectible type.
 function ____exports.pocket(self, params)
     if params == "" then
@@ -51858,8 +52126,8 @@ end
 --- Toggles spamming Blood Rights on every frame. Useful for killing enemies very fast without using
 -- "debug 10".
 function ____exports.spam(self)
-    v.run.spamBloodRights = not v.run.spamBloodRights
-    printEnabled(nil, v.run.spamBloodRights, "spamming Blood Rights")
+    v.persistent.spamBloodRights = not v.persistent.spamBloodRights
+    printEnabled(nil, v.persistent.spamBloodRights, "spamming Blood Rights")
 end
 function ____exports.spawnCollectible(self, params)
     if params == "" then
@@ -51926,15 +52194,25 @@ function ____exports.spawnTrinket(self, params)
     local centerPos = roomClass:GetCenterPos()
     spawnTrinketFunction(nil, trinketType, centerPos)
 end
---- Toggles maximum movement speed and flight for the player.
-function ____exports.speed(self)
+--- Toggles a set movement speed and flight for the player. You can provide an optional argument to
+-- this command in order to set the speed to a specific amount. Default is 2.0 (which is the maximum
+-- that the stat can be set to).
+function ____exports.speed(self, params)
     local player = Isaac.GetPlayer()
-    v.run.maxSpeed = not v.run.maxSpeed
+    if params ~= "" then
+        local num = tonumber(params)
+        if num == nil then
+            printConsole(nil, "The provided speed amount is invalid: " .. params)
+            return
+        end
+        v.persistent.damageAmount = num
+    end
+    v.persistent.speed = not v.persistent.speed
     player:AddCacheFlags(CacheFlag.SPEED)
     player:EvaluateItems()
-    local value = tostring(v.run.maxSpeed)
+    local value = tostring(v.persistent.speed)
     ____exports.flight(nil, value)
-    printEnabled(nil, v.run.maxSpeed, "max speed and flight")
+    printEnabled(nil, v.persistent.speed, "max speed and flight")
 end
 --- Alias for the "startingRoom" command.
 function ____exports.startRoom(self)
@@ -51944,14 +52222,23 @@ end
 function ____exports.superSecretRoom(self)
     warpToRoomType(nil, RoomType.SUPER_SECRET)
 end
---- Toggles an extremely high tears stat (e.g. fire rate) for the player, equivalent of that to soy
--- milk.
-function ____exports.tears(self)
-    v.run.maxTears = not v.run.maxTears
+--- Toggles a set tear delay (e.g. fire rate) for the player. You can provide an optional argument to
+-- this command in order to set the tear delay to a specific amount. Default is 1 (which is
+-- equivalent to the Soy Milk tear rate).
+function ____exports.tears(self, params)
+    if params ~= "" then
+        local num = tonumber(params)
+        if num == nil then
+            printConsole(nil, "The provided tear delay amount is invalid: " .. params)
+            return
+        end
+        v.persistent.tearsAmount = num
+    end
+    v.persistent.tears = not v.persistent.tears
     local player = Isaac.GetPlayer()
     player:AddCacheFlags(CacheFlag.FIRE_DELAY)
     player:EvaluateItems()
-    printEnabled(nil, v.run.maxDamage, "debug tear-rate")
+    printEnabled(nil, v.persistent.damage, "debug tear-rate")
 end
 --- Alias for the "runTests" command.
 function ____exports.tests(self)
@@ -52026,16 +52313,13 @@ local ____lualib = require("lualib_bundle")
 local Map = ____lualib.Map
 local __TS__ObjectEntries = ____lualib.__TS__ObjectEntries
 local ____exports = {}
-local initCommandMap, initCallbacks, postUpdate, evaluateCacheFireDelay, evaluateCacheSpeed, evaluateCacheFlying, entityTakeDmgPlayer, postCurseEval, executeCmd, postFireTear
+local initCommandMap, initCallbacks, postUpdate, evaluateCacheDamage, evaluateCacheFireDelay, evaluateCacheSpeed, evaluateCacheFlying, entityTakeDmgPlayer, postCurseEval, executeCmd
 local ____isaac_2Dtypescript_2Ddefinitions = require("lua_modules.isaac-typescript-definitions.dist.src.index")
 local CacheFlag = ____isaac_2Dtypescript_2Ddefinitions.CacheFlag
 local CollectibleType = ____isaac_2Dtypescript_2Ddefinitions.CollectibleType
 local EntityType = ____isaac_2Dtypescript_2Ddefinitions.EntityType
 local LevelCurse = ____isaac_2Dtypescript_2Ddefinitions.LevelCurse
 local ModCallback = ____isaac_2Dtypescript_2Ddefinitions.ModCallback
-local TearVariant = ____isaac_2Dtypescript_2Ddefinitions.TearVariant
-local ____constants = require("src.core.constants")
-local MAX_SPEED_STAT = ____constants.MAX_SPEED_STAT
 local ____flag = require("src.functions.flag")
 local addFlag = ____flag.addFlag
 local bitFlags = ____flag.bitFlags
@@ -52066,37 +52350,42 @@ function initCommandMap(self)
 end
 function initCallbacks(self, mod)
     mod:AddCallback(ModCallback.POST_UPDATE, postUpdate)
+    mod:AddCallback(ModCallback.EVALUATE_CACHE, evaluateCacheDamage, CacheFlag.DAMAGE)
     mod:AddCallback(ModCallback.EVALUATE_CACHE, evaluateCacheFireDelay, CacheFlag.FIRE_DELAY)
     mod:AddCallback(ModCallback.EVALUATE_CACHE, evaluateCacheSpeed, CacheFlag.SPEED)
     mod:AddCallback(ModCallback.EVALUATE_CACHE, evaluateCacheFlying, CacheFlag.FLYING)
     mod:AddCallback(ModCallback.ENTITY_TAKE_DMG, entityTakeDmgPlayer, EntityType.PLAYER)
     mod:AddCallback(ModCallback.POST_CURSE_EVAL, postCurseEval)
     mod:AddCallback(ModCallback.EXECUTE_CMD, executeCmd)
-    mod:AddCallback(ModCallback.POST_FIRE_TEAR, postFireTear)
 end
 function postUpdate(self)
-    if v.run.spamBloodRights then
+    if v.persistent.spamBloodRights then
         local player = Isaac.GetPlayer()
         player:UseActiveItem(CollectibleType.BLOOD_RIGHTS)
     end
 end
+function evaluateCacheDamage(self, player)
+    if v.persistent.damage then
+        player.Damage = v.persistent.damageAmount
+    end
+end
 function evaluateCacheFireDelay(self, player)
-    if v.run.maxTears then
-        player.FireDelay = 1
+    if v.persistent.tears then
+        player.FireDelay = v.persistent.tearsAmount
     end
 end
 function evaluateCacheSpeed(self, player)
-    if v.run.maxSpeed then
-        player.MoveSpeed = MAX_SPEED_STAT
+    if v.persistent.speed then
+        player.MoveSpeed = v.persistent.speedAmount
     end
 end
 function evaluateCacheFlying(self, player)
-    if v.run.flight then
+    if v.persistent.flight then
         player.CanFly = true
     end
 end
 function entityTakeDmgPlayer(self, _entity, _damageAmount, _damageFlags, _damageSource, _damageCountdownFrames)
-    if v.run.spamBloodRights then
+    if v.persistent.spamBloodRights then
         return false
     end
     return nil
@@ -52148,15 +52437,6 @@ function executeCmd(self, command, params)
     printConsole(nil, "Command: " .. commandName)
     commandFunction(nil, params)
 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
 function ____exports.extraConsoleCommandsInit(self, mod)
     saveDataManager(nil, "extraConsoleCommands", v, false)
     initCommandMap(nil)
@@ -54605,142 +54885,6 @@ function ____exports.nextSeed(self, seed)
     rng:Next()
     return rng:GetSeed()
 end
-return ____exports
- end,
-["src.objects.transformationNames"] = function(...) 
-local ____exports = {}
-local ____isaac_2Dtypescript_2Ddefinitions = require("lua_modules.isaac-typescript-definitions.dist.src.index")
-local PlayerForm = ____isaac_2Dtypescript_2Ddefinitions.PlayerForm
-____exports.TRANSFORMATION_NAMES = {
-    [PlayerForm.GUPPY] = "Guppy",
-    [PlayerForm.BEELZEBUB] = "Beelzebub",
-    [PlayerForm.FUN_GUY] = "Fun Guy",
-    [PlayerForm.SERAPHIM] = "Seraphim",
-    [PlayerForm.BOB] = "Bob",
-    [PlayerForm.SPUN] = "Spun",
-    [PlayerForm.YES_MOTHER] = "Yes Mother?",
-    [PlayerForm.CONJOINED] = "Conjoined",
-    [PlayerForm.LEVIATHAN] = "Leviathan",
-    [PlayerForm.OH_CRAP] = "Oh Crap",
-    [PlayerForm.BOOKWORM] = "Bookworm",
-    [PlayerForm.ADULT] = "Adult",
-    [PlayerForm.SPIDER_BABY] = "Spider Baby",
-    [PlayerForm.STOMPY] = "Stompy"
-}
-return ____exports
- end,
-["src.functions.transformations"] = function(...) 
-local ____lualib = require("lualib_bundle")
-local Map = ____lualib.Map
-local __TS__New = ____lualib.__TS__New
-local Set = ____lualib.Set
-local __TS__Spread = ____lualib.__TS__Spread
-local __TS__Iterator = ____lualib.__TS__Iterator
-local ____exports = {}
-local ____isaac_2Dtypescript_2Ddefinitions = require("lua_modules.isaac-typescript-definitions.dist.src.index")
-local ItemConfigTag = ____isaac_2Dtypescript_2Ddefinitions.ItemConfigTag
-local PlayerForm = ____isaac_2Dtypescript_2Ddefinitions.PlayerForm
-local ____transformationNames = require("src.objects.transformationNames")
-local TRANSFORMATION_NAMES = ____transformationNames.TRANSFORMATION_NAMES
-local ____collectibles = require("src.functions.collectibles")
-local getCollectibleTags = ____collectibles.getCollectibleTags
-local ____collectibleTag = require("src.functions.collectibleTag")
-local getCollectibleTypesWithTag = ____collectibleTag.getCollectibleTypesWithTag
-local ____enums = require("src.functions.enums")
-local getEnumValues = ____enums.getEnumValues
-local ____flag = require("src.functions.flag")
-local hasFlag = ____flag.hasFlag
-local ____players = require("src.functions.players")
-local getPlayerCollectibleCount = ____players.getPlayerCollectibleCount
-local TRANSFORMATION_TO_TAG_MAP = __TS__New(Map, {
-    {PlayerForm.GUPPY, ItemConfigTag.GUPPY},
-    {PlayerForm.BEELZEBUB, ItemConfigTag.FLY},
-    {PlayerForm.FUN_GUY, ItemConfigTag.MUSHROOM},
-    {PlayerForm.SERAPHIM, ItemConfigTag.ANGEL},
-    {PlayerForm.BOB, ItemConfigTag.BOB},
-    {PlayerForm.SPUN, ItemConfigTag.SYRINGE},
-    {PlayerForm.YES_MOTHER, ItemConfigTag.MOM},
-    {PlayerForm.CONJOINED, ItemConfigTag.BABY},
-    {PlayerForm.LEVIATHAN, ItemConfigTag.DEVIL},
-    {PlayerForm.OH_CRAP, ItemConfigTag.POOP},
-    {PlayerForm.BOOKWORM, ItemConfigTag.BOOK},
-    {PlayerForm.SPIDER_BABY, ItemConfigTag.SPIDER}
-})
-local TRANSFORMATIONS_THAT_GRANT_FLYING = __TS__New(Set, {PlayerForm.GUPPY, PlayerForm.BEELZEBUB, PlayerForm.SERAPHIM, PlayerForm.LEVIATHAN})
---- Helper function to get all of the collectible types in the game that count towards a particular
--- transformation.
--- 
--- For example, to get all of the collectible types that count towards Guppy:
--- 
--- ```ts
--- const guppyCollectibleTypes = getCollectibleTypesForTransformation(PlayerForm.GUPPY);
--- ```
-function ____exports.getCollectibleTypesForTransformation(self, playerForm)
-    local itemConfigTag = TRANSFORMATION_TO_TAG_MAP:get(playerForm)
-    if itemConfigTag == nil then
-        error(("Failed to get the collectible types for the transformation of " .. tostring(playerForm)) .. " because that transformation is not based on collectibles.")
-    end
-    return getCollectibleTypesWithTag(nil, itemConfigTag)
-end
---- Returns the number of items that a player has towards a particular transformation.
-function ____exports.getPlayerNumCollectiblesForTransformation(self, player, playerForm)
-    local collectibleTypes = ____exports.getCollectibleTypesForTransformation(nil, playerForm)
-    return getPlayerCollectibleCount(
-        nil,
-        player,
-        __TS__Spread(collectibleTypes:values())
-    )
-end
---- Returns a set of the player's current transformations.
-function ____exports.getPlayerTransformations(self, player)
-    local transformations = __TS__New(Set)
-    for ____, playerForm in ipairs(getEnumValues(nil, PlayerForm)) do
-        if player:HasPlayerForm(playerForm) then
-            transformations:add(playerForm)
-        end
-    end
-    return transformations
-end
---- Helper function to get a transformation name from a PlayerForm enum.
--- 
--- For example:
--- 
--- ```ts
--- const transformationName = getTransformationName(PlayerForm.LORD_OF_THE_FLIES);
--- // transformationName is "Beelzebub"
--- ```
-function ____exports.getTransformationName(self, playerForm)
-    return TRANSFORMATION_NAMES[playerForm]
-end
-function ____exports.getTransformationsForCollectibleType(self, collectibleType)
-    local itemConfigTags = getCollectibleTags(nil, collectibleType)
-    local playerForms = getEnumValues(nil, PlayerForm)
-    local transformationSet = __TS__New(Set)
-    for ____, playerForm in ipairs(playerForms) do
-        do
-            local itemConfigTag = TRANSFORMATION_TO_TAG_MAP:get(playerForm)
-            if itemConfigTag == nil then
-                goto __continue11
-            end
-            if hasFlag(nil, itemConfigTags, itemConfigTag) then
-                transformationSet:add(playerForm)
-            end
-        end
-        ::__continue11::
-    end
-    return transformationSet
-end
-function ____exports.hasFlyingTransformation(self, player)
-    for ____, playerForm in __TS__Iterator(TRANSFORMATIONS_THAT_GRANT_FLYING:values()) do
-        if player:HasPlayerForm(playerForm) then
-            return true
-        end
-    end
-    return false
-end
-function ____exports.isTransformationFlying(self, playerForm)
-    return TRANSFORMATIONS_THAT_GRANT_FLYING:has(playerForm)
-end
 return ____exports
  end,
 ["src.functions.trinketCacheFlag"] = function(...)