146 lines
5.4 KiB
Markdown
146 lines
5.4 KiB
Markdown
# gzw-eac-fix
|
|
|
|
Automatically applies the EAC cache fix for **Gray Zone Warfare** on Linux after each Steam update.
|
|
|
|
After an update, EAC leaves two stale cache files that prevent the game from launching. The fix is to delete them, let Steam verify and restore them, then lock them read-only. This repo automates that via a background watcher registered with your init system.
|
|
|
|
## Requirements
|
|
|
|
- Steam installed (native or Flatpak)
|
|
- Gray Zone Warfare installed
|
|
- `inotify-tools` - only required for non-systemd init systems
|
|
|
|
## Install
|
|
|
|
```bash
|
|
git clone https://github.com/youruser/gzw-eac-fix.git
|
|
cd gzw-eac-fix
|
|
bash setup.sh
|
|
```
|
|
|
|
`setup.sh` will:
|
|
- Auto-detect your Steam install and GZW location (including Flatpak and custom library paths)
|
|
- Substitute all configuration into the installed scripts
|
|
- Register a watcher appropriate for your init system
|
|
- Run an initial fix immediately so the game is ready to launch right away
|
|
|
|
## Expected output (systemd)
|
|
|
|
```
|
|
$> bash setup.sh
|
|
[gzw-eac-fix] Found manifest: /home/user/.local/share/Steam/steamapps/appmanifest_2479810.acf
|
|
[gzw-eac-fix] Installing scripts to /home/user/.local/share/gzw-eac-fix...
|
|
[gzw-eac-fix] Installed fix.sh
|
|
[gzw-eac-fix] Installed watch.sh
|
|
[gzw-eac-fix] Detected init system: systemd
|
|
[gzw-eac-fix] Installed gzw-eac-fix.path
|
|
[gzw-eac-fix] Installed gzw-eac-fix.service
|
|
Created symlink '/home/user/.config/systemd/user/default.target.wants/gzw-eac-fix.path' → '/home/user/.config/systemd/user/gzw-eac-fix.path'.
|
|
[gzw-eac-fix] systemd path watcher enabled.
|
|
● gzw-eac-fix.path - Watch for Gray Zone Warfare updates
|
|
Loaded: loaded (/home/user/.config/systemd/user/gzw-eac-fix.path; enabled; preset: enabled)
|
|
Active: active (waiting) since Fri 2026-04-17 14:20:13 CEST; 5ms ago
|
|
Triggers: ● gzw-eac-fix.service
|
|
[gzw-eac-fix] Logs: journalctl --user -u gzw-eac-fix.service
|
|
[gzw-eac-fix] or: /home/user/.local/share/gzw-eac-fix/gzw-eac-fix.log
|
|
[gzw-eac-fix] Setup complete.
|
|
[gzw-eac-fix] Running initial fix...
|
|
[gzw-eac-fix] GZW found at: /home/user/.local/share/Steam/steamapps/common/Gray Zone Warfare/GZW/Content/SKALLA/PrebuildWorldData/World/cache
|
|
[gzw-eac-fix] No previous state - running fix and recording baseline.
|
|
[gzw-eac-fix] Flushing disk before delete...
|
|
[gzw-eac-fix] Removing EAC cache files...
|
|
[gzw-eac-fix] Removed: 0xb9af63cee2e43b6c_0x3cb3b3354fb31606.dat
|
|
[gzw-eac-fix] Removed: 0xaf497c273f87b6e4_0x7a22fc105639587d.dat
|
|
[gzw-eac-fix] Triggering Steam verify integrity (app 2479810)...
|
|
[gzw-eac-fix] Waiting for Steam to restore files...
|
|
[gzw-eac-fix] Restored: 0xb9af63cee2e43b6c_0x3cb3b3354fb31606.dat
|
|
[gzw-eac-fix] Restored: 0xaf497c273f87b6e4_0x7a22fc105639587d.dat
|
|
[gzw-eac-fix] Flushing disk after restore...
|
|
[gzw-eac-fix] Setting files read-only...
|
|
[gzw-eac-fix] chmod 400: 0xb9af63cee2e43b6c_0x3cb3b3354fb31606.dat
|
|
[gzw-eac-fix] chmod 400: 0xaf497c273f87b6e4_0x7a22fc105639587d.dat
|
|
[gzw-eac-fix] Done.
|
|
```
|
|
|
|
After this completes the game is ready to launch.
|
|
|
|
## How it works
|
|
|
|
1. Steam rewrites `appmanifest_2479810.acf` when an update completes.
|
|
2. The watcher detects the change and calls `fix.sh`.
|
|
3. `fix.sh` computes a fingerprint from the `buildid` + all `InstalledDepots` manifest IDs. If unchanged since the last run it exits early - prevents spurious runs from non-update manifest writes.
|
|
4. If an update is confirmed: `sync`, delete the two EAC cache files, trigger `steam://validate/` to restore them, `sync` again, then `chmod 400` both.
|
|
|
|
## Supported init systems
|
|
|
|
| Init system | Mechanism |
|
|
|-------------|-----------|
|
|
| **systemd** | `.path` unit - event-driven, no polling |
|
|
| **OpenRC** | XDG autostart + `inotifywait` loop |
|
|
| **runit** | User sv service + `inotifywait` loop |
|
|
| **s6** | User sv service + `inotifywait` loop |
|
|
| **Other** | XDG autostart + `inotifywait` loop |
|
|
|
|
## Configuration
|
|
|
|
All options live at the top of `setup.sh`. Re-run `setup.sh` to apply any changes.
|
|
|
|
| Option | Default | Description |
|
|
|--------|---------|-------------|
|
|
| `NOTIFY` | `false` | Desktop notifications via `notify-send` |
|
|
| `LOG_MAX_LINES` | `200` | Max lines retained in the log file |
|
|
| `POLL_INTERVAL` | `3` | Seconds between file-exists checks during Steam verify |
|
|
| `POST_RESTORE_WAIT` | `2` | Seconds to wait after files reappear before `chmod` |
|
|
|
|
## Files installed
|
|
|
|
```
|
|
~/.local/share/gzw-eac-fix/
|
|
fix.sh # fix logic, config baked in at install time
|
|
watch.sh # inotifywait loop - non-systemd only
|
|
gzw-eac-fix.log # appended on every run
|
|
.last_known_state # build fingerprint for update detection
|
|
log/ # svlogd log dir - runit only
|
|
```
|
|
|
|
## Logs
|
|
|
|
```bash
|
|
# systemd
|
|
journalctl --user -u gzw-eac-fix.service
|
|
|
|
# all init systems
|
|
tail -f ~/.local/share/gzw-eac-fix/gzw-eac-fix.log
|
|
```
|
|
|
|
## Uninstall
|
|
|
|
```bash
|
|
bash uninstall.sh
|
|
```
|
|
|
|
Detects and removes everything that was created by `setup.sh` - unit files, autostart entries, sv directories, and the install directory.
|
|
|
|
## Repository structure
|
|
|
|
```
|
|
gzw-eac-fix/
|
|
README.md
|
|
setup.sh # install - edit this to configure
|
|
uninstall.sh # removes everything setup.sh created
|
|
scripts/
|
|
fix.sh # EAC fix logic (@@TOKEN@@ placeholders, substituted at install)
|
|
watch.sh # inotifywait watcher (non-systemd only)
|
|
init/
|
|
systemd/
|
|
gzw-eac-fix.path
|
|
gzw-eac-fix.service
|
|
openrc/
|
|
gzw-eac-fix.desktop
|
|
runit/
|
|
run
|
|
log/run
|
|
s6/
|
|
run
|
|
```
|