Hello, we are AJS Development! We are the same team that brought you OgarUl! In AJS, we have many members. The main members are Andrews54757 and LegitSoulja. We decided to create this project after OgarUl's Ogar infrastructure couldnt hold with all those cool features! So, we created our own, completely from scratch. Now, OpenAgar is the most efficient Ogar-like game server available! Twice as efficient as MultiOgar, a gazillion times efficient than OgarUL, and 5 times efficient than Ogar! (Proof) We also decided to make OpenAgar as interesting as possible! New physics, new features, new gameplay and more!
It is a web game that we are making, similar to agar.io, but very different
Please note that a key is required, that it's distribution is limited! This is so that computer newbies wont waste our time
- Nodejs (v5.10.0+)
- Npm (included with Nodejs)
- Download this repo, or do
git clone https://github.com/AJS-development/OpenAgar.gitto download from command line. - Change directory to the project folder
cd OpenAgar - Make sure all the dependancies are installed
- Install npm dependancies
npm install - Run index.js using node
node index.js - Record the ID given and register by going here: http://login.opnagar.us. (OPTIONAL but recommended)
- Run index.js again
- Connect using
opnagar.us
While you do not need to registrate to run openagar (not anymore), you need to registrate to use services provided by AJS. Such include:
- Statistics - Publishing your server online to opnagar.us
- Plugins - Use of our libraries (One plugins is allowed for unregistered copies)
- Socket Protection
- Skin publishing - globally to opnagar.us
- Auto issue reports
- Our client.
If you dont registrate, you are unable to:
- Publish server on stats
- Use more than 1 plugin
- No socket protection
- Inability to use our client (excluding localhost and lan)
- Inability to publish global skins
- Auto issue reports
This is the website to generate keys from. You will have to sign up/sign in using your github account. We are using github because:
- We would rather have developers, not noobs
- We dont want to deal with managing accounts (ie, making sure they are real)
Then, once you are logged in, you can register servers. You may only have two registrated servers in your account. You may delete or deactivate unused registrations
Please do not be an idiot and try to make money off of ths system. We will monitor accounts and suspend them that are known for misuse.
If you bought a copy of openagar, wow, you have been ripped. People who have a registrated version might try to sell it for money. While sharing of servers is allowed, however note that if multiple people are using it at the same time - your server will become unjoinable - I suggest not doing this unless you are his/her friend. Another thing, is that openagar is free. Yes, its FREE. Also, the registration is FREE and UNLIMITED.
There are commands you can type in command line.
| Command | Desc |
|---|---|
| help | Displays a list of commands |
| startv | Start visual gui, not implemented |
| plugin | Plugin command, the core feature of OpenAgar |
| list | List the players/bots/minions in the game |
| server | Create servers, remove servers, select servers, and list them |
| pause | Pause/unpause the game |
| restart | Restart. Use just like you would use in command prompt. Do restart all [time] to restart all servers |
| kick | Kick a player |
| kickbots | Kick bots |
| addbots | Add bots |
| ban | Ban players |
| debug | Toggle the debug console |
| update | Updates the software |
| stop | Stops the server |
There are also chat commands
| Command | Desc |
|---|---|
| help | Displays a list of commands |
There are also some gamemodes
| ID | Mode |
|---|---|
| 0 | FFA |
| 1 | Teams |
| 2 | Experimental |
| 3 | Minions |
| 4 | Hide n seek |
| 5 | Adv Teams |
| 6 | Get rich or die trying (not finished) |
| 7 | Leap (not finished) |
| 8 | Timed FFA (not finished) |
| 9 | Hunger Games (not finished) |
Minigames are planned for OpenAgar, we dont know exactly how they will work, but we have an idea. Some ideas:
- Pool: Like 8-ball pool with some tweaks. (2 players)
- Maze: A maze, with teams and the first team to solve first wins (2-20 players)
- Get the F off my turf: A game where you defend your turf from others.
Statistics allow you to host a public server. To post your server to statistics, edit serverConfig.ini's statistics config values. Then, your server will be listed and it will be joinable at http://opnagar.us/server/yoururl.
Since most of OpenAgar's features doesnt come in the box, plugins are very important. So we made it very easy to install plugins.
The plugin command has four important actions.
plugin install [name]
Install a plugin from plugin library. The default library is this. Note that plugins are case sensitive.
plugin search [search term]
Search plugin librarys for plugins matching your search term
plugin library [url]
This adds a library to install/search plugins from. The url is the plugin JSON file with all the plugin data (example). All the libraries are stored in source/commands/lib/libraries. It is a line-break separated list of urls.
plugin add [name] [url]
This adds a plugin from it's url.
OpenAgar is made so you can host multiple servers on one port. There are two ways to create additional servers in the multi-server system
Using this folder, you can automatically have OpenAgar create additional servers for you. Also, this allows you to easily change the configurations of the individual servers.
- Create a file in the source/settings/server folder, the file should be
[Server name].ini - Then, you can override configs in that file. For example, I can put the line
gameMode = 1to have the server be in teams - Start the server. Your server will automatically be created.
The server command has 4 different usages
server create [name] [configs (optional)]
This adds an additional server. The configs argument overrides default configs and looks like this: configname1:value1,configname2:value2. You do not have to specify every config values.
server remove [id]
This removes a server by id
server select [id]
This selects a server for you to control via console.
server list
This lists all servers: their ids, names, players/bots, uptime, and status
OpenAgar is compatable with SSL. To use, set ssl to true in serverConfig.ini.
SSL uses this file to configure SSL.
{
"key": "", // RSA Private key (PEM format)
"certificate": "", // RSA Signed Certificate
"ca": "", // certificate authority
"expire": int // Expiration (in milliseconds) (Optional)
}
OpenAgar can generate its own self-signed RSA certificate. To use, just set ssl to true, without adding the rsa.json file. However, to be able to connect however (in most browsers), you must go to https:yourip:yourport in the browser and verify the certificate. (Since no CA is used)
- Andrews54757
- LegitSoulja
One thing we decided, was that we are not going to help other people run this project. If you cant... Too bad, use ogar. We are really trying to have this project be semi-private.
People have complained to me about this project being semi private. But in order to have everybody enjoy it, we must, since being too open means disaster. This was the problem with OgarUL, it got too big it collapsed on itself. Resources cost money you know.
Make a pr. But please make good ones
Actually, there are a lot of features, but none come in the box. You must use the plugin command to add them
Yes, but note that we are very very strict. So many pull requests wont be accepted
Yes, you may.
Statistics will not show your ip, minimising ddos attacks. Also, OpenAgar is made to handle them. It will detect those attacks and mitigate them. DDOSers have no life.
Some files are encrypted because they are needed to secure things such as sockets, or because they use our assets (our servers, other resources...).