Skip to main content

Game Mod Guard

Read-only safety checker for downloaded game mods and mod archives.

Game Mod Guard helps players review Farming Simulator, American Truck Simulator, Euro Truck Simulator, and other game mod downloads before installing them. It does not prove a mod is safe, but it catches common "stop and look closer" signs: executables hiding in archives, scripts, nested archives, shortcut files, odd file types, and Microsoft Defender detections when Defender is available.

What It Does

  • Scans files, folders, .zip, and .scs archives without running the mod.
  • Computes SHA-256 hashes for downloaded files.
  • Flags risky file types such as .exe, .msi, .bat, .cmd, .ps1, .js, .vbs, .scr, and .lnk.
  • Flags nested archives and very large archives for review.
  • Calls Microsoft Defender on Windows when MpCmdRun.exe is available.
  • Prints a simple result: SAFE-LOOKING, REVIEW, or STOP.
  • Gives plain removal guidance, but never deletes anything.

Easiest Windows Setup

This is the simple version for normal players.

  1. Install Python from the Microsoft Store or from https://www.python.org/downloads/. During install, turn on Add python.exe to PATH if you see that checkbox.
  2. Go to the Game Mod Guard GitHub page.
  3. Click the green Code button.
  4. Click Download ZIP.
  5. Open your Downloads folder.
  6. Right-click the downloaded game-mod-guard-main.zip.
  7. Click Extract All....
  8. Open the extracted game-mod-guard-main folder.
  9. Find scan-mod.bat.
  10. Drag a downloaded mod file onto scan-mod.bat.

You do not need to unzip the game mod first. Drag the mod download itself, such as .zip, .scs, or a mod folder, onto scan-mod.bat.

If Windows asks whether to run the batch file, choose Run. Game Mod Guard is read-only: it scans and reports, but it does not delete or change the mod.

Important: the GitHub ZIP download does not auto-update. To update this simple version later, download the newest ZIP from GitHub again and extract it over the old folder.

Normal Use

After setup, use it like this:

  1. Download a mod.
  2. Do not open or install it yet.
  3. Drag the downloaded mod onto scan-mod.bat.
  4. Read the result.

If it says SAFE-LOOKING, the scanner did not find its known warning signs.

If it says REVIEW, ask a technical friend to check it before installing.

If it says STOP, do not install it. Delete that downloaded mod and get the mod from a safer source.

Computer Friend Setup

If you are comfortable with Python packages, install from PyPI:

py -m pip install --user game-mod-guard

Run it:

py -m game_mod_guard "C:\Users\you\Downloads\some-mod.zip"

Upgrade later:

py -m pip install --user --upgrade game-mod-guard

If Windows put Python scripts on PATH, this also works:

game-mod-guard "C:\Users\you\Downloads\some-mod.zip"

For release/publishing notes, see docs/PUBLISHING.md.

Command Line Use

Windows:

python game_mod_guard.py "C:\Users\you\Downloads\some-mod.zip"

Linux/macOS:

python3 game_mod_guard.py ~/Downloads/some-mod.zip

Scan several downloads at once:

python3 game_mod_guard.py ~/Downloads/mod1.zip ~/Downloads/mod2.scs

Write a JSON report:

python3 game_mod_guard.py ~/Downloads/mod.zip --json report.json

How To Read Results

Report output creates a new file exclusively (0600 permissions on POSIX). Existing files and links are refused, including aliases of scanned inputs. A failed write returns 1 and may leave a partial new report; it is not a successful scan receipt.

Exit codes are 0 for SAFE-LOOKING, 1 for REVIEW or report-write errors, and 2 for STOP (also argparse usage errors). Unlistable directories, unreadable explicit files and unsupported target types require review, never a clean result. Directory inspection classifies file names/metadata; it does not read every file's contents or recursively inspect archives inside that directory.

SAFE-LOOKING means Game Mod Guard did not find its known local warning signs. It is not a guarantee. Prefer official sources like GIANTS ModHub, Steam Workshop, and trusted mod communities.

REVIEW means the mod has something unusual: scripts, nested archives, unexpected file types, a huge archive, or the scanner could not inspect all contents. Ask a technical friend to review before installing.

STOP means the mod contains executable-style content or Microsoft Defender reported a detection. Do not install it. Delete the downloaded mod file and get the mod from a safer source.

If Python Is Missing

If scan-mod.bat says Python is missing:

  1. Open the Microsoft Store.
  2. Search for Python.
  3. Install the newest Python 3 version.
  4. Try dragging the mod onto scan-mod.bat again.

Computer-friend route: install Python from https://www.python.org/downloads/ and enable Add python.exe to PATH during install.

Good Habits

  • Avoid .exe installers for normal mods.
  • Avoid password-protected archives.
  • Avoid "download manager" buttons and random mirror sites.
  • Keep Windows Security / Microsoft Defender enabled.
  • Prefer official ModHub and Steam Workshop downloads.

Scope

This is a local, read-only scanner. It does not upload files, contact a cloud scanner, remove malware, or modify mods. If you already ran a suspicious file, use Windows Security Offline Scan or ask a trusted technician for help.

Metadata

Release files for game-mod-guard 0.1.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for game-mod-guard 0.1.4
File Size Uploaded Provenance Actions
game_mod_guard-0.1.4.tar.gz 9.9 kB With provenance Details for game_mod_guard-0.1.4.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for game-mod-guard 0.1.4
File Interpreter ABI Platform Actions
game_mod_guard-0.1.4-py3-none-any.whl Python 3 none any Details for game_mod_guard-0.1.4-py3-none-any.whl

Total release size: 18.6 kB

Release files / game_mod_guard-0.1.4.tar.gz

Download URL game_mod_guard-0.1.4.tar.gz
Size 9.9 kB
Tags Source
SHA-256 checksum
How to use checksums
88adec46c9d6edaa4f7b60241b617e3c8a93b0dc08471bc8813b11ace181f55a
BLAKE2b-256 checksum
How to use checksums
cea69a7e3167a8e72e73256221e3bcc2ecf72e3bcd6ea446b6ef2dc9c324a92b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.

Transparency log

Release files / game_mod_guard-0.1.4-py3-none-any.whl

Download URL game_mod_guard-0.1.4-py3-none-any.whl
Size 8.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
289a77d8987db56789fcf2a7c56352c9994022d99cefc107d5d89efe5773c303
BLAKE2b-256 checksum
How to use checksums
5a1ff5286b2d30746569b6498a4c7dd19843e2d2d76b1307b735dfb5088e9908
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.

Transparency log

Security for game-mod-guard 0.1.4

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for game_mod_guard-0.1.4.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.4 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page