Frequently Asked Questions and Tutorials

This is done here. You can only see this page if you are logged in, and if you have the suitable permission.

To delete a session, go to parameter admin page of the session at SESSION_URL/admin/. At the bottom of the page there is a form to delete the session.

The portal of a session is the page from which the users can enter the session (via logging in for instance). The home is the page in which players see all the games that are on offer.

Users can either have a global account, or an account that is specific to a session. We call the latter restricted users. Users are restricted when a non-authenticated person creates a player profile from the portal of a session.

Restricted users can only access the content of the session to which they registered. Whenever they try to access a page outside of the session, a prompt will require them to log out first.

Guest players are users who joined the session without registering. These players cannot log in.

They are typically used for one-shot events in which there is no need to create accounts.

Every user can change their password by going to their account settings. This page is accessible via the side panel.

An admin of a session can also change the password of the players of the session. This is only possible for players who are restricted to the session. Use this functionality if a player has lost their password, for instance. The links to change the password of the players are located in the tables available at SESSION_URL/admin/players.

There are many admin pages for a session. The admin pages for the whole sessions can be found under:

• SESSION_URL/admin/ for the parameters of the session,
• SESSION_URL/admin/players for the players,
• SESSION_URL/admin/games for the games.

In addition, each game has its own set of admin pages:

• SESSION_URL/admin/game/GAME_URL_TAG for the settings of the game,
• SESSION_URL/admin/game/GAME_URL_TAG/teams for the teams of the game,
• SESSION_URL/admin/game/GAME_URL_TAG/answers for the answers of the game.

Links to these different admin pages can be found in the side-panel and at the top of each admin page.

To test the session and see how things look the easiest is to create a test player account. Login to that test account in a different browser (or an incognito page) and you will be able to see how things are presented. Note that as an admin, the display is quite different. If things are correctly displayed to admins it does not mean that they are correctly displayed to the players.

Note that most of the games implement random answer generation if you want to see how the result page of a game looks.

This probably means that you did not update the setting of the game so that the results are visible. This can be changed from the page SESSION_URL/admin/game/GAME_URL_TAG or by using one of the quick admin link at the top of page of a game.

Note that admins can always see the result page, regardless of the visibility status of the results.

Your result page indicates that there are no answers or some of the fields are not displayed properly (None, or wrong values)? You probably did not run the management commands. These are often necessary for the results to be displayed correctly.

Via registration. Once you have created the session, you can open the registration to allow the students to register for your session. Registration can be closed again after some time to avoid students creating more than one account (which would allow them to have additional influence in the games).

Via upload. You can also upload a CSV file with the account details to pre-create player profiles for your students. This is done under via form in the page: SESSION_URL/admin/players. You do not need to ever open the registration to your session. This ensures that all students have an account (and no more than one).

Opening and closing the registration is done by updating the session parameters on the page SESSION_URL/admin.

If you need more workforce, simply for running the management commands on time for instance, you can add admins to the session. Do so on the page: SESSION_URL/admin/players.

If a student has lost their password, the only way to get access to the account again is by changing their password directly. As a session admin, you can do that in the SESSION_URL/admin/players page. Not that this is only possible if the student is session-restricted.

To add a new student after you have closed the registrations. You can use the form available on the SESSION_URL/admin/players page. Set up a default password and ask the student to immediately change their password after their first login.

To reduce the overhead, consider disabling the display of the registration and logging in forms in the session portal. To do so, update the session parameters on the page SESSION_URL/admin.

If you are only using a single game in your session, save one click by setting up a direct redirect to a game after login. This skips the session home. To do so, update the parameters of the session on the page SESSION_URL/admin.

If you want the players to have direct feedback after submitting an answer, you can select the result page to be the page after submit of a game. To do so, update the settings of the game on the page SESSION_URL/admin/game/GAME_URL_TAG.

Consider running the management commands automatically as well. That is necessary for the games that need them to display the result page properly. This is also done by updating the settings of the game on the page SESSION_URL/admin/game/GAME_URL_TAG. This can incur delay in the response, especially as the number of players increases.

The following settings can be adapted in the definition of the Numbers Game.

• Lower and Upper bounds: The minimum and maximum values that can be submitted. The values are 0 and 100 by default.
• Factor: The multiplier applied to the average submitted number when determining the winning answers. The winning answers are the answers that are the closest to the average submitted number multiplied by this factor. The default value is 2/3.

The following settings can be adapted in the definition of the Iterated Prisoner's Dilemma Tournament.

• The Payoff Matrix: Each entry of the payoff matrix is customisable. The default is as displayed above.
• The Number of Rounds: The number of times the game is iterated. Several numbers can be specified. In that case, each answer will play against every other answer for all specified number of rounds.

The following settings can be adapted in the definition of the Centipede Game.

• The payoffs: All payoffs in the picture above can be modified. The default is as above.

The following settings can be adapted in the definition of the Auction Game.

• Number of auctions: The number of auctions run. The default value is 5.
• Valuation sampler: The method used to sample the valuation of the players. It can be constant, uniform or binomial.

The following settings can be adapted in the definition of the Good or Bad Game.

• Questions: The set of question that is available in the game. These questions can be either COMSOC riddle or logos. COMSOC riddles are short questions about the field of computational social choice. Logo questions are image-based and the user is asked to retrieve the correct logo for a company.
• Number of displayed questions: With this parameter, you can set how many questions do the players have to provide an answer for. The questions will be selected uniformly at random from the ser of available questions.