Skip to content

Latest commit

 

History

History
76 lines (59 loc) · 2.74 KB

README.md

File metadata and controls

76 lines (59 loc) · 2.74 KB

Git To The Hub

Technical:

  • Made with NodeJS and Socket.IO
  • The states of all the objects are all instantiated, updated, and managed server side. All calculations are done server side.
  • The client merely sends intents to the server, which are processed. The server returns a series of JSON objects that hold the state of the world to the client for rendering.
  • The server holds authoritative determination over the positions and states of all the objects.

Setting Up:

This project requires node version 0.12 or greater. npm, bower and gulp should be installed globally on your system.

npm install
bower install
gulp

Gulpfile

The project Gulpfile already has a few custom processes to run.

gulp            # will compile the JS and LESS assets and lint the JS files

gulp lint       # Will lint the JS assets for errors

gulp js         # will compile and lint the JS assets

gulp less       # will compile only the LESS assets

gulp watch      # will watch the JS and LESS assets and compile them when
                # they are modified

gulp watch-js   # will only watch the JS assets

gulp watch-less # will only watch the LESS assets

Start the server in dev mode using node server --dev to serve uncompiled JS files during development.

File Organization:

/extern contains external variable declarations that are needed by they Google Closure Compiler.

/lib contains the server side classes that manage the states of the games and lobbies.

/public contains all static assets, including LESS stylesheets, scripts, images, compiled assets, and external dependencies installed through bower.

/shared contains JavaScript modules with utilities that are needed on both the server and client side. (Util.js)

/views contains the HTML templates that are rendered to the client.

Contributing:

  • Fork this repository and set it up on your computer.
  • Commit to your own fork and send a pull request to the master repository.
  • The search-src script will help you search for TODOs in the source code. Run search-src todo to find things that need to be fixed or modified.
  • Note that only compiled sources are exposed on the server but are not committed to this repository. Do not commit compiled sources (/public/dist).
  • Your code will be reviewed and must be approved before it is merged.
  • Please use our convention of 2 space tabs that are space characters and not tab characters. Document any code that you write.
  • Please only commit working builds that do not compile with any errors.

Creators:

  • Alvin Lin (omgimanerd)
  • Kenneth Li (noobbyte)
  • Pranay Gupta (gpranay)
  • Katherine Shatinsky (kshatinsky)

© 2016 Penumbra Games