forked from gd-programming/gd.docs
-
Notifications
You must be signed in to change notification settings - Fork 19
/
level.md
120 lines (106 loc) · 17 KB
/
level.md
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
# Client Level Resource
## Level
A level is a playable object in Geometry Dash, namely coming with data that explains on what it is, and the string that the client interprets, known as a level string. It is stored in [XML](https://en.wikipedia.org/wiki/XML) format, and each level entry is a dictionary, containing key/value pairs denoting the level's properties.
### Level Data
**Level Structure**
| Key | Name/Value | Type | Description |
| :-- | :----------------------------- | :--------------------------------------------------------------- | :------------------------------------------------------------------------------- |
| k1 | Level ID | **integer** | the id of the level |
| k2 | Level Name | **string** | the name of the level |
| k3 | Description | **string** | the level description, encoded in [base64](https://en.wikipedia.org/wiki/Base64) |
| k4 | Inner Level String | **[inner level string](/resources/client/level-components/inner-level-string.md)** | the inner level string, or the playable level |
| k5 | Creator | **[user](./user.md)Name** | the name of the level creator |
| k6 | UserID | **integer** | The UserID of the level Creator |
| k7 | level difficulty | **integer** | the difficulty the level has |
| k8 | Official Song ID | **[Audio Track](/reference?id=audio-track)** | the official Song ID (if used) |
| k9 | Rating | **integer** | The rating a level has |
| k10 | RatingSum | **integer** | the sum of all the ratings a level has |
| k11 | Downloads | **integer** | the amount of times the level's been downloaded |
| k12 | setCompletes | **integer** | level completions for that particular level |
| k13 | isEditable | **Bool** | used to stop people editing online and Official levels |
| k14 | Verified | **bool** | whether the level is verified or not |
| k15 | Uploaded | **bool** | whether the level is uploaded to the server or not |
| k16 | Level Version | **integer** | the version of the level |
| k17 | Game Version | **integer** | The Games Version |
| k18 | Attempts | **integer** | the number of attempts that are made to this level |
| k19 | Normal Mode Percentage | **integer** | the max percentage that has been achieved in normal mode in this level |
| k20 | Practice Mode Percentage | **integer** | the max percentage that has been achieved in practice mode in this level |
| k21 | levelType | **Integer** | The Level Type (1 = Official, 2 = Local, 3 = Saved, 4 = Online) |
| k22 | Like Rating | **integer** | the level's like rating (`likes - dislikes`) |
| k23 | Length | **[Length](enumerations.md)** | the level's length |
| k24 | Dislikes | **integer** | how many dislikes a level has (unused) |
| k25 | isDemon | **Bool** | if the level is demon or not |
| k26 | Stars | **integer** | the stars the level is worth |
| k27 | FeatureScore | **integer** | A featured levels Feature Score |
| k33 | Auto | **Bool** | If the level is auto |
| k34 | Replay Data | **[Gziped String](/topics/encryption/zip.md)** | Contains a Gzipped String which contains replay data for levels |
| k35 | isPlayable? | **Bool** | if the level is downloaded (honestly not much is known about this) |
| k36 | Jumps | **integer** | total Jumps on a level |
| k37 | required coins | **Integer** | coins required to unlock an official level |
| k38 | isUnlocked | **Bool** | is Official level Unlocked |
| k39 | level Size | **integer** | `this->levelSize = std::floor(this->levelString.length() * 0.152);` |
| k40 | Build Version | **integer** | the games build version |
| k41 | Password | **integer** | the [password]() <!-- local gamesave password topic link --> set for the level |
| k42 | Original | **integer** | The ID the of the original level (if the level was copied) |
| k43 | Two-Player Mode | **Bool** | If the level is 2 player mode |
| k45 | Custom Song ID | **integer** | the custom Song ID (if used) |
| k46 | Level Revision | **integer** | the revision of the level |
| k47 | hasBeenModified | **Bool** | if the level has been modified from outside the GD editor |
| k48 | Object Count | **integer** | the object count of the level |
| k50 | Binary Version | **integer** | hardcoded to binary Version |
| k51 | capacity001 | **integer** | BatchNodes |
| k52 | capacity002 | **integer** | BatchNodes |
| k53 | capacity003 | **integer** | BatchNodes |
| k54 | capacity004 | **integer** | BatchNodes |
| k60 | AccountID | **integer** | the Creators AccountID |
| k61 | First Coin Acquired | **bool** | whether the first coin is acquired during verification |
| k62 | Second Coin Acquired | **bool** | whether the second coin is acquired during verification |
| k63 | Third Coin Acquired | **bool** | whether the third coin is acquired during verification |
| k64 | Total Coins | **Integer** | How many Coins the level has |
| k65 | areCoinsVerified | **Bool** | denotes if the coins are verified or not |
| k66 | Requested Stars | **integer** | the requested stars during publication of the level |
| k67 | [Capacity String](/resources/client/level-components/capacity-string.md) | **String** | Contains batch information about levels |
| k68 | triggeredAntiCheat | **Bool** | if you trigger the anticheat when beating demons |
| k69 | High Object Count | **Bool** | If a level has a high object count |
| k71 | Mana Orb Percentage | **integer** | the percentage up until the orb reward has been granted |
| k72 | hasLowDetailMode | **Bool** | If a level has LDM |
| k73 | toggleLDM | **Bool** | If a LDM is Enabled |
| k74 | timelyID | **integer** | the timelyID for a level |
| k75 | isEpic | **Bool** | if a level has been awarded an epic rating |
| k76 | demon type | **integer** | Demon Type Enum |
| k77 | isGauntlet | **Bool** | is the level in a gauntlet |
| k78 | isAltGame | **Bool** | Levels that were completed on the free games |
| k79 | Unlisted | **bool** | whether the level is to be marked as unlisted or not during publication |
| k80 | Seconds Spent Editing | **integer** | the number of seconds spent editing the level |
| k81 | Seconds spent Editing (copies) | **integer** | the number of seconds spent editing the level (Previous copies) |
| k82 | isLevelFavourited | **Bool** | if you put the level in your favourites |
| k83 | levelOrder | **integer** | ordering for levels |
| k84 | Level Folder | **integer** | the folder in which the level belongs (0 represents no folder) |
| k85 | Clicks | **integer** | Clicks done on the best attempt |
| k86 | Player Time | **integer** | the amount of time on a players best attempt |
| k87 | level Seed | **[LevelScoreSeed](/topics/encryption/chk?id=level-leaderboard)**| Contains info to verify the integrity of levelScores |
| k88 | Level Progress | **String** | Contains a list of high score differences seperated by a `,` |
| k89 | vfDChk | **Bool** | used to check for level completion |
| k90 | Leaderboard percentage | **integer** | Contains the percentage for level Leaderboards |
**Last Editor State Key/Value Pairs**
The last editor state key/value pairs contain a few values that indicate the last state of the editor before exiting the editor on that level.
| Key | Name/Value | Type | Description |
| :-- | :----------------------- | :------------- | :--------------------------------------- |
| kI1 | Editor Camera X Position | **float** | the X position of the editor camera |
| kI2 | Editor Camera Y Position | **float** | the Y position of the editor camera |
| kI3 | Editor Camera Zoom | **float** | the zoom level of the editor camera |
| kI4 | Build Tab Page | **integer** | the displayed page within the build tab |
| kI5 | Build Tab | **integer** | the selected build tab |
| kI6 | Build Tab Pages | **dictionary** | the last browsed pages of each build tab |
| kI7 | Editor Layer | **float** | the last selected index of a layer |
Note that the build tab pages do not depend on the user's button row/column settings. That means, if the settings are changed, the build tab pages will not reflect the correct changes. For example:
The build tab page is 5, and the button settings are 6x2 (default), meaning the currently shown elements range from `5 * 6 * 2` = 60 to `6 * 6 * 2 - 1` = 71 (zero-indexed). If the user changes the button settings to 12x3, the tab page will remain as 5, showing elements ranging from `5 * 12 * 3` = 180 to `6 * 12 * 3 - 1` = 215 (zero-indexed).
### GDL22
<!-- from what i gathered, there doesnt seem to be any code that triggers these yet-->
**Current Unknown Values**
| Key | Type | Info |
| :-- | :---------- | :------------------------------------------------------- |
| k91 | **string** | |
| k92 | **integer** | |
| k93 | **Bool** | unlimited Objects? |
| k94 | **Bool** | Platformer? |