Skip to content

Commit c891b75

Browse files
committed
indents, more getPlayer examples
1 parent 0a02515 commit c891b75

File tree

3 files changed

+88
-73
lines changed

3 files changed

+88
-73
lines changed

src/Client.js

Lines changed: 17 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -51,14 +51,28 @@ class Client {
5151
* @param {PlayerMethodOptions} [options={}] Method options
5252
* @return {Promise<Player>}
5353
* @example
54-
* // { guild: true } - fetch player's guild
55-
* hypixel.getPlayer('StavZDev', { guild: true }).then(player => {
54+
* hypixel.getPlayer('StavZDev').then(player => {
5655
* console.log(player.level); // 141
5756
* console.log(player.rank); // 'MVP+'
58-
* console.log(player.guild); // null (player is not in guild)
5957
* }).catch(e => {
6058
* console.log(e);
6159
* })
60+
* @example
61+
* // Get player's guild along with player stats
62+
* hypixel.getPlayer('Minikloon').then(player => {
63+
* console.log(player.guild) // null if player isn't is guild
64+
* console.log(player.guild.name) // Mini Squid
65+
* console.log(player.guild.level) // 110
66+
* }).catch(e => {
67+
* console.log(e);
68+
* });
69+
* @example
70+
* // async/await
71+
* const player = await hypixel.getPlayer('Minikloon').catch(console.log);
72+
* // If player doesn't exist
73+
* console.log(player); // null
74+
*
75+
* console.log(player.uuid); // 20934ef9488c465180a78f861586b4cf
6276
*/
6377
/**
6478
* Allows you to get statistics of hypixel guild

src/structures/Player.js

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -102,7 +102,8 @@ class Player {
102102
*/
103103
this.prefixColor = this.rank === 'MVP++' ? (data.monthlyRankColor ? new Color(data.monthlyRankColor) : new Color('GOLD')) : null;
104104
/**
105-
* Player's guild. Guild option must be `true`
105+
* Player's guild. Guild option must be `true`. <br>
106+
* Example: {@link Client#getPlayer}
106107
* @type {Guild}
107108
*/
108109
this.guild = data.guild ? data.guild : null;

src/structures/SkyBlock/SkyblockMember.js

Lines changed: 69 additions & 69 deletions
Original file line numberDiff line numberDiff line change
@@ -25,54 +25,54 @@ class SkyblockMember {
2525
*/
2626
this.player = data.m.player || null;
2727
/**
28-
* Skyblock member's profile name
29-
* @type {string}
30-
*/
28+
* Skyblock member's profile name
29+
* @type {string}
30+
*/
3131
this.profileName = data.profileName;
3232
/**
33-
* Timestamp when player first joined SkyBlock
34-
* @type {number}
35-
*/
33+
* Timestamp when player first joined SkyBlock
34+
* @type {number}
35+
*/
3636
this.firstJoinTimestamp = data.m.first_join;
3737
/**
38-
* Timestamp when player first joined SkyBlock as Date
39-
* @type {Date}
40-
*/
38+
* Timestamp when player first joined SkyBlock as Date
39+
* @type {Date}
40+
*/
4141
this.firstJoinAt = new Date(data.m.first_join);
4242
/**
43-
* Timestamp when player first joined the SkyBlock Hub
44-
* @type {number}
45-
*/
43+
* Timestamp when player first joined the SkyBlock Hub
44+
* @type {number}
45+
*/
4646
this.firstJoinHubTimestamp = data.m.first_join_hub;
4747
/**
48-
* Timestamp when player first joined the SkyBlock Hub as Date
49-
* @type {Date}
50-
*/
48+
* Timestamp when player first joined the SkyBlock Hub as Date
49+
* @type {Date}
50+
*/
5151
this.firstJoinHubAt = new Date(data.m.first_join_hub);
5252
/**
53-
* Last save timestamp
54-
* @type {number}
55-
*/
53+
* Last save timestamp
54+
* @type {number}
55+
*/
5656
this.lastSave = data.m.last_save;
5757
/**
58-
* Last save timestamp as Date
59-
* @type {Date}
60-
*/
58+
* Last save timestamp as Date
59+
* @type {Date}
60+
*/
6161
this.lastSaveAt = new Date(data.m.last_save);
6262
/**
63-
* Last death timestamp as Date
64-
* @type {Date}
65-
*/
63+
* Last death timestamp as Date
64+
* @type {Date}
65+
*/
6666
this.lastDeathAt = new Date(skyblock_year_0 + data.m.last_death * 1000);
6767
/**
68-
* Last save timestamp
69-
* @type {number}
70-
*/
68+
* Last save timestamp
69+
* @type {number}
70+
*/
7171
this.lastDeath = data.m.last_death;
7272
/**
73-
* Equipped armor
74-
* @return {Promise<SkyblockMemberArmor>}
75-
*/
73+
* Equipped armor
74+
* @return {Promise<SkyblockMemberArmor>}
75+
*/
7676
this.getArmor = async () => {
7777
const base64 = data.m.inv_armor;
7878
const decoded = await decode(base64.data);
@@ -85,39 +85,39 @@ class SkyblockMember {
8585
return armor;
8686
};
8787
/**
88-
* Collected fairy souls
89-
* @type {number}
90-
*/
88+
* Collected fairy souls
89+
* @type {number}
90+
*/
9191
this.fairySouls = data.m.fairy_souls_collected || 0;
9292
/**
93-
* Amount of fairy soul exchanges
94-
* @type {number}
95-
*/
93+
* Amount of fairy soul exchanges
94+
* @type {number}
95+
*/
9696
this.fairyExchanges = data.m.fairyExchanges || 0;
9797
/**
98-
* Skyblock member skills
99-
* @type {SkyblockMemberSkills}
100-
*/
98+
* Skyblock member skills
99+
* @type {SkyblockMemberSkills}
100+
*/
101101
this.skills = getSkills(data.m);
102102
/**
103-
* Skyblock member slayer
104-
* @type {SkyblockMemberSlayer|null}
105-
*/
103+
* Skyblock member slayer
104+
* @type {SkyblockMemberSlayer|null}
105+
*/
106106
this.slayer = getSlayer(data.m);
107107
/**
108-
* Skyblock member dungeons
109-
* @type {SkyblockMemberDungeons|null}
110-
*/
108+
* Skyblock member dungeons
109+
* @type {SkyblockMemberDungeons|null}
110+
*/
111111
this.dungeons = getDungeons(data.m);
112112
/**
113-
* Skyblock member collections
114-
* @type {object}
115-
*/
113+
* Skyblock member collections
114+
* @type {object}
115+
*/
116116
this.collections = data.m.collection ? data.m.collection : null;
117117
/**
118-
* Skyblock member enderchest
119-
* @return {Promise<SkyblockInventoryItem[]>}
120-
*/
118+
* Skyblock member enderchest
119+
* @return {Promise<SkyblockInventoryItem[]>}
120+
*/
121121
this.getEnderChest = async () => {
122122
const chest = data.m.ender_chest_contents;
123123
if (!chest) return [];
@@ -138,9 +138,9 @@ class SkyblockMember {
138138
}
139139
};
140140
/**
141-
* Skyblock member inventory
142-
* @return {Promise<SkyblockInventoryItem[]>}
143-
*/
141+
* Skyblock member inventory
142+
* @return {Promise<SkyblockInventoryItem[]>}
143+
*/
144144
this.getInventory = async () => {
145145
let inventory = data.m.inv_contents;
146146
if (!inventory) return [];
@@ -160,32 +160,32 @@ class SkyblockMember {
160160
}
161161
};
162162
/**
163-
* Skyblock coins in purse
164-
* @type {number}
165-
*/
163+
* Skyblock coins in purse
164+
* @type {number}
165+
*/
166166
this.purse = data.m.purse || 0;
167167
/**
168-
* Skyblock member stats
169-
* @type {SkyblockMemberStats}
170-
*/
168+
* Skyblock member stats
169+
* @type {SkyblockMemberStats}
170+
*/
171171
this.stats = data.m.stats ? single(data.m.stats) : null;
172172
/**
173-
* Skyblock pets
174-
* @type {SkyblockPet[]}
175-
*/
173+
* Skyblock pets
174+
* @type {SkyblockPet[]}
175+
*/
176176
this.pets = data.m.pets ? data.m.pets.map((pet) => new SkyblockPet(pet)) : [];
177177
}
178178
/**
179-
* Skyblock Member pet score
180-
* @return {number}
181-
*/
179+
* Skyblock Member pet score
180+
* @return {number}
181+
*/
182182
getPetScore () {
183183
return this.pets.reduce((acc, cur) => acc + (cur.petScore || 0), 0);
184184
}
185185
/**
186-
* UUID
187-
* @return {string}
188-
*/
186+
* UUID
187+
* @return {string}
188+
*/
189189
toString () {
190190
return this.uuid;
191191
}

0 commit comments

Comments
 (0)