An Atom package to improve your Binding of Isaac modding experience.
The core documentation scraping functionality (specifically the regex patterns) is based on Kapiainen's Sublime plug-in The Subliming of Isaac.
All the code has been refactored to adhere to a more readable standard.
update.itfile or the addition of very commonly used snippets.
open mod creatorin the command palette)
A Python3.5 or higher interpreter available on the system.
Note, on Windows, Python 3.5 might cause issues, install Python 3.6 instead. On Linux, the most recent version available in your distro should work fine.
The autocomplete-lua and language-lua packages.
The game that this package is supposed to help you mod, already installed.
The Atom editor
Those packages are not require to run properly Atom-boilua but they will help you improve your modding experience.
linter-lua provides real-time syntax checking using luac. Currently, Afterbirth+ uses lua 5.3, so make sure to get 5.3 luac binaries!
This speeds up the debugging process (you'll immediately be notified of your mistake rather than after running your mod and testing it). It also prevents a bug in autocomplete-lua stopping autocompletion suggestions.
On Windows, you can download them here.
On Linux, you are better off downloading the source and compiling the binaries for yourself. The sources are here. Just uncompress the archive, go in the target directory and type
You then need to specify in the linter-lua settings the path to the
This helps a lot. Issues in the xml files in isaac will usually crash the game, without a crash log :). Having linter in your xmls won't prevent all the crashes, but it will definitely prevent some simple mistakes that might take hours to fix.
apm install Atom-boilua et voilà!
You can also search for
Atom-boilua in the install tab and install it through the UI.
Please look into the package's settings to configure your installation.
Here is what you can find in the settings tab:
|Isaac AB+ mod editing folder||The directory in which you edit your mods, by default, it is the Afterbirth+ mod folder. Note that setting this to something different than your mod folder might cause issues with the log reading feature.|
|Isaac Game folder||The directory in which Rebirth is installed, if you use a custom Steam location, this must be changed.|
|Python path||The Python executable path, Windows users must specify it|
See the patch notes on Github: https://github.com/GHGibonus/Atom-boilua/releases
All improvement suggestions goes on the issue tracker: https://github.com/GHGibonus/Atom-boilua/issues
If you want to work yourself on new feature, check the guidelines on the wiki https://github.com/GHGibonus/Atom-boilua/wiki/Contributing
This package has several components under several different licenses. First off, at the exception of contrary notice, the code is licensed under the MIT (Expat) license.
Good catch. Let us know what about this package looks wrong to you, and we'll investigate right away.