Tutorial: Running a Session

Running a Session

This tutorial shows how to start and run a session. A session consists of a series of apps. We will use an implementation of the public goods game app described in Box 1 that comes included with jtree. The tutorial that follows this one will show you how to actually build the corresponding app.

Box 1 - Description of the simple public goods game.

#########
A group of players is given an endowment from which they may contribute a certain amount to the creation of a public good. The total amount produced of the public good is the sum of player contributions multiplied by a production factor. The public good is then divided equally among all players in the group. The payoff to each player is their endowment, minus their contribution, plus their share of the public good.

#########

Follow these steps to run a session:

  1. Click "Open App...".
  2. Find the "public-goods" app. Click the blue play button. jtree opens a new "Session" with this App.
  3. Start the session: Click the "Start" button.

The session is now running.

The "Participants" tab contains a table of the participants in the session, including data for each player's current period and individual links to open each participant in a new browser tab.

The "Monitor" tab lets you supervise / test multiple participants at the same time. "Show All" opens a preview window for each participant. "Start autoplay" starts all players playing automatically.

Once all participants have finished playing an app, output for that app is written to the session output file. This is a regular text file that can be downloaded by clicking "Download output". The last few lines of this file are a list of all session participants and how many points they earned.