Handy

Handy - a Balatro mod which adds keybinds and new controls to the game

designed for faster, easier and more comfortable Vanilla and Modded gameplay

Key features

• Keybinds for all vanilla actions: play, discard, hand sorting, cash out, shop reroll, view deck, _and more_;
• Fast hand selection: select cards just by hovering them (showcase);
• Quick Buy/Sell/Use: buy, sell or use cards in one button press (showcase);
• Faster game speed: adjust game speed up to x512;
• Animations skip: instant scoring and cards drawing, removing unnecessary animations (showcase);
• Precise selecting: easier management of large amount of jokers or consumables (showcase);
• Mass Sell and Remove: solutions for bulk selling and removing jokers for your Cryptid runs (showcase);

-...And much more: up to 100 controls to try and play around!

Quality & Accessibility

• Lovely mod: no SMODS required; all controls always available; doesn't disable achievements;
• Stability is priority: safe for use in Vanilla, Multiplayer and with any other mods;
• Full control: each feature can be disabled/enabled individually;
• Full freedom: any keybind can be assigned to _any combination_ of mouse, keyboard or gamepad buttons;
• Instant effect: all config changes applied immediately, no run or game restart required;
• Presets: save up to 3 config layouts to switch between in any moment;
• Built-in mod updater: install once, update mod in-game automatically;
• Full gamepad support

Installation

• Install lovely by following instructions in repository page. Make sure your antivirus is not removing it;
• Download latest release of mod by selecting an archive named Handy-[version].zip;
• Put HandyBalatro folder from archive (NOT Handy-[version]) into Mods folder.
• Start a game, go to "Options". if you see new blue button, all done correctly;
• Configure each feature and keybind as you want. Explore and go wild!
• Continue playing! No game restart or new run required.

Contribute

Want new features to be implemented? Want add mod support? Found a bug?

Create an issue or let me know in Discord mod's thread!

Special thanks

• Jogla (@jogla_the_wizard in Discord) - old Spanish localization
• Sesebasti - old Spanish (Mexico) localization
• shxiaj - Simplified Chinese localization
• Rynnya (@Ancowi in Discord) - testing on gamepad
• Aikoyori - testing (including MacOS)
• missingnumber (@clickonflareblitz in Discord) - testing (including SteamDeck)
• jenwalter666 (@jenwalter in Discord) - non-direct support with "spreading" a mod for other players
• LocalThunk - for making such outstanding and groundbreaking game we all LÖVE

-...and everyone who report bugs, make suggestions, and playing with my mod!

For developers

When adding new buy or use buttons for jokers/consumables via G.UIDEF.buy_and_sell_buttons(), you can mark them and Handy will use them when [Quick Buy/Sell] or [Quick Use] controls is called.

Include in button config definition field handy_insta_action with one of the following values:

• sell: when card needs to be sold, used by [Quick Buy/Sell]
• buy: when card needs to be bought, used by [Quick Buy/Sell]
• use: when card needs to be used, used by [Quick Use]

-- Somewhere inside G.UIDEF.buy_and_sell_buttons() hook

{

n = G.UIT.R,

config = {

button = 'buy_my_card', func = 'can_buy_my_card',

handy_insta_action = 'buy',

--...your button definition

},

nodes = {... }

},

Mod and/or specific controls can be partially or fully disabled conditionally.

if Handy and Handy.e_mitter then

-- Apply all changes when mod and game fully ready

Handy.e_mitter.on("game_start", function()

-- Disable mod entirely

local mod_active_ref = Handy.is_mod_active

function Handy.is_mod_active()

return not MyMod.allow_only_vanilla_controls and mod_active_ref()

end

-- Disable controls such as mass sell and mass remove

local dangerous_active_red = Handy.is_dangerous_actions_active

function Handy.is_dangerous_actions_active()

return not MyMod.only_safe_controls and d