hades is a mod for The Binding of Isaac: Repentance, written in TypeScript using the IsaacScript framework.
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.)
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.