Case study

AMMA

Most guidance breaks the moment you do. Miss a step and the instructions march on without you. AMMA adapts the interface to the person, switching between HUD, object highlighting, and speech from a live user model. I built the multimodal pipeline and the engine bridge that made it run inside a commercial VR game.

Type
Research software · Adaptive XR guidance
Role
Research Developer · 3rd author · Stanford CURIS
Contribution
  • Built the adaptive multimodal pipeline, HUD and highlight logic, Azure TTS and language parsing
  • Built the research instrumentation, logging and study CLI
  • Co-developed the C# BepInEx engine bridge
  • Third author on the IEEE VR 2024 paper
Tools
Unity · C# · BepInEx · Python · Azure Speech · TCP sockets
Timeline
Stanford HCI / CURIS · Summer 2022
Team
Led by Jackie Yang · 7 authors · adv. Monica Lam & James Landay
Published
IEEE VR 2024 (full paper, pp. 892–902)
Adaptive UIMultimodalVRSystemsHuman factors
AMMA
Built
Adaptive multimodal pipeline (HUD · highlighting · Azure TTS) + a C#/BepInEx bridge relaying a commercial VR game to a Python state tracker over TCP
Study
13 participants (12 valid) · high-fidelity VR cooking simulator · task time + manual modality switches + NASA-TLX
Result
~22% faster task completion (p<.001) · task load statistically unchanged (NASA-TLX p=.243) · personalization gain p<.001
Problem

Guidance that breaks the moment you do

Step-by-step instructions assume a perfect user: right order, no mistakes, one way of understanding. Real people burn the salmon, work out of sequence, and read a HUD where someone else needs to hear the step. When guidance can’t adapt, it stops being help and starts being noise.

3ways to deliver a step (HUD, highlight, speech) that should depend on the moment
1rigid script is all most guidance systems actually offer
0recovery paths when a user makes an irreversible mistake

The research question: how does guidance move past a fixed script to adapt to mistakes, differing physical abilities, and individual communication preferences, in real time?

Approach

Adapt the interface, not just the instruction

AMMA generates the interface from a step list by tracking what the user has actually done and learning a personal model of how they work, then choosing which modality to fire and when. The hard part was making it run inside a real VR task, where the system watches every grab, pour, and seasoning and reacts before the moment passes.

Process & artifacts

Building the adaptive layer

I owned the layer that turns a tracked state into the right cue at the right time, and the bridge that let research logic drive a closed commercial game.

How the pieces work together, and which were mine
● Built by me◐ Co-developed○ Team
Activity Specificationaction and step specs · tasks · feedback UIs · user model templatefeeds tracking and planning
Commercial game
Cooking Simulator VRa closed commercial game
Engine bridge
C#/BepInEx pluginbi-directional TCP relay
Tracking
State TrackerPython
Research instrumentationreplay logging · study CLI
Planning
Guidance Planneruser model · simulator · policy
Multimodal guidance
HUD · highlight · speechAzure TTS with contextual interrupts
guidance fires → the user acts in the game → the bridge relays it → the tracker updates
view the paper's original architecture figure
redrawn from the IEEE VR 2024 paper's architecture figure, ownership reflects my role on the project
Component details
ComponentDetail
C#/BepInEx pluginInjects research logic into the closed game, relaying every grab, pour, and seasoning to the Python side with minimal latency.
Research instrumentationPickle-based logging for perfect post-study replay, plus a study CLI to start and stop sessions, reset positions, and manage continuous speech recognition.
HUD · highlight · speechThe logic that switches between a HUD, 3D object highlighting, and speech, deciding by task type and the user's learned preference, prioritizing time-critical cues like Flip or Stop so instructions never stack. The speech pipeline parses raw recipe data (0/300mg) into natural speech (300 milligrams) to hold immersion.
Impact

Faster, lighter, and tuned to the person

22%faster task completion vs the baseline guidance system380.2s vs 487.6s, p<.001, n=12 valid
NASA-TLXTask load statistically unchanged, medians 13.5 vs 11.5 (p = .243). Users got faster without a measurable increase in cognitive load
p<.001Personalization measurably improved as the user model converged on each participant
IEEE VR 2024Published as a full conference paper (pp. 892–902), I am third author
Evaluation results: NASA-TLX, task completion time, and personalization effectiveness
Task time dropped ~22% with AMMA (p<.001). NASA-TLX task load was statistically unchanged (medians 13.5 vs 11.5, p = .243). The user model's error shrank significantly after personalization.
My role

I joined AMMA as a Stanford CURIS undergraduate researcher in Summer 2022 and am third author on the IEEE VR 2024 paper. I built the adaptive multimodal pipeline (HUD/highlight logic, the Azure TTS pipeline, and the language parsing) and the research instrumentation (logging + study CLI), and co-developed the C#/BepInEx engine bridge. The state tracker and the study design were team work, led by Jackie (Junrui) Yang and advised by Monica S. Lam and James A. Landay.

Reflections & takeaways

The lesson that stuck wasn’t about adaptivity. It was about restraint. The fastest way to overwhelm someone in VR is to give them more guidance, so the real engineering was deciding what not to surface: suppressing redundant cues, interrupting cleanly when a time-critical step arrived, and keeping speech natural enough that it didn’t break immersion. And making research logic drive a closed commercial game (C# to Python over a socket, hooking low-level events in real time) taught me that the unglamorous bridge is often what decides whether an idea can be studied at all.

Jackie (Junrui) Yang, Leping Qiu, Emmanuel Angel Corona-Moreno, Louisa Shi, Hung Bui, Monica S. Lam, and James A. Landay. 2024. “AMMA: Adaptive Multimodal Assistants Through Automated State Tracking and User Model-Directed Guidance Planning.” In 2024 IEEE Conference on Virtual Reality and 3D User Interfaces (VR), Orlando, FL, USA, pp. 892–902.