# Immersive Events

> Custom interactive immersive attractions (Halloween & holiday shows) combining
> scenic design with electronic games. The current active project is **Halloween
> 2026** — a brand-new electronic attraction set in the Blackwood Manor universe,
> built around five major Arduino / ESP32 / RFID / BrightSign games plus analog
> parlor activities.

Site root: https://immersive-events-7f76db.pages.dev

## Recommended agent workflow

1. This file (`/llms.txt`) — the machine-oriented index.
2. [CHANGELOG](https://immersive-events-7f76db.pages.dev/CHANGELOG.md) — what changed recently (newest first); each entry links to the doc it affected.
3. The affected **authoritative** doc — a game's `GAME-INFO.md`, the show's `SHOW-INFO.md`, or the platform spec.
4. Deeper source/adaptation material only when you need it.

Links below are absolute URLs. Folder names contain spaces encoded as `%20`.

## Maturity legend (do not mistake design for tested fact)

- **proposed** — brief/idea only; not yet engineered. Treat as intent, not spec.
- **decided** — design decisions made and documented, but NOT yet bench-tested on
  real hardware. Authoritative as *intent*; hardware specifics may still change.
- **verified** — bench-tested / confirmed on real hardware.
- **production** — built and running in the show.

> Nothing in Halloween 2026 is `verified` or `production` yet — it is a design/
> prototyping-phase show. Per-game status is tagged below.

## Halloween 2026 — active project

- [Show overview & master index](https://immersive-events-7f76db.pages.dev/Halloween%202026/SHOW-INFO.md): rooms, all games, authority model, resolved decisions, open questions.
- [Cross-Pollination — Laboratory](https://immersive-events-7f76db.pages.dev/Halloween%202026/games/cross-pollination/GAME-INFO.md) — **[decided]** spec complete incl. Brett's original brief; bench pending. Magnetic-wand plant-hybrid puzzle; Arduino Mega + ESP32 ×6 cabinets; 16 Hall sensors; RGB + UV. First prototype target.
- [Evangeline's Lost Ledger — Library](https://immersive-events-7f76db.pages.dev/Halloween%202026/games/evangelines-lost-ledger/GAME-INFO.md) — **[decided — partial]** ESP32 chosen; source spec truncated at §33 and Phase-2 mechanic still undefined. Read-only RFID auction-lot mystery; ESP32 ×8 easels + Ledger Desk; BrightSign clue videos.
- [The Reserve — Wine Cellar](https://immersive-events-7f76db.pages.dev/Halloween%202026/games/the-reserve/GAME-INFO.md) — **[decided]** spec authoritative; RFID hardware direction set (SPI, PN532/PN5180 A/B pending bench); feedback + answer content open. 8 independent barrel wine-mysteries; three interchangeable firmware types (A/B/C).
- [The Séance — Drawing Room](https://immersive-events-7f76db.pages.dev/Halloween%202026/games/the-seance/GAME-INFO.md) — **[proposed]** one-paragraph brief only; full spec pending. Two séance tables, 6 buttons/seat, candle-based chances.
- [The Final Examination — Laboratory](https://immersive-events-7f76db.pages.dev/Halloween%202026/games/the-final-examination/GAME-INFO.md) — **[proposed]** one-paragraph brief only; full spec pending. Specimen diagnostic/reanimation stations with magnetic probes.

Supporting docs for the active show:
- [Show computer & network overview](https://immersive-events-7f76db.pages.dev/Halloween%202026/show-computer.html): the Raspberry Pi show controller, Art-Net/DMX lighting, ESP-NOW/RS-485 transport.
- [Questions for Brett (A&L)](https://immersive-events-7f76db.pages.dev/Halloween%202026/QUESTIONS-FOR-BRETT.md): open design/content decisions only the A&L designer can answer.

## Platform / engineering standards

- [Unified Show Platform Specification v0.2](https://immersive-events-7f76db.pages.dev/platform/unified-show-platform-spec-v0.2.md): engineering constitution — hardware patterns, device identity, semantic show vocabulary, transport independence (ESP-NOW/RS-485), config model, safety boundary. Every game conforms to this.
- [BrightSign HD223 hardware reference](https://immersive-events-7f76db.pages.dev/platform/hardware/brightsign-hd223.md): video/audio outputs used by The Reserve.
- ESP-NOW RF commissioning walk-test tool (spec §9): `platform/tools/rf-commissioning/` — **[decided — tool built, field test pending]**.

## Other shows (context / prior work)

- [Blackwood Manor 2025 — paper/puzzle Halloween games](https://immersive-events-7f76db.pages.dev/Blackwood%20Manor%20Games/index.html): the prior (non-electronic) Halloween event; inspiration only.
- [Christmas 2025](https://immersive-events-7f76db.pages.dev/Christmas/index.html): all-ages holiday event.
- [Murder Mystery research](https://immersive-events-7f76db.pages.dev/Murder%20Mystery/index.html): concept/research phase.

## Authority model (what to trust)

- **Authoritative working spec** = each game's `GAME-INFO.md` + the unified platform
  spec. Start there.
- **Historical / seed context** = original A&L / Brett source docs under each game's
  `design/brett-source/` (posterity — not the working spec).
- **Working decisions / adaptations** = each game's `design/td-canonical/`.