/MAE106_Ogar

A custom version of Ogar (For Research!)

Primary LanguageJavaScriptOtherNOASSERTION

Ogar3

An open source Agar.io server implementation, written in Node.js.

Original Authors

Please find his project here: https://github.com/Faris90/Ogar3.
This project is largely based on his code, so big thanks to him!

Additionally, I used the Admin Console from the following project:
https://github.com/ArixProject/MultiOgar-Edited-Unlimited

THIS IS STILL IN PROGRESS

Project Status

Here are the features previously implemented:

  • Game server basic implementation (clients can connect)
  • Single-cell movement
  • Randomly generated cells and viruses
  • Ejecting mass
  • Splitting
  • Multi-cell player movement
  • Cells eating other cells
  • Leaderboard

Here are the features that I added/plan to add:

  • Spectate mode
  • Admin Commands
  • Server Logging
  • Chat Filter for Profanity
  • IP Ban
  • Kick Players via Command Line
  • Seperate Queue Page with Redirect to Game

How to access server

Go to localhost if you set the port to 80 go to localhost:80 Demo: Click here for demo

Obtaining and Using

If you are on Windows, Ogar3 no longer requires an installation of node.js to run. Simply launch the batch file that is included to run the server. This is a beta feature, and if there are any problems, switch back to using Ogar3 with node.js. The rest of this section is for non Windows users.

Server tracker

Server Tracker(does not work yet)

Info

As Ogar3 is written in Node.js, you must have Node.js and its "ws" module installed to use it (Unless you are on Windows). You can usually download Node using your distribution's package manager (for *nix-like systems), or from the Node website. To install the "ws" module that is required, open up your system command line (cmd for windows, terminal for mac) and type "npm install ws".

Although Ogar3 allows you to run both the Agar.io master server and game server separately, it's currently recommended that you run both servers together until the master server is more implemented. Alternatively, you could run the game server only, and use a client-side mod to connect to the IP address of the server.

~$ git clone git:github.com/ajz123/MAE106_Ogar.git Ogar 
~$ npm install ./Ogar 	
~$ npm start 

Currently, Ogar3 listens on this port(for now):

  • *:80 - for the game server

Please note that on some systems, you may have to run the process as root or otherwise elevate your privileges to allow the process to listen on the needed ports.

Configuring Ogar3

Use gameserver.ini in src to modify Ogar3's configurations field.