Skip to content

Home

This is currently a concept and work in progress. If you want to help, please reach out on Discord

When it comes to creating mods for Balatro, it can be a bit tricky, especially if you're not familiar with the game engine. This repo aims to provide a collection of guides, tips and tricks that will help you get started with your first mod.

What is Balatro?

Balatro is a hypnotically satisfying deckbuilder where you play illegal poker hands, discover game-changing jokers, and trigger adrenaline-pumping, outrageous combos.

Source: Steam

What language is Balatro written in?

Balatro is built using love2d, a 2D game engine built in Lua. In fact, if you own the game, you can easily access the source code and explore the mechanics of the game

Todo: Link to guide on accessing source code

What if I don't know how to code?

Whilst it's recommend you have some understanding of programming fundamentals, you don't need to be a master coder to create mods for Balatro. The guides should provide enough information and context that anyone can create their own mods, regardless of their experience level.

If you find the guides too difficult to follow, or you don't understand something, please create a discussion topic in GitHub.

Useful resources

  • Balatro Discord - In addition to the official Balatro Discord, there are several channels dedicated to modding Balatro. Usually searching for your issue will yield helpful results but the community is very responsive should you ask for help.
  • SMODS Wiki - The wiki for Steammodded, a modding framework for Balatro. This wiki contains a lot of useful information about how to use the framework and comprehensive API documentation.