Skip to content

DZAladan/Balatro-Music-Selector

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

59 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Balatro Music Selector

Standalone Cardsauce music selector for Balatro

DISCLAIMER

I'm NOT a programmer, I helped myself with templates/guides and I tried my best to understand the code because I'm trying to learn Lua in my own way. A lot of the code in this mod comes from Cardsauce. Please, support the original devs.

Why?

I simply wanted to be able to choose different music and add my own, but I didn't want to install Cardsauce in its entirety just for that. So, I identified the chunk of code responsible for that and made it standalone, then I somehow managed to add a way to make it modular (but the procoess is still a little laborious. See the provided instructions) so that everyone can add their own music.
This mod was also heavily inspired by qvattro0's Balatro Music Replacer which, however, is not a mod but an external software to literally replace the music files.

How it works

It simply adds an extra option in the Audio settings that allows to pick different soundtracks.
The mod allows to add custom music as well. image

Notes

⚠️ If you have the Cardsauce mod installed, this mod won't load. This is by design: since this mod is essentially a piece of the other, I preferred to avoid any issues and conflicts because I currently lack the skills to solve them.
⚠️ If any of the original authors of the soundtracks featured in this mod come forward and ask me to remove their work, I will comply without question.
⚠️ For the same reason above, if BarrierTrio asks me to take this mod down, I will also comply.
⚠️ The code I came up with is likely spaghetti. I'm sure there are better ways to do all of this but, as I said, I currently lack the skills.

Credits

❇️ qvattro0 for the inspiration
❇️ BarrierTrio for the original code

Featured soundtracks

❇️ Cardsauce OST by Basscleff (Cardsauce mod)
YouTube | Bandcamp | Newgrounds | Soundcloud | Twitter
❇️ Balatro: B-Side by Afterlight (standalone mod)
YouTube | Bandcamp | GitHub
❇️ Bonne Soirée by Vongola
YouTube | Soundcloud | Ko-Fi
❇️ Going In Blind by Recycled Scraps (standalone mod)
YouTube
❇️ Monkey Business by Bombaflex
YouTube | Spotify | Instagram | GitHub | Portfolio
❇️ Raise The Stakes by JohnathanSucks (standalone mod)
YouTube | Bandcamp | GitHub

Installation

  1. Make a copy of the original "balatro.exe" and rename it "balatro_unmodded.exe";
    ℹ️ This step is optional, but will allow you to keep a vanilla version of the game just in case you may need it.
  2. Install Lovely following the guides below:
    ➡️ For Windows, Proton and Wine
    ➡️ For Mac
  3. Install Steamodded following this guide;
  4. Download the latest .zip file from the Releases;
  5. Open it with a software like 7-Zip, then drag and drop the folder inside the %AppData&/Balatro/Mods folder.

How to add your own music

  1. Choose a name for your music pack (it must be all lowercase);
  2. Create inside "assets/sounds" a folder with the name you chose for the pack;
    • You can also rename the "template" folder, but it's recommended to keep it for future uses.
  3. Place inside that folder the music files (in .ogg format) of your choice, being mindful of using these exact names:
    • music1.ogg = main menu, Small and Big Blinds
    • music2.ogg = Standard, Buffoon, Spectral and Arcana Packs
    • music3.ogg = Celestial Packs
    • music4.ogg = Shop
    • music5.ogg = Boss Blinds
  4. Copy "mpack_template.lua" from "assets/template" inside your folder;
  5. Rename "mpack_template.lua" by replacing "template" with your folder's name;
  6. Now open that file and:
    • Replace the string in "mpack_name" with the folder's name (don't delete the quote marks);
    • Replace "[soundtrack title]" and "[artist]" with the approriate info (keep the quote marks here as well);
    • Save and close the file.
  7. Go back to the mod's root folder ("Music Selector") and open "main.lua";
  8. Add your folder's name to "mpack_files", making sure to use quote marks and a comma ("example",), then save and close.

What I hope to do

🔧 Make an injector for the Cardsauce mod in order to feature extra tracks even with Cardsauce installed.
🔧 Otherwise, being able to at least override its music selector with this one.

About

Standalone Cardsauce music selector for Balatro

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages