# Compatible renderer adapter

This directory contains the source patch used to turn the pinned GPLv3-compatible Red Alert 2 Web client into the DSH renderer companion.

- Upstream: `https://github.com/huangkaoya/redalert2.git`
- Pinned commit: `8c07f1092b2a9e8d8605ed49ef46d77b6c3ea367`
- Patch license: `GPL-3.0-only`, matching the upstream `LICENSE`
- Game assets: not included and never downloaded by the preparation script

Run `pnpm prepare:renderer -- /absolute/output/directory`. The command clones the pinned source into a new directory, checks the exact commit, decodes and applies `patches/redalert2-8c07f109.patch.gz.base64`, runs the companion test, and builds `dist/`. It refuses to reuse or overwrite an existing destination. The checked-in artifact is only a gzip-compressed base64 representation of the normal Git patch; decode it with `base64 --decode | gzip --decompress` when reviewing it manually.

After the build, set `RA_RENDERER_DIST_DIR` to the printed absolute `dist` path. The real client asks the user to select their own lawful RA2 archive in the browser. The plugin and preparation script do not copy or publish that archive.