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 www.voxel-warriors.com 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
npm installed. otherwise navigate to nodejs.org 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.
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
npm install forever -g
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 of the client and the editor, the code has to be combined with
uglifyify however. these packages can globally be installed through
npm within a console.
npm install browserify -g
npm install uglifyify -g
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.
please refer to the appropriate file within this repository.