To run an experimental session, run the following command from the
The data from the session will be saved in the folder:
<session_id> is a UUID.
This folder will contain the following files:
metadata.json: A JSON file containing metadata about the session.
Folders corresponding to the missions run in the session, of the form
Nis some identifier (e.g.
mission_Nwill have the following files:
webcam_video.mpg: A video recording of the player’s face taken using the built-in webcam.
screen_video.mpg: A video recording of the Minecraft playthrough (i.e. what the player sees on their screen)
player_audio.wav: A WAV file containing the audio recording of the player.
system_audio.wav: A WAV file containing a recording of the sound output produced by the computer. This will not be produced on macOS computers running macOS Mojave or older.
malmo_data.txt: A file containing timestamped observations of the player’s state (position, velocity, health, pitch, yaw, etc.)
events.txt: A file containing timestamped discrete event data such as players interacting with doors, buttons, and levers, or attacking monsters.
chat.txt: A file containing timestamped chat event data. Can be empty if there were no chats sent.
self_reports.txt: A JSON file with self-report survey responses. Can be empty if the player exits the game before answering the self-report questions.
The format for the event and observation data can be found here.
To interrupt the game and quit at any time, press the
Esc key, then click on
the terminal window where you ran the
run_session.sh script, and then
interrupt the process with
Ctrl+C. You can also quit the game by closing the