br-metaverse

The BlackRoad Metaverse Platform - Spatial Operating System Layer

Three-Layer Architecture

Universe (Physics)  →  Lucidia (Canonical World)  →  br-metaverse (You are here)

br-metaverse is the interface layer where:

• Developers build spatial experiences
• Users interact with Lucidia agents in 3D/2D
• Multiple art styles coexist (illustrated, pixel, Unity)
• Every app is a physical space you navigate

Quick Start

```bash npm install npm run dev ```

Visit: `http://localhost:5173`

Architecture

See ARCHITECTURE.md for full technical details.

Packages

• @br-metaverse/core - Main spatial engine
• @br-metaverse/illustrated - Anime-style renderer
• @br-metaverse/pixel - Retro pixel renderer
• @br-metaverse/sdk - Developer tools
• @br-metaverse/agent-bridge - Lucidia connection

Worlds

• terminal-street - Command center (default spawn)
• agent-park - Casual interaction space
• dev-office - Coding environments
• user-created - Community builds

Deployment

Domain: `metaverse.blackroad.io`

Infrastructure:

• WebGL app → Cloudflare Pages
• WebSocket gateway → K3s cluster
• NATS → Agent orchestrator
• Assets → Cloudflare R2

License

Proprietary - BlackRoad OS Inc.