52 lines
2.2 KiB
Markdown
52 lines
2.2 KiB
Markdown
# HIDDEN SPECTRE 👻
|
|
|
|
An augmented-reality ghost-hunting web app — an homage to the LEGO® Hidden Side™ app, focused purely on the AR mechanics: ghosts roam your real-world space and you trap them with an aiming reticle.
|
|
|
|
> Not affiliated with or endorsed by the LEGO Group. A fan-made tribute to the AR play concept.
|
|
|
|
## What it does
|
|
|
|
- **World-tracked AR** via WebXR (`immersive-ar`) on supported devices (Android Chrome, etc.).
|
|
- **Graceful fallback** to a live camera feed + device-gyro look-around on devices without WebXR AR (e.g. most iOS Safari) — so it still works as a "point and turn" experience.
|
|
- **Roaming ghosts** rendered as procedural glowing wisps in Three.js that drift, bob, and eventually flee.
|
|
- **Trap tool**: aim the reticle at a ghost and *hold* the trap button to charge a capture. Fill the meter before it escapes.
|
|
- HUD with live score, nearby count, off-screen direction hints, capture flash + haptics.
|
|
|
|
## How to play
|
|
|
|
1. Open on a phone over **HTTPS** (camera/WebXR require a secure context).
|
|
2. Tap **Begin the Hunt** and grant camera + motion permissions.
|
|
3. Pan slowly to map the area, then turn your body to find ghosts.
|
|
4. Center a ghost in the reticle, **hold the trap button** until the green ring fills.
|
|
|
|
## Tech
|
|
|
|
- [Three.js](https://threejs.org/) (ES module via CDN import map)
|
|
- WebXR Device API with camera + `DeviceOrientation` fallback
|
|
- Vanilla JS, no build step — static files only
|
|
|
|
## Files
|
|
|
|
```
|
|
index.html markup + screens
|
|
css/style.css neon supernatural styling
|
|
js/ar-engine.js WebXR / camera+gyro abstraction
|
|
js/ghost.js procedural ghost mesh + behaviour
|
|
js/main.js game loop, aiming, trapping, scoring
|
|
```
|
|
|
|
## Running locally
|
|
|
|
Any static server over HTTPS works. For quick local testing:
|
|
|
|
```bash
|
|
npx serve .
|
|
# then open the https URL on your phone (use a tunnel like ngrok/cloudflared for device testing)
|
|
```
|
|
|
|
## Notes & limitations
|
|
|
|
- iOS Safari does not support `immersive-ar`; it uses the camera+gyro fallback (look-around only, ghosts are world-locked relative to your starting orientation).
|
|
- Motion permission on iOS must be triggered by a user gesture — handled on the Begin button tap.
|
|
- Lighting and a steady camera improve the illusion, same as the original.
|