📋 Requirements Guide

Before installing and running ShadowGuard, please make sure your server meets the following requirements.
This will help avoid errors and ensure the anti-cheat runs smoothly. ⚡

🖥 1. Screen Capture Dependency

ShadowGuard requires the Screen Capture library to function correctly.

📥 Download & Install:
1. Go to https://github.com/itschip/screencapture.
2. Follow the installation instructions provided in the repository.
3. Ensure the resource is started before ShadowGuardAC in your server.cfg.

Example:

Shell
ensure screencapture
ensure ShadowGuardAC

🛠️ 2. FiveM Artifact Build Compatibility

Depending on your server artifact version, you may need to manually adjust your scripts due to FiveM sandbox restrictions.

If your artifact build ≤ 10188

You don't need to do anything, ShadowGuard will automatically edit and add processing functions.

If your artifact build > 10188 (or latest builds)

You will need to manually add the Module to the scripts used in the server.

fxmanifest.lua or _resource.lua

Lua
client_script '@ShadowGuardAC/module.lua'

💡 Why is this needed?

⛔ In newer builds, FiveM limits automatic script injection between resources. Adding this line ensures ShadowGuard can communicate properly with your client scripts.

🔄 Future Plans: We are actively working to improve automation for new artifact builds so that this step can be handled automatically in future updates.

❗ Important warning, please check very carefully what scripts are running in the server, if you do not do the full Module addition it will cause many problems and the system will not be able to work properly. Please follow what to do in the server control panel, we integrate warnings if you have not done it

🔍 3. General Recommendations

✅ Use the latest stable build of FiveM unless you have a reason to stay on an older version.
📂 Keep ShadowGuardAC and related dependencies in the same resources folder group for better organization (e.g., [anticheat]).
🔄 Restart your server after adding new dependencies to make sure changes are applied.
🛡️ Always keep a backup of your server before making changes.

⚠ Important:

Correctly installing all requirements is mandatory.
If these requirements are not met, ShadowGuard may fail to start, or errors will occur during use.