Back to Mod Resources
loadersinstallationsetup

Mod Loaders & Installation

Complete guide to installing and managing Balatro mods

Balatro HQ
7/3/2026
~10 min read

Mod Loaders & Installation

Learn how to install and manage Balatro mods with source-backed loader checks, save backups and safe testing habits.

Lovely

Lovely is a common Balatro modding dependency. Read the Lovely repository before installing it, because setup details can change between releases.

Features:

  • Runtime injector: Used by mod setups that need code injection
  • Release notes: Check the current installation path before use
  • PC-focused setup: Do not assume console or mobile support
  • Rollback planning: Keep the release file you installed

Installation Steps:

  1. Download Lovely from the maintainer repository
  2. Extract to your Balatro installation directory
  3. Follow the current release instructions
  4. Restart Balatro and test with no content mods first

Steamodded

Steamodded is the main framework listed by many Balatro community mods. Read the Steamodded repository and its release notes before adding dependent mods.

Features:

  • Mod framework: Provides APIs that many mods depend on
  • Version notes: Match the loader release to the mod requirement
  • Dependency clarity: Check whether a mod also needs Lovely
  • Issue tracking: Review known crashes before updating a working setup

Installation Guide

Step 1: Backup Your Save

Before installing any mods, always backup your save files:

  • Navigate to your Balatro save directory
  • Copy all .save files to a safe location
  • This ensures you can restore your progress if needed

Step 2: Choose Your Loader

  • Beginners: Use Lovely for simplicity
  • Advanced Users: Consider Steamodded for more features
  • Compatibility: Check which loader your desired mods require

Step 3: Install the Loader

Follow the specific installation instructions for your chosen loader:

For Lovely:

1. Download the current release from the maintainer source
2. Extract to Balatro folder
3. Follow the release instructions
4. Launch Balatro with no content mods first

For Steamodded:

1. Download from the Steamodded repository
2. Place in Balatro directory
3. Follow the current setup notes
4. Add content mods only after the loader works

Step 4: Install Mods

  • Download mods from trusted sources
  • Place mod files in the designated mods folder
  • Enable mods through the loader interface
  • Restart Balatro to apply changes

Mod Management

Organizing Your Mods

  • Create folders for different mod categories
  • Use descriptive names for easy identification
  • Keep backups of working mod configurations
  • Document dependencies between mods

Troubleshooting Common Issues

Mod Not Loading

  • Check file placement in correct directory
  • Verify mod compatibility with current game version
  • Ensure all dependencies are installed
  • Check for conflicting mods

Game Crashes

  • Disable recently installed mods
  • Check mod loader logs for error messages
  • Verify game file integrity
  • Update mod loader to latest version

Performance Issues

  • Limit number of active mods
  • Check for resource-heavy mods
  • Monitor system performance
  • Consider mod alternatives

Safety & Best Practices

Trusted Sources

Only download mods from:

  • Maintainer repositories such as GitHub release pages
  • Community pages that link back to the maintainer
  • Known mod developers with public issue history
  • Platforms that show changelogs and dependency notes

Security Considerations

  • Scan downloads with antivirus software
  • Read mod descriptions carefully
  • Check user reviews and ratings
  • Avoid suspicious file types

Backup Strategy

  • Regular backups of save files
  • Export mod configurations
  • Document working setups
  • Keep installer files for easy restoration

Quality of Life

  • UI Improvements: Better interfaces and information display
  • Automation: Streamlined gameplay mechanics
  • Accessibility: Features for different player needs
  • Performance: Optimization and speed improvements

Content Expansion

  • New Jokers: Additional joker cards with unique effects
  • Extra Blinds: New enemies and challenges
  • Game Modes: Alternative ways to play
  • Cosmetics: Visual enhancements and themes

Gameplay Modifications

  • Balance Changes: Adjusted card values and mechanics
  • Difficulty Mods: Harder or easier gameplay options
  • Rule Changes: Modified game mechanics
  • Experimental Features: Beta content and new ideas

Community Resources

Getting Help

  • Discord Servers: Real-time community support
  • Reddit Communities: Discussion and troubleshooting
  • GitHub Issues: Bug reports and feature requests
  • Wiki Pages: Comprehensive documentation

Contributing

  • Bug Reports: Help improve mod stability
  • Feature Requests: Suggest new functionality
  • Testing: Try beta versions and provide feedback
  • Documentation: Help write guides and tutorials

Future of Modding

Conclusion

Modding can change Balatro in useful ways, but the safest setup is deliberate: install loaders from their maintainers, read each mod's own requirements, and keep backups before every test.

Remember to always:

  • Backup your saves before installing mods
  • Install one change at a time
  • Keep source links and versions in your notes
  • Remove the newest mod first when troubleshooting
  • Use trusted sources for downloads
  • Keep mods updated for best compatibility
  • Contribute to the community when possible

Happy modding!

Share this article