cssforsaken

A source-backed ForsakenX scene renderer powered by PolyCSS. It prepares ForsakenX level data into browser-ready assets, then renders the scene as inspectable HTML/CSS 3D geometry instead of WebGL or canvas.

Run Locally

pnpm install
export FORSAKENX_DATA_URL="https://github.com/ForsakenX/forsaken-data/archive/52ed2ef1c79f80753af376a50c790dcca19ef7f1.zip"
pnpm build:full
pnpm dev

Open:

http://127.0.0.1:5173/?level=vol2&start=0

If you already have data locally, use this instead of FORSAKENX_DATA_URL:

export FORSAKENX_DATA_ROOT=".local/forsaken-data"

Generated assets are ignored and written to:

build/generated/public/forsaken

Netlify

Use a Git-connected deploy with:

Build command: pnpm run build:full
Publish directory: dist

Set this environment variable:

FORSAKENX_DATA_URL=https://github.com/ForsakenX/forsaken-data/archive/52ed2ef1c79f80753af376a50c790dcca19ef7f1.zip

Optional:

NODE_VERSION=22
FORSAKENX_DATA_SHA256=<archive sha256>

Commands

pnpm prepare:forsaken -- --level vol2 --start 0 --mode source-visible
pnpm build
pnpm build:full
pnpm test
pnpm test:assets
pnpm test:browser
pnpm test:all

pnpm build uses existing generated assets. pnpm build:full prepares assets first.

Routes

/?level=vol2&start=0
/?level=vol2&start=0&mode=source-visible

Runtime debug state is exposed at:

window.__cssForsakenDebug

Data and License

Source code is GPL-2.0-only. Original ForsakenX data is not committed to this repository. Raw data, generated assets, screenshots, traces, and local reports should stay ignored unless the project policy changes explicitly.