isaacscript-common 1.2.135 → 1.2.138

package/dist/features/extraConsoleCommands/commands.lua

@@ -0,0 +1,658 @@
+--[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+local ____lualib = require("lualib_bundle")
+local Map = ____lualib.Map
+local __TS__StringSlice = ____lualib.__TS__StringSlice
+local ____exports = {}
+local addHeart, devilAngel, listEntities, listGridEntities, movePlayer, printEnabled, spawnTrapdoorOrCrawlspace, warpToRoomType, DEFAULT_MOVE_UNITS
+local ____cachedClasses = require("cachedClasses")
+local game = ____cachedClasses.game
+local sfxManager = ____cachedClasses.sfxManager
+local ____constants = require("constants")
+local PILL_GIANT_FLAG = ____constants.PILL_GIANT_FLAG
+local ____gridEntity = require("functions.gridEntity")
+local spawnGridEntityWithVariant = ____gridEntity.spawnGridEntityWithVariant
+local ____log = require("functions.log")
+local logAllSeedEffects = ____log.logAllSeedEffects
+local logEntities = ____log.logEntities
+local logGridEntities = ____log.logGridEntities
+local logRoom = ____log.logRoom
+local logSounds = ____log.logSounds
+local logTemporaryEffects = ____log.logTemporaryEffects
+local ____map = require("functions.map")
+local getMapPartialMatch = ____map.getMapPartialMatch
+local ____npc = require("functions.npc")
+local getNPCs = ____npc.getNPCs
+local ____player = require("functions.player")
+local getPlayers = ____player.getPlayers
+local useActiveItemTemp = ____player.useActiveItemTemp
+local ____playerHealth = require("functions.playerHealth")
+local addPlayerHealthType = ____playerHealth.addPlayerHealthType
+local ____rooms = require("functions.rooms")
+local changeRoom = ____rooms.changeRoom
+local getRoomData = ____rooms.getRoomData
+local getRoomGridIndexesForType = ____rooms.getRoomGridIndexesForType
+local gridToPos = ____rooms.gridToPos
+local ____run = require("functions.run")
+local restart = ____run.restart
+local ____utils = require("functions.utils")
+local printConsole = ____utils.printConsole
+local ____vector = require("functions.vector")
+local directionToVector = ____vector.directionToVector
+local ____cardMap = require("maps.cardMap")
+local CARD_MAP = ____cardMap.CARD_MAP
+local ____characterMap = require("maps.characterMap")
+local CHARACTER_MAP = ____characterMap.CHARACTER_MAP
+local ____pillEffectMap = require("maps.pillEffectMap")
+local PILL_EFFECT_MAP = ____pillEffectMap.PILL_EFFECT_MAP
+local ____HealthType = require("types.HealthType")
+local HealthType = ____HealthType.HealthType
+local ____v = require("features.extraConsoleCommands.v")
+local v = ____v.default
+function ____exports.blackHearts(self, params)
+    addHeart(nil, params, HealthType.BLACK)
+end
+function ____exports.chaosCardTears(self)
+    v.run.chaosCardTears = not v.run.chaosCardTears
+    printEnabled(nil, v.run.chaosCardTears, "Chaos Card tears")
+end
+function ____exports.devil(self)
+    devilAngel(nil, true)
+end
+function ____exports.eternalHearts(self, params)
+    addHeart(nil, params, HealthType.ETERNAL)
+end
+function ____exports.goldenBomb(self)
+    local player = Isaac.GetPlayer()
+    player:AddGoldenBomb()
+end
+function ____exports.goldenKey(self)
+    local player = Isaac.GetPlayer()
+    player:AddGoldenKey()
+end
+function ____exports.hearts(self, params)
+    addHeart(nil, params, HealthType.RED)
+end
+function ____exports.IAMERROR(self)
+    changeRoom(nil, GridRooms.ROOM_ERROR_IDX)
+end
+function ____exports.soulHearts(self, params)
+    addHeart(nil, params, HealthType.SOUL)
+end
+function ____exports.startingRoom(self)
+    local level = game:GetLevel()
+    local startingRoomIndex = level:GetStartingRoomIndex()
+    changeRoom(nil, startingRoomIndex)
+end
+function addHeart(self, params, healthType)
+    local numHearts = healthType == HealthType.MAX_HEARTS and 2 or 1
+    if params ~= "" then
+        local num = tonumber(params)
+        if num == nil then
+            printConsole(nil, "That is an invalid amount of hearts to add.")
+            return
+        end
+        numHearts = num
+    end
+    local player = Isaac.GetPlayer()
+    addPlayerHealthType(nil, player, healthType, numHearts)
+end
+function devilAngel(self, useDevil)
+    local level = game:GetLevel()
+    local devilAngelRoomData = getRoomData(nil, GridRooms.ROOM_DEVIL_IDX)
+    if devilAngelRoomData ~= nil then
+        local roomType = devilAngelRoomData.Type
+        local conflictingType = useDevil and RoomType.ROOM_ANGEL or RoomType.ROOM_DEVIL
+        if roomType == conflictingType then
+            local roomDesc = level:GetRoomByIdx(GridRooms.ROOM_DEVIL_IDX)
+            roomDesc.Data = nil
+        end
+    end
+    if useDevil then
+        level:InitializeDevilAngelRoom(false, true)
+    else
+        level:InitializeDevilAngelRoom(true, false)
+    end
+    changeRoom(nil, GridRooms.ROOM_DEVIL_IDX)
+end
+function listEntities(self, params, includeBackgroundEffects)
+    local entityTypeFilter
+    if params ~= "" then
+        entityTypeFilter = tonumber(params)
+        if entityTypeFilter == nil then
+            printConsole(nil, "That is an invalid entity type to filter by.")
+            return
+        end
+    end
+    logEntities(includeBackgroundEffects, entityTypeFilter)
+    printConsole(nil, "Logged the entities in the room to the \"log.txt\" file.")
+end
+function listGridEntities(self, params, includeWalls)
+    local gridEntityTypeFilter
+    if params ~= "" then
+        gridEntityTypeFilter = tonumber(params)
+        if gridEntityTypeFilter == nil then
+            printConsole(nil, "That is an invalid grid entity type to filter by.")
+            return
+        end
+    end
+    logGridEntities(includeWalls, gridEntityTypeFilter)
+    printConsole(nil, "Logged the grid entities in the room to the \"log.txt\" file.")
+end
+function movePlayer(self, params, direction)
+    local amount = DEFAULT_MOVE_UNITS
+    if params ~= "" then
+        local num = tonumber(params)
+        if num == nil then
+            printConsole(nil, "That is an invalid amount of units to move.")
+            return
+        end
+        amount = num
+    end
+    local player = Isaac.GetPlayer()
+    local vector = directionToVector(nil, direction)
+    local modifiedVector = vector * amount
+    player.Position = player.Position + modifiedVector
+end
+function printEnabled(self, enabled, description)
+    local enabledText = enabled and "Enabled" or "Disabled"
+    printConsole(nil, ((enabledText .. " ") .. description) .. ".")
+end
+function spawnTrapdoorOrCrawlspace(self, trapdoor)
+    local room = game:GetRoom()
+    local player = Isaac.GetPlayer()
+    local position = room:FindFreeTilePosition(player.Position, 0)
+    local gridIndex = room:GetGridIndex(position)
+    local gridEntityType = trapdoor and GridEntityType.GRID_TRAPDOOR or GridEntityType.GRID_STAIRS
+    spawnGridEntityWithVariant(nil, gridEntityType, 0, gridIndex)
+end
+function warpToRoomType(self, roomType, roomTypeName)
+    local gridIndexes = getRoomGridIndexesForType(nil, roomType)
+    if #gridIndexes == 0 then
+        printConsole(nil, ("There are no " .. roomTypeName) .. "s on this floor.")
+        return
+    end
+    local firstGridIndex = gridIndexes[1]
+    changeRoom(nil, firstGridIndex)
+end
+DEFAULT_MOVE_UNITS = 0.5
+function ____exports.angel(self)
+    devilAngel(nil, false)
+end
+function ____exports.ascent(self)
+    game:SetStateFlag(GameStateFlag.STATE_BACKWARDS_PATH_INIT, true)
+    game:SetStateFlag(GameStateFlag.STATE_BACKWARDS_PATH, true)
+    printConsole(nil, "Set Ascent flags.")
+end
+function ____exports.bh(self, params)
+    ____exports.blackHearts(nil, params)
+end
+function ____exports.blackMarket(self)
+    changeRoom(nil, GridRooms.ROOM_BLACK_MARKET_IDX)
+end
+function ____exports.bloodCharges(self, params)
+    local charges = 1
+    if params ~= "" then
+        local num = tonumber(params)
+        if num == nil then
+            printConsole(nil, "That is an invalid amount of charges to add.")
+            return
+        end
+        charges = num
+    end
+    local player = Isaac.GetPlayer()
+    player:AddBloodCharge(charges)
+end
+function ____exports.bomb(self, params)
+    local numBombs = 1
+    if params ~= "" then
+        local num = tonumber(params)
+        if num == nil then
+            printConsole(nil, "That is an invalid amount of bombs to add.")
+            return
+        end
+        numBombs = num
+    end
+    local player = Isaac.GetPlayer()
+    player:AddBombs(numBombs)
+end
+function ____exports.bombs(self, params)
+    local numBombs = 99
+    if params ~= "" then
+        local num = tonumber(params)
+        if num == nil then
+            printConsole(nil, "That is an invalid amount of bombs to add.")
+            return
+        end
+        numBombs = num
+    end
+    local player = Isaac.GetPlayer()
+    player:AddBombs(numBombs)
+end
+function ____exports.boneHearts(self, params)
+    addHeart(nil, params, HealthType.BONE)
+end
+function ____exports.boss(self)
+    warpToRoomType(nil, RoomType.ROOM_BOSS, "Boss Room")
+end
+function ____exports.bm(self)
+    ____exports.blackMarket(nil)
+end
+function ____exports.brokenHearts(self, params)
+    addHeart(nil, params, HealthType.BROKEN)
+end
+function ____exports.card(self, params)
+    if params == "" then
+        printConsole(nil, "You must specify a card name or number.")
+        return
+    end
+    local num = tonumber(params)
+    if num ~= nil then
+        if num < 1 or num >= Card.NUM_CARDS then
+            printConsole(nil, "That is an invalid card sub-type.")
+            return
+        end
+        Isaac.ExecuteCommand("g k" .. tostring(num))
+        printConsole(
+            nil,
+            "Gave card: " .. tostring(num)
+        )
+        return
+    end
+    local match = getMapPartialMatch(nil, params, CARD_MAP)
+    if match == nil then
+        printConsole(nil, "Unknown card: " .. params)
+        return
+    end
+    Isaac.ExecuteCommand("g k" .. tostring(match))
+    printConsole(
+        nil,
+        "Gave card: " .. tostring(match)
+    )
+end
+function ____exports.cards(self)
+    local cardType = 1
+    do
+        local y = 0
+        while y <= 6 do
+            do
+                local x = 0
+                while x <= 12 do
+                    if cardType == Card.NUM_CARDS then
+                        return
+                    end
+                    local position = gridToPos(nil, x, y)
+                    Isaac.Spawn(
+                        EntityType.ENTITY_PICKUP,
+                        PickupVariant.PICKUP_TAROTCARD,
+                        cardType,
+                        position,
+                        Vector.Zero,
+                        nil
+                    )
+                    cardType = cardType + 1
+                    x = x + 1
+                end
+            end
+            y = y + 1
+        end
+    end
+end
+function ____exports.cc(self)
+    ____exports.chaosCardTears(nil)
+end
+function ____exports.characterCommand(self, params)
+    if params == "" then
+        printConsole(nil, "You must specify a character name or number.")
+        return
+    end
+    local num = tonumber(params)
+    if num ~= nil then
+        if num < 0 or num >= PlayerType.NUM_PLAYER_TYPES then
+            printConsole(nil, "That is an invalid player sub-type.")
+            return
+        end
+        printConsole(
+            nil,
+            "Restarting as character: " .. tostring(num)
+        )
+        restart(nil, num)
+        return
+    end
+    local match = getMapPartialMatch(nil, params, CHARACTER_MAP)
+    if match == nil then
+        printConsole(nil, "Unknown character: " .. params)
+        return
+    end
+    restart(nil, match)
+    printConsole(
+        nil,
+        "Restarting as character: " .. tostring(match)
+    )
+end
+function ____exports.coin(self, params)
+    local numCoins = 1
+    if params ~= "" then
+        local num = tonumber(params)
+        if num == nil then
+            printConsole(nil, "That is an invalid amount of coins to add.")
+            return
+        end
+        numCoins = num
+    end
+    local player = Isaac.GetPlayer()
+    player:AddCoins(numCoins)
+end
+function ____exports.coins(self, params)
+    local numCoins = 999
+    if params ~= "" then
+        local num = tonumber(params)
+        if num == nil then
+            printConsole(nil, "That is an invalid amount of coins to add.")
+            return
+        end
+        numCoins = num
+    end
+    local player = Isaac.GetPlayer()
+    player:AddCoins(numCoins)
+end
+function ____exports.crawlspace(self)
+    spawnTrapdoorOrCrawlspace(nil, false)
+end
+function ____exports.d6(self)
+    local player = Isaac.GetPlayer()
+    useActiveItemTemp(nil, player, CollectibleType.COLLECTIBLE_D6)
+end
+function ____exports.d20(self)
+    local player = Isaac.GetPlayer()
+    useActiveItemTemp(nil, player, CollectibleType.COLLECTIBLE_D20)
+end
+function ____exports.damage(self)
+    v.run.maxDamage = not v.run.maxDamage
+    printEnabled(nil, v.run.maxDamage, "debug damage")
+end
+function ____exports.dd(self)
+    ____exports.devil(nil)
+end
+function ____exports.down(self, params)
+    movePlayer(nil, params, Direction.DOWN)
+end
+function ____exports.effects(self)
+    local player = Isaac.GetPlayer()
+    logTemporaryEffects(player)
+    printConsole(nil, "Logged the player's effects to the \"log.txt\" file.")
+end
+function ____exports.eh(self, params)
+    ____exports.eternalHearts(nil, params)
+end
+function ____exports.error(self)
+    ____exports.IAMERROR(nil)
+end
+function ____exports.fool(self)
+    ____exports.startingRoom(nil)
+end
+function ____exports.goldBomb(self)
+    ____exports.goldenBomb(nil)
+end
+function ____exports.goldKey(self)
+    ____exports.goldenKey(nil)
+end
+function ____exports.h(self, params)
+    ____exports.hearts(nil, params)
+end
+function ____exports.key(self, params)
+    local numKeys = 1
+    if params ~= "" then
+        local num = tonumber(params)
+        if num == nil then
+            printConsole(nil, "That is an invalid amount of keys to add.")
+            return
+        end
+        numKeys = num
+    end
+    local player = Isaac.GetPlayer()
+    player:AddKeys(numKeys)
+end
+function ____exports.keys(self, params)
+    local numKeys = 99
+    if params ~= "" then
+        local num = tonumber(params)
+        if num == nil then
+            printConsole(nil, "That is an invalid amount of keys to add.")
+            return
+        end
+        numKeys = num
+    end
+    local player = Isaac.GetPlayer()
+    player:AddKeys(numKeys)
+end
+function ____exports.list(self, params)
+    listEntities(nil, params, false)
+end
+function ____exports.listAll(self, params)
+    listEntities(nil, params, true)
+end
+function ____exports.listGrid(self, params)
+    listGridEntities(nil, params, false)
+end
+function ____exports.listGridAll(self, params)
+    listGridEntities(nil, params, true)
+end
+function ____exports.lowHP(self)
+    for ____, npc in ipairs(getNPCs(nil)) do
+        npc.HitPoints = 1
+    end
+    printConsole(nil, "Set every NPC to 1 HP.")
+end
+function ____exports.luck(self)
+    Isaac.ExecuteCommand("debug 9")
+end
+function ____exports.maxHearts(self, params)
+    addHeart(nil, params, HealthType.MAX_HEARTS)
+end
+function ____exports.mh(self, params)
+    ____exports.maxHearts(nil, params)
+end
+function ____exports.pill(self, params)
+    if params == "" then
+        printConsole(nil, "You must specify a pill name or number.")
+        return
+    end
+    local num = tonumber(params)
+    if num ~= nil then
+        if num < 1 or num >= PillEffect.NUM_PILL_EFFECTS then
+            printConsole(nil, "That is an invalid pill effect ID.")
+            return
+        end
+        Isaac.ExecuteCommand("g p" .. tostring(num))
+        printConsole(
+            nil,
+            "Gave pill: " .. tostring(num)
+        )
+        return
+    end
+    local match = getMapPartialMatch(nil, params, PILL_EFFECT_MAP)
+    if match == nil then
+        printConsole(nil, "Unknown pill effect: " .. params)
+        return
+    end
+    Isaac.ExecuteCommand("g p" .. tostring(match))
+    printConsole(
+        nil,
+        "Gave pill: " .. tostring(match)
+    )
+end
+function ____exports.pills(self)
+    local pillColor = 1
+    local horse = false
+    do
+        local y = 0
+        while y <= 6 do
+            do
+                local x = 0
+                while x <= 12 do
+                    if pillColor == PillColor.NUM_PILLS then
+                        if horse then
+                            return
+                        end
+                        horse = true
+                        pillColor = 1
+                    end
+                    local horsePillColor = pillColor + PILL_GIANT_FLAG
+                    local subType = horse and horsePillColor or pillColor
+                    local position = gridToPos(nil, x, y)
+                    Isaac.Spawn(
+                        EntityType.ENTITY_PICKUP,
+                        PickupVariant.PICKUP_PILL,
+                        subType,
+                        position,
+                        Vector.Zero,
+                        nil
+                    )
+                    pillColor = pillColor + 1
+                    x = x + 1
+                end
+            end
+            y = y + 1
+        end
+    end
+end
+function ____exports.planetarium(self)
+    warpToRoomType(nil, RoomType.ROOM_PLANETARIUM, "Planetarium")
+end
+function ____exports.pocket(self, params)
+    if params == "" then
+        printConsole(nil, "You must supply a collectible type to put as the pocket item.")
+        return
+    end
+    local num = tonumber(params)
+    if num == nil then
+        printConsole(nil, "That is an invalid collectible type.")
+        return
+    end
+    local player = Isaac.GetPlayer()
+    player:SetPocketActiveItem(num, ActiveSlot.SLOT_POCKET)
+end
+function ____exports.positionCommand(self)
+    for ____, player in ipairs(getPlayers(nil)) do
+        local character = player:GetPlayerType()
+        printConsole(
+            nil,
+            ((((("Player position for character " .. tostring(character)) .. ": (") .. tostring(player.Position.X)) .. ", ") .. tostring(player.Position.Y)) .. ")"
+        )
+    end
+end
+function ____exports.redHearts(self, params)
+    ____exports.hearts(nil, params)
+end
+function ____exports.rh(self, params)
+    ____exports.redHearts(nil, params)
+end
+function ____exports.roomCommand(self)
+    logRoom()
+end
+function ____exports.rottenHearts(self, params)
+    addHeart(nil, params, HealthType.ROTTEN)
+end
+function ____exports.s(self, params)
+    if params == "" then
+        printConsole(nil, "You must specify a stage number.")
+        return
+    end
+    local finalCharacter = string.sub(params, -1)
+    local stageString
+    local stageTypeLetter
+    if finalCharacter == "a" or finalCharacter == "b" or finalCharacter == "c" or finalCharacter == "d" then
+        stageString = __TS__StringSlice(params, 0, #params - 1)
+        stageTypeLetter = finalCharacter
+    else
+        stageString = params
+        stageTypeLetter = ""
+    end
+    local stage = tonumber(stageString)
+    if stage == nil then
+        printConsole(
+            nil,
+            "That is an invalid stage number: " .. tostring(stage)
+        )
+        return
+    end
+    local minStage = 1
+    local maxStage = 13
+    if stage < minStage or stage > maxStage then
+        printConsole(
+            nil,
+            ((("Invalid stage number; must be between " .. tostring(minStage)) .. " and ") .. tostring(maxStage)) .. "."
+        )
+        return
+    end
+    Isaac.ExecuteCommand(("stage " .. tostring(stage)) .. stageTypeLetter)
+end
+function ____exports.seeds(self)
+    logAllSeedEffects()
+    printConsole(nil, "Logged the seed effects to the \"log.txt\" file.")
+end
+function ____exports.sh(self, params)
+    ____exports.soulHearts(nil, params)
+end
+function ____exports.shop(self)
+    warpToRoomType(nil, RoomType.ROOM_SHOP, "shop")
+end
+function ____exports.smelt(self)
+    local player = Isaac.GetPlayer()
+    useActiveItemTemp(nil, player, CollectibleType.COLLECTIBLE_SMELTER)
+end
+function ____exports.soulCharges(self, params)
+    local charges = 1
+    if params ~= "" then
+        local num = tonumber(params)
+        if num == nil then
+            printConsole(nil, "That is an invalid amount of charges to add.")
+            return
+        end
+        charges = num
+    end
+    local player = Isaac.GetPlayer()
+    player:AddSoulCharge(charges)
+end
+function ____exports.sound(self, params)
+    local soundEffect = tonumber(params)
+    if soundEffect == nil then
+        printConsole(nil, "That is an invalid sound effect ID.")
+        return
+    end
+    sfxManager:Play(soundEffect)
+end
+function ____exports.sounds(self)
+    logSounds()
+    printConsole(nil, "Logged the currently playing sound effects to the \"log.txt\" file.")
+end
+function ____exports.spam(self)
+    v.run.spamBloodRights = not v.run.spamBloodRights
+end
+function ____exports.speed(self)
+    local player = Isaac.GetPlayer()
+    v.run.maxSpeed = not v.run.maxSpeed
+    if v.run.maxSpeed and not player:HasCollectible(CollectibleType.COLLECTIBLE_FATE) then
+        local numEternalHearts = player:GetEternalHearts()
+        if numEternalHearts == 0 then
+            player:AddCollectible(CollectibleType.COLLECTIBLE_FATE)
+            player:AddEternalHearts(-1)
+        else
+            player:AddEternalHearts(-1)
+            player:AddCollectible(CollectibleType.COLLECTIBLE_FATE)
+        end
+    end
+    player:AddCacheFlags(CacheFlag.CACHE_SPEED)
+    player:EvaluateItems()
+    printEnabled(nil, v.run.maxSpeed, "max speed")
+end
+function ____exports.trapdoorCommand(self)
+    spawnTrapdoorOrCrawlspace(nil, true)
+end
+function ____exports.treasure(self)
+    warpToRoomType(nil, RoomType.ROOM_TREASURE, "Treasure Room")
+end
+function ____exports.ultra(self)
+    warpToRoomType(nil, RoomType.ROOM_ULTRASECRET, "Ultra Secret Room")
+end
+return ____exports

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

@@ -0,0 +1,25 @@
+/// <reference types="isaac-typescript-definitions" />
+/**
+ * Enables extra console commands which are useful for debugging. See the `isaacscript-common`
+ * documentation for details on the commands that are added.
+ */
+export declare function enableExtraConsoleCommands(mod: Mod): void;
+/**
+ * Helper function to add a custom console command.
+ *
+ * The standard library comes with many existing console commands that are useful for debugging, but
+ * you can also add your own commands that are useful for your particular mod. It's easier to add
+ * commands to the existing command system than to add logic manually to the ExecuteCmd callback.
+ *
+ * Before using this function, you must first invoke `enableExtraConsoleCommands`.
+ */
+export declare function addConsoleCommand(commandName: string, commandFunction: (params: string) => void): void;
+/**
+ * Helper function to remove a custom console command.
+ *
+ * The standard library comes with many existing console commands that are useful for debugging. If
+ * you want to disable one of them, use this function.
+ *
+ * Before using this function, you must first invoke `enableExtraConsoleCommands`.
+ */
+export declare function removeConsoleCommand(commandName: string): void;