https://github.com/DivvyCr/Balatro-Preview

Simulate the score you will get on the selected cards!
https://github.com/DivvyCr/Balatro-Preview

Last synced: 12 days ago
JSON representation

Simulate the score you will get on the selected cards!

• Host: GitHub
• URL: https://github.com/DivvyCr/Balatro-Preview
• Owner: DivvyCr
• License: gpl-3.0
• Created: 2024-03-22T02:16:38.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2025-01-23T20:47:08.000Z (3 months ago)
• Last Synced: 2025-01-23T21:29:32.959Z (3 months ago)
• Language: Lua
• Homepage:
• Size: 143 MB
• Stars: 79
• Watchers: 4
• Forks: 7
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-balatro - Divvy's Preview - Simulate and preview the score that your hand will get! by [@DivvyCr](https://github.com/DivvyCr) (Mods (Require [**Steamodded**](https://github.com/Steamopollys/Steamodded)) / GUI)

README

        
Divvy's Preview for Balatro




![Version](https://img.shields.io/badge/latest-v3.2-blue.svg)

![GitHub License](https://img.shields.io/github/license/DivvyCR/Balatro-Preview?color=blue)







Simulate the score and the dollars that you will get by playing the selected cards!



## :point_right: Installation

 0. Install [Lovely](https://github.com/ethangreen-dev/lovely-injector)


   Do you have Steamodded? Then, you probably already have Lovely!

 1. Download the latest release of this mod, [here](https://github.com/DivvyCr/Balatro-Preview/releases/latest).

 2. Unzip the downloaded folder to `C:\Users\[USER]\AppData\Roaming\Balatro\Mods`


   You should have:


   `...\Balatro\Mods\DVPreview`


   `...\Balatro\Mods\DVSimulate`


   `...\Balatro\Mods\DVSettings`


 3. Launch the game!

## :point_right: Features

 - Score and dollar preview **without side-effects**!

 - **Updates in real-time** when changing selected cards, changing joker order, or using consumables!

 - Can preview score even when cards are face-down!

 - Perfectly **predicts random effects**...

 - ... or not! There is an option to show the **minimum and maximum possible scores** when probabilities are involved!

> [!CAUTION]

> This mod is currently **incompatible** with other mods.

> I am in the process of kick-starting the process of making the popular mods compatible.

> If you are a mod creator, please help me out by reading the *Mod Compatibility* section below.

## :point_right: See It In Action



Demonstration for the preview updating in real-time.


 



Demonstration for the preview being hidden with face-down cards.


 



Demonstration for the preview updating in real-time, pay attention to the dollars.


## :point_right: Mod Compatibility

By default, this mod **only simulates vanilla jokers**. To support modded jokers, it is necessary to tell this mod how to simulate them, which requires writing a new function for each modded joker. Unfortunately, this is the best way I could see to bypass all animations and side-effects, to calculate exact/min/max previews simultaneously, and to make the simulation efficient. It will be up to the other mod developers to ensure that the preview is accurate for their mods.

### :arrow_forward: How to make your mod compatible?

See [Divvy's Simulation](https://github.com/DivvyCr/Balatro-Simulation?tab=readme-ov-file#how-to-add-modded-jokers)