O que é o Caliburn no cenário de mods de Cyberpunk 2077
Caliburn é uma ferramenta e framework de modding desenvolvido pela comunidade para Cyberpunk 2077. Ele substitui ou complementa os métodos tradicionais de modificação do jogo, oferecendo um sistema mais organizado para carregar arquivos de personalização, texturas, scripts e ajustes de gameplay. Diferente de simplesmente jogar .dlls na pasta do jogo, o Caliburn oferece uma camada de abstração que lida com conflicts entre mods de forma mais inteligente.
Caliburn Cyberpunk como base para mods avançados
A instalação básica envolve baixar o pacote do repositório oficial no GitHub e extrair os arquivos na raiz do diretório de instalação do Cyberpunk 2077, que normalmente fica em C:\Program Files (x86)\Steam\steamapps\common\Cyberpunk 2077. O instalador cria uma pasta chamada Caliburn junto com um arquivo de configuração YAML que você edita manualmente. A primeira vez que eu configurei, gastei cerca de 40 minutos só entendendo porque os mods não estavam carregando — o problema era que o caminho no config apontava para uma versão antigo do jogo que eu já havia desinstalado. Reconfigurar o paths resolvidou em dois minutos. O grande diferencial é o sistema de load order. Você define prioridade na config YAML, e o Caliburn aplica as alterações na ordem correta. Mods que sobrescrevem os mesmos arquivos não entram em conflito direto — o de maior prioridade simplesmente ganha. Isso elimina aquele problema clássico de dois mods de HUD que se destroem quando instalados juntos.
Instalação prática
Baixe a última versão estável do repositório oficial. Extraia o conteúdo na pasta do jogo. Abra o arquivo config.yaml com qualquer editor de texto. Adicione os caminhos dos seus mods na seção mods, um por linha, usando caminhos absolutos. Salve. Inicie o jogo. Se o log em Caliburn/logs/loader.log mostrar linhas verdes com "Loaded successfully" para cada mod, está funcionando. Se aparecerem avisos amarelos, verifique se o arquivo que o mod tenta modificar realmente existe no jogo — isso acontece frequentemente com mods feitos para versões diferentes do patch. O download oficial fica no GitHub do projeto. Procure pela aba Releases e baixe o arquivo .zip mais recente. Evite versões beta a menos que precise de alguma feature específica que ainda não foi lançada stable — elas costumam ter instability crônica, especialmente em sessões de jogo com mais de três horas de duração.
👉 Clique no botão abaixo para saber mais sobre o assunto!
Problemas reais que ninguém cuenta
Um issue recorrente é quando o Caliburn falha em hot-reload após uma atualização do jogo. O CDPROJEKT_RED altera IDs de arquivos entre patches, e o Caliburn pode começar a dar erro de mapeamento. A solução que eu uso é rodar o script de verificação de integridade deles antes de cada update do jogo, e limpar o cache com o parâmetro --clear-cache no launch options da Steam. Isso geralmente resolve em menos de 5 minutos. Outro problema é compatibilidade com Redmod. O Caliburn e o Redmod nativo da CD Projekt às vezes colidem porque ambos tentam hook no mesmo ponto de execução. Eu nunca consegui fazer os doisem paz de forma estável. Se você usa Redmod, desative o Caliburn. Se prefere o sistema de load order do Caliburn, remova o Redmod. Escolha um e fique com ele.
O Caliburn também não lida bem com mods que modificam o engine do jogo em si, como aqueles que alteram a engine graphique ou sistemas de rendering. Esses mods precisam ser aplicados manualmente como .dll overrides, e o Caliburn não tem mecanismo para gerenciar isso. Nesse caso, você precisa manter uma pasta separada de arquivos manuais e atualiza-los manualmente a cada patch.
Limitações importantes
O Caliburn não é uma solução perfeita. Ele depende do estado do jogo não ser corrompido — se os arquivos base do Cyberpunk 2077 foram modificados por outras ferramentas (como trainers ou cheat engines), o comportamento do Caliburn se torna imprevisível. Recomendo fortemente verificar a integridade dos arquivos do jogo na Steam antes de qualquer instalação. Também não há suporte oficial para modding multiplayer, já que o jogo não tem modo multiplayer nativo, mas mods que tentam simular isso costumam causar crash que o Caliburn não consegue isolar. Para quem está começando, o Curbarn funciona bem com mods de textura, UI, e ajustes de gameplay. Para mods de engine profunda, considere ferramentas mais especializadas ou modifie os arquivos diretamente. A curva de aprendizado é de cerca de uma tarde inteira para dominar a configuração inicial, depois o uso diário se torna automático.
