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 mega maw
spawn 20
spawn 10.1
Spawns entities. The decimal format's syntax is as follows:
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 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 1000
gridspawn 1494
gridspawn 9000
gridspawn 9100
Spawns a grid entity with the given ID at a random place in the room.
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 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 t53
remove soy milk
remove cursed eye
r bob's brain
r experi
remove *
Removes items.
costumetest 33
Gives Isaac a number of random costumes, without having the associated items.
Resets the game back to the beginning of a new run.
Prints a list of all items in Isaac's possession, and how many of each.
spawn 10
repeat 50
giveitem meat!
repeat 100
repeat 100
Repeats the last given command a number of times.
Removes all easter egg effects from the current run.
seed T1MM AY48
Starts a new run with the inputted seed.
challenge 20
Starts a new run on a random seed on the given challenge number.
combo 0.69
combo [itempool #].[number of random items]
Gives you an amount of random items from a specified item pool.
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 2
curse 16
curse 127
Sets a value corresponding to the sum of the desired curses.
Generates a new layout for the current floor with a new floor seed.
copy 3
Copies a specified amount of previous console commands to your clipboard.
Clears the console. Useful for video recording purposes or if you want to dispose of incriminating evidence.
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 /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 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.
Reports memory usage for Lua

Undocumented Commands[edit | edit source]

Name Syntax Description
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 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.)

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 1
Plays the specified cutscene.
playsfx 1
Plays the specified sound effect.
Reloads the graphical shaders. (Has no discernible in-game effect.)
Restocks all shops.
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.

Dataminer Icon.png Modding Dataminer Icon.png

References Modding Tutorials - XML Modding - Added in Afterbirth † Lua Reference - Added in Afterbirth † Modding of Isaac Lua Reference
Tools Added in Afterbirth † Debug Console - Modding Tools - Basement Renovator
Releases Modding of Isaac - Added in Afterbirth † Steam Workshop - NexusMods
Community Modding of Isaac Subreddit - Modding of Isaac Discord Server