Como Modar Balatro: Guia Completo com Lovely e Steamodded

Quer turbinar o deck‑builder roguelike sensação de 2024? Com poucos minutos e as ferramentas certas, é possível adicionar baralhos inéditos, artes alternativas, desafios diários, modos cooperativos locais e até traduções personalizadas a Balatro. Este guia em português mostra cada etapa – da preparação do ambiente à gestão de conflitos – para que qualquer jogador lusófono consiga “modar” o jogo com segurança e facilidade.

Visão geral do modding em Balatro

Balatro foi criado em LÖVE 2D, motor que já nasce compatível com scripts Lua. A comunidade aproveitou esse detalhe para desenvolver injetores de código em tempo real que expõem a lógica do jogo e permitem carregamento dinâmico de novas cartas, baralhos, regras e interfaces. Hoje o ecossistema gira em torno de duas peças‑chave:

• Lovely – injetor runtime escrito em C ++ que insere uma ponte Lua entre o executável oficial e scripts externos.
• Steamodded (Smods) – estrutura modular que usa o Lovely internamente e fornece carregador, menu de mods, hooks prontos e sistema de auto‑update.

Combinando as duas ferramentas, instalar ou remover conteúdo extra resume‑se a copiar pastas para um diretório mods e reiniciar o jogo. Simples, rápido e reversível.

Pré‑requisitos e boas práticas

• Faça cópia de segurança da pasta de instalação (…/Steam/steamapps/common/Balatro) e dos ficheiros de gravação (%APPDATA%/Balatro ou ~/.local/share/Balatro). Assim você reverte qualquer problema em segundos.
• Verifique compatibilidade: cada mod costuma indicar a versão mínima de Smods ou do próprio Balatro. Misturar versões incorretas é a causa nº 1 de crashes.
• Participe da comunidade (Discord oficial, Reddit, fóruns Steam). Lá os autores anunciam atualizações, correções rápidas e coletam feedback.
• Mantenha o antivírus em modo “silencioso” para a pasta do jogo; version.dll e injectores costumam ser marcados como falso positivo.

Ferramentas essenciais

Ferramenta	Função principal	Formato de distribuição
Lovely	Injeta runtime Lua em executáveis LÖVE	binário version.dll ou lovely.dll
Steamodded / Smods	Framework de mods para Balatro	arquivo zip, pasta Smods
WinRAR / 7‑Zip	Extração de arquivos compactados	executável Windows / CLI Linux
Editor de texto (VS Code, Notepad++)	Inspecionar ou criar scripts Lua	instalador ou portable

Passo a passo completo

Instalar Lovely

1. Feche Balatro e o Steam.
2. Extraia o arquivo version.dll (ou lovely.dll em versões antigas) diretamente na pasta principal do jogo, ao lado de Balatro.exe.
3. Abra o Steam e execute Balatro uma vez. Se tudo deu certo, o injetor cria um log lovely.log sem erros.

Instalar Steamodded (Smods)

1. Baixe a versão estável mais recente de Smods (arquivo zip).
2. Descompacte dentro da mesma pasta do jogo, mantendo a estrutura Balatro/Smods/.
3. Inicie Balatro novamente. O Smods gera um novo subdiretório mods e mostra um menu “Mods” no canto inferior esquerdo.

Adicionar mods individuais

1. Procure pacotes em repositórios de confiança (Thunderstore, Nexus, repositórios Git). Evite fóruns obscuros sem revisão.
2. Verifique se o arquivo requer descompactação ou pode ser copiado como .zip. Smods lê ambos.
3. Coloque o mod dentro de Balatro/mods. Exemplo de estrutura após instalar três criações populares:

Balatro/
├── Balatro.exe
├── version.dll
├── Smods/
│   ├── smods.dll
│   └── ...
└── mods/
    ├── PortugueseTranslation_v1.2.zip
    ├── CustomDecks/
    │   └── init.lua
    └── MinimalHUD/
        ├── icons.png
        └── main.lua

No jogo, abra o menu “Mods”, ative ou desative cada item e clique em “Reload Mods” – sem reiniciar Balatro.

Atualizar ou remover

• Atualizar: substitua o arquivo antigo pelo novo (mesmo nome) ou sobreponha a pasta. O Smods recarrega a versão mais recente.
• Remover: apague a pasta ou .zip. Na próxima inicialização o conteúdo deixa de ser carregado.
• Roll‑back: mantém‑se a cópia de segurança; basta restaurar tudo e validar arquivos no Steam se necessário.

Solução de problemas comuns

Sintoma	Causa provável	Correção rápida
Jogo não abre após colocar version.dll	Antivírus bloqueou o injetor	Adicionar exceção ou desativar verificação em tempo real para a pasta Balatro
Tela preta com som	Mod incompatível depois de atualização oficial	Desativar metade dos mods e testar; repetir até encontrar o culpado
Menu “Mods” não aparece	Smods fora da pasta correta	Verificar se existe Balatro/Smods/smods.dll e reinstalar
Erro Lua “attempt to index nil”	Função do mod usando API mudada	Checar Git do autor em busca de commit de correção

Dicas avançadas

Carregamento seletivo por perfil

Para manter conjuntos de mods separados (ex.: “run sério” vs. “run caótico”), crie subpastas dentro de mods e renomeie antes de abrir o jogo. Exemplo:

mods_official/
mods_experimentos/
mods_stream/

Renomeie a pasta desejada para mods e inicie o jogo. Esse “perfil manual” evita conflitos sem depender de utilitários externos.

Gerindo dezenas de mods

• Use nomes padronizados: [Balancing]‑DamageRework, [UI]‑MinimalHUD, [Deck]‑TaroPack. O menu de Smods lista em ordem alfabética, facilitando busca.
• Desative debug logs em mods estáveis; economiza I/O e reduz atrasos na troca de cenas.
• Mantenha um documento CHANGELOG.txt próprio registrando data de instalação, versão e observações.

Criando o primeiro mod

1. Dentro de Balatro/mods, crie pasta HelloWorld.
2. Adicione main.lua com:

local mod = {
    id = "helloworldmod",
    name = "Olá Mundo!",
    version = "0.1.0"
}

function mod:load()
    G.log("Olá, modders lusófonos! 🚀")
end

return mod

Ative no menu e observe a mensagem no ficheiro smods.log. Pronto – seu primeiro mod funcionou!

Segurança e manutenção a longo prazo

• Atualize o Lovely apenas quando um mod expressamente exigir. Saltos de versão podem quebrar APIs antigas.
• Leia release notes dos autores; muitos avisam quando removem funções ou alteram nomes de variáveis.
• Desconfie de mods que pedem executáveis externos; a maioria deve ser simples script Lua ou assets.
• Armazene os instaladores offline; se um repositório sair do ar você ainda terá cópia local.
• Siga o calendário de patches oficiais. Até hoje, grandes atualizações de Balatro acontecem a cada dois ou três meses; programe‑se para “congelar” sua pasta de mods durante 48 h até que as compatibilidades sejam testadas.

FAQ – Perguntas frequentes

Posso ser banido no Steam por usar mods?
Balatro não utiliza anticheat nem modo online competitivo. O risco de ban é nulo.

Existe suporte oficial a Steam Workshop?
Ainda não. Os devs sinalizaram interesse, mas por ora o processo manual continua dominante.

Mods afetam conquistas?
Depende do mod. Traduções e cosméticos geralmente não; baralhos quebrados podem desbloquear conquistas sem querer. Use com parcimônia se liga para achievement hunting.

Funciona no Linux via Proton?
Sim. Basta colocar version.dll na pasta do prefixo Proton. Usuários relatam 100 % de sucesso.

Conclusão

Com alguns cliques, Balatro transforma‑se num laboratório infinito de experiências. Lovely entrega a ponte técnica, Smods organiza o conteúdo e a comunidade garante fluxo constante de ideias. Siga as boas práticas deste guia – backup, compatibilidade, participação em fóruns – e explore baralhos inéditos, desafios insanos e interfaces elegantes. Modar Balatro em 2025 é fácil, seguro e abre caminho para centenas de horas extras de diversão.