Skip to content

About

Game Patcher Leggero e Sicuro

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎮 BatPatcher – Game Patcher Leggero e Sicuro

BatPatcher è un patcher automatico per giochi, pensato come alternativa moderna ai classici patcher come martysama0134 o il patcher di TheSeed, ma senza i loro inconvenienti.
Niente installazioni complesse, nessun falso positivo dagli antivirus e supporto nativo HTTPS per i download.

✅ Perfetto per server privati, emulatori e progetti amatoriali che necessitano di un sistema di aggiornamento affidabile, veloce e trasparente.


🔥 Perché scegliere BatPatcher?

Caratteristica BatPatcher Patcher tradizionali (es. Martysama)
Nessuna installazione ✅ Sì (standalone) ❌ Richiedono setup
Rilevato come virus ✅ NO (firmato da script puliti) ❌ Spesso flaggati come malware
Protocollo HTTPS ✅ Supporto nativo ❌ Spesso solo HTTP (insicuro)
Controllo integrità SHA256 ✅ Sì ❌ Raro o assente
Compatibilità Windows ✅ 7/8/10/11 ✅ Variabile
Script open-source ✅ Batch puro ❌ Binari chiusi

📦 Cosa fa BatPatcher?

  1. Scarica una patchlist.txt dal tuo server (via HTTPS).
  2. Confronta gli hash SHA256 dei file locali con quelli presenti nella lista.
  3. Scarica solo i file modificati o mancanti, con fallback automatico (curl → PowerShell).
  4. Verifica l'integrità di ogni download e, se corrotto, lo cancella per ritentare al prossimo avvio.
  5. Alla fine, mostra un menu interattivo per:
    • Avviare il gioco (Game.exe)
    • Aprire il file di configurazione (config.ini)
    • Entrare nel server Discord
    • Uscire

🚀 Installazione e Utilizzo

1. Scarica il file

Prendi l'ultima versione del file patcher.bat dal repository o dal tuo server di distribuzione.

2. Configura il server

Modifica le variabili all'inizio del file:

set "SERVER_URL=https://tua-url/Patcher"
set "PATCH_URL=https://tua-url/Patcher/patch"

Il server deve ospitare:

  • patchlist.txt (formato: nomefile|sha256)
  • I file nella sottocartella patch/ (o quella che hai impostato)

3. Esegui il patcher

Basta fare doppio clic su patcher.bat. Non serve installare nulla, nessuna dipendenza esterna (curl e PowerShell sono già presenti in Windows).

4. Menu finale

Dopo il controllo, scegli l'opzione desiderata.


🔧 Formato della patchlist

Il file patchlist.txt deve essere UTF-8 senza BOM e contenere righe del tipo:

file1.dll|a1b2c3d4e5f6...
file2.exe|67890abcdef...
sottocartella/file3.dat|abcdef...

Ogni riga: percorso relativo (con barre / o \) e hash SHA256 (esadecimale, senza spazi).

⚠️ Il patcher rispetta la struttura delle cartelle – le crea automaticamente se mancano.


🛠️ Personalizzazione

  • Avvio automatico – basta modificare la variabile GAME_EXE (di default Game.exe).
  • Configurazione – il file config.ini è apribile dal menu.
  • Link Discord – modifica l'URL nella sezione :DISCORD.
  • Colori ANSI – il patcher rileva automaticamente Windows 10/11 e attiva i colori; sui sistemi più vecchi vengono disattivati per compatibilità.

🧪 Funzionamento tecnico (per sviluppatori)

  1. Il download della patchlist usa curl con User‑Agent fake; in caso di fallimento (es. Windows 7) usa PowerShell.
  2. Per ogni file, calcola l'hash SHA256 con certutil e lo confronta con quello remoto.
  3. Se il file è nuovo o diverso, viene scaricato usando lo stesso meccanismo (curl → PowerShell).
  4. Dopo il download, ricalcola l'hash per verificare che il file non sia corrotto.
  5. Tutti gli errori (403, 404, HTML spurio) vengono intercettati e gestiti.

🛡️ Sicurezza e Affidabilità

  • Tutta la comunicazione è in HTTPS – niente traffico in chiaro.
  • Controllo hash SHA256 – previene aggiornamenti corrotti o manomissioni.
  • Nessun binario esterno – script interamente in Batch, visibile e modificabile.
  • Nessuna chiamata a servizi di terze parti – solo il tuo server.

📄 Licenza

Questo progetto è rilasciato sotto MIT License – sei libero di usarlo, modificarlo e distribuirlo, anche in progetti commerciali, con l'unico obbligo di mantenere il copyright originale.


🤝 Supporto e Community

Per segnalare bug, chiedere aiuto o contribuire, apri una Issue su GitHub.


🌟 Conclusione

BatPatcher riunisce il meglio dei patcher classici (leggerezza, velocità, controllo versione) eliminando i loro difetti storici.
Se gestisci un server di gioco e cerchi un sistema di aggiornamento pulito, sicuro e senza sorprese, BatPatcher è la scelta giusta.


Creato con ❤️ da NazgulCoder

🎮 BatPatcher – Lightweight and Secure Game Patcher

BatPatcher is an automatic game patcher designed as a modern alternative to classic patchers like martysama0134 or TheSeed's patcher, but without their drawbacks.

No complex installations, no antivirus false positives, and native HTTPS support for downloads.

✅ Perfect for private servers, emulators, and hobby projects that need a reliable, fast, and transparent update system.


🔥 Why Choose BatPatcher?

Feature BatPatcher Traditional Patchers (e.g., Martysama)
No installation ✅ Yes (standalone) ❌ Requires setup
Flagged as a virus ✅ NO (clean batch script) ❌ Often flagged as malware
HTTPS Protocol ✅ Native support ❌ Often HTTP only (insecure)
SHA256 integrity check ✅ Yes ❌ Rare or missing
Windows compatibility ✅ 7/8/10/11 ✅ Variable
Open-source script ✅ Pure Batch ❌ Closed binaries

📦 What Does BatPatcher Do?

  1. Downloads a patchlist.txt from your server (via HTTPS).
  2. Compares the SHA256 hashes of local files with the ones in the list.
  3. Downloads only modified or missing files, with automatic fallback (curl → PowerShell).
  4. Verifies the integrity of each download and, if corrupted, deletes it to retry on the next launch.
  5. Finally, displays an interactive menu to:
  • Launch the game (Game.exe)
  • Open the configuration file (config.ini)
  • Join the Discord server
  • Exit

🚀 Installation and Usage

1. Download the file

Get the latest version of the patcher.bat file from the repository or your distribution server.

2. Configure the server

Modify the variables at the top of the file:

set "SERVER_URL=https://your-url/Patcher"
set "PATCH_URL=https://your-url/Patcher/patch"

The server must host:

  • patchlist.txt (format: filename|sha256)
  • The files inside the patch/ subfolder (or whatever folder you configured)

3. Run the patcher

Just double-click patcher.bat. No installation required, no external dependencies (curl and PowerShell are already built into Windows).

4. Final menu

After the check is complete, choose your desired option.


🔧 Patchlist Format

The patchlist.txt file must be UTF-8 without BOM and contain lines formatted as follows:

file1.dll|a1b2c3d4e5f6...
file2.exe|67890abcdef...
subfolder/file3.dat|abcdef...

Each line: relative path (using / or \ slashes) and SHA256 hash (hexadecimal, no spaces).

⚠️ The patcher respects folder structure – it automatically creates subfolders if they are missing.


🛠️ Customization

  • Auto-launch – simply modify the GAME_EXE variable (defaults to Game.exe).
  • Configuration – the config.ini file can be opened directly from the menu.
  • Discord Link – edit the URL in the :DISCORD section.
  • ANSI Colors – the patcher automatically detects Windows 10/11 and enables colors; on older systems, they are disabled for compatibility.

🧪 How It Works Under the Hood (For Developers)

  1. Downloading the patchlist uses curl with a spoofed User-Agent; on failure (e.g., Windows 7), it falls back to PowerShell.
  2. For each file, it calculates the SHA256 hash using certutil and compares it with the remote hash.
  3. If the file is new or modified, it gets downloaded using the same mechanism (curl → PowerShell).
  4. After downloading, it recalculates the hash to verify the file is not corrupted.
  5. All errors (403, 404, unexpected HTML response) are intercepted and handled cleanly.

🛡️ Security & Reliability

  • All communication is over HTTPS – no unencrypted traffic.
  • SHA256 hash checking – prevents corrupted updates or tampering.
  • No external binaries – purely written in Batch, transparent and fully editable.
  • No third-party service calls – communicates strictly with your server.

📄 License

This project is released under the MIT License – you are free to use, modify, and distribute it, including in commercial projects, with the sole requirement of preserving the original copyright notice.


🤝 Support & Community

To report bugs, ask for help, or contribute, open an Issue on GitHub.


🌟 Conclusion

BatPatcher combines the best features of classic patchers (lightweight, fast, version-controlled) while eliminating their historical shortcomings.

If you run a game server and need a clean, secure, hassle-free update system, BatPatcher is the right choice.


Created with ❤️ by NazgulCoder

About

Game Patcher Leggero e Sicuro

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages