/hades

Primary LanguageTypeScriptGNU General Public License v3.0GPL-3.0

hades

hades is a mod for The Binding of Isaac: Repentance, written in TypeScript using the IsaacScript framework.

How To Play

For normal people, you can play the mod by subscribing to it on the Steam Workshop. (Subscribing to the mod will automatically download and install it once you launch the game.)

How To Compile

If you are a developer, or if the mod is not yet uploaded to the Steam Workshop, you can play the mod by compiling the TypeScript code into a "main.lua" file. Perform the following steps:

  • Download and install Node.js (Windows Installer .msi, 64-bit).
  • Download and install Git (64-bit Git for Windows setup).
  • Download (or clone) this repository:
    • Click on the "Code" button in the top-right-corner of this page.
    • Click on "Download ZIP".
  • Unzip the zip file to a new directory.
  • Open the command prompt (or another shell of your choice).
  • Use the cd command to navigate to the place where you unzipped the repository.
  • Use the yarn install --immutable command to install the project dependencies.
  • Use the npx isaacscript command to start the IsaacScript watcher.
  • If IsaacScript is successful, you will see "Compilation successful." (You can continue to leave the terminal window open; it will monitor for changes in your project, and recompile if necessary.)
  • Completely close Isaac if it is already open, and then open the game again, and the mod should be in the list of mods. You can now play or test the mod.