VR Charades

Setting Up a Charades Session

1. Configure Player IPs
   • Enter the IP addresses of Player 1 and Player 2 VR headsets
   • These should match the IPs you used in the control.py commands
   • Note: The default placeholders are examples - use your actual headset IPs
2. Prepare Word List
   • Copy your word list from word-list.txt and paste it into the large text area
   • Click the "Shuffle" button to randomize the word order
   • Click the "Modify" button to generate interactive word items
3. Set Game Parameters
   • Current Player For Acting: Select which player will be acting out the words
   • Time (s): Set the time limit for each word (e.g., 30 seconds)
   • Last Word Status: Set to "None" for the first word

Running the Experiment

Manual Mode (Individual Words)

1. Enter a word in the "Word" field
2. Select the acting player (Player 1 or Player 2)
3. Set the time limit
4. Click "Send" to transmit the word to the VR headsets

Automatic Mode (Word List)

1. After clicking "Modify" with your word list, the interface shows all words with timers
2. The system automatically starts with the first word and counts down
3. During the session:
   • Mark words correct: Hover over a word and check the checkbox if guessed correctly
   • Visual indicators: ▶ = Current word, ✅ = Correct, ❌ = Time expired
4. Stop the session: Click "Stop" to end early

Exporting Results

1. After completing the word list, click "Save as CSV"
2. This downloads a CSV file with:
   • Word name
   • Whether it was guessed correctly (true/false)
   • Time remaining when completed

Troubleshooting

• If words don't appear in VR headsets, check that control.py commands were sent correctly
• If timer doesn't start, ensure you clicked "Modify" after entering the word list
• If players can't see each other, verify the MODE commands were sent with correct parameters
• If shuffle doesn't work, make sure the word list isn't currently running (click "Stop" first)