Skip to content

jhonnriq/S4Cleaner

Repository files navigation

🎮 The Sims 4 - Limpador de Cache

Version Python License Status

Um programa com interface gráfica moderna para limpar arquivos de cache do The Sims 4.


📸 Screenshots

Interface Principal Resultado da Limpeza

Esquerda: Interface Principal | Direita: Resultado da Limpeza


✨ Características

  • 🎨 Interface gráfica moderna com PySide6
  • 🧹 Limpeza automática de arquivos de cache do The Sims 4
  • 📊 Exibição do tamanho do cache antes e depois da limpeza
  • 🔍 Detecção de arquivos em uso pelo jogo
  • ✅ Mensagens claras de sucesso e erro
  • 🆓 Totalmente gratuito e código aberto
  • 💾 Cálculo automático de espaço liberado

🗑️ Arquivos que são limpos

Pastas

  • cachestr
  • onlinethumbnailcache

Arquivos

  • Config.log
  • GameVersion.txt
  • localthumbcache.package
  • localsimtexturecache.package
  • lastException.txt (e variações)

📋 Requisitos

  • Python: 3.8 ou superior
  • PySide6: Interface gráfica

🚀 Instalação

Clone este repositório

git clone https://github.com/jhonnriq/S4Cleaner.git
cd S4Cleaner

Instale as dependências

pip install -r requirements.txt

💻 Como usar

Versão compilada (.exe) - Pronta para uso

A forma mais simples de usar o programa é baixar a versão já compilada:

  1. Acesse a seção Releases no repositório
  2. Baixe o arquivo S4Cleaner.exe da versão mais recente
  3. Execute o arquivo .exe diretamente - não precisa instalar Python ou dependências

✅ Vantagens da versão compilada:

  • Não requer instalação do Python
  • Não precisa instalar dependências
  • Pronta para usar imediatamente
  • Funciona em qualquer Windows

Executar do código fonte

python S4Cleaner.py

Ou use a versão sem console:

pythonw S4Cleaner.pyw

Compilar para executável

Use o script de build incluído:

python build_exe.py

O executável será gerado na pasta dist.


🔒 Segurança

Este programa é 100% seguro e código aberto. O código fonte completo está disponível para análise.

O que o programa faz:

  • ✅ Acessa apenas a pasta Documents/Electronic Arts/The Sims 4
  • ✅ Remove apenas arquivos de cache conhecidos
  • ✅ Não faz nenhuma conexão com a internet
  • ✅ Não coleta nenhum dado do usuário
  • ✅ Não modifica saves ou configurações do jogo

Por que é seguro:

  • 🔓 Código fonte aberto para verificação
  • 🔄 Apenas remove arquivos de cache que o jogo regenera automaticamente
  • 💾 Não afeta seus saves, mods ou configurações personalizadas

⏰ Quando usar o limpador

É especialmente recomendado usar este limpador:

  • 🔄 Após instalar uma atualização do The Sims 4
  • 📦 Após instalar uma atualização de Mods
  • 🗑️ Após remover algum Mod
  • ⚠️ Quando o jogo se comporta de forma estranha

💡 Benefício especial: Ao limpar o cache após uma atualização, seus mods e scripts permanecerão habilitados automaticamente, evitando a necessidade de reativá-los manualmente.


Dependências

  • PySide6 - Interface gráfica
  • PyInstaller - Compilação para executável (opcional)

📜 Licença

Este projeto é licenciado sob a GNU General Public License v3.0.

Para mais detalhes, visite: https://www.gnu.org/licenses/gpl-3.0.html


👨‍💻 Créditos

Desenvolvido por Jhonnriq


🤝 Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para:

  • 🐛 Reportar bugs
  • 💡 Sugerir novas funcionalidades
  • 🔨 Fazer pull requests

📞 Suporte

Se você encontrar algum problema ou tiver sugestões, por favor abra uma issue no repositório.

About

Ferramenta moderna em Python para limpar arquivos de cache do The Sims 4 (TS4), remover lag e otimizar o carregamento de mods com segurança e não precisar habilitar Mods e Scripts depois de uma atualização do The Sims 4.

Topics

Resources

License

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors

Languages