Merge pull request #45 from Wyliemaster/branch2-2

lgtm

Author: SMJSGaming

docs/_sidebar.md

@@ -4,8 +4,7 @@
 - [Reference](/reference.md)
 - [Credits](/CREDITS.md)
 
-**Resources**
------
+## **Resources**
 
 - **Server**
   - [Comment](/resources/server/comment.md)
@@ -17,73 +16,86 @@
   - [Message](/resources/server/message.md)
   - [Song](/resources/server/song.md)
   - [User](/resources/server/user.md)
+  - [Restore](/resources/server/restore.md)
 - **Client**
   - [Gamesave](/resources/client/gamesave.md)
+    - [Encoder Keys](resources/client/gamesave/kCEK.md)
+    - [GS Values](/resources/client/gamesave/GS_Value.md)
+    - [GLM](/resources/client/gamesave/GLM.md)
+    - [value Keeper](/resources/client/gamesave/valueKeeper.md)
+    - [Game Variables](/resources/client/gamesave/gv.md)
+    - [Achievements](/resources/client/gamesave/achievement.md)
+    - [quests](/resources/client/gamesave/quests.md)
   - [Level](/resources/client/level.md)
+    - [Object IDs](/resources/client/level-components/objectids.md)
     - [Inner Level String](/resources/client/level-components/inner-level-string.md)
     - [Level Object](/resources/client/level-components/level-object.md)
     - [Color String](/resources/client/level-components/color-string.md)
     - [Guideline String](/resources/client/level-components/guideline-string.md)
 
 **Endpoints**
-  - Comments
-    - [deleteGJAccComment20](/endpoints/deleteGJAccComment20.md)
-    - [deleteGJComment20](/endpoints/deleteGJComment20.md)
-    - [getGJAccountComments20](/endpoints/getGJAccountComments20.md)
-    - [getGJCommentHistory](/endpoints/getGJCommentHistory.md)
-    - [getGJComments21](/endpoints/getGJComments21.md)
-    - [uploadGJAccComment20](/endpoints/uploadGJAccComment20.md)
-    - [uploadGJComment21](/endpoints/uploadGJComment21.md)
-  - Level Packs
-    - [getGJGauntlets21](/endpoints/getGJGauntlets21.md)
-    - [getGJMapPacks21](/endpoints/getGJMapPacks21.md)
-  - Levels
-    - [deleteGJLevelUser20](/endpoints/deleteGJLevelUser20.md)
-    - [downloadGJLevel22](/endpoints/downloadGJLevel22.md)
-    - [getGJDailyLevel](/endpoints/getGJDailyLevel.md)
-    - [getGJLevels21](/endpoints/getGJLevels21.md)
-    - [rateGJDemon21](/endpoints/rateGJDemon21.md)
-    - [rateGJStars211](/endpoints/rateGJStars211.md)
-    - [reportGJLevel](/endpoints/reportGJLevel.md)
-    - [updateGJDesc20](/endpoints/updateGJDesc20.md)
-    - [uploadGJLevel21](/endpoints/uploadGJLevel21.md)
-  - Messages
-    - [deleteGJMessages20](/endpoints/deleteGJMessages20.md)
-    - [downloadGJMessage20](/endpoints/downloadGJMessageo20.md)
-    - [getGJMessages20](/endpoints/getGJMessages20.md)
-    - [uploadGJMessage20](/endpoints/uploadGJMessage20.md)
-  - Miscellaneous
-    - [getAccountURL](/endpoints/getAccountURL.md)
-    - [getGJSongInfo](/endpoints/getGJSongInfo.md)
-    - [getGJTopArtists](/endpoints/getGJTopArtists.md)
-    - [getSaveData](/endpoints/getSaveData.md)
-    - [testSong](/endpoints/testSong.md)
-    - [likeGJItem211](/endpoints/likeGJItem211.md)
-    - [requestUserAccess](/endpoints/requestUserAccess.md)
-    - [restoreGJItems](/endpoints/restoreGJItems.md)
-  - Relationships
-    - [acceptGJFriendRequest20](/endpoints/acceptGJFriendRequest20.md)
-    - [blockGJUser20](/endpoints/blockGJUser20.md)
-    - [deleteGJFriendRequests20](/endpoints/deleteGJFriendRequests20.md)
-    - [getGJFriendRequests20](/endpoints/getGJFriendRequests20.md)
-    - [getGJUserList20](/endpoints/getGJUserList20.md)
-    - [readGJFriendRequest20](/endpoints/readGJFriendRequest20.md)
-    - [removeGJFriend20](/endpoints/removeGJFriend20.md)
-    - [unblockGJUser20](/endpoints/unblockGJUser20.md)
-    - [uploadFriendRequest20](/endpoints/uploadFriendRequest20.md)
-  - Rewards
-    - [getGJChallenges](/endpoints/getGJChallenges.md)
-    - [getGJRewards](/endpoints/getGJRewards.md)
-  - Scores
-    - [getGJLevelScores211](/endpoints/getGJLevelScores211.md)
-    - [getGJScores20](/endpoints/getGJScores20.md)
-  - Users
-    - [getGJUserInfo20](/endpoints/getGJUserInfo20.md)
-    - [getGJUsers20](/endpoints/getGJUsers20.md)
-    - [updateGJAccSettings20](/endpoints/updateGJAccSettings20.md)
-    - [updateGJUserScore22](/endpoints/updateGJUserScore22.md)
+
+- Comments
+  - [deleteGJAccComment20](/endpoints/deleteGJAccComment20.md)
+  - [deleteGJComment20](/endpoints/deleteGJComment20.md)
+  - [getGJAccountComments20](/endpoints/getGJAccountComments20.md)
+  - [getGJCommentHistory](/endpoints/getGJCommentHistory.md)
+  - [getGJComments21](/endpoints/getGJComments21.md)
+  - [uploadGJAccComment20](/endpoints/uploadGJAccComment20.md)
+  - [uploadGJComment21](/endpoints/uploadGJComment21.md)
+- Level Packs
+  - [getGJGauntlets21](/endpoints/getGJGauntlets21.md)
+  - [getGJMapPacks21](/endpoints/getGJMapPacks21.md)
+- Levels
+  - [deleteGJLevelUser20](/endpoints/deleteGJLevelUser20.md)
+  - [downloadGJLevel22](/endpoints/downloadGJLevel22.md)
+  - [getGJDailyLevel](/endpoints/getGJDailyLevel.md)
+  - [getGJLevels21](/endpoints/getGJLevels21.md)
+  - [rateGJDemon21](/endpoints/rateGJDemon21.md)
+  - [rateGJStars211](/endpoints/rateGJStars211.md)
+  - [reportGJLevel](/endpoints/reportGJLevel.md)
+  - [suggestGJStars](/endpoints/suggestGJStars.md)
+  - [updateGJDesc20](/endpoints/updateGJDesc20.md)
+  - [uploadGJLevel21](/endpoints/uploadGJLevel21.md)
+- Messages
+  - [deleteGJMessages20](/endpoints/deleteGJMessages20.md)
+  - [downloadGJMessage20](/endpoints/downloadGJMessageo20.md)
+  - [getGJMessages20](/endpoints/getGJMessages20.md)
+  - [uploadGJMessage20](/endpoints/uploadGJMessage20.md)
+- Miscellaneous
+  - [getAccountURL](/endpoints/getAccountURL.md)
+  - [getGJSongInfo](/endpoints/getGJSongInfo.md)
+  - [getGJTopArtists](/endpoints/getGJTopArtists.md)
+  - [getSaveData](/endpoints/getSaveData.md)
+  - [testSong](/endpoints/testSong.md)
+  - [likeGJItem211](/endpoints/likeGJItem211.md)
+  - [requestUserAccess](/endpoints/requestUserAccess.md)
+  - [restoreGJItems](/endpoints/restoreGJItems.md)
+- Relationships
+  - [acceptGJFriendRequest20](/endpoints/acceptGJFriendRequest20.md)
+  - [blockGJUser20](/endpoints/blockGJUser20.md)
+  - [deleteGJFriendRequests20](/endpoints/deleteGJFriendRequests20.md)
+  - [getGJFriendRequests20](/endpoints/getGJFriendRequests20.md)
+  - [getGJUserList20](/endpoints/getGJUserList20.md)
+  - [readGJFriendRequest20](/endpoints/readGJFriendRequest20.md)
+  - [removeGJFriend20](/endpoints/removeGJFriend20.md)
+  - [unblockGJUser20](/endpoints/unblockGJUser20.md)
+  - [uploadFriendRequest20](/endpoints/uploadFriendRequest20.md)
+- Rewards
+  - [getGJChallenges](/endpoints/getGJChallenges.md)
+  - [getGJRewards](/endpoints/getGJRewards.md)
+- Scores
+  - [getGJLevelScores211](/endpoints/getGJLevelScores211.md)
+  - [getGJScores20](/endpoints/getGJScores20.md)
+- Users
+
+  - [getGJUserInfo20](/endpoints/getGJUserInfo20.md)
+  - [getGJUsers20](/endpoints/getGJUsers20.md)
+  - [updateGJAccSettings20](/endpoints/updateGJAccSettings20.md)
+  - [updateGJUserScore22](/endpoints/updateGJUserScore22.md)
 
 - **Accounts**
+
   - [Login](/endpoints/accounts/loginGJAccount.md)
   - [Registration](/endpoints/accounts/registerGJAccount.md)
 
@@ -95,6 +107,7 @@
 - [Level Encoding/Decoding](/topics/levelstring_encoding_decoding.md)
 - [Game Save Files Encryption/Decryption](/topics/localfiles_encrypt_decrypt.md)
 - [Status Codes](/topics/status_codes.md)
+- [Vault Codes](/topics/vault_codes.md)
 - **Encryption**
   - [Base64 Encoding](topics/encryption/base64.md)
   - [CHK Generation](topics/encryption/chk.md)

docs/endpoints/accounts/register.md

@@ -0,0 +1,3 @@
+# accounts/register.php
+
+Account registration via a webpage

docs/endpoints/getAccountURL.md

@@ -8,7 +8,7 @@ Gets the URL for the data server. Official domain name is [http://geometrydash.c
 
 **accountID** - Anyone's account ID
 
-**type** - Unknown use; 2 by default
+**type** - used to decide which endpoint is used after the data server is found - 1 = backup data/ 2 = sync data
 
 **secret** - Wmfd2893gb7
 

docs/endpoints/getGJGauntlets21.md

@@ -16,6 +16,8 @@ Gets the gauntlet levels.
 
 **gdw** - 0
 
+**special** - 1 (fetches the 2.2 gauntlets)
+
 ## Response
 
 A list of [gauntlet objects](/resources/server/gauntlet.md), separated by a pipe `|`.

docs/endpoints/getGJLevelScores211.md

@@ -32,15 +32,15 @@ Gets the leaderboard scores for a particular level and submits a user's current
 
 **s3** - User's time in seconds + 4085
 
-**s4** - Unknown
+**s4** - related to percentage -> Client does math on it (likely used to make the leaderboards accurate)
 
-**s5** - Unknown
+**s5** - Random number goes up to 4 digits
 
 **s6** - List of PB differences (For example from 0 to 50, then 69, it would be `50,19`) [XOR'd](topics/encryption/xor.md) with 41274 and [Base64](topics/encryption/base64.md) encoded
 
-**s7** - Unknown
+**s7** - Randomly Generated 10 character string
 
-**s8** - Unknown
+**s8** - Attempt Count
 
 **s9** - The amount of coins the user got + 5819
 

docs/endpoints/rateGJDemon21.md

@@ -1,21 +1,15 @@
 # rateGJDemon21.php
 
-Rates the demon difficulty of a demon level
+Rates the demon difficulty of a demon level - only works for Geometry Dash moderators
 
 ## Parameters
 
 ### Required Parameters
 
-N/A
-
-### Optional Parameters
-
 **gameVersion** - 21
 
 **binaryVersion** - 35
 
-**gdw** - 0
-
 **secret** - Wmfp3897gc3
 
 **accountID** - The accountID of the user who's rating the demon's difficulty
@@ -26,15 +20,25 @@ N/A
 
 **rating** - 1 for Easy Demon, 2 for Medium Demon, 3 for Hard Demon, 4 for Insane Demon and 5 for Extreme Demon
 
+### Optional Parameters
+
+**gdw** - 0 
+
 ## Response
 
-Always -1. Returns a 500 error code when sent by GD
+For normal Players: Internal Server Error or -1
+
+if mode=1
+
+mod: levelID
+
+normal user: -2
 
 ## Example
 
 <!-- tabs:start -->
 
-### **Python**
+### **Python - normal Players**
 
 ```py
 import requests
@@ -57,4 +61,31 @@ print(req.text)
 -1
 ```
 
+### **Python - Moderators**
+
+```py
+import requests
+
+headers = {
+}
+
+data = {
+    "gameVersion": 21,
+    "binaryVersion": 35
+    "accountID": 71,
+    "gjp": *********, #the GJP of the moderator
+    "secret": "Wmfp3897gc3",
+    "levelID": 4284013,
+    "rating": 3
+}
+
+req = requests.post('http://www.boomlings.com/database/rateGJDemon21.php', headers=headers, data=data)
+print(req.text)
+```
+
+**Response**
+```py
+4284013
+```
+
 <!-- tabs:end -->

docs/endpoints/suggestGJStars.md

@@ -0,0 +1,59 @@
+# suggestGJStars.md
+
+Endpoint used by moderators to send levels to RobTop
+
+## Parameters
+
+### Required Parameters
+
+**accountID** - accountID of the user
+
+**gjp** - The [GJP](/topics/encryption/gjp.md) of the user
+
+**levelID** - the ID of the level
+
+**stars** - how many stars that are requested
+
+**secret** - Wmfp3879gc3
+
+**gameVersion** - the game version
+
+**binaryVersion** - the binary version
+
+**feature** - 1 for feature, 0 for star rate
+
+**gdw** - 0
+
+## Response
+
+-2 or 1
+
+## example
+
+<!--tabs:start -->
+
+## Python
+```py
+import requests
+
+data = {
+        "gameVersion": 21,
+        "binaryVersion":35
+        "accountID": 71, # a moderators accountID
+        "gjp": "********", # This would be the mods password encoded with GJP encryption
+        "levelID": 128,
+        "stars": 3,
+        "feature": 0,
+        "gdw": 0,
+        "secret": "Wmfp3879gc3"
+}
+
+req = requests.post("http://boomlings.com/database/suggestGJStars.php", data=data)
+print(req.text)
+
+```
+
+**Response**
+```py
+1
+```

docs/endpoints/updateGJUserScore22.md

@@ -60,7 +60,7 @@ Updates a user's data
 
 **color2** - Color 2 of the player. Defaults to the default secondary color when left out
 
-**special** - Unsure
+**special** - Glow (2 if enabled)
 
 **seed** - A random set of 10 numbers and letters in A-Za-z0-9
 

docs/endpoints/uploadGJLevel21.md

@@ -48,19 +48,19 @@ Uploads a created level to the servers.
 
 **levelString** - The actual level data. Must be gzip compressed and then converted to [URL-safe base64](./topics/encryption/base64.md)
 
-**seed2** - A mandatory [chk value](./topics/encryption/chk.md) generated from the first 50 characters of the ***compressed*** level data
+**seed2** - A mandatory [chk value](./topics/encryption/chk.md) generated from the first 50 characters of the **_compressed_** level data
 
 **secret** - Wmfd2893gb7
 
 ### Optional Parameters
 
-**wt** - A random number
+**wt** - the amount of time spent in the editor of a level (local copy)
 
-**wt2** - Another random number
+**wt2** - The amount of time spent in the editor of a level (previous copies)
 
 **seed** - A random string
 
-**extraString** - A list of underscore seperated numbers. Unknown usage, but can be left out entirely without problems
+**extraString** - A list of underscore seperated numbers. apparently used for rendering levels
 
 **levelInfo** - A random gzip compressed string
 
@@ -117,6 +117,7 @@ print(req.text)
 ```
 
 **Response**
+
 ```py
 62687277
 ```