agar.io

.gitignore

@@ -1 +1,2 @@
 *.png
+.idea/*

PROTOCOL.md

@@ -0,0 +1,32 @@
+# PROTOCOL
+
+## Protocol extensions
+As the server has to tell whether the client supports protocol extensions, the values of package 254 and 255 have been adjusted.
+Package 255 now contains "Ogar" in ASCII (1332175218) while package 254 contains the version number. When modifying the protocol,
+only new features can be implemented. Also, the client must be compatible with older versions of the server.
+
+## Changes
+Please document any changes introduced here. Direction has to be either `S2C` (server to client) or `C2S`.
+
+### Version 1
+
+
+| Direction  | ID  | Value | Description|
+| :------------ |:---------------| :-----|:----|
+|C2S       | 254 |                1 | Version number|
+|C2S       | 255 |       1332175218 | String "Ogar" - Tells the server how to use the modified protocol|
+|S2C       |  48 | behaves like #49 | Leaderboard without numbers|
+|C2S       |  99 | flags (uint8) [1], message | For in-game chat, each char is in Uint16 |
+|S2C       |  99 | flags (uint8) [1], r (uint8), g (uint8), b (uint8), nick, '\0', message, '\0' | same as above |
+
+ [1] If flags has the 2, 4, or 8 bit set, an offset of 4, 8, or 16 bytes follows before any other data. Until these additional
+   bytes are used, just skip them. 
+
+Hint : to use Packet 48, make sure the packet ID in case 48 of Ogar/src/packet/UpdateLeaderboard.js is adjusted like this: 
+```
+view.setUint8(0, this.packetLB, true);
+```
+You can also use https://github.com/m-byte/Ogar, which already has this feature enabled.
+
+### Version 2
+TODO: We could add chat functionality in this version. That way, only one websocket server would be needed.

README.md

@@ -1,6 +1,70 @@
 # agar-clone
-clone of agar.io
 
-You can use nginx to deploy it on your server. 
+## Contents
+ - [Introduction](#introduction)
+ - [Setup](#setup)
+ - [Test and Known Issues](#test-and-known-issues)
+ - [FAQ](#faq)
+ - [Protocol Extensions](#protocol-extensions)
+ - [Contributions](#contributions)
+ - [Disclaimer](#disclaimer)
 
+## Introduction
+
+This is a clone of agar.io. In this project we aim to acheive the following. 
+
+- [x] Hack main_out.js and make the variables and function names readable. Now most of the variable and function name should make sense. 
+- [x] Add uploading custom skins features (Done)
+- [x] Add [in-game chat](https://cloud.githubusercontent.com/assets/5158896/8327532/c41e94fa-1a9b-11e5-87cc-f42b5f6ef2df.png) feature. (Done)
+- [x] Add mobile device support (Done)
+- [x] Support multi-server feature (Done in Cigar)
+
+##Setup
+
+Copy all files to a server with PHP support (e.g. LEMP/LAMP). To check whether your server supports PHP, please read [this tutorial](http://www.cyberciti.biz/faq/how-do-i-test-php-installation-with-a-phpinfo-page/).
+Once everything is set up, open index.html in your browser. If everything is working well, go to the next section to use your own Ogar server.
+
+### Support Your Server
 Replace the CONNECTION_URL with your own ip and port in main_out.js
+
+### Upload Custom Skins
+The upload module does two things. The first is to upload a skin onto skins folder. The second is that the client request the server to run checkdir.php every 15 seconds to check what skins are uploaded and add them into knownNameDict. Then the skins can be loaded. 
+
+To make this feature work, you need to give upload.php priviliage to read skins folder. 
+
+
+``` 
+chmod 777 skins 
+```
+
+will make it work.
+
+
+
+## Test and Known Issues
+
+This client has been tested on LEMP stack on OS X 10.10 and Ubuntu 14.04 with server side [Ogar](https://github.com/vram4/Ogar).
+
+It is known that some of the variables and function names still make no sense, we are working on that. 
+
+## FAQ
+### Can agar-clone connect to the official server?
+No, agar-clone is not intended to be used with the official server. You will have to use it with [Ogar](https://github.com/forairan/Ogar) or [Cigar](https://github.com/m-byte/Cigar).
+
+### How can I use the chat feature?
+Currently, only [Cigar](https://github.com/m-byte/Cigar) supports the chat protocol. If you know of another server supporting the extended protocol, feel free to [let us know](https://github.com/Eureka22/agar-clone/issues).
+
+## Protocol extensions
+As the server has to tell whether the client supports protocol extensions, the values of package 254 and 255 have been adjusted.
+Package 255 now contains "Ogar" in ASCII (1332175218) while package 254 contains the version number. When modifying the protocol,
+only new features can be implemented. Also, the client must remain compatible with older versions of the server.
+
+Original protocol can be found [here](https://github.com/vram4/Agar.io-Protocol). Changes to the protocol have to be [documented](PROTOCOL.md).
+
+## Contributions
+
+Pull Request are welcome. 
+
+## Disclaimer
+
+Note that the aim of this repo is to study agar.io client, understand the mechanism and find potential improvements. It is worth pointing out that hosting a third-party agar client is against the [Terms](http://agar.io/terms.txt) of Agario and not recommended by the owner of this repo. Please think twice before hosting the client and do it at your own risk. :)

Vector2.js

@@ -0,0 +1,121 @@
+var Vector2 = function(x, y) {
+    this.x = x || 0;
+    this.y = y || 0;
+};
+Vector2.prototype = {
+    reset: function(x, y) {
+        this.x = x;
+        this.y = y;
+        return this;
+    },
+    toString: function(decPlaces) {
+        decPlaces = decPlaces || 3;
+        var scalar = Math.pow(10, decPlaces);
+        return "[" + Math.round(this.x * scalar) / scalar + ", " + Math.round (this.y * scalar) / scalar + "]";
+    },
+    clone: function() {
+        return new Vector2(this.x, this.y);
+    },
+    copyTo: function(v) {
+        v.x = this.x;
+        v.y = this.y;
+    },
+    copyFrom: function(v) {
+        this.x = v.x;
+        this.y = v.y;
+    },
+    magnitude: function() {
+        return Math.sqrt((this.x * this.x) + (this.y * this.y));
+    },
+    magnitudeSquared: function() {
+        return (this.x * this.x) + (this.y * this.y);
+    },
+    normalise: function() {
+        var m = this.magnitude();
+        this.x = this.x / m;
+        this.y = this.y / m;
+        return this;
+    },
+    reverse: function() {
+        this.x =- this.x;
+        this.y =- this.y;
+        return this;
+    },
+    plusEq: function(v) {
+        this.x += v.x;
+        this.y += v.y;
+        return this;
+    },
+    plusNew: function(v) {
+        return new Vector2(this.x + v.x, this.y + v.y);
+    },
+    minusEq: function(v) {
+        this.x -= v.x;
+        this.y -= v.y;
+        return this;
+    },
+    minusNew: function(v) {
+        return new Vector2(this.x - v.x, this.y - v.y);
+    },
+    multiplyEq: function(scalar) {
+        this.x*=scalar;
+        this.y*=scalar;
+        return this;
+    },
+    multiplyNew: function(scalar) {
+        var returnvec = this.clone();
+        return returnvec.multiplyEq(scalar);
+    },
+    divideEq: function(scalar) {
+        this.x/=scalar;
+        this.y/=scalar;
+        return this;
+    },
+    divideNew: function(scalar) {
+        var returnvec = this.clone();
+        return returnvec.divideEq(scalar);
+    },
+    dot: function(v) {
+        return (this.x * v.x) + (this.y * v.y);
+    },
+    angle: function(useRadians) {
+        return Math.atan2(this.y, this.x) * (useRadians ? 1 : Vector2Const.TO_DEGREES);
+    },
+    rotate: function(angle, useRadians) {
+        var cosRY = Math.cos(angle * (useRadians ? 1 : Vector2Const.TO_RADIANS));
+        var sinRY = Math.sin(angle * (useRadians ? 1 : Vector2Const.TO_RADIANS));
+        Vector2Const.temp.copyFrom(this);
+        this.x = (Vector2Const.temp.x * cosRY) - (Vector2Const.temp.y * sinRY);
+        this.y = (Vector2Const.temp.x * sinRY) + (Vector2Const.temp.y * cosRY);
+        return this;
+    },
+    equals: function(v) {
+        return ((this.x == v.x) && (this.y == v.x));
+    },
+    isCloseTo: function(v, tolerance) {
+        if (this.equals(v))
+            return true;
+        Vector2Const.temp.copyFrom(this);
+        Vector2Const.temp.minusEq(v);
+        return (Vector2Const.temp.magnitudeSquared() < tolerance * tolerance);
+    },
+    rotateAroundPoint: function(point, angle, useRadians) {
+        Vector2Const.temp.copyFrom(this);
+        Vector2Const.temp.minusEq(point);
+        Vector2Const.temp.rotate(angle, useRadians);
+        Vector2Const.temp.plusEq(point);
+        this.copyFrom(Vector2Const.temp);
+    },
+    isMagLessThan: function(distance) {
+        return (this.magnitudeSquared() < distance * distance);
+    },
+    isMagGreaterThan: function(distance) {
+        return (this.magnitudeSquared() > distance * distance);
+    }
+};
+Vector2Const = {
+    TO_DEGREES: 180 / Math.PI,
+    TO_RADIANS: Math.PI / 180,
+    temp: new Vector2()
+};
+

changelog.html

@@ -0,0 +1,21 @@
+<html>
+changes are recorded in this document
+
+
+<head>
+<meta charset="UTF-8">
+</head>
+<br/>
+日常更新(June 22): 
+
+<br/>
+1.
+更新了客户端，请大家帮忙测试，如果有问题请告诉我。考完试增加更多特性请期待。
+<br/>
+
+2. 更新了"部落模式", 如果使用[部落名]用户名 例如"[526a]李小花","[ee]Richard
+Song" 之类的id, 会使用中括号里的名字作为皮肤, 玩家可以上传皮肤。
+预告: 近期将开启皮肤图片库功能，另外上传和背景色相同的图片将会被禁止。
+<br/>
+
+</html>