🔄 BepInEx Mod Updater

Automatic mod updates for ANY game with BepInEx — directly from ThunderStore, no launcher required.

🇬🇧 English | 🇷🇺 Русский | 🇪🇸 Español | 🇧🇷 Português | 🇩🇪 Deutsch | 🇫🇷 Français

---

🇬🇧 English

Automatic mod updates for ANY game with BepInEx — directly from ThunderStore, no launcher required.

📦 Installation

1. Download BepInExUpdater.exe from Releases
2. Put it anywhere — the program scans ALL your Steam libraries (C:, D:, ...) and finds every game with BepInEx by itself
3. Run BepInExUpdater.exe

🎮 How to use

1. Run the program
2. It scans all Steam libraries and lists games with BepInEx (if there are several — pick one by number)
3. It fetches the ThunderStore catalog and scans your mods
4. A report appears:

   --- CHECK RESULTS ---
     [OK]        Mod1 1.7.2
     [UPDATE]    Mod2: 3.0.1  ->  3.0.2
     [DELETED]  Mod3 1.0.0 (removed from ThunderStore)
   

5. If updates are available it asks: Do you want to update these mods? (Yes - 1, No - 2)
6. After updating — a summary and the backups path

🛡️ Safety

• Before every update the old mod version is moved to a backup, not deleted
• If download or extraction fails — automatic rollback
• Downloaded archives are verified by zip signature (PK) and exact size from the ThunderStore API
• The program never touches anything outside the folders of the mods being updated

🌍 Languages

The program speaks 6 languages — the language is picked automatically from your Windows language:

Language	Code
🇬🇧 English	en
🇷🇺 Русский	ru
🇪🇸 Español	es
🇧🇷 Português (BR)	pt
🇩🇪 Deutsch	de
🇫🇷 Français	fr

How to change the language:

1. Run the program and type /lang in the game selection menu, or run the program with the /lang argument (shortcut: append /lang to the target; or in PowerShell: .\BepInExUpdater.exe /lang)
2. Pick a language by number (1–6) — the choice is saved to lang.txt next to the program, and the program restarts automatically
3. To return to auto-detection — just delete lang.txt

⌨️ Commands

Type any command in the game selection menu:

Command	What it does
/help	Show this help
/lang	Change the language (restarts)
/log	Open updater_log.txt in Notepad
/info	Program info, version, GitHub link, total mods updated
/addgame [path]	Add a non-Steam game (e.g. C:\Games\MyGame) — saved to folders.txt

❓ FAQ

The program found no games It looks for games with a BepInEx folder inside Steam\steamapps\common\<game>, plus any folders you added via /addgame in folders.txt. Make sure BepInEx is installed.

My game is not on Steam (piracy, Epic, GOG, etc.) Run the program, type /addgame C:\path\to\game (the folder must contain BepInEx). It will be saved to folders.txt and shown alongside your Steam games on every launch.

A mod is listed as [DELETED] That mod has been removed from ThunderStore — it cannot be checked or updated, it is simply skipped.

A [CONFLICT] appears in the report Two or more mods ship the same .dll file. That can break things — check which mods share the file and remove the duplicate.

What are "loose" .dll files in the report? Those are mods dropped into plugins as a single file without a folder. Their version cannot be detected. Unzip the mod's zip as a folder — and updates become automatic.

The game is running — can I still update? The program will warn you and ask. Better close the game: mod files are locked and the update may fail.

Where are the old mod versions? In the .mod_backups folder inside plugins. The last 3 versions of each mod are kept, older ones are cleaned automatically.

---

🇷🇺 Русский

Автоматическое обновление модов для ЛЮБОЙ игры с BepInEx — напрямую с ThunderStore, без установки лаунчера.

📦 Установка

1. Скачайте BepInExUpdater.exe из раздела Releases
2. Положите его куда угодно — программа сама просканирует все библиотеки Steam (C:, D:, ...) и найдёт все игры с BepInEx
3. Запустите BepInExUpdater.exe

🎮 Как пользоваться

1. Запустите программу
2. Она просканирует все библиотеки Steam и покажет игры с BepInEx (если их несколько — выберите нужную по номеру)
3. Программа получит каталог ThunderStore и просканирует ваши моды
4. Появится отчёт:

   --- РЕЗУЛЬТАТ ПРОВЕРКИ ---
     [OK]        Мод1 1.7.2
     [UPDATE]    Мод2: 3.0.1  ->  3.0.2
     [DELETED]  Мод3 1.0.0 (удалён с ThunderStore)
   

5. Если есть обновления — программа спросит: Хотите ли вы обновить данные моды? (Да - 1, Нет - 2)
6. После обновления — итог и путь к бэкапам

🛡️ Безопасность

• Перед каждым обновлением старая версия мода перемещается в бэкап, а не удаляется
• Если скачивание или распаковка упали — автоматический откат на место
• Скачанный архив проверяется по zip-сигнатуре (PK) и точному размеру из API ThunderStore
• Программа ничего не трогает за пределами папок обновляемых модов

🌍 Языки

Программа говорит на 6 языках — язык выбирается автоматически по языку Windows:

Язык	Код
🇬🇧 English	en
🇷🇺 Русский	ru
🇪🇸 Español	es
🇧🇷 Português (BR)	pt
🇩🇪 Deutsch	de
🇫🇷 Français	fr

Как сменить язык:

1. Запустите программу и введите /lang в меню выбора игр, или запустите с аргументом /lang (ярлык: допишите /lang после пути; либо в PowerShell: .\BepInExUpdater.exe /lang)
2. Выберите язык цифрой (1–6) — выбор сохранится в lang.txt рядом с программой, и программа перезапустится автоматически
3. Чтобы вернуться к автоопределению — просто удалите lang.txt

⌨️ Команды

Введите команду прямо в меню выбора игр:

Команда	Что делает
/help	Показать эту справку
/lang	Сменить язык (перезапуск программы)
/log	Открыть updater_log.txt в Блокноте
/info	Информация о программе, версия, ссылка на GitHub, всего обновлено модов
/addgame [путь]	Добавить игру не из Steam (например, C:\Games\MyGame) — сохранится в folders.txt

❓ FAQ

Программа не нашла игры Она ищет игры с папкой BepInEx внутри Steam\steamapps\common\<игра>, а также папки, добавленные через /addgame в folders.txt. Убедитесь, что BepInEx установлен.

Игра не из Steam (пиратка, Epic, GOG и т.д.) Запустите программу и введите /addgame C:\path\to\game (в папке должен быть BepInEx). Путь сохранится в folders.txt и будет показываться наравне со Steam-играми при каждом запуске.

Мод в списке [DELETED] Такой мод удалён с ThunderStore — проверить/обновить его нельзя, он просто пропускается.

В отчёте появился [CONFLICT] Два или более модов содержат одинаковый .dll файл. Это может ломать игру — проверьте, какие моды делят файл, и удалите дубликат.

Что за «голые» .dll в отчёте? Это моды, кинутые в plugins одним файлом без папки. Их версию определить нельзя. Распакуйте zip мода папкой — и обновление станет автоматическим.

Игра запущена — можно обновляться? Программа предупредит и спросит. Лучше закрыть игру: файлы модов заблокированы, обновление может упасть.

Где старые версии модов? В папке .mod_backups внутри plugins. Хранятся последние 3 версии каждого мода, старые чистятся автоматически.

---

🇪🇸 Español

Actualización automática de mods para CUALQUIER juego con BepInEx — directamente desde ThunderStore, sin instalar ningún launcher.

📦 Instalación

1. Descarga BepInExUpdater.exe desde Releases
2. Ponlo donde quieras — el programa escanea TODAS tus bibliotecas de Steam (C:, D:, ...) y encuentra cada juego con BepInEx por sí mismo
3. Ejecuta BepInExUpdater.exe

🎮 Cómo usarlo

1. Ejecuta el programa
2. Escanea todas las bibliotecas de Steam y muestra los juegos con BepInEx (si hay varios — elige uno por número)
3. Obtiene el catálogo de ThunderStore y escanea tus mods
4. Aparece un informe:

   --- RESULTADOS DE LA COMPROBACIÓN ---
     [OK]        Mod1 1.7.2
     [UPDATE]    Mod2: 3.0.1  ->  3.0.2
     [DELETED]  Mod3 1.0.0 (eliminado de ThunderStore)
   

5. Si hay actualizaciones, pregunta: ¿Quieres actualizar estos mods? (Sí - 1, No - 2)
6. Tras actualizar — resumen y ruta de las copias de seguridad

🛡️ Seguridad

• Antes de cada actualización, la versión antigua del mod se mueve a una copia de seguridad, no se borra
• Si la descarga o extracción falla — reversión automática
• Los archivos descargados se verifican por la firma zip (PK) y el tamaño exacto de la API de ThunderStore
• El programa no toca nada fuera de las carpetas de los mods que se actualizan

🌍 Idiomas

El programa habla 6 idiomas — el idioma se elige automáticamente según tu idioma de Windows:

Idioma	Código
🇬🇧 English	en
🇷🇺 Русский	ru
🇪🇸 Español	es
🇧🇷 Português (BR)	pt
🇩🇪 Deutsch	de
🇫🇷 Français	fr

Cómo cambiar el idioma:

1. Ejecuta el programa y escribe /lang en el menú de selección de juegos, o ejecútalo con el argumento /lang (acceso directo: añade /lang tras la ruta; o en PowerShell: .\BepInExUpdater.exe /lang)
2. Elige el idioma con un número (1–6) — la elección se guarda en lang.txt junto al programa, y el programa se reinicia automáticamente
3. Para volver a la detección automática — simplemente borra lang.txt

⌨️ Comandos

Escribe cualquier comando en el menú de selección de juegos:

Comando	Qué hace
/help	Mostrar esta ayuda
/lang	Cambiar el idioma (reinicia)
/log	Abrir updater_log.txt en el Bloc de notas
/info	Información del programa, versión, enlace a GitHub, total de mods actualizados
/addgame [ruta]	Añadir un juego que no sea de Steam (ej.: C:\Games\MiJuego) — se guarda en folders.txt

❓ FAQ

El programa no encuentra juegos Busca juegos con carpeta BepInEx dentro de Steam\steamapps\common\<juego>, más las carpetas añadidas con /addgame en folders.txt. Asegúrate de que BepInEx está instalado.

Mi juego no es de Steam (pirata, Epic, GOG, etc.) Ejecuta el programa y escribe /addgame C:\ruta\al\juego (la carpeta debe contener BepInEx). Se guardará en folders.txt y aparecerá junto a tus juegos de Steam en cada inicio.

Un mod aparece como [DELETED] Ese mod ha sido eliminado de ThunderStore — no se puede comprobar ni actualizar, simplemente se omite.

Aparece un [CONFLICT] en el informe Dos o más mods incluyen el mismo archivo .dll. Eso puede romper cosas — revisa qué mods comparten el archivo y elimina el duplicado.

¿Qué son los .dll "sueltos" del informe? Son mods echados en plugins como un solo archivo sin carpeta. No se puede detectar su versión. Descomprime el zip del mod como carpeta — y las actualizaciones serán automáticas.

El juego está en marcha — ¿puedo actualizar? El programa te avisará y preguntará. Mejor cierra el juego: los archivos están bloqueados y la actualización puede fallar.

¿Dónde están las versiones antiguas de los mods? En la carpeta .mod_backups dentro de plugins. Se guardan las últimas 3 versiones de cada mod, las más antiguas se limpian automáticamente.

---

🇧🇷 Português

Atualização automática de mods para QUALQUER jogo com BepInEx — direto do ThunderStore, sem instalar launcher.

📦 Instalação

1. Baixe o BepInExUpdater.exe em Releases
2. Coloque-o onde quiser — o programa escaneia TODAS as suas bibliotecas da Steam (C:, D:, ...) e encontra cada jogo com BepInEx sozinho
3. Execute o BepInExUpdater.exe

🎮 Como usar

1. Execute o programa
2. Ele escaneia todas as bibliotecas da Steam e mostra os jogos com BepInEx (se houver vários — escolha um pelo número)
3. Ele obtém o catálogo do ThunderStore e escaneia seus mods
4. Aparece um relatório:

   --- RESULTADO DA VERIFICAÇÃO ---
     [OK]        Mod1 1.7.2
     [UPDATE]    Mod2: 3.0.1  ->  3.0.2
     [DELETED]  Mod3 1.0.0 (removido do ThunderStore)
   

5. Se houver atualizações, ele pergunta: Deseja atualizar estes mods? (Sim - 1, Não - 2)
6. Após atualizar — resumo e caminho dos backups

🛡️ Segurança

• Antes de cada atualização, a versão antiga do mod é movida para um backup, não apagada
• Se o download ou a extração falharem — reversão automática
• Os arquivos baixados são verificados pela assinatura zip (PK) e pelo tamanho exato da API do ThunderStore
• O programa não toca em nada fora das pastas dos mods que estão sendo atualizados

🌍 Idiomas

O programa fala 6 idiomas — o idioma é escolhido automaticamente pelo idioma do seu Windows:

Idioma	Código
🇬🇧 English	en
🇷🇺 Русский	ru
🇪🇸 Español	es
🇧🇷 Português (BR)	pt
🇩🇪 Deutsch	de
🇫🇷 Français	fr

Como mudar o idioma:

1. Execute o programa e digite /lang no menu de seleção de jogos, ou execute com o argumento /lang (atalho: acrescente /lang após o caminho; ou no PowerShell: .\BepInExUpdater.exe /lang)
2. Escolha o idioma pelo número (1–6) — a escolha é salva em lang.txt junto ao programa, e o programa reinicia automaticamente
3. Para voltar à detecção automática — basta apagar o lang.txt

⌨️ Comandos

Digite qualquer comando no menu de seleção de jogos:

Comando	O que faz
/help	Mostrar esta ajuda
/lang	Mudar o idioma (reinicia)
/log	Abrir o updater_log.txt no Bloco de notas
/info	Informações do programa, versão, link do GitHub, total de mods atualizados
/addgame [caminho]	Adicionar um jogo que não é da Steam (ex.: C:\Games\MeuJogo) — salvo em folders.txt

❓ FAQ

O programa não encontra jogos Ele procura jogos com pasta BepInEx dentro de Steam\steamapps\common\<jogo>, mais as pastas adicionadas via /addgame em folders.txt. Verifique se o BepInEx está instalado.

Meu jogo não é da Steam (pirata, Epic, GOG, etc.) Execute o programa e digite /addgame C:\caminho\para\jogo (a pasta deve conter BepInEx). Ele será salvo em folders.txt e aparecerá junto aos jogos da Steam em cada execução.

Um mod aparece como [DELETED] Esse mod foi removido do ThunderStore — não pode ser verificado nem atualizado, ele é simplesmente ignorado.

Aparece um [CONFLICT] no relatório Dois ou mais mods incluem o mesmo arquivo .dll. Isso pode quebrar as coisas — verifique quais mods compartilham o arquivo e remova o duplicado.

O que são os .dll "soltos" do relatório? São mods jogados em plugins como um único arquivo sem pasta. Não dá para detectar a versão deles. Extraia o zip do mod como pasta — e as atualizações ficarão automáticas.

O jogo está em execução — posso atualizar? O programa avisará e perguntará. Melhor fechar o jogo: os arquivos dos mods ficam bloqueados e a atualização pode falhar.

Onde estão as versões antigas dos mods? Na pasta .mod_backups dentro de plugins. São guardadas as últimas 3 versões de cada mod, as mais antigas são limpas automaticamente.

---

🇩🇪 Deutsch

Automatische Mod-Updates für JEDES Spiel mit BepInEx — direkt von ThunderStore, ohne Launcher.

📦 Installation

1. Lade die BepInExUpdater.exe aus Releases herunter
2. Lege sie ab, wo du willst — das Programm durchsucht ALLE deine Steam-Bibliotheken (C:, D:, ...) und findet jedes Spiel mit BepInEx von selbst
3. Starte BepInExUpdater.exe

🎮 Benutzung

1. Programm starten
2. Es durchsucht alle Steam-Bibliotheken und zeigt die Spiele mit BepInEx (bei mehreren — wähle eines per Nummer)
3. Es lädt den ThunderStore-Katalog und durchsucht deine Mods
4. Ein Bericht erscheint:

   --- PRÜFERGEBNIS ---
     [OK]        Mod1 1.7.2
     [UPDATE]    Mod2: 3.0.1  ->  3.0.2
     [DELETED]  Mod3 1.0.0 (von ThunderStore entfernt)
   

5. Gibt es Updates, fragt es: Möchtest du diese Mods aktualisieren? (Ja - 1, Nein - 2)
6. Nach dem Update — Zusammenfassung und Backup-Pfad

🛡️ Sicherheit

• Vor jedem Update wird die alte Mod-Version in ein Backup verschoben, nicht gelöscht
• Schlägt Download oder Entpacken fehl — automatischer Rollback
• Heruntergeladene Archive werden per Zip-Signatur (PK) und exakter Größe aus der ThunderStore-API geprüft
• Das Programm fasst nichts außerhalb der Ordner der zu aktualisierenden Mods an

🌍 Sprachen

Das Programm spricht 6 Sprachen — die Sprache wird automatisch anhand deiner Windows-Sprache gewählt:

Sprache	Code
🇬🇧 English	en
🇷🇺 Русский	ru
🇪🇸 Español	es
🇧🇷 Português (BR)	pt
🇩🇪 Deutsch	de
🇫🇷 Français	fr

So änderst du die Sprache:

1. Starte das Programm und tippe /lang im Spielauswahlmenü ein, oder starte es mit dem Argument /lang (Verknüpfung: häng /lang an den Pfad an; oder in PowerShell: .\BepInExUpdater.exe /lang)
2. Wähle die Sprache per Nummer (1–6) — die Wahl wird in lang.txt neben dem Programm gespeichert, und das Programm startet neu automatisch
3. Um zur automatischen Erkennung zurückzukehren — lösche einfach die lang.txt

⌨️ Befehle

Tippe einen Befehl im Spielauswahlmenü:

Befehl	Funktion
/help	Diese Hilfe anzeigen
/lang	Sprache ändern (Neustart)
/log	updater_log.txt im Editor öffnen
/info	Programminfos, Version, GitHub-Link, insgesamt aktualisierte Mods
/addgame [Pfad]	Nicht-Steam-Spiel hinzufügen (z. B. C:\Games\MeinSpiel) — wird in folders.txt gespeichert

❓ FAQ

Das Programm findet keine Spiele Es sucht nach Spielen mit einem BepInEx-Ordner in Steam\steamapps\common\<Spiel>, plus Ordnern, die du per /addgame in folders.txt hinzugefügt hast. Stelle sicher, dass BepInEx installiert ist.

Mein Spiel ist nicht von Steam (Pirat, Epic, GOG usw.) Starte das Programm und tippe /addgame C:\pfad\zum\spiel (der Ordner muss BepInEx enthalten). Es wird in folders.txt gespeichert und bei jedem Start zusammen mit deinen Steam-Spielen angezeigt.

Ein Mod erscheint als [DELETED] Dieser Mod wurde von ThunderStore entfernt — er kann weder geprüft noch aktualisiert werden, er wird einfach übersprungen.

Im Bericht erscheint [CONFLICT] Zwei oder mehr Mods enthalten dieselbe .dll-Datei. Das kann Probleme verursachen — prüfe, welche Mods die Datei teilen, und entferne das Duplikat.

Was sind die „losen" .dll-Dateien im Bericht? Das sind Mods, die als einzelne Datei ohne Ordner in plugins geworfen wurden. Ihre Version ist nicht erkennbar. Entpacke das Zip des Mods als Ordner — dann werden Updates automatisch.

Das Spiel läuft — kann ich trotzdem updaten? Das Programm warnt und fragt. Besser das Spiel schließen: Die Mod-Dateien sind gesperrt und das Update kann fehlschlagen.

Wo sind die alten Mod-Versionen? Im Ordner .mod_backups innerhalb von plugins. Die letzten 3 Versionen jedes Mods bleiben erhalten, ältere werden automatisch gelöscht.

---

🇫🇷 Français

Mise à jour automatique des mods pour N'IMPORTE quel jeu avec BepInEx — directement depuis ThunderStore, sans launcher.

📦 Installation

1. Téléchargez BepInExUpdater.exe depuis Releases
2. Mettez-le où vous voulez — le programme scanne TOUTES vos bibliothèques Steam (C:, D:, ...) et trouve chaque jeu avec BepInEx tout seul
3. Lancez BepInExUpdater.exe

🎮 Utilisation

1. Lancez le programme
2. Il scanne toutes les bibliothèques Steam et affiche les jeux avec BepInEx (s'il y en a plusieurs — choisissez-en un par numéro)
3. Il récupère le catalogue ThunderStore et scanne vos mods
4. Un rapport apparaît :

   --- RÉSULTAT DE LA VÉRIFICATION ---
     [OK]        Mod1 1.7.2
     [UPDATE]    Mod2: 3.0.1  ->  3.0.2
     [DELETED]  Mod3 1.0.0 (retiré de ThunderStore)
   

5. S'il y a des mises à jour, il demande : Voulez-vous mettre à jour ces mods ? (Oui - 1, Non - 2)
6. Après la mise à jour — bilan et chemin des sauvegardes

🛡️ Sécurité

• Avant chaque mise à jour, l'ancienne version du mod est déplacée dans une sauvegarde, pas supprimée
• Si le téléchargement ou l'extraction échoue — annulation automatique
• Les archives téléchargées sont vérifiées par la signature zip (PK) et la taille exacte de l'API ThunderStore
• Le programme ne touche à rien en dehors des dossiers des mods mis à jour

🌍 Langues

Le programme parle 6 langues — la langue est choisie automatiquement selon votre langue Windows :

Langue	Code
🇬🇧 English	en
🇷🇺 Русский	ru
🇪🇸 Español	es
🇧🇷 Português (BR)	pt
🇩🇪 Deutsch	de
🇫🇷 Français	fr

Comment changer de langue :

1. Lancez le programme et tapez /lang dans le menu de sélection des jeux, ou lancez-le avec l'argument /lang (raccourci : ajoutez /lang après le chemin ; ou dans PowerShell : .\BepInExUpdater.exe /lang)
2. Choisissez la langue par numéro (1–6) — le choix est enregistré dans lang.txt à côté du programme, et le programme redémarre automatiquement
3. Pour revenir à la détection automatique — supprimez simplement lang.txt

⌨️ Commandes

Tapez une commande dans le menu de sélection des jeux :

Commande	Effet
/help	Afficher cette aide
/lang	Changer la langue (redémarre)
/log	Ouvrir updater_log.txt dans le Bloc-notes
/info	Infos du programme, version, lien GitHub, total de mods mis à jour
/addgame [chemin]	Ajouter un jeu hors Steam (ex. : C:\Games\MonJeu) — sauvegardé dans folders.txt

❓ FAQ

Le programme ne trouve aucun jeu Il cherche des jeux avec un dossier BepInEx dans Steam\steamapps\common\<jeu>, plus les dossiers ajoutés via /addgame dans folders.txt. Vérifiez que BepInEx est installé.

Mon jeu n'est pas sur Steam (pirate, Epic, GOG, etc.) Lancez le programme et tapez /addgame C:\chemin\vers\jeu (le dossier doit contenir BepInEx). Il sera sauvegardé dans folders.txt et affiché avec vos jeux Steam à chaque lancement.

Un mod apparaît comme [DELETED] Ce mod a été retiré de ThunderStore — il ne peut ni être vérifié ni mis à jour, il est simplement ignoré.

Un [CONFLICT] apparaît dans le rapport Deux mods ou plus contiennent le même fichier .dll. Cela peut casser des choses — vérifiez quels mods partagent le fichier et supprimez le doublon.

Que sont les .dll « isolés » du rapport ? Ce sont des mods déposés dans plugins en un seul fichier sans dossier. Leur version est indéterminable. Décompressez le zip du mod en dossier — et les mises à jour deviendront automatiques.

Le jeu est en cours d'exécution — puis-je mettre à jour ? Le programme vous avertira et demandera. Mieux vaut fermer le jeu : les fichiers des mods sont verrouillés et la mise à jour peut échouer.

Où sont les anciennes versions des mods ? Dans le dossier .mod_backups dans plugins. Les 3 dernières versions de chaque mod sont conservées, les plus anciennes sont nettoyées automatiquement.

---

📜 Changelog

See CHANGELOG.md for the full version history.