- The Next Generation Ogar

[![Demo] (https://img.shields.io/badge/Demo-Heroku-green.svg)] (https://github.com/AJS-development/Ogar-unlimited/wiki/Demos)

A fully functional open source Agar.io server implementation, written in Node.js by the big ajs development team. Ogar Unlimited is designed to be used with the latest Agar.io client. It is basically what it says in the title, Ogar, except its functionality is unlimited!

Installation Guide (short)

1. Download and install Node
   • Required version v5.9.0
2. Download Ogar Unlimited (Zip or Git)
   • Download Latest Zip
   • git clone [email protected]:AJS-development/Ogar-unlimited.git
3. Once downloaded
   • CD to the extracted zip folder, or clone to Ogar-unlimited folder.
4. Install Modules
   • Run command using cmd, or terminal npm install, wait until done, or run InstallDependecies.bat file in the src folder.
5. Launch Ogar Unlimited
   • CD to the src folder inside Ogar-unlimited and run the start.bat/sh file or use command (node index).
6. You're all done. Continue reading for more info

NOTE: FOR THOSE WHO CANT USE THE INSTALL DEPENDANCIES SCRIPT, YOU MUST DO NPM INSTALL AFTER YOU CD INTO THE SRC FOLDER

Troubleshooting

https://github.com/AJS-development/Ogar-unlimited/issues/638

Highlight features in this modified copy

1. PMSG command, to periodically send a message (no need for admin to be online to explain rules)
2. OP , to do stuff in game WITHOUT a illegal clone client, see below
3. MSG, FMSG commands
4. Max IP Connections
5. Troll command ;)
6. More GameModes
7. Ban, Unban, Ban List (with revolutionary ban technique, no lag, no DDoS attacks)
8. Autoban option (see config.ini or advconfig.ini)
9. More control (config.ini and advconfig.ini)
10. and other features such as merge or nojoin or kick/killrange
11. Better physics (ejected mass and split and virus)
12. Colortext command (Changes console output color and style)
13. Live Console (see gameserver.ini, where a live console appears) NOTE: this is way different that Ogarserv's Console
14. Restart. Make it restart automatically or restart manually, Only works if use windows start script
15. skins, to use custom skins, do and then your name. for example <spy> lol will give you spy skin with name of lol use [website] to use a custom skin from a website (you need to use a url shortener though)
16. customskins (see custom skins)
17. Minions: you can create minions like agario powerups. press q to enter minion control mode (a b will appear next to your name). w = eject, space = split. press q again to exit
18. Banlist file
19. Opbyip
20. Database free high score keeper
21. pcmd command to do periodic commands
22. range command for bulk commands
23. easy verify system as anti bot mesure (config.ini or advconfig.ini)
24. mousefilter as a anti bot measure
25. plugins. Add gamemodes and commands easily! (See example plugin and template plugin)
26. uniban. A pre-made banlist of already known bad ips
27. garbage collection. prevent memory leak.
28. chat
29. Multi server support (see multiverse)
30. Bots that team
31. client configs
32. language support
33. tutorial
34. quadrants
35. chat commands

Note:

Please note that this is updated very frequently and you should check for updates every week. I added an update system but It needs to be initialized by you (because I don't think it is the right thing to do, updating without your consent). Also you may copy this and modify it just please give some credit to the hard working dev team, that is all I care. Another note is that I am sometimes terrible in my grammar (I still cannot spell potato out loud). If there is an issue, please notify me. If there is something you want in this, just make a pull request.

DO NOT BUY OGAR UL!

If you've purchased a copy of Ogar UL, you just got scammed. It is open source which means it is FREE. yes FREE! So if you paid any money, well, too bad.

DO not get from other sources

If you got ogarUL from anywhere besides github, DELETE IT IMMEDIATLY!!! Those might be bundled with viruses and other things. Remember you are running this probably from sudo. Get the github one here: https://github.com/AJS-development/Ogar-unlimited

How do I install plugins from the official library?

the official library is here: https://github.com/AJS-development/OgarUL-Plugin-Library

To install any plugins from the library, first do plugin available and remember the name of the plugin you want. then do plugin install [name] and you are set!

How do I use other plugins?

To use a plugin, simply download the folder and drag it into the plugins folder in src or use the plugin add command. To use the plugin add command, the plugin must have a files.txt file. then click on that file, click raw, and then copy the url. Then do plugin add [url] [pluginname] and it will even reload automatically for you. Thats it! example, doing plugin add https://raw.githubusercontent.com/AJS-development/OgarUL-Plugin-Library/master/devtools-plugin/files.txt devtools will add a plugin called devtools to your plugins.

How do I create a plugin? Is there Documentation?

This is the fun part, creating your own plugins. There is an example plugin you should look at and there is a template plugin. To get started, you can look at the plugin API documentation here.

Multiverse

Multiverse is for having multiple servers in one console. This is how you use it. The command for multiverse is multiverse [command] [arg]. Available commands are list,create,remove, and select. The list is used by doing multiverse list and it will list servers and their ports. It will also tell you f that is the master or is selected. The create command creates a server. The args are multiverse create [name] [port] [gamemode] [title]. Make sure that the port is not repeated in other servers. The title arg is optional and spaces are allowed, it is what is displayed in the client. Note that only the master has a statsport and sends multiverse data. To remove a server, do multiverse remove [name]. To then control the server using console commands, you have to select it. Do multiverse select [name] to select a server and start controlling it.

Easy Verify

For those of you who have trouble with minions and such, this feature is for you. Currently, there is no program that can get through all of ogar unlimited's filters and features, but in some future, someone might be able to crack the other anti bot measures. So we created an easy verify system, a currently foolproof system that filters out bots. To turn on, turn verify to 1 in config. Then when a player spawns, he is frozen at a spot and is given a 3 digit code. Then that player presses w to kill himself and types in the code in the nickname box. Afterword, when pressing play again, it shows a success message. Press w again to play.

Minions

You use minions by doing minion [yourid] [amount] [minionname]. Then, they will start following your mouse. You can control those minions by useing E and R keys. E for split. R for feed. If that doesnt work because of you client, turn useER to 0 in config.ini. then in game, q key. If you press it, a B will appear next to your name. then controls will be normal except now ejecting and splitting will happen on your minions not you. you can re-enter normal control mode by pressing q again. You can disable minions by doing minion [id] in console for just you or do minion destroy and it will remove all minions.

OP(2.4.5) - Guide,

You use OP by first setting who has op by doing op [id] in console. Then, that player can use the op features in game by pressing q. Then a c will appear next to your name. If you press w in this state, it gives you 100 more mass. If you press space in this state, you will be able to rejoin instantly. You will find out that if you press q again, two c's will appear next to your name. if you press w in this state, you shoot viruses. If you press space in this state, you shoot tiny things (almost invisible) that if someone eats, their mass is reduced by 100. Then, if you press q again,3 c's will appear.press w with 3c's, you shoot a virus, but whoever who eats it will be trolled :). If you press space with 3 c's the person who eats the virus will explode.If you press q again, 4 cs will appear and if you press w, you will shoot a virus tha kills people and space, it shoots a kick virus. You can then exit op by pressing q again after doing an action or by pressing Q until the three c's will dissappear (so that you can normally split and shoot mass).

• Note: names (CC's) dont work when player name is blank and it doesnt work on Virus and Leap gamemodes

Custom skins (guide)

You can use custom skins by putting them in customskins.txt the format is [shortcut] [skin] for the skin field, to use a URL skin, you do :http://url DO NOT FORGET TO GET REID OF THE S IF IT IS HTTPS OR FORGET TO PUT A : BEFORE.To use an agario skin, use %skinnameTo use that skin in game simply do <skinsshortuct> and then your name,

You can see a more detailed guide on the [wiki] (https://github.com/AJS-development/Ogar-unlimited/wiki/Skins-and-skin-shortcuts)

Obtaining and Using

As Ogar Unlimited is written in Node.js, you must have Node.js and its "ws", and "request" module installed to use it (unless you are using the Windows binary). You can usually download Node using your distribution's package manager (for *nix-like systems), or from the Node website. To install the "ws" and "request" module that is required, open up your system command line (cmd for windows, terminal for mac) and type "npm install ws" and do "npm install request". To see a detailed guide go to the [Installation guide] (https://github.com/AJS-development/Ogar-unlimited/wiki/Installation) in the wiki

(You can install and use Ogar unlimited on windows very quickly. First click Installdependancies.bat in src. Then wait (it takes a while), then click Start.bat and you're off! The next time you start the server, you only have to click Start.bat)

~~ (Binarys are also available in Releases)~~ OUTDATED

Currently, Ogar listens on the following addresses and ports:

• *:88 - for the stats server (I would use it to track servers)
• *: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 UL is being used. Usually, Skype is the culprit. To solve this, either close out skype, or change the serverPort value in settings/advconfig.ini to a different port. You will have to change your connection ip to "127.0.0.1:PORT"

Once the game server is running, you can connect (locally) by typing play.ogarul.tk/?ip=127.0.0.1:443 into your browser's address bar.

Configuring Ogar UL

To control how your server is run, Edit files in src/settings/

Custom Game modes

Ogar UL 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	Additional Description
0	Free For All	Everyone on there own
1	Teams	Team and be the best
2	Experimental (As of 6/13/15)	Something cool
3	Timed FFA	Normal FFA but with time limit (see config.ini for time configuration)
4	Virus Off	No virus in the map
5	UnlimitPVP	Where you can split indefinitely and rejoin instantly - 1v1 game (created by me)
6	UnlimitFFA	Same as above (Unlimited PVP) except in FFA (created by me)
7	Shrinking FFA	Shrinks the game(map size) as time passes
8	Experimental v2	An improved Experimental mode (created by )
10	Tournament	Normal FFA, but with no respawn and time limit
11	Hunger Games	Adapted from a movie called "Hunger Games"
12	Zombie Mode
13	Team Z	Teaming in Zombie Mode
14	Team X	Teaming in Experimental
15	NoCollision Teams	Same as Teams mode but with no collision between teammates
16	NoCollision TeamZ	Same as Team Z mode but with no collision between teammates
17	NoCollision TeamX	Same as Team X mode but with no collision between teammates
18	Leap	Where you leap instead of split, made by Ogarplus
20	Rainbow FFA	Hint: Use "Acid Mode" in the settings in the custom client
22	BlackHole	Normal FFA but with one big black hole

Chat Commands

The available in-game chat commands

Command	Usage
help	Shows list of commands
color [r] [b] [g]	Changes the color of your chatname
mute	Mutes/unmutes chat
pm [chatname] [msg]	sends a private message

Console Commands

The current available console commands are listed here. Command names are not case sensitive, but player names are.

Command	Usage
help	Shows list of commands
ophelp	Shows how to use op
quickrestart	Quickly restart your server. (Does not restart, nor reduce memory)
multiverse [command] [args]	Manage multiple servers in 1 OgarUl instance. See multiverse
plugin [command]	Manage plugins (reload,list,delete,add,available,install,update,search)
chat [command] [args]	Chat from console. (all, pm) (Usage: chat all [msg])
chatbat [id]	Ban people user id from chatting.
announce	Starts the high score announce feature.
verify [command] [id]	Verifies/Re-verifies a player. (Usage: verify reverify 1 force 1 to verify again)
minion [id] [amount] [name]	Create minions. To turn of (Usage: minion [id]), To destroy (Usage: minion destroy)
update [all,botname,skin]	Update to current/recent version & replace old with new.
reset	Destroys everything and start from scratch.
range [start] [end] [command] [flag]	Bulk commands (Usage: range 1 10 freeze) freezes players 1-10(id)
pcmd [delay] [repeattime] [command] [flag]	Periodic commands
opbyip [add,remove,list,clear,record] [ip]	Allows you to use opbyip features. Op based on ip
changelog [page]	Gets changelog from the servers
explode [id]	Explodes a player (Usage: explode 1)
blind [id]	Blinds/Unblind a player
hide [id]	Hide/Unhide a player
split [id] [count]	Splits a player
shrink [amount]	Shrinks the game play space. Amount is optional
enlarge [amount]	Enlarge the game place space. Amount is optional
freeze [id]	Freezes a player
spawnmass [id] [mass]	Sets a player spawnmass. Default (0)
speed [id] [mass]	Sets a player base speed. Default (0))
colortext [color]	Changes console color and style. (blue, green,red,yellow,bold,reset,dim,white, help)
team [id] [team (r,g,b)]	Changes a players team. (You might have to split to see the changes though)
resetvirus	Turns specials virusus (From OP's) into normal ones.
whitelist [ip]	Whitelist an ip
unwhitelist [ip]	Remove ip from whitelist
whitelist	Lists the whitelist
clearban	Clears ban list
ban [ip]	Bans an IP and sends a Message. Do (ban record) to record a ban.
unban [ip]	Unbans an IP
rainbow [id]	Gives a player a rainbow effect
kickbots [number]	Kick a specific number of bots. (Leave blank to kick all)
kickbots [number]	Kill a specific number of bots. (Leave blank to kill all)
restart [minutes]	Restarts the server after a specific amount of minutes. (Leave blank for instant restart)
banlist	Lists banned IP's
op [id]	Makes a player OP using ID instead of there IP
dop [id]	De-Op's a player
rop	Resets OP's
pfmsg [delay] [duration] [x to repeat] [msg1] [msg2] [etc...]	Periodically sends a force message (seconds)
spfmsg	Stops pfmsg
pmsg [delay] [duration] [x to repeat] [msg1] [msg2] [etc...]	Periodically sends a message (seconds)
spmsg	Stops pmsg
troll [id]	You'll figure this one out. It's a suprise!.
fmsg [message 1] [message 2] [etc...]	Forces players to read a message. Changes leaderboard, freeze players, and change their name temporarily
msg [message1] [message2] [etc...]	Changes the leaderboard to a message for a short time
kick/killrange/ban [start] [end]	Kicks/kills/bans in a range (eg: killrange 1 10 will kill players whos ids are between them)
nojoin [id]	Makes a player unable to join
merge [id]	Forces a player to merge
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] ...	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. (Usage: change serverMaxConnections 32).Note that some config values (Like serverGamemode) are parsed before the server starts so changing them mid game will have no effect.
clear	Clears the console output
color [id] [r] [g] [b]	Replaces the color of the specified player with this color.
exit	Closes the server
food [x pos] [y pos] [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!.
kick [id]	Kicks a specific player -or- bot from the server
kill [id]	Kills all cells belonging to a specific player
mass [id] [mass]	Sets the mass of all cells belonging to a specified player.
name [id] [new name]	Changes the name of the player with the specified id with [New Name].
playerlist	Shows a list of connected players, their IP, player ID, the amount of cells they have, total mass, and their position.
pause	Pauses/Unpauses the game
reload	Reloads the config file used by the server. However, the following values are not affected: serverPort, serverGamemode, serverBots, serverStatsPort, serverStatsUpdate.
status	Shows the amount of players currently connected, time elapsed, memory usage (memory used/memory allocated), and the current gamemode.
tp [id] [x pos] [y pos]	Teleports the specified player to the specified coordinates.
virus [x pos] [y pos] [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

Just make a pull request or make your own copy

Things that I dont want you to copy (copying it to your own file or fork)

1. No-Lag antibot measures
2. OP
3. minions
4. smart bot/despawn
5. easy verify
6. Periodic things (pmsg, pcmd, etc..)
7. mousefilter
8. plugins
9. Adv Multiverse system
10. client config system
11. language support system
12. tutorial system
13. quadrants

#####anything else, if you improved it, you dont have to give us credit, or else if you just copied, you must give us credit