Steamodded is a mod loader and injector for the game Balatro. It is developed using Lua for the injected code and Python for additional tools. Currently, Steamodded focuses on basic mod loading and injection functionalities and does not include a modding API.
- Mod Loader: Loads mods into the game.
It will load every mods located at the path C:\Users\USER\AppData\Roaming\Balatro (or %appdata%\Balatro\Mods) into the game.
If it's for now very simple, it will seach for an header at the top of the file that looks like this:
--- STEAMODDED HEADER
--- MOD_NAME: Your Mod Name
--- MOD_ID: YourModID
--- MOD_AUTHOR: [You, AnotherDev, AnotherOtherDev]
--- MOD_DESCRIPTION: The Description of your Mod
This header is mandatory and the mod loader will not load the mod without it.
The MOD_ID must be unique and without spaces. The MOD_AUTHOR mus be an array. Every part of the Header must be present.
After the Header validation, the lua code of your mod will be loaded.
- Core Management: Handles the overall management of mods.
This is the hearth of the project, every parts depend on it.
For now it's not doing much outside of displaying basic informations and offering a basic GUI for Steamodded. In the future it will be the most important part of the project.
- Debug Socket: Provides a way to output debug data.
The debug Socket is used to send debug informtions from the Game and the Mods outside of the Game. Since we can't launch Balatro linked with a console interface, it's the most efficient way to provide debug data.
- Injector: Injects Steamodded into Balatro.
The injector is coded in Python. It's used to inject every other parts of Steamodded into the base game.
It use 2 external tools: 7zip for is extreme capability in term of SFX ZIP, permiting Steamodded to modify the executable without breaking it, and luajit-decompiler-v2 that is used for decompiling the code before reinjection. Big thanks to them, they made this project way easier to do.
The code is NOT recompiled after injection. It might change in the future but it will stay like that for now.
- CUT THE GAME !
- Go to the release page and download the last release (Your aiming for the ".exe" download)
- Unzip the downloaded file
- Drag and Drop your "Balatro.exe" to the executable
- Wait for it to finish
- And that's it! Balatro is now ready to be Modded.
- Go to
C:\Users\USER\AppData\Roaming\Balatro\Mods(Create the "Mods" directory if necessary) - Put the mod into the directory (only the Mod File if there is only one file provided or all the files in a subdirectory)
- Launch the Game and enjoy!
-
7zip - Used by the Injector (A gpg pubkey signed repack from NamelessNanashi is used as a better alternative has not been found yet. You can get the pubkey with
gpg --keyserver hkp://keys.openpgp.org --recv-keys B7D76FACB1665D40) -
luajit-decompiler-v2 - Used by the Injector
All the previous depencies are automaticaly downloaded during the injection.
- pyinstaller - Used to compile the injector
This project is open for contribution. Please, feel free to open a merge requeste to do so.
Instruction to compile the injector are provided into is dedicated directory.
Steamo, MathIsFun_ and 00001H
This project is licensed under the GNU General Public License. This ensures that the software is free to use, modify, and distribute. For more details, see the LICENSE file in the repository.