gj-boomlings-api 2.0.3 → 2.1.1

package/functions/getProfile.js

@@ -1,3 +1,45 @@
+/**
+ * @typedef {Object} completedClassicLevels
+ * @property {number} auto - The amount of classic levels rated auto (1*) the player has completed.
+ * @property {number} easy - The amount of classic levels rated easy (2*) the player has completed.
+ * @property {number} normal - The amount of classic levels rated normal (3*) the player has completed.
+ * @property {number} hard - The amount of classic levels rated hard (4-5*) the player has completed.
+ * @property {number} harder - The amount of classic levels rated harder (6-7*) the player has completed.
+ * @property {number} insane - The amount of classic levels rated insane (8-9*) the player has completed.
+ * @property {number} daily - The amount of daily levels the player has completed.
+ * @property {number} gauntlet - The amount of levels the player has completed in gauntlets.
+ */
+
+/**
+ * @typedef {Object} completedPlatformers
+ * @property {number} auto - The amount of platformers rated auto (1 moon) the player has completed.
+ * @property {number} easy - The amount of platformers rated easy (2 moons) the player has completed.
+ * @property {number} normal - The amount of platformers rated normal (3 moons) the player has completed.
+ * @property {number} hard - The amount of platformers rated hard (4-5 moons) the player has completed.
+ * @property {number} harder - The amount of platformers rated harder (6-7 moons) the player has completed.
+ * @property {number} insane - The amount of platformers rated insane (8-9 moons) the player has completed.
+ */
+
+/**
+ * @typedef {Object} completedClassicDemons
+ * @property {number} easy - The amount of classic easy demons the player has completed.
+ * @property {number} medium - The amount of classic medium demons the player has completed.
+ * @property {number} hard - The amount of classic hard demons the player has completed.
+ * @property {number} insane - The amount of classic insane demons the player has completed.
+ * @property {number} extreme - The amount of classic extreme demons the player has completed.
+ * @property {number} weekly - The amount of weekly demons the player has completed.
+ * @property {number} gauntlet - The amount of demons the player has completed in gauntlets.
+ */
+
+/**
+ * @typedef {Object} completedPlatformerDemons
+ * @property {number} easy - The amount of platformer easy demons the player has completed.
+ * @property {number} medium - The amount of platformer medium demons the player has completed.
+ * @property {number} hard - The amount of platformer hard demons the player has completed.
+ * @property {number} insane - The amount of platformer insane demons the player has completed.
+ * @property {number} extreme - The amount of platformer extreme demons the player has completed.
+ */
+
 /**
  * @typedef {Object} Player
  * @property {string} username - The player's username.
@@ -24,61 +66,78 @@
  * @property {number} jetpackID - The ID of the currently selected jetpack icon.
  * @property {number} explosionID - The ID of the currently selected explosion animation.
  * @property {boolean} glow - Whether the player's icon has the "glow" feature enabled.
- * @property {string} messages - The current state of messaging the player. Returns "all" if anyone can message the person, "friends" if it's limited to friends, and "none" if no one can.
+ * @property {string} glowColor - The HEX code of the player's glow color.
+ * @property {("all"|"friends"|"none")} messages - The current state of messaging the player. Returns "all" if anyone can message the person, "friends" if it's limited to friends, or "none" if no one can.
  * @property {boolean} friendRequests - Whether the player has allowed to receive friend requests.
- * @property {string} commentHistory - The current state of viewing the player's comment history. Returns "all" if anyone can do it, "friends" if it's limited to friends, and "none" if only the player can.
- * @property {string|null} mod - Whether the player is a moderator. Returns `null` if not, "mod" if the user is a regular moderator and "elder" if the user is an elder moderator.
- * @property {string} youtube - The player's YouTube channel ID, used in this template: `https://youtube.com/channel/((youtube))`.
+ * @property {("all"|"friends"|"none")} commentHistory - The current state of viewing the player's comment history. Returns "all" if anyone can do it, "friends" if it's limited to friends, or "none" if only the player can.
+ * @property {string|null} mod - Whether the player is a moderator. Returns `null` if not, "mod" if the user is a regular moderator or "elder" if the user is an elder moderator.
+ * @property {string} youtube - The player's YouTube channel ID/handle, used in this template: `https://youtube.com/@((youtube))` or `https://youtube.com/channel/((youtube))` (only if the provided value starts with UC).
  * @property {string} twitter - The player's X (formerly Twitter) username, used in this template: `https://x.com/((twitter))`.
  * @property {string} twitch - The player's Twitch username, used in this template: `https://twitch.tv/((twitch))`.
+ * @property {string} instagram - The player's Instagram username, used in this template: `https://instagram.com/@((instagram))`.
+ * @property {string} tiktok - The player's TikTok username, used in this template: `https://tiktok.com/@((tiktok))`.
+ * @property {string} discord - The player's Discord username.
+ * @property {string} custom - The custom string provided by the player.
+ * @property {completedClassicLevels} completedClassicLevels - An object breaking down what classic levels the player has completed by difficulties, as well as daily levels and gauntlet levels.
+ * @property {completedPlatformers} completedPlatformers - An object breaking down what platformer levels (non-demons) the player has completed by difficulties.
+ * @property {completedClassicDemons} completedClassicDemons - An object breaking down what classic demons the player has completed by difficulties, as well as weekly demons and gauntlet demons.
+ * @property {completedPlatformerDemons} completedPlatformerDemons - An object breaking down what platformer demons the player has completed by difficulties.
  */
 
 module.exports = {
     /**
      * Fetches the profile of a specified user.
-     * @param {string} name - The search query (user, account ID or player ID).
-     * @param {("name"|"accountid"|"playerid")} mode - The search mode, defaults to "auto". If "auto" is selected, the search is first attempted by matching the matching the username, then account ID and then player ID.
+     * @param {string} name - The search query (username, account ID or player ID).
+     * @param {("name"|"accountid"|"playerid"|"auto")} mode - The search mode, defaults to "auto". If "auto" is selected, the search is first attempted by looking up the username, then account ID and then player ID.
      * @returns {Player}
      */
     getProfile: async function (name, mode = "auto") {
-        const { gjReq } = require("../gjReq");
+        const { gjReq } = require("../misc/gjReq");
         const { rgbToHEX } = require("../misc/rgbToHEX");
         const colors = require("../misc/colors.json");
-        if (!name) throw new Error("Please provide an account name, player ID or account ID!")
-        if (!["name", "accountid", "playerid", "auto"].includes(mode)) throw new Error("Please provide a valid search mode! It's either \"name\", \"accountid\", \"playerid\", or \"auto\"")
+        if (!name) throw new Error("Please provide the account name, player ID or account ID!")
+        if (!["name", "accountid", "playerid", "auto"].includes(mode)) throw new Error("Please provide a valid search mode! It's either \"name\", \"accountid\", \"playerid\", or \"auto\".")
 
         function decodeUser(array) {
-            let accName = array[1];
-            let playerID = Number(array[3]);
-            let secretCoins = Number(array[5]);
-            let userCoins = Number(array[7]);
-            let c1 = array[9];
-            let c2 = array[11];
-            let stars = Number(array[15]);
-            let moons = Number(array[17]);
-            let diamonds = Number(array[19]);
-            let demons = Number(array[21]);
-            let cp = Number(array[23]);
-            let msg = array[25];
-            let friendReqs = array[27];
-            let commentHistory = array[29];
-            let yt = array[31];
-            let cube = Number(array[33]);
-            let ship = Number(array[35]);
-            let ball = Number(array[37]);
-            let ufo = Number(array[39]);
-            let wave = Number(array[41]);
-            let robot = Number(array[43]);
-            let spider = Number(array[47]);
-            let swing = Number(array[51]);
-            let jetpack = Number(array[53]);
-            let glow = Boolean(Number(array[45]));
-            let explosion = Number(array[49]);
-            let rank = Number(array[55]);
-            let accID = Number(array[57]);
-            let twitter = array[61];
-            let twitch = array[63];
-            let mod = array[65];
+            let accName = array[1];                             // 1:
+            let playerID = Number(array[3]);                    // 2:
+            let secretCoins = Number(array[5]);                 // 13:
+            let userCoins = Number(array[7]);                   // 17:
+            let c1 = array[9];                                  // 10:
+            let c2 = array[11];                                 // 11:
+            let stars = Number(array[15]);                      // 3:
+            let moons = Number(array[17]);                      // 52:
+            let diamonds = Number(array[19]);                   // 46:
+            let demons = Number(array[21]);                     // 4:
+            let cp = Number(array[23]);                         // 8:
+            let msg = array[25];                                // 18:
+            let friendReqs = array[27];                         // 19:
+            let commentHistory = array[29];                     // 50:
+            let yt = array[31];                                 // 20:
+            let cube = Number(array[33]);                       // 21:
+            let ship = Number(array[35]);                       // 22:
+            let ball = Number(array[37]);                       // 23:
+            let ufo = Number(array[39]);                        // 24:
+            let wave = Number(array[41]);                       // 25:
+            let robot = Number(array[43]);                      // 26:
+            let spider = Number(array[47]);                     // 43:
+            let swing = Number(array[51]);                      // 53:
+            let jetpack = Number(array[53]);                    // 54:
+            let glowColor = Number(array[13]);                  // 51:
+            let glow = Boolean(Number(array[45]));              // 28:
+            let explosion = Number(array[49]);                  // 48:
+            let rank = Number(array[81]);                       // 30:
+            let accID = Number(array[55]);                      // 16:
+            let twitter = array[59];                            // 44:
+            let twitch = array[61];                             // 45:
+            let instagram = array[63];                          // 59:
+            let tiktok = array[65];                             // 60:
+            let discord = array[67];                            // 58:
+            let custom = array[69];                             // 61:
+            let mod = array[71];                                // 49:
+            let completedDemons = array[73].split(",");         // 55:
+            let completedClassicLevels = array[75].split(",");  // 56:
+            let completedPlatformers = array[77].split(",");    // 57:
 
             let msgObj = {
                 0: "all",
@@ -122,39 +181,69 @@ module.exports = {
                 jetpackID: jetpack,
                 explosionID: explosion,
                 glow: glow,
+                glowColor: rgbToHEX(colors[glowColor]),
                 messages: msgObj[msg],
                 friendRequests: friendReqsObj[friendReqs],
                 commentHistory: msgObj[commentHistory],
                 mod: modObj[mod],
                 youtube: yt,
                 twitter: twitter,
-                twitch: twitch
+                twitch: twitch,
+                instagram: instagram,
+                tiktok: tiktok,
+                discord: discord,
+                custom: custom,
+                completedClassicLevels: {
+                    auto: Number(completedClassicLevels[0]),
+                    easy: Number(completedClassicLevels[1]),
+                    normal: Number(completedClassicLevels[2]),
+                    hard: Number(completedClassicLevels[3]),
+                    harder: Number(completedClassicLevels[4]),
+                    insane: Number(completedClassicLevels[5]),
+                    daily: Number(completedClassicLevels[6]),
+                    gauntlet: Number(completedClassicLevels[7])
+                },
+                completedPlatformers: {
+                    auto: Number(completedPlatformers[0]),
+                    easy: Number(completedPlatformers[1]),
+                    normal: Number(completedPlatformers[2]),
+                    hard: Number(completedPlatformers[3]),
+                    harder: Number(completedPlatformers[4]),
+                    insane: Number(completedPlatformers[5])
+                },
+                completedClassicDemons: {
+                    easy: Number(completedDemons[0]),
+                    medium: Number(completedDemons[1]),
+                    hard: Number(completedDemons[2]),
+                    insane: Number(completedDemons[3]),
+                    extreme: Number(completedDemons[4]),
+                    weekly: Number(completedDemons[10]),
+                    gauntlet: Number(completedDemons[11])
+                },
+                completedPlatformerDemons: {
+                    easy: Number(completedDemons[5]),
+                    medium: Number(completedDemons[6]),
+                    hard: Number(completedDemons[7]),
+                    insane: Number(completedDemons[8]),
+                    extreme: Number(completedDemons[9])
+                }
             }
         }
 
         async function accIDSearch() {
-            let res = await gjReq("getGJUserInfo20", {
-                targetAccountID: name,
-                secret: "Wmfd2893gb7"
-            });
-            if (res.data == -1) return {};
+            let res = await gjReq("getGJUserInfo20", { targetAccountID: name });
+            if (res.data == -1) throw new Error(`-1: Player not found`);
             let accArray = res.data.split(":");
 
             return decodeUser(accArray);
         }
 
         async function nonAccIDSearch() {
-            let search = await gjReq("getGJUsers20", {
-                str: name,
-                secret: "Wmfd2893gb7"
-            });
-            if (search.data == -1) return {};
-            let targetAccID = search.data.split(":")[21];
-
-            let res = await gjReq("getGJUserInfo20", {
-                targetAccountID: targetAccID,
-                secret: "Wmfd2893gb7"
-            });
+            let search = await gjReq("getGJUsers20", { str: name });
+            if (search.data == -1) throw new Error(`-1: Player not found`);
+            let targetAccID = search.data.split(":")[23];
+
+            let res = await gjReq("getGJUserInfo20", { targetAccountID: targetAccID });
             let accArray = res.data.split(":");
 
             return decodeUser(accArray);

package/functions/getSongInfo.js

@@ -12,19 +12,14 @@ module.exports = {
     /**
      * Searches for a song on Newgrounds or in the internal Geometry Dash song library.
      * @param {number} song - The song ID.
-     * @returns {Song}
+     * @returns {Song} Returns the song object, or an empty object containing only the song ID if the song hasn't been found.
      */
     getSongInfo: async function (song) {
         if (isNaN(song)) throw new Error("Please provide a valid song ID.");
-        const { gjReq } = require("../gjReq");
+        const { gjReq } = require("../misc/gjReq");
 
-        const data = {
-            songID: song,
-            secret: "Wmfd2893gb7"
-        }
-
-        let res = await gjReq('getGJSongInfo', data);
-        if (res.data == -2) throw new Error(`-2. Couldn't find a song with ID ${song}.`)
+        let res = await gjReq('getGJSongInfo', { songID: song });
+        if (res.data == -2 || res.data == -1) return { id: Number(song) };
         let rawSong = res.data.split("~|~");
 
         let link = decodeURIComponent(rawSong[13]);

package/functions/getSongsLibrary.js

@@ -29,10 +29,21 @@ module.exports = {
      */
     getSongsLibrary: async function () {
         const zlib = require("zlib");
-        const fetch = require("node-fetch");
+        const https = require("https");
 
-        let req = await fetch("https://geometrydashfiles.b-cdn.net/music/musiclibrary.dat");
-        let res = await req.text();
+        const res = await new Promise((resolve, reject) => {
+            https.get("https://geometrydashfiles.b-cdn.net/music/musiclibrary.dat", (res) => {
+                let data = "";
+
+                res.on("data", chunk => {
+                    data += chunk;
+                });
+
+                res.on("end", () => {
+                    resolve(data);
+                });
+            }).on("error", reject);
+        });
 
         let libArray;
         const buffer = await new Promise((resolve, reject) => {

package/functions/getTab.js

@@ -9,16 +9,15 @@ module.exports = {
         let tabs = { trending: 3, recent: 4, featured: 6, magic: 7, awarded: 11, sent: 27 }
         if (!tabs[tab.toLowerCase()]) throw new Error('Please provide a valid tab! Possible tabs: "trending", "recent", "featured", "magic", "awarded", "sent".');
 
-        const { gjReq } = require("../gjReq");
+        const { gjReq } = require("../misc/gjReq");
         let GJDecode = require("../misc/GJDecode");
         const { decodeSearchResults } = new GJDecode;
         const res = await gjReq("getGJLevels21", {
             type: tabs[tab.toLowerCase()],
-            page: Number(page) - 1,
-            secret: "Wmfd2893gb7"
+            page: Number(page) - 1
         });
         if (res.data == -1) return [];
-        
+
         return decodeSearchResults(res.data);
     }
 }

package/functions/getTop100.js

@@ -6,15 +6,12 @@ module.exports = {
     getTop100: async function () {
         let GJDecode = require("../misc/GJDecode");
         const { decodeScoresUser } = new GJDecode;
-        const { gjReq } = require("../gjReq");
+        const { gjReq } = require("../misc/gjReq");
 
-        const data = {
-            secret: "Wmfd2893gb7",
+        let res = await gjReq("getGJScores20", {
             type: "top",
             count: 100
-        }
-
-        let res = await gjReq("getGJScores20", data);
+        });
 
         let players = res.data.split("|");
         players.pop();

package/functions/getTopLists.js

@@ -5,12 +5,11 @@ module.exports = {
      * @returns {import("./searchLists").List[]}
      */
     getTopLists: async function (page = 1) {
-        const { gjReq } = require("../gjReq");
+        const { gjReq } = require("../misc/gjReq");
         const GJDecode = require("../misc/GJDecode");
         const { decodeLists } = new GJDecode;
         const res = await gjReq("getGJLevelLists", {
             type: 6,
-            secret: "Wmfd2893gb7",
             page: Number(page) - 1
         })
         if (res.data == -1) return [];

package/functions/getUserLevels.js

@@ -8,23 +8,19 @@ module.exports = {
     getUserLevels: async function (username, page = 1) {
         if (!username) throw new Error("Please provide a username or player ID!");
 
-        const { gjReq } = require("../gjReq.js");
+        const { gjReq } = require("../misc/gjReq");
         let GJDecode = require("../misc/GJDecode.js");
         const { decodeSearchResults } = new GJDecode;
-        let playerID=username;
+        let playerID = username;
         if (isNaN(username)) {
-            let search = await gjReq("getGJUsers20", {
-                str: username,
-                secret: "Wmfd2893gb7"
-            });
-            if (search.data == -1) return [];
+            let search = await gjReq("getGJUsers20", { str: username });
+            if (search.data == -1) throw new Error(`-1: Player "${username}" not found`);
             playerID = search.data.split(":")[3];
         }
 
         const res = await gjReq("getGJLevels21", {
             type: 5,
             str: playerID,
-            secret: "Wmfd2893gb7",
             page: Number(page) - 1
         });
         if (res.data == -1) return [];

package/functions/getWeeklyDemon.js

@@ -1,11 +1,11 @@
 module.exports = {
     /**
      * Gets the current weekly demon.
-     * @returns {import("./dlLevel").Level}
+     * @returns {import("./downloadLevel").Level}
      */
     getWeeklyDemon: async function () {
-        const { dlLevel } = require("./dlLevel");
-        let res = await dlLevel(-2);
+        const { downloadLevel } = require("./downloadLevel");
+        let res = await downloadLevel(-2);
         return res;
     }
 }

package/functions/removeFriend.js

@@ -0,0 +1,33 @@
+module.exports = {
+    /**
+     * Removes a friend.
+     * @param {string} target - The friend to be removed.
+     * @param {string} username - The removing person's username or player ID.
+     * @param {string} password - The removing person's password.
+     * @returns {number} Returns 1 if everything's OK, or -1 if something went wrong.
+     */
+    removeFriend: async function (target, username, password) {
+        if (!target) throw new Error("Please provide the target's player ID or username!");
+        if (!username) throw new Error("Please provide the player ID or username!");
+        if (!password) throw new Error("Please provide the password!");
+
+        const { gjReq } = require("../misc/gjReq");
+        const { gjp2 } = require("../misc/gjp2");
+
+        let userSearch = await gjReq("getGJUsers20", { str: username });
+        if (userSearch.data == -1) throw new Error(`-1: Player with the ID or player username "${username}" not found`);
+        let userAccID = userSearch.data.split(":")[23];
+
+        let recSearch = await gjReq("getGJUsers20", { str: target });
+        if (recSearch.data == -1) throw new Error(`-1: Player with the ID or player username "${target}" not found`);
+        let targetAccID = recSearch.data.split(":")[23];
+
+        let res = await gjReq("removeGJFriend20", {
+            targetAccountID: targetAccID,
+            accountID: userAccID,
+            gjp2: gjp2(password)
+        });
+
+        return Number(res.data);
+    }
+}

package/functions/reportLevel.js

@@ -2,16 +2,13 @@ module.exports = {
     /**
      * Reports a level.
      * @param {number} level - The level ID.
-     * @returns {1} - Always returns 1, regardless of whether the level was reported or not.
+     * @returns {1} Always returns 1, regardless of whether the level was reported or not.
      */
     reportLevel: async function (level) {
         if (isNaN(level)) throw new Error("Please provide a valid level ID.");
-        const { gjReq } = require("../gjReq");
+        const { gjReq } = require("../misc/gjReq");
 
-        let res = await gjReq("reportGJLevel", {
-            levelID: level,
-            secret: "Wmfd2893gb7"
-        });
+        let res = await gjReq("reportGJLevel", { levelID: level });
 
         return res.data;
     }

package/functions/searchLevels.js

@@ -6,15 +6,14 @@ module.exports = {
      * @returns {import("./getLevelByID").Level[]}
      */
     searchLevels: async function (query, page = 1) {
-        const { gjReq } = require("../gjReq");
+        const { gjReq } = require("../misc/gjReq");
         let GJDecode = require("../misc/GJDecode");
         const { decodeSearchResults } = new GJDecode;
 
         let res = await gjReq("getGJLevels21", {
             type: 0,
             str: query,
-            page: Number(page) - 1,
-            secret: "Wmfd2893gb7"
+            page: Number(page) - 1
         });
         if (res.data == -1) return [];
 

package/functions/searchLists.js

@@ -13,7 +13,7 @@
  * @property {boolean} disliked - Whether the list is disliked (i.e. if the likes count is less than 0).
  * @property {Array<Number>} levels - The array of level IDs in the list.
  * @property {number} required - The amount of completed levels required to get the reward.
- * @property {number} uploadedUnix - The UNIX timestamp of the list's upload date.
+ * @property {number} uploadedUnix - The Unix timestamp of the list's upload date (GMT timezone).
  */
 
 module.exports = {
@@ -24,13 +24,12 @@ module.exports = {
      * @returns {List[]}
      */
     searchLists: async function (query, page = 1) {
-        const { gjReq } = require("../gjReq");
+        const { gjReq } = require("../misc/gjReq");
         const GJDecode = require("../misc/GJDecode");
         const { decodeLists } = new GJDecode;
         const res = await gjReq("getGJLevelLists", {
             type: 0,
             str: query,
-            secret: "Wmfd2893gb7",
             page: Number(page) - 1
         })
         if (res.data == -1) return [];

package/functions/unblockUser.js

@@ -1,43 +1,33 @@
 module.exports = {
     /**
      * Unblocks a specified user.
-     * @param {string} target - The player that needs to be unblocked.
+     * @param {string} target - The player to be unblocked.
      * @param {string} username - The unblocking person's username or player ID.
      * @param {string} password - The unblocking person's password.
-     * @returns {number} Returns 1 if everything's OK, and -1 if something went wrong.
+     * @returns {number} Returns 1 if everything's OK, or -1 if something went wrong.
      */
     unblockUser: async function (target, username, password) {
-        if (!target) throw new Error("Please provide a target's player ID or username!");
-        if (!username) throw new Error("Please provide a player ID or username!");
-        if (!password) throw new Error("Please provide a password!");
+        if (!target) throw new Error("Please provide the target's player ID or username!");
+        if (!username) throw new Error("Please provide the player ID or username!");
+        if (!password) throw new Error("Please provide the password!");
 
-        const { gjReq } = require("../gjReq");
-        const XOR = require("../xor");
-        const xor = new XOR;
+        const { gjReq } = require("../misc/gjReq");
+        const { gjp2 } = require("../misc/gjp2");
 
-        let userSearch = await gjReq("getGJUsers20", {
-            str: username,
-            secret: "Wmfd2893gb7"
-        });
-        if (userSearch.data == -1) throw new Error(-1);
-        let userAccID = userSearch.data.split(":")[21];
+        let userSearch = await gjReq("getGJUsers20", { str: username });
+        if (userSearch.data == -1) throw new Error(`-1: Player with the ID or player username "${username}" not found`);
+        let userAccID = userSearch.data.split(":")[23];
 
-        let recSearch = await gjReq("getGJUsers20", {
-            str: target,
-            secret: "Wmfd2893gb7"
-        });
-        if (recSearch.data == -1) throw new Error(-1);
-        let targetAccID = recSearch.data.split(":")[21];
+        let recSearch = await gjReq("getGJUsers20", { str: target });
+        if (recSearch.data == -1) throw new Error(`-1: Player with the ID or player username "${target}" not found`);
+        let targetAccID = recSearch.data.split(":")[23];
 
-        const data = {
-            secret: "Wmfd2893gb7",
+        let res = await gjReq("unblockGJUser20", {
             targetAccountID: targetAccID,
             accountID: userAccID,
-            gjp: xor.encrypt(password, 37526)
-        }
-
-        let res = await gjReq("unblockGJUser20", data);
+            gjp2: gjp2(password)
+        });
 
-        return res.data;
+        return Number(res.data);
     }
 }

package/functions/updateAccountSettings.js

@@ -0,0 +1,75 @@
+/**
+ * @typedef {Object} AccountSettings
+ * @property {("all"|"friends"|"none")?} messages - Who the player allows messages from. Set to "all" to allow messages from everyone, "friends" to make messaging limited to friends, or "none" to disable messaging altogether.
+ * @property {Boolean?} friendRequests - Whether the player allows friend requests.
+ * @property {("all"|"friends"|"none")?} commentHistory - Who the player allows to view their comments. Set to "all" to allow everyone, "friends" to limit it to friends, or "none" to limit it to yourself.
+ * @property {string} youtube - The player's YouTube channel ID/handle, used in this template: `https://youtube.com/@((youtube))` or `https://youtube.com/channel/((youtube))` (only if the provided value starts with UC). Be careful, as not providing this value unsets it on the servers as well.
+ * @property {string} twitter - The player's X (formerly Twitter) username, used in this template: `https://x.com/((twitter))`. Be careful, as not providing this value unsets it on the servers as well.
+ * @property {string} twitch - The player's Twitch username, used in this template: `https://twitch.tv/((twitch))`. Be careful, as not providing this value unsets it on the servers as well.
+ * @property {string} instagram - The player's Instagram username, used in this template: `https://instagram.com/@((instagram))`. Be careful, as not providing this value unsets it on the servers as well.
+ * @property {string} tiktok - The player's TikTok username, used in this template: `https://tiktok.com/@((tiktok))`. Be careful, as not providing this value unsets it on the servers as well.
+ * @property {string} discord - The player's Discord username. Be careful, as not providing this value unsets it on the servers as well.
+ * @property {string} custom - The custom string provided by the player. Be careful, as not providing this value unsets it on the servers as well.
+ */
+
+module.exports = {
+    /**
+     * Updates the account settings.
+     * @param {string} username - The player's username or player ID.
+     * @param {string} password - The player's password.
+     * @param {AccountSettings} settings - The settings to set.
+     * @returns {number} Returns 1 regardless of whether anything was updated, or -1 if something went wrong.
+     */
+    updateAccountSettings: async function (username, password, settings) {
+        if (!username) throw new Error("Please provide the username or the player ID!");
+        if (!password) throw new Error("Please provide the password!");
+
+        const { gjReq } = require("../misc/gjReq");
+        const { gjp2 } = require("../misc/gjp2");
+
+        let search = await gjReq("getGJUsers20", { str: username });
+        if (search.data == -1) throw new Error(`-1: Player with the ID or player username "${username}" not found`);
+        let accID = search.data.split(":")[23];
+
+        const parseAccessIDs = {
+            "all": "0",
+            "friends": "1",
+            "none": "2",
+            "0": "0",
+            "1": "1",
+            "2": "2"
+        };
+
+        const parseBoolean = {
+            "true": "0",
+            "false": "1",
+            "0": "0",
+            "1": "1"
+        };
+
+        let messages = parseAccessIDs[settings.messages?.toString()] || "";
+        let friendRequests = parseBoolean[settings.friendRequests?.toString()] || "";
+        let commentHistory = parseAccessIDs[settings.commentHistory?.toString()] || "";
+
+        const dataObj = {
+            accountID: accID,
+            secret: "Wmfv3899gc9",
+            gjp2: gjp2(password),
+            mS: messages,
+            frS: friendRequests,
+            cS: commentHistory
+        };
+
+        if (settings.youtube) dataObj.yt = settings.youtube;
+        if (settings.twitter) dataObj.twitter = settings.twitter;
+        if (settings.twitch) dataObj.twitch = settings.twitch;
+        if (settings.instagram) dataObj.instagram = settings.instagram;
+        if (settings.tiktok) dataObj.tiktok = settings.tiktok;
+        if (settings.discord) dataObj.discord = settings.discord;
+        if (settings.custom) dataObj.custom = settings.custom;
+
+        let res = await gjReq("updateGJAccSettings20", dataObj);
+
+        return Number(res.data);
+    }
+}