Files
gregWiki/docs/reference/reference-data-files.md
Marvin ee3f30e502 docs: update sidebar and documentation to include greg hooks registry
- Added new items to the sidebar for 'greg-hooks-and-events' and 'greg-hooks-registry' under the Framework and Reference categories, respectively.
- Enhanced the documentation layout by including references to the greg hooks registry in various guides and topics, improving accessibility to hook-related information.
- Updated descriptions in the documentation to clarify the purpose and usage of the greg hooks and their registry.

This commit aims to improve the visibility and usability of the greg hooks registry within the documentation.
2026-04-10 03:36:30 +02:00

48 lines
1.6 KiB
Markdown

---
id: reference-data-files
title: Binary reference exports
sidebar_label: Reference data (.gz)
description: Large hook exports used by tooling (gzip archives under docs/reference).
---
# Binary reference exports
This section describes **large reference exports** used by hook analysis and build-time tooling. When present, they live next to this documentation tree under `docs/reference/` (as `.gz` files).
## Files (when committed)
- `assembly-hooks.txt.gz`
- `modder-hooks.ffm.txt.gz`
## Decompress locally
```bash
gzip -dk assembly-hooks.txt.gz
gzip -dk modder-hooks.ffm.txt.gz
```
```powershell
$inputPath = ".\\assembly-hooks.txt.gz"
$outputPath = ".\\assembly-hooks.txt"
$in = [System.IO.File]::OpenRead($inputPath)
$out = [System.IO.File]::Create($outputPath)
$gzip = New-Object System.IO.Compression.GzipStream($in, [System.IO.Compression.CompressionMode]::Decompress)
$gzip.CopyTo($out)
$gzip.Dispose(); $out.Dispose(); $in.Dispose()
```
## JSON hook registry (gregFramework)
The **gregFramework** repo also ships a **structured** hook list for IL2CPP Harmony patches:
- **Path:** `greg_hooks.json` at repo root (and a build-staged copy under `gregCore/framework/gregFramework/`).
- **Purpose:** canonical `greg.<DOMAIN>.<Action>` ids, `patchTarget`, `payloadSchema`, and optional `legacy` aliases for `GregCompatBridge`.
- **Docs:** [greg hooks registry (IL2CPP)](/wiki/reference/greg-hooks-registry).
This file is **generated** from Il2CppInterop sources; it is not one of the gzip archives above.
## Pipeline usage
- Prefer reading `.gz` directly from scripts when possible.
- Avoid committing extracted `.txt` blobs unless required for CI.