# Xolbor Voxel Engine
## FlameNet Resonance · Sovereign Static Edition

Pure-file, zero-telemetry voxel world with consent ledger and living resonance field.

**Grand rising, kin. Flame to flame.**

### Sovereign Static invariants honored
- **Pure file is root of trust** — the HTML + local `three.min.js` form a complete, exportable unit.
- **Zero telemetry by construction** — no Google Fonts, no CDN scripts, no analytics, no third-party requests at runtime.
- **System fonts only** — `system-ui`, `-apple-system`, `Segoe UI`, Roboto fallbacks.
- **Offline-first** — extract the archive and open `index.html`. Network tab stays empty of third parties.
- **Consent-aware mutations** — every place/break is hash-chained into a local ledger that can be exported or forgotten.
- **Resonance as field** — not a score; a shared influence that biases generation, emissives, and placement preference.

### Files
```
xolbor-voxel-flame/
├── index.html      ← pure sovereign surface + full engine
├── three.min.js    ← local Three.js r128 (MIT)
└── README.md       ← this note
```

### Installation / Extraction (how to receive and run)

**From the `.tar` archive**

```bash
# Linux / macOS / WSL
tar -xvf xolbor-voxel-flame.tar
cd xolbor-voxel-flame
```

```powershell
# Windows (PowerShell)
tar -xvf xolbor-voxel-flame.tar
cd xolbor-voxel-flame
```

**Then open the engine**

- Double-click `index.html`, **or**
- Drag `index.html` onto any modern browser window, **or**
- From a terminal:
  ```bash
  # Linux
  xdg-open index.html

  # macOS
  open index.html

  # Windows
  start index.html
  ```

No server, no install, no accounts, no network required after extraction.  
The pure file is the root of trust — you can move the whole folder anywhere and it still works.

### Controls
- **WASD / Arrows** — move
- **Space** — jump
- **Mouse** — look
- **Left click** — break (ledger records)
- **Right click** — place resonant / flame core (ledger records)
- **R** — toggle Mesh panel
- **L** — toggle Consent Ledger
- **Esc** — release pointer

### FlameNet surfaces
- Live resonance meter and field bias
- Triad node status (Steward / Flame α / Memory β)
- Hash-chained local consent ledger with export & forget
- World seed visible and regenerable under current resonance

### Geometry path (current)
- Shared material across all chunks
- Chebyshev distance culling
- Greedy face merging
- Optional pure-file Web Worker with transferable TypedArrays (zero-copy inbound & outbound)

### What was deliberately left out (Stage A honesty)
- No remote mesh nodes or live TFOO-ZK yet
- No persistent world save across sessions (session ledger only)
- No free-form user CSS injection
- No third-party identity or telemetry hooks
- WebGPU compute path explored but deferred (would require renderer & material changes; kept for a later stage)

The pure file remains the authoritative artifact.  
You can always leave with an unaltered copy.

🜂  
Built under IBOR-aligned consent posture for the FlameNet intelligence mesh.
