Inspiration

From the very beginning, I knew I wanted to build something centered around the ocean and maritime physics. Mooring a 50,000–100,000 ton container ship is one of the most unforgiving maneuvers at sea: captains face massive 50–100 meter blind spots from the aft bridge, zero brake pedals, and immense hydrodynamic momentum where contact speeds must remain under 5–10 cm/s to avoid crushing pier structures.

When looking at the competition categories, I initially envisioned TomeXR for the Productivity track—functioning as a practical "360° tactical parking assistant" and rehearsal tool for ship captains and navigators. However, during planning I realized that a pure professional mooring utility would be far too niche for a general audience, so I pivoted the concept into the Gaming track: a seated tabletop tactical strategy and physics puzzle where anyone can test their spatial intuition against wind, currents, and 100,000 tons of momentum using only their bare hands.

What it does

TomeXR places a 3D harbor diorama directly in front of the player, turning container ship mooring into a hands-first spatial puzzle. Players progress through three tactical scenarios—Calm Water, 15-kt Offshore Crosswind (with a bow tugboat), and 25-kt Storm & Tidal Current (with dual bow and stern tugboats)—guiding the vessel into the green berth at a safe contact speed under 5 cm/s.

How I built it

TomeXR was built from scratch in TypeScript using the Meta Immersive Web SDK (@iwsdk/core v1.1.0-rc.2), Three.js, UIKitML, and Vite:

  • Hydrodynamic Physics Engine: Custom 2D planar physics simulating cargo vessel mass, linear and angular momentum, lateral hull drag, and realistic wind and tidal current forces.
  • 30-Second Predictive Drift Trajectory: A live forward projection arc that calculates vessel drift and rotation ahead of time based on active forces.
  • Hands-First Tugboat Tethering & Controls: Built for controller-free play (Pinch & Drag to position the hull and tugboats, Pinch & Rotate on the 3D weather compass dial, and Finger Poke on physical console buttons). Stretching a tugboat's towline applies calibrated thrust vectors and rotational torque to the vessel's hull stations, backed by built-in clearance algorithms to prevent hull clipping and a Tracking Guard to filter out occlusion jitter.
  • Laser Fender Guides & Zero-Text Onboarding: Pier fenders cast dynamic laser guide lines to the vessel hull, calculating approach velocity and switching to color-coded impact feedback (Green < 5 cm/s for safe mooring, Yellow for caution, Red for critical impact) across three progressive scenarios (Calm Water, 15-kt Crosswind, and 25-kt Storm & Current).
  • ECS Architecture & Competition Alignment: Built on a strict Entity-Component-System (ECS) pattern with clean separation across entities, systems, and constant catalogs, maintaining zero-allocation update loops for a stable 72+ FPS in WebXR. Engineered to pass the Airplane Seat Test (60 cm seated radius), the One Bus Stop Test (instant WebXR launch, 2–5 minute sessions), and the Take It Away Test (100% original simulation logic with zero third-party wrappers).

Challenges I ran into

  1. Hands-First Physics without Controllers: Translating the heavy maritime inertia of a 100,000-ton vessel into bare-hand gestures without physical haptics required careful tuning of force-scaling and input smoothing. I built a TrackingGuard layer to filter camera occlusions and hand jitter when hands cross in front of headset sensors, ensuring the ship and tugboats never feel floaty or jump abruptly.
  2. WebXR Desktop & Headset Parity: Supporting both live Meta Quest headsets and desktop IWER emulator testing required deterministic input bridging and robust interaction layers (PokeInteractable, OneHandGrabbable, and DistanceGrabbable).

Accomplishments that I'm proud of

  • Building a deterministic 2D planar hydrodynamics engine and 30-second forward trajectory predictor from scratch that runs at a locked 60–72+ FPS in WebXR.
  • Designing a 100% zero-text visual onboarding loop where laser fender clearance lines and drift arcs teach complex mooring physics within the first minute.

What I learned

I gained hands-on experience structuring a real-time spatial simulation with the Meta Immersive Web SDK (@iwsdk/core), bridging WebXR hand-tracking inputs with custom vector physics, and designing ergonomic seated tabletop UI within a strict 60 cm reach cone.

What's next for TomeXR

  • Expand the tactical scenario library with new harbor layouts, narrow locks, variable water depths, and moving vessel traffic.
  • Add optional Mixed Reality (MR) passthrough table anchoring for physical desk surfaces.

Built With

  • hand-tracking
  • hands-first
  • iwsdk
  • maritime
  • meta-quest
  • meta-quest-3
  • meta-quest-3s
  • meta-quest-pro
  • physics-simulation
  • three.js
  • typescript
  • uikitml
  • vercel
  • vite
  • webxr
Share this project:

Updates

Submission history