gavryush/ogar

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

Ogar

A fully functional open source Agar.io server implementation, written in Node.js. Ogar is designed to be used with the latest Agar.io client (as of 6/13/15).

Obtaining and Using

If you are on Windows, Ogar 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 Ogar with node.js. The rest of this section is for non Windows users.

As Ogar 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".

~$ git clone git://github.com/vram4/Ogar.git Ogar
~$ npm install ./Ogar
~$ node Ogar

Currently, Ogar listens on the following addresses and ports:

• *:80 - for the master server
• *:443 - 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. If you are getting an EADDRINUSE error, it means that the port required to run Ogar is being used. Usuallly, Skpye is the culprit. To solve this, either close out skype, or change the serverPort value in gameserver.ini to a different port. You will have to change your connection ip to 127.0.0.1:PORT

Once the server is running, you can connect (locally) by typing "agar.io?127.0.0.1:443" into your browser's address bar. No client side mods are needed to connect.

Configuring Ogar

Use "gameserver.ini" to modify Ogar's configurations field. Playerbots are currently basic and for testing purposes. To use them, change "serverBots" to a value higher than zero in the configuration file. To add/remove bot names, edit the file named "botnames.txt" which is in the same folder as "gameserver.ini". Names should be separated by using the enter key.

Custom Game modes

Ogar has support for custom game modes. To switch between game modes, change the value of "serverGamemode" in the configurations file to the selected game mode id and restart the server. The current supported game modes are:

Id	Name
0	Free For All
1	Teams
2	Experimental (As of 6/13/15)
10	Tournament
11	Hunger Games
20	Rainbow FFA - Hint: Use with "setAcid(true)"

Console Commands

The current available console commands are listed here. Command names are not case sensitive, but player names are. Note: To affect unnamed players, add 2 spaces after the command and then add any other parameters the command requires. Ex. (Treat the underscores as spaces) "mass__200", "kill__", or "color__0 0 250"

• Addbot [Number]
  • Adds [Number] of bots to the server. If an amount is not specified, 1 bot will be added.
• Board [String 1] [String 2] [String 3] ...
  • Replaces the text on the leaderboard with the string text.
• Boardreset
  • Resets the leaderboard to display the proper data for the current gamemode
• Change [Config setting] [Value]
  • Changes a config setting to a value. Ex. "change serverMaxConnections 32" will change the variable serverMaxConnections to 32. Note that some config values (Like serverGamemode) are parsed before the server starts so changing them mid game will have no effect.
• Color [Name] [Red] [Green] [Blue]
  • Replaces the color of all players matching [Name] with this color.
• Food [X position] [Y position] [Mass]
  • Spawns a food cell at those coordinates. If a mass value is not specified, then the server will default to "foodStartMass" in the config.
• Gamemode [Id]
  • Changes the gamemode of the server. Warning - This can cause problems.
• Kill [Name]
  • Kills all cells belonging to players that match [Name].
• Killall
  • Kills all player cells on the map.
• Mass [Name] [Number]
  • Sets the mass of all cells belonging to players that match [Name] to [Number].
• Playerlist
  • Shows a list of connected players, the amount of cells they have, total mass, and their position.
• Pause
  • Pauses/Unpauses the game.
• Status
  • Shows the amount of players currently connected and the current gamemode.
• Virus [X position] [Y position] [Mass]
  • Spawns a virus cell at those coordinates. If a mass value is not specified, then the server will default to "virusStartMass" in the config.

Contributing

Please see CONTRIBUTING.md for contribution guidelines.

License

Please see LICENSE.md.