Node.js library for interacting with Geometry Dash servers. Every single endpoint is implemented, but currently not tested very well.
This library is a work in progress. In the future it will also include tools for level string creation and save file reading/writing.
Support for versions below 2.2 is very limited at the moment. Support for GDPSes is provided, but certain GDPSes also may not work out of the box.
Example (getting the first page of auto levels):
import * as gd from "dashtools";
// Only the first 3 are required for most endpoints, however some need the username and/or UDID too
const client = new gd.GDClient(new gd.GDAccount(playerID, accountID, password, username, udid));
client.getLevels({
difficulties: [gd.constants.DIFFICULTIES.AUTO]
}, (data) => {
console.log(data.levels)
})This class represents a logged into GD account.
new gd.GDAccount(playerID, accountID, password, username, udid);All parameters can be left blank if you don't wish to log in. The username and udid fields are not required for most endpoints.
playerID - Your player/user ID. You can find this ID on GDBrowser.
accountID - Your account ID. You can find this ID on GDBrowser.
password - Your account password.
username - Your username.
udid - Your UDID. This can be found in your save file.
This class represents a GD server client.
new gd.GDClient(new gd.GDAccount(playerID, accountID, password, username, udid), serverURL, );This object contains all the constants.
Default values for every endpoint.
export const DEFAULT_ENDPOINTS = {
"getLevels": "getGJLevels21.php",
"getDailyLevel": "getGJDailyLevel.php",
"getMapPacks": "getGJMapPacks21.php",
"getGauntlets": "getGJGauntlets21.php",
"downloadLevel": "downloadGJLevel22.php",
"reportLevel": "reportGJLevel.php",
"getUsers": "getGJUsers20.php",
"getUserInfo": "getGJUserInfo20.php",
"getAccountComments": "getGJAccountComments20.php",
"getComments": "getGJComments21.php",
"registerAccount": "accounts/registerGJAccount.php",
"loginAccount": "accounts/loginGJAccount.php",
"getCommentHistory": "getGJCommentHistory.php",
"getSongInfo": "getGJSongInfo.php",
"updateUserScore": "updateGJUserScore22.php",
"getRewards": "getGJRewards.php",
"requestModAccess": "requestUserAccess.php",
"getLeaderboards": "getGJScores20.php",
"deleteLevel": "deleteGJLevelUser20.php",
"uploadAccountComment": "uploadGJAccComment20.php",
"deleteAccountComment": "deleteGJAccComment20.php",
"uploadComment": "uploadGJComment21.php",
"deleteComment": "deleteGJComment20.php",
"getTopArtists": "getGJTopArtists.php",
"getLists": "getGJLevelLists.php",
"likeItem": "likeGJItem211.php",
"rateLevel": "rateGJStars211.php",
"rateDemon": "rateGJDemon21.php",
"updateDescription": "updateGJDesc20.php",
"uploadLevel": "uploadGJLevel21.php",
"deleteLevel": "deleteGJLevelUser20.php",
"getUserList": "getGJUserList20.php",
"loadSaveData": "accounts/syncGJAccountNew.php",
"updateAccountSettings": "updateGJAccSettings20.php",
"getMessages": "getGJMessages20.php",
"readMessage": "downloadGJMessage20.php",
"sendMessage": "uploadGJMessage20.php",
"deleteMessage": "deleteGJMessages20.php",
"blockUser": "blockGJUser20.php",
"unblockUser": "unblockGJUser20.php",
"deleteFriendRequests": "deleteGJFriendRequests20.php",
"sendFriendRequest": "uploadFriendRequest20.php",
"getFriendRequests": "getGJFriendRequests20.php",
"readFriendRequest": "readGJFriendRequest20.php",
"acceptFriendRequest": "acceptGJFriendRequest20.php",
"removeFriend": "removeGJFriend20.php",
"uploadList": "uploadGJLevelList.php",
"deleteList": "deleteGJLevelList.php",
"getAccountURL": "getAccountURL.php",
"getLevelLeaderboards": "getGJLevelScores211.php",
"getPlatformerLevelLeaderboards": "getGJLevelScoresPlat.php",
"backupSaveData": "backupGJAccountNew.php",
"getContentURL": "getCustomContentURL.php",
"musicLibraryVersion": "music/musiclibrary_version_02.txt",
"musicLibraryVersionOld": "music/musiclibrary_version.txt",
"sfxLibraryVersion": "sfx/sfxlibrary_version.txt",
"musicLibrary": "music/musiclibrary_02.dat",
"musicLibraryOld": "music/musiclibrary.dat",
"sfxLibrary": "sfx/sfxlibrary.dat",
"getChallenges": "getGJChallenges.php"
}Default request headers for 2.1.
export const DEFAULT_HEADERS_21 = {
"User-Agent": "",
"Accept": "*/*",
"Content-Type": "application/x-www-form-urlencoded"
}Default request headers for 2.2.
export const DEFAULT_HEADERS_22 = {
"User-Agent": "",
"Accept": "*/*",
"Content-Type": "application/x-www-form-urlencoded",
"Cookie": "gd=1;",
"Host": "www.boomlings.com"
}Default URL for account management endpoints.
https://www.robtopgames.org/database
Default URL for the Music & SFX libraries.
https://geometrydashfiles.b-cdn.net
Default URL for most endpoints.
https://www.boomlings.com/database
Default URL for most endpoints (2.1).
http://www.boomlings.com/database
All possible difficulty values for levels and lists.
AUTO = -1
NA = 0
EASY = 1
NORMAL = 2
HARD = 3
HARDER = 4
INSANE = 5
EASY_DEMON = 6
MEDIUM_DEMON = 7
HARD_DEMON = 8
INSANE_DEMON = 9
EXTREME_DEMON = 10
Default endpoints for 2.100.
Default endpoints for 2.113.
Default endpoints for 2.205.
Character set for hexadecimal values.
"abcdef1234567890".split("")
All icon types.
CUBE = 0
ICON = 0
SHIP = 1
BALL = 2
BIRD = 3
UFO = 3
WAVE = 4
DART = 4
ROBOT = 5
SPIDER = 6
SWING = 7
SWINGCOPTER = 7
JETPACK = 8
All possible chest reward items.
FIRE = 1
ICE = 2
POISON = 3
SHADOW = 4
LAVA = 5
KEY = 6
EARTH = 10
BLOOD = 11
METAL = 12
LIGHT = 13
SOUL = 14
All XOR keys used throughout Geometry Dash.
export const KEYS = {
SAVE_DATA: "\x0B",
MESSAGES: "14251",
VAULT_CODES: "19283",
CHALLENGES: "19847",
LEVEL_PASSWORD: "26364",
COMMENT: "29481",
ACCOUNT_PASSWORD: "37526",
LEVEL_LEADERBOARD: "39673",
LEVEL: "41274",
LOAD_DATA: "48291",
RATE: "58281",
CHEST_REWARDS: "59182",
STAT_SUBMISSION: "85271"
}All possible level lengths.
TINY = 0
SHORT = 1
MEDIUM = 2
LONG = 3
XL = 4
PLATFORMER = 5
The hash that is always returned by the getGJLevelLists endpoint (as of 2.206).
"f5da5823d94bbe7208dd83a30ff427c7d88fdb99"
Character set for RS (random string) values.
"QWERTYUIOPASDFGHJKLZXCVBNMqwertyuiopasdfghjklzxcvbnm1234567890".split("")
All salts used in various SHA1 operations.
LEVEL = "xI25fpAapCQg"
COMMENT = "xPT6iUrtws0J"
GJP2 = "mI29fmAnxgTs"
STAT_SUBMISSION = "xI35fsAapCRg"
LIKE_OR_RATE = "ysg6pUrtjn0J"
LEVEL_LEADERBOARDS = "yPg6pUrtWn0J"
REWARDS = "pC26fpYaQCtg"
CHALLENGES = "oC36fpYaPtdg"
All values for the secret parameter, which is sent in almost every request.
COMMON = "Wmfd2893gb7"
ACCOUNT = "Wmfv3899gc9"
DELETE = "Wmfv2898gc9"
MOD = "Wmfp3879gc3"
ADMIN = "Wmfx2878gb9"
Possible leaderboard types for getLeaderboards.
TOP = "top"
RELATIVE = "relative"
FRIENDS = "friends"
CREATORS = "creators"
Various version values.
export const VERSIONS = {
gameVersion: 22,
binaryVersion: 42
}
export const VERSIONS_2_205 = {
gameVersion: 22,
binaryVersion: 41
}
export const VERSIONS_2_204 = {
gameVersion: 22,
binaryVersion: 40
}
export const VERSIONS_2_200 = {
gameVersion: 22,
binaryVersion: 37
}
export const VERSIONS_2_113 = {
gameVersion: 21,
binaryVersion: 35
}
export const VERSIONS_2_111 = {
gameVersion: 21,
binaryVersion: 34
}
export const VERSIONS_2_100 = {
gameVersion: 21,
binaryVersion: 33
}
export const VERSIONS_2_011 = {
gameVersion: 20,
binaryVersion: 29
}
export const VERSIONS_2_000 = {
gameVersion: 20,
binaryVersion: 27
}
export const VERSIONS_1_930 = {
gameVersion: 19,
binaryVersion: 25
}Various utility functions for Geometry Dash.
Returns a random number between min and max.
Encodes a string as a GJP. (outdated as of 2.2)
Encrypts a string with GJP2 encryption.
Returns the MD5 hash for the string.
Returns the MD5 hash for the string as a Buffer.
Splits a string on every second instance of the separator, and then the split strings get converted into a Map, where the first value is the key, and the second is the value.
Same as robTopSplit, but generates an Object.
Returns the SHA-1 hash for the string.
XOR's the string using the key.
