World Engine
Approved environment presets supply the sky shader, directional sun vector, fog curve, reflection lightformers, and bounded 50m × 50m terrain around the showroom. Natural perimeter dunes conceal the 41m invisible courtyard boundary without artificial fences.
- MVP Preset
- DESERT-001 (Desert Glass)
- Phase 2/3 Presets
- OCEAN-001, FOREST-001, ALPINE-001, SKY-001, URBAN-001
- Plot Dimensions
- 50m × 50m (41m walkable courtyard)
Modular Store Engine
Reconstructs a fixed-footprint 14m × 24m × 4m architectural pavilion at the world origin (Y = 0, entrance facing +Z). Blue-tinted structural glass bays, carved limestone reliefs, and the illuminated orange squircle portal load from validated module IDs.
- Showroom Footprint
- 14m W × 24m D × 4m H (ADR 0005)
- Entrance Portal
- 3m × 3m Facing +Z (ARCH-PORTAL-001)
- Collision Model
- Circle-vs-AABB Sliding Proxies (No Physics Engine)
Interior & Asset Pipeline
Materials, lighting presets, pedestals, counters, and decorative sculptures are placed by validated SceneConfig coordinates. Every 3D asset is compressed with Meshopt and KTX2 UASTC textures and verified against aisle-clearance and overlap gates.
- Geometry & Texture
- Meshopt + KTX2 BasisU (≤1K Normal/Roughness)
- Validation Gate
- Zod validateScene (bounds, overlap, 1.2m aisle)
- Provenance Rule
- Mandatory asset_licenses approval row
Multi-Tenant Commerce & RLS
Products, variants, integer minor-unit prices across 6 currencies, guest carts, authenticated checkout, and idempotent payment webhooks run on PostgreSQL with strict tenant_id Row-Level Security.
- Supported Currencies
- MYR, SGD, USD, EUR, GBP, AUD
- Payment Adapter
- PaymentProvider Interface (Demo + ToyyibPay)
- Tenant Isolation
- virtuo_app RLS enforced + cross-tenant test suite
View the configuration
One Engine. Infinite Spatial Configurations.
VIRTUO never hardcodes a single brand into the WebGL renderer. Select an environment preset, a merchandise display system, and an operating mode below to see how SceneConfig reassembles the experience on the fly.
World Environment Preset
DESERT-001Controls sky shader, horizon terrain, directional sun vector, fog density, and courtyard boundary.
Merchandise Display System
FURN-PEDESTAL-001Swaps interior display anchors, GLB compression targets, and inspection camera distance.
Spatial Operating Mode
LIVE IN MVPReconfigures the interaction layer between retail shopping, guided press exhibitions, and a live AI agent company floor.
Fragrance & Cosmology · Display Slot Telemetry
Meshopt + KTX2 UASTC · ≤1K PBR Normal/RoughnessSculptural flacons, stoppers, and relief medallions rendered as real 3D GLB objects on individual lit plinths. Prices, olfactory notes, and stock resolve live from PostgreSQL.
Live Validated SceneConfig Contract
src/schemas/scene.ts · Zod Validated{
"schemaVersion": 1,
"store": {
"id": "store-desert-fragrance",
"slug": "auren",
"templateId": "GLASS-PORTAL-001",
"operatingMode": "retail-storefront"
},
"world": {
"presetId": "DESERT-001",
"version": 1,
"bounds": "50m × 50m (41m walkable courtyard)",
"sun": "[18.0, 9.0, -24.0]"
},
"interior": {
"categoryModule": "fragrance",
"displayFixture": "FURN-PEDESTAL-001",
"lightingPreset": "luxury-warm"
},
"runtime": {
"navigation": "first-person-kinematic (2.2 m/s, 0.4m radius)",
"interaction": "product-raycast (3.5m range) + server-cart",
"telemetry": "postgres-rls + verified-payment-webhooks"
}
}Four-Layer Spatial Architecture
The world is replaceable; the store is reusable; products and commerce data remain independent. Each layer has a strict boundary enforced by TypeScript and PostgreSQL Row-Level Security.
Core 3D Engine
src/engine/core · src/engine/navigation
Three.js and React Three Fiber v9 rendering, 1.65m eye-level camera, pointer-lock and mobile touch controls, circle-vs-box sliding collision, 41m courtyard boundary, centre-ray focus.
Never owns: Store names, brand copy, hardcoded product prices, or heavy physics engines.
Store Configuration
src/schemas/scene.ts · src/content/stores/*.json
Zod-validated SceneConfig defining world preset ID, architectural template, interior material presets, furniture coordinates, and product display slots.
Never owns: Imperative Three.js rendering logic or unvalidated client-supplied footprints.
Ecommerce & Merchant Platform
src/commerce · src/checkout · src/payments · src/merchant
Multi-currency integer minor-unit pricing (MYR, SGD, USD, EUR, GBP, AUD), guest-to-account cart merge, PaymentProvider webhook verification, and merchant admin.
Never owns: Client-calculated order totals, redirect-based payment marking, or cross-tenant leaks.
Controlled 3D Asset Library
src/engine/assets · public/assets
Meshopt and KTX2 compressed GLB product models, modular limestone and portal architecture bays, collision footprints, and verified asset licence provenance.
Never owns: Unlicensed 3D downloads or commerce text baked into textures.
