documentation
Maps, not mysteries.
Start here for how Block fits together. Deep detail stays in the GitHub Markdown so it versions with the code.
Download / get started
Zip, Setup, multi-viewer, Shift+B.
Viewers
Firestorm, Alchemy, Black Dragon, and friends.
Platforms
Windows · Linux Vulkan · macOS Metal soon.
Contribute
Ground rules, build, PR + CI authorship gates.
AI policy
Human craft only — what we reject and accept.
Architecture
OpenGL injector vs Vulkan layer.
Handbook
Repo map and product principles.
Notices
vkShade, ReShade, and brand credit.
Security
How to report a vulnerability.
latest.json
OTA channel for Setup and the overlay.
Backends & platforms
| Path | Artifact | Status |
|---|---|---|
| OpenGL (Windows) | opengl32.dll via Setup | Supported — Firestorm, Alchemy, Black Dragon |
| Vulkan (Win / Linux) | block.dll / layer | Experimental / builds on Linux CI |
| Metal (macOS) | Future rebuild | Coming soon |
Overlay hotkey: Shift+B. Licence: BSD-2-Clause.
Principles
- Honest compatibility — only claim viewers you tested
- Slow-PC defaults — performance mode, compile active techniques
- Safe addons on OpenGL — no DXGI / DLSS / renodx by default
- Human authorship — AI policy + PR CI gates
- Credit upstream — vkShade, ReShade FX, user GShade packs