Skip to content

Aurelius7309/BlackHole

Repository files navigation

Black Hole - Accessibility/Screenreader mod for Balatro

Black Hole is an accessibility mod for Balatro that adds screen reader support to the game. It was tested on Windows with NVDA. Other screenreaders supported by Tolk should also work. If no screenreader is detected, Microsoft SAPI 5 will be used instead (Not recommended). Support for default speech voices on macOS is also included.

How to install Black Hole

For a complete distribution including Achievements Enabler, Nopeus and an automatic update script, head to the latest release. For a manual installation process, follow the steps below:

  1. Install Balatro on Steam if you haven't already. Wait a few seconds for the music to start playing to ensure the save directory is set up correctly, then close the game.
  2. Create an exclusion for Balatro in Windows Security. Lovely is incorrectly flagged as malicious, so it will cause issues if you don't disable it.
  3. Install Lovely.
  4. Download the latest source code of Steamodded using this direct link. Copy the Steamodded-main folder inside the zip file to your clipboard.
  5. Press the Windows key + R and type in %AppData%/Balatro. In this folder, create a new directory named Mods. Paste the Steamodded-main folder from your clipboard here.
  6. Download the latest source code of Black Hole as well as any other mods you wish to install and add them to your Mods folder.
  7. If you are using NVDA (recommended): Copy nvdaControllerClient64.dll from the bin folder inside Black Hole and paste it into the same directory where you placed version.dll earlier.
  8. Launch the game!

The keyboard controller

Black Hole allows you to play the game solely with your keyboard by emulating controller inputs. The default keybinds are listed below. If you want to configure different keybinds, press 3 on the main menu.

Controller button Default key Usage
D-Pad up W
D-Pad down S
D-Pad left A
D-Pad right D
X X Play hand / Reroll shop
Y C Start run (in the main menu or while paused) / Discard / Next round (in shop)
A Space Confirm / Select cards (hold to rearrange)
B Shift Cancel / Deselect all cards
Start Escape Open Options menu
Left Trigger Q Show Deck preview
Right Trigger E Open Deck view
Left Bumper Z Sell card
Right Bumper V Buy card / Use consumable
Back Tab Open Run Info

Limitations

  • The game settings are not yet accessible.
  • The game features popups with multiple tabs in some places. You can use the bumpers to switch between tabs, but there is no audio output while doing so. If you move down into the menu and back up to the tab selector, it is however possible to know your current selection.

Other mods

  • Nopeus is an extension of the MoreSpeeds mod for Balatro, including a new speed which reduces delays in the event manager to 0/near-zero.
  • Achievements Enabler is an example mod included with Steamodded that re-enables Steam achievements.
  • Dimserene's Modpack includes a large selection of various mods for you to choose from. Depending on their additions, not all mods may be fully accessible.

Credits

About

Accessibility/Screenreader mod for Balatro

Resources

Stars

Watchers

Forks

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •