Parameterize reference games as experiment 'plug-in'

[hawkrobe]

e.g. to work with something like Dallinger, factoring out templates and shared code such that a full experiment could be specified in a fairly short file exporting a fairly small set of functions.

To specify a particular ref game, you'd need to have a config.json and separately export the following functions:

config options

{
  email: ...,
  projectName: ...,
  experimentName: ...,
  iterationName: ...,
  anonymizeCSV: ...,
  dataStore: ...,
  bonusAmt: ...,
  playersThreshold: ...,
  playerRoleNames: ...,
  swapRoles: ...,
  numHorizontalCells: ...,
  numVerticalCells: ...,
  cellDimensions: ...,
  feedbackDelay: ..., 
  autoEnd: ...
}

game.core.js

• trialList: the sequence of stimuli/metadata passed to participants on each round
• newRound: called to terminate the current round and begin the next
• communicationModality: unrestricted chat-box, sketchpad, word-list
  • each with own config options or ability to pass in html w/ callbacks?
• stimulusDisplay: how to show stimuli from trialList
  • e.g. grid, map; more generally a drawing function that takes an HTML5 canvas

game.server.js

• dataOutput: json of data to record upon different events (e.g. 'message', 'listenerClick')
• onMessage: collection of socket.io event-handlers for client messages