Debug Console

From Binding of Isaac: Rebirth Wiki
Jump to: navigation, search

The debug console is accessible in The Binding of Isaac: Afterbirth †. It is an extremely useful way to verify a particular game mechanic, explore a seed, or test various things about the game. And if you are a mod developer, you can use it to quickly test various things on your mod.

The debug console is only accessible if one or more mods are enabled. If you don't have any mods to enable, download one from Steam Workshop, or simply create an empty folder in your mods directory. (By default, the mods directory is located at "C:\Users\[username]\Documents\My Games\Binding of Isaac Afterbirth+ Mods".)

Using the Debug Console[edit | edit source]

To show the console, press the grave/tilde (~) key while in a run. (This is equivalent to "ù" on AZERTY keyboards, "ö" on German QWERTZ keryboards, "ñ" on Spanish QWERTY keryboards, ">" on Italian QWERTY keryboards, and "æ" on Danish QWERTY keyboards). To hide the console, hit Enter without typing anything or Esc.

Commands are listed below in the order that they appear in the Lua documentation.

Name Syntax Description
spawn
spawn mega maw
spawn 20
spawn 10.1
spawn 10.2.0.4
Spawns entities. The decimal format's syntax is as follows:
[type].[variant].[subtype].[champion]
goto
goto s.boss.1010
goto s.error.21
goto d.10
Goes to rooms on the current floor. "s" indicates special room types and "d" indicates normal room types.
stage
stage 1
stage 10a
stage 3b
Goes to another floor. Entering non-existent floors can lead to unexpected results and the large majority crash the game.
gridspawn
gridspawn 1000
gridspawn 1494
gridspawn 9000
gridspawn 9100
Spawns a grid entity with the given ID at a random place in the room.
debug
debug 8
Enables various cheats.
  • debug 1: "Entity Positions" - Draws a marker on the screen at the position of each entity.
  • debug 2: "Grid" - Shows the number of grid entities on the screen. (Seems to be bugged, as most grid entities appear as 1000.)
  • debug 3: "Infinite HP" - Taking damage does not decrease the player's health.
  • debug 4: "High Damage" - +40 damage
  • debug 5: "Show Room Info" - Displays text at the bottom of the screen about the current room.
  • debug 6: "Textual Map" - Unknown
  • debug 7: "Show Damage Values" - Similar to Added in AfterbirthSpider Mod Spider ModSpider Mod Icon.pngDisplays Isaac's tear damage and enemy health bars. Spawns a gray spider familiar that wanders around and inflicts a random status effect on any enemies it comes into contact with. Occasionally spawns a blue spider upon clearing a room., this will display how much damage is taken by enemies. (Unlike Spider Mod, it will leave the damage as their raw values.)
  • debug 8: "Infinite Item Charges" - The active item always has the maximum charge.
  • debug 9: "High Luck" - +50 luck
  • debug 10: "Quick Kill" - All enemies take constant and rapid damage.
  • debug 11: "Grid Info" - Displays the coordinates for each square on the grid.
giveitem
giveitem dr. fetus
giveitem c15
giveitem Petrified Poop
giveitem t15
giveitem ipec
givetim mutant sp
g soy milk
giveitem p0
g p22
giveitem k1
iveitem c6
g k45
Gives items, trinkets, cards, and pills.

Use a capital P to receive items starting with a P.

You can use the alias of "g" to avoid typing out the whole command.

remove
remove t53
remove soy milk
remove cursed eye
r bob's brain
r experi
remove *
Removes items.
costumetest
costumetest
costumetest 33
Gives Isaac a number of random costumes, without having the associated items.
restart
restart
Resets the game back to the beginning of a new run.
listcollectibles
listcollectibles
Prints a list of all items in Isaac's possession, and how many of each.
repeat
spawn 10
repeat 50
giveitem meat!
repeat 100
repeat 100
Repeats the last given command a number of times.
clearseeds
clearseeds
Removes all easter egg effects from the current run.
seed
seed GGGG GGGG
seed T1MM AY48
Starts a new run with the inputted seed.
challenge
challenge 20
Starts a new run on a random seed on the given challenge number.
combo
combo 0.69
combo [itempool #].[number of random items]
Gives you an amount of random items from a specified item pool.
macro
mom
momh
hush
bigchest
hud
Usually teleports Isaac to Depths II, Womb II, Blue Womb, or Cathedral, usually with very high damage.
  • mom and momh give the Bible and the Emperor card.
  • hush gives 15 or more random items, a random active item, and the Emperor card.
  • bigchest gives Isaac Soy Milk Soy MilkSoy Milk Icon.pngTears shrink and do much less damage, but fire in very rapid succession., Mutant Spider Mutant SpiderMutant Spider Icon.pngGrants quadruple shot but decreases tears., Lord of the Pit Lord of the PitLord of the Pit Icon.pngGrants flight and increases speed., 5 The Belt The BeltThe Belt Icon.pngIncreases speed by 0.3., The Polaroid The PolaroidThe Polaroid Icon.pngIf the character has half a red heart or no red hearts after taking damage, it triggers the Book Of Shadows effect, creating a shield that nullifies all types of damage for 5 seconds. Also allows entrance into The Chest., The Negative The NegativeThe Negative Icon.pngIf the character has half a red heart or no red hearts after taking damage, it triggers The Necronomicon effect, damaging all enemies in the room. Also allows entrance into the Dark Room. and the Emperor card.
  • hud gives Isaac 3 Dead Cat Dead CatDead Cat Icon.pngSets the amount of red heart containers to 1, but gives Isaac 9 extra lives. After dying, Isaac is teleported to the last safe room. New heart containers can be obtained after picking up this item, but after each death, the number of heart containers is set to 1 again.s, Guppy's Collar Guppy's CollarGuppy's Collar Icon.pngGrants Isaac a permanent 50% chance to respawn with 1/2 of a red heart after death., 13 MEAT! MEAT!MEAT! Icon.pngAdds a heart container and increases damage.s, The Compass The CompassThe Compass Icon.pngReveals all special rooms (except secret rooms of any kind)., Blue Map Blue MapBlue Map Icon.pngShows secret and super secret room locations on the map., Treasure Map Treasure MapTreasure Map Icon.pngReveals all rooms for every floor. However, it does not reveal icons or secret rooms., Little Baggy Little BaggyLittle Baggy Icon.pngIsaac can hold 2 pills at once and all cards are replaced by pills., two random pills, Mom's Purse Mom's PurseMom's Purse Icon.pngAllows Isaac to hold 1 additional trinket., Paper Clip Paper ClipPaper Clip Icon.pngGolden Chests can be opened without using a key., Petrified Poop Petrified PoopPetrified Poop Icon.pngGreatly increases the chances of a pickup dropping when destroying poop., and My Little Unicorn My Little UnicornMy Little Unicorn Icon.png6 roomsUpon use, grants invulnerability and increased speed for five seconds, removing the ability to shoot tears and replacing it with the ability to deal contact damage to enemies..
curse
curse 2
curse 16
curse 127
Sets a value corresponding to the sum of the desired curses.
reseed
reseed
Generates a new layout for the current floor with a new floor seed.
copy
copy 3
Copies a specified amount of previous console commands to your clipboard.
clear
clear
Clears the console. Useful for video recording purposes or if you want to dispose of incriminating evidence.
lua
lua print("Hello World!")
l for _,v in pairs(Isaac.GetRoomEntities()) do if v:IsVulnerableEnemy() then print(v.HitPoints.."/"..v.MaxHitPoints) end end
Directly runs a line of Lua code. The first example simply prints "Hello World!" to the console, while the second prints the current HP and max HP of every vulnerable enemy in the room.

You can use the alias of "l" to avoid typing out the whole command.

luarun
luarun /full_path/hello.lua
luarun relative_path/hello.lua
Takes a path to a lua file and runs it immediately. Paths are relative to the folder where the game is installed.
luamod
luamod mygreatmod
Takes a mod folder name and runs the main.lua for it. This can be used to reload a mod without relaunching the game.
luamem
luamem
Reports memory usage for Lua

Undocumented Commands[edit | edit source]

Name Syntax Description
listcollectibles
listcollectibles
Prints a list of all items in Isaac's possession, and how many of each.

This is not technically an undocumented command, but it is included here since people may not know about it - the formatting is messed up in the official documentation and it blends in to the command above it (restart).

achievement
achievement 300
achievement meconium
Unlocks achievements.

This is mentioned in the official documentation, but it states that the command is useless since it affects your persistent data. (In Afterbirth+, when mods and/or the console is active, nothing should affect the persistent data.)

eggs
eggs
Unlocks all Easter Eggs in the menu.

This is mentioned in the official documentation, but it states that the command is useless since it affects your persistent data. (In Afterbirth+, when mods and/or the console is active, nothing should affect the persistent data.)

restart [character number]
restart 2
Resets the game back to the beginning of a new run and sets the character to the specified number.

The base restart command is documented but not the ability to supply a character number as an argument.

cutscene
cutscene 1
Plays the specified cutscene.
playsfx
playsfx 1
Plays the specified sound effect.
reloadshaders
reloadshaders
Reloads the graphical shaders. (Has no discernible in-game effect.)
restock
restock
Restocks all shops.
time
time
Prints the total amount of time passed on the run (based on "game" frames / the in-game timer).

Trivia[edit | edit source]

  • Stage 13 is the only non-standard stage that does not crash. It consists of 2x1 vertical rooms that have doors that only sometimes close, minimal enemies (usually 2 of the same type), and uses the Caves background. The music is a single layer of either the Blue Womb, the Cellar, or the Burning Basement music, and only plays when enemies are in the room. The boss is always The Duke of Flies, and no trapdoor or items spawn when the boss is defeated.
    • Stage 13a is the same, but with the Depths background. The boss is always Monstro II.
    • Stage 13b is the same, but with the Womb background. The boss is always The Duke of Flies.
    • Any variant beyond 13b is the same as stage 13.
    • The enemy spawn patterns are the same as the waves in Greed mode, suggesting that this stage is used to store the waves in the game.
  • Entering "stage 8" in Greed or Greedier mode will grant access to The Void. The rooms and music are same as The Void in regular mode, but the boss is Ultra Greed and will drop the Final Boss Chest. Entering the chest will play the final ending instead of End 18 or 19.
  • When using the "repeat" command, if the number given is larger than 10,000, the command will not work and a message saying "Don't get carried away" will show up.

Modding resources[edit | edit source]