# aeterna-rongroi

> An offline, read-only, open-source PC-check tool for FiveM communities. It looks for traces that cheats leave on a Windows PC and for machine settings that make cheating easier, and shows them as evidence. It never says a PC is "clean". Latest release: {{rongroi.version}} ({{rongroi.published_date}}), pre-alpha, with {{rongroi.rules}} detection rules and {{rongroi.selectors}} timeline selectors.

*rongroi* (ร่องรอย) is Thai for "traces". A player runs it on their own PC, either to check themselves or while server staff watch over a screenshare (SS) with the player's consent.

What it does and does not do:

- Every result is Found, Not found (with how far back the source reaches) or Not measured (with a reason). There is no score and no pass/fail summary.
- It reads local Windows artifacts (Prefetch, BAM, PCA, event logs, registry, files) and never writes, deletes or moves anything on the scanned PC.
- The program's own code has no network code; CI fails the build if any is added.
- It cannot see cheats running on a second PC (DMA) or menus hidden from screen capture. Finding nothing does not mean there is nothing.
- Windows x64 only. Releases are not code-signed yet; check the download against `SHA256SUMS` on the release page.
- Code is GPL-3.0-or-later; rules are CC-BY-SA-4.0. Free to use.

## Docs

- [README](https://github.com/aeterna/aeterna-rongroi/blob/main/README.md): what it is, quick start, how to verify a download
- [Screenshare guide](https://github.com/aeterna/aeterna-rongroi/blob/main/docs/screenshare-guide.md): how staff and players run a consented check
- [Rules reference](https://github.com/aeterna/aeterna-rongroi/blob/main/docs/rules-reference.md): every rule, what it reads and what a match means
- [Architecture](https://github.com/aeterna/aeterna-rongroi/blob/main/docs/architecture.md): collectors, rules engine and report
- [Privacy](https://github.com/aeterna/aeterna-rongroi/blob/main/PRIVACY.md): what is read, what leaves the PC, what SS mode shows

## Decisions

- [ADR 0002 — Evidence, never a verdict](https://github.com/aeterna/aeterna-rongroi/blob/main/docs/adr/0002-evidence-not-verdict.md)
- [ADR 0003 — Offline: no network code](https://github.com/aeterna/aeterna-rongroi/blob/main/docs/adr/0003-offline-no-network.md)
- [ADR 0045 — Reading the report in layers](https://github.com/aeterna/aeterna-rongroi/blob/main/docs/adr/0045-reading-the-report-in-layers-and-where-its-code-is.md)

## Optional

- [Releases](https://github.com/aeterna/aeterna-rongroi/releases): downloads and `SHA256SUMS`
- [Discussions](https://github.com/aeterna/aeterna-rongroi/discussions): questions and false-positive reports
- [Security policy](https://github.com/aeterna/aeterna-rongroi/blob/main/SECURITY.md): report a way around a check privately
