# Local Offset Repository

Runtime offset loading is offline-only. Files are grouped by Roblox client build:

```text
Data/Offsets/
  manifest.json
  version-<clientVersionUpload>/
    Offsets.cs
    LuaOffsets.cs
```

`Offsets.cs` is required for attach. `LuaOffsets.cs` is optional; when it is missing
or invalid, the bridge falls back to Lua signature scanning.

Manual update flow:

1. Identify the Roblox `clientVersionUpload` for the build you want to support.
2. Create `Data/Offsets/version-<clientVersionUpload>/`.
3. Place the instance offsets in `Offsets.cs`.
4. Place the Lua VM offsets in `LuaOffsets.cs` when available.
5. Update `manifest.json` with source, timestamp, bytes and SHA-256.
6. Build or publish the app so the folder is copied beside the executable.

For local experiments or emergency hotfixes, set `BADTRAINERS_OFFSET_ROOT` to a
different offset root. The expected structure under that directory is the same.
