nodegame / nodegame-server

nodeGame server for the browser and node.js

nodeGame

Fast, scalable JavaScript for large-scale, online, multiplayer, real-time games and experiments.

---

The Good parts

• Open source and open standard (HTML5)
• Modular framework (server / client / window / widgets / games)
• Low / medium level of programming required
• Powerful API
• Integrated NDDB Javascript database
• Server can run multiple games at the same time
• Powerful and customizible waiting rooms
• Monitor interface
• Works on mobile devices and tablets
• Bots (for playing) and Phantoms (for testing)
• Installation is required only for the server, clients just need their browser windows
• Integrates smoothly with other libraries (e.g. jQuery, D3.js, etc.) and web services, such as Amazon Mechanical Turk

Quick Start

nodeGame comes with a default game taken from the academic literature of game theory. It is called the Ultimatum game. To play it follows the steps:

1. Download the latest version of node.js for your platform
2. Download the latest version of git for your platform
3. Download installer, and install nodegame: node nodegame-installer
4. Enter installation directory.
5. Start the server with the command: node launcher.js
6. Open one tab pointing to localhost:8080
7. Select Ultimatum game
8. Open more tabs, or start a bot through the waiting room interface
9. Check the monitor interface at localhost:8080/ultimatum/monitor

Documentation

Complete documentation is available in the nodeGame wiki.

License

MIT

nodegame-server's Issues

Demo branch is using reserved word abstract

See:
https://www.w3schools.com/js/js_reserved.asp

Please rename to "publication" also in the games.

Meritocracy fails to load CHOSEN_TREATMENT

This is a bug introduced in 4.3.0.
TODO: Fix routine creating WaitingRoom.availableTreatments.

dispatchWithBots should not change global settings

As it does in this line:

nodegame-server/lib/rooms/WaitingRoom.js

Line 400 in 5c07ec3

this.PING_BEFORE_DISPATCH = false;

Moreover, assuming, for example, that you have 5 real players in the waiting room, and you want to add 5 bots to start the game, you probably want to PING the real five anyway, right? But not the bots.

Think about how to implement this, and we can discuss it in tomorrow meeting.

game.settings variables can only be referenced by an active treatment in views

Values and variables defined in game.settings.js can only be referenced by an active treatment (in the views):

var newVariable = settings.treatmentName.variable;

Since it is sometimes necessary to deactivate certain treatments, it would be preferable if it were possible to reference them directly without being tied to a specific treatment.

Easy way to parse query string parameter by game or game room

At the moment, you can do it only with auth enabled or by directly accessing channel.playerServer.clientObjDecorator

There is no clear way of setting the treatment via queryString parameter, or overwriting a setting. This could be automatized.

When there are levels, bot is connected from game folder, rather than levels

Update documentation for room parameters

• roomOwnDataDir: true
• roomCounter: 100,
• roomCounterChars: 6

Also add defaults in channel.settings in game template.

PhantomJS Bot crashes the server

When I click on Start Bot in the monitor interface the server crashes with the following error:

error: ServerNode caught an exception: Error: spawn ENOENT

/var/www/ngtest/node_modules/nodegame-server/lib/ServerNode.js:236
throw err;
^
Error: spawn ENOENT
at errnoException (child_process.js:980:11)
at Process.ChildProcess._handle.onexit (child_process.js:771:34)