No description or website provided.
Switch branches/tags
Nothing to show
Clone or download
Latest commit 8d2460a Jun 24, 2017
Failed to load latest commit information.
assets no message Apr 28, 2017
worlds no message Aug 28, 2016
.gitignore no message May 5, 2016
LICENSE updated readme Nov 11, 2014
NodeConf.js no message Mar 21, 2016
NodeRect.js no message Aug 28, 2016 no message Jun 24, 2017
VoxConf.js updated readme, used bootstrap and added cors Sep 19, 2014
VoxRect.js no message Apr 28, 2017
package.json no message Apr 28, 2017


This project aims to develop a game with voxel-based graphics and a gameplay similar to capture the flag.


Since this game is purely multiplayer based, it is required to join a server. You can therefore simply navigate to in order to find a list of active servers. It is also possible to setup a new server, what is further described below.



Make sure to have node and npm installed. Otherwise, navigate to in order to download the latest binaries.

A prebuilt version of the server is being provided and can be downloaded accordingly. After unpacking it, go ahead and navigate to the root folder of the archive. Before node is being used to start the server, the dependencies can then be installed by calling npm within a console.

npm install
node VoxRect.js

several preferences of the game can furthermore be changed within VoxConf.js. To change the port on which the server is listening, open NodeConf.js and change the following line appropriately.

NodeConf.intExpressPort = 15897;

To keep the server up and running, using forever is recommended. It can globally be installed through npm within a console and can then simply be utilized to start the server and keep it running. It is therefore no longer necessary to call node directly.

npm install forever -g
forever VoxRect.js


Make sure to be able to start a server as described in the previous section. Since there is no actual compilation step, this is also everything that is required in order to develop the server.

In order to apply changes to the client and the editor, the code has to be combined with browserify and uglifyify however. These packages can globally be installed through npm within a console.

npm install browserify -g
npm install uglifyify -g

After browserify and uglifyify are available, the batch files can be used in order to perform the required combination.


In order to gain a quick overview of the architecture, the following diagram can be consulted. Since it is only a sketch, it does not follow a specific format.


NoteRect.js is a basic library that is also being used in other projects. It is therefore quite generic and developers can probably just ignore it.

VoxRect.js is the webserver that handles all the communication between the clients. In order to appear in the list of active servers, it furthermore frequently reports to the master server.

index.debug.js is the client, which is being delivered when accessing the server. The connection to the server is continually kept alive, in order to keep the state of the game up to date.

editor.debug.js is a very basic editor, which is being used to create the maps. It is necessary to access this component via the server since the images are otherwise linked incorrectly.


Since the project consists of several components and each component has individual dependencies, they are being listed separately.


  • node / npm
  • schemapack
  • express


  • node / npm
  • schemapack
  • voxel-engine / voxel-highlight / minecraft-skin
  • browserify / uglify-js
  • jquery / moment
  • bootstrap


  • node / npm
  • schemapack
  • voxel-engine / voxel-highlight / minecraft-skin
  • browserify / uglify-js
  • jquery / moment
  • bootstrap


  • gpp



Please refer to the appropriate file within this repository.