Vuoi espandere Balatro con funzionalità aggiuntive, mazzi personalizzati o piccoli ritocchi di qualità della vita? In questa guida completa scoprirai tutto quello che serve per moddare il gioco in maniera sicura, reversibile e organizzata, da chi parte da zero fino a chi vuole creare la propria mod.
Perché moddare Balatro
Balatro è un titolo che si presta particolarmente a essere personalizzato: la struttura single‑player, il motore leggero e una community attiva fanno sì che nuove carte, regole di punteggio alternative e migliorie estetiche compaiano di continuo. Installare mod significa:
- Allungare la longevità del gioco con contenuti inediti.
- Adattare la difficoltà al proprio stile (sfide hardcore o partite rilassate).
- Affinare l’interfaccia — dal font alle animazioni — se si gioca su monitor ultrawide o Steam Deck.
- Sperimentare meccaniche prototipo prima che diventino ufficiali.
Prerequisiti hardware e software
Balatro gira su Windows, Linux (Proton) e Steam OS. I passaggi qui illustrati valgono in linea di massima per ogni piattaforma, con piccole differenze di percorso:
- Windows:
C:\Program Files (x86)\Steam\steamapps\common\Balatro\ - Linux o Steam Deck:
~/.steam/steam/steamapps/common/Balatro/(o corrispondente).
Assicurati di avere i permessi di scrittura nella cartella del gioco, un programma di estrazione (7‑Zip, WinRAR, unarchiver) e, se richiesto, l’ultima versione di BepInEx o del Mod Manager scelto.
Piano di lavoro consigliato
| Passo | Cosa fare | Perché è importante |
|---|---|---|
| Backup | Copiare l’intera cartella del gioco o, quantomeno, i file saves e settings.json. | Protegge i progressi da eventuali salvataggi corrotti o crash post‑mod. |
| Verifica versione | Controllare che la mod sia compatibile con la build installata (numero di versione in basso a sinistra nel menu principale). | Dopo una patch ufficiale molte mod richiedono un aggiornamento. |
| Scaricare i file di sviluppo | Procurarsi l’SDK pubblicato dagli autori o librerie come BepInEx 6; includere eventuali dipendenze. | Le mod di Balatro, spesso scritte in C#, vengono caricate come plugin e hanno bisogno di un bootstrapper. |
| Individuare la directory di Balatro | In Steam: Gestisci → Sfoglia file locali. | Serve a copiare i file senza creare percorsi errati. |
| Estrarre i file della mod | Aprire l’archivio (.zip, .rar, .7z) e mantenere intatta la gerarchia. | Un file spostato di una cartella può mandare in errore l’intero caricamento. |
| Copiare nella cartella corretta | Tipicamente \Balatro\Mods\ o \BepInEx\plugins\. Se assente, crearla. | BepInEx scansiona solo le directory predefinite. |
| Testare | Avviare Balatro: se il logo di BepInEx appare o se compare un nuovo pannello “Mods”, il caricamento è riuscito. | Meglio installare una mod alla volta per isolare conflitti. |
| Comunità & supporto | Controllare forum (Steam, Discord, Reddit r/Balatro) per hotfix e consigli. | Alcuni bug si risolvono con un file patch rilasciato in giornata. |
Scelta del Mod Manager
Se installi più mod in parallelo, un gestore dedicato ti evita copia‑incolla manuali:
- r2modman: interfaccia pulita, profili separati, integrazione con Thunderstore.
- Vortex: supporta un’enorme libreria di giochi, ma richiede qualche minuto di configurazione iniziale.
- Manuale + script PowerShell: per chi preferisce pieno controllo e automazioni personalizzate.
Indipendentemente dallo strumento scelto, imposta sempre una copia pulita di Balatro come base, da ripristinare in caso di problemi.
Installazione dettagliata di BepInEx
Download
Scarica la build x64 compatibile con il framework .NET usato dal gioco; solitamente si tratta del pacchetto “BepInEx 6 IL2CPP”.
Posizionamento
- Scompatta l’archivio direttamente dentro la cartella principale di Balatro.
- Accertati che la struttura risultante contenga le directory
core,config,plugins. - Avvia il gioco una prima volta per generare i file di log.
Verifica
Nella cartella BepInEx\config dovrebbero comparire i config della console e delle patch; in BepInEx\LogOutput.log troverai la lista dei plugin caricati (inizialmente nessuno).
Installare la prima mod
- Scarica il file zip della mod.
- Aprilo e trascina il
.dll(o l’intera cartella della mod) dentroBepInEx\plugins\. - Lancia Balatro: in fase di boot, BepInEx mostrerà “Loaded 1 plugin”.
- Controlla in‑game che le nuove voci di menu, carte o seed siano effettivamente presenti.
In caso di crash istantaneo, vai su BepInEx\crashes\ e leggi l’ultimo report per individuare il nome del file incriminato.
Risolvere conflitti e crash
Shuffling mod
Due plugin che toccano la stessa classe C# possono sovrascriversi a vicenda. Ordina i file in base al load order, rinominandoli con prefissi numerici se necessario (00‑CoreFix.dll, 10‑UIEnhance.dll).
Rollback rapido
Se il gioco si rifiuta di partire:
- Rinomina momentaneamente
BepInExinBepInEx‑disabled. - Avvia Balatro: se parte, il problema è in una mod.
- Ripristina la cartella e togli un plugin alla volta finché non trovi il colpevole.
Log di avvio chiari
Imposta LogConsole = true in BepInEx.cfg: avrai un prompt separato che mostra in tempo reale eccezioni e stacktrace.
Consigli avanzati
- Profilazione FPS: alcuni shader custom pesano più del previsto; usa MSI Afterburner o l’overlay di Steam per monitorare frame‑time.
- Steam Deck: aggiungi
WINEDLLOVERRIDES="winhttp=n,b"nelle opzioni di lancio se BepInEx dà errore su Proton 8. - Compatibilità cloud: i file di salvataggio modded possono non sincronizzarsi. Disattiva la cloud di Steam finché non hai testato a fondo.
- Signature check: se l’antivirus blocca la dll, aggiungila alle esclusioni o ricompilala localmente.
Creare la propria mod
Vuoi passare dall’altra parte della barricata? Segui questi passaggi:
- Installa Visual Studio Community 2022 con il carico di lavoro “Sviluppo desktop con C#”.
- Crea un progetto class library .NET Standard 2.1.
- Riferisci le dll di Balatro:
Balatro_Data\Managed\Assembly‑CSharp.dlleUnityEngine.dll. - Imposta l’entry point con l’attributo
[BepInPlugin]. - Compila e copia il risultato in
BepInEx\plugins\. - Testa con HarmonyX per patchare i metodi del gioco in runtime.
Template pronto all’uso
Molti modder condividono su Git repository con template già configurati: basta clonare, rinominare namespace e plugin ID, quindi concentrarsi sulla logica.
Manutenzione periodica
- Controlla il changelog di Balatro ad ogni patch: se vengono toccati file di asset, sospendi l’auto‑update di Steam finché gli autori delle mod non confermano la compatibilità.
- Archivia le versioni funzionanti delle tue mod preferite; un update mal riuscito può rendere irrecuperabile la build precedente.
- Pulisci la cartella
configdi BepInEx: i vecchi file di configurazione possono puntare a classi non più esistenti.
Domande frequenti
La console di BepInEx non si apre, cosa faccio?
Verifica di aver copiato la build x64: Balatro è a 64 bit; la console non compare con le varianti x86.
Posso giocare online con un amico se ho mod installate?
Balatro è un’esperienza single‑player; la condivisione di seed funziona, ma i punteggi non ufficiali non entrano nelle classifiche.
È possibile usare più mod che modificano le carte?
Sì, purché non editino le stesse carte base. In caso di conflict resolver, prevale l’ultima caricata.
Best practice di sicurezza
Prima di eseguire un eseguibile setup.exe allegato a una mod, calcola l’hash SHA‑256 con CertUtil ‑hashfile nomefile.exe SHA256 e confrontalo con quello dichiarato dall’autore. Se non coincide, cestina il download.
Checklist finale prima di avviare il gioco
- Cartella
BepInExal livello principale di Balatro. - Plugin posizionati correttamente e non duplicati.
- Backup del salvataggio in una directory esterna.
- Modalità offline di Steam disattivata solo dopo il primo test.
Conclusioni
Moddare Balatro amplia enormemente le possibilità strategiche senza compromettere la stabilità del titolo originale, a patto di seguire un metodo rigoroso: backup, verifica versione, installazione ordinata e log puntuali. Con questa guida hai tutti gli strumenti per tuffarti nel lato più creativo del gioco e — perché no — contribuire tu stesso con nuove idee alla community.