hypixel-api-reborn 9.0.3 → 10.0.0

package/README.md

@@ -47,7 +47,7 @@ hypixel.getGuild('name', 'The Foundation').then(guild => {
 ```
 For more examples go to our [documentation](https://hypixel.stavzdev.me/).
 ## Changelog
-[v9.0.3](https://github.com/Hypixel-API-Reborn/hypixel-api-reborn/releases/tag/9.0.3)
+[v10.0.0](https://github.com/Hypixel-API-Reborn/hypixel-api-reborn/releases/tag/10.0.0)
 
 ### Try it now
 **[Code Sandbox](https://codesandbox.io/s/clever-babbage-xqmfw?file=/src/index.js)**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hypixel-api-reborn",
-  "version": "9.0.3",
+  "version": "10.0.0",
   "description": "Feature-rich Hypixel API wrapper for Node.js",
   "main": "./src/index.js",
   "types": "./typings/index.d.ts",

package/src/API/getAPIStatus.js

@@ -1,7 +1,8 @@
 const Rss = require('rss-parser');
 const Parser = new Rss();
-module.exports = async function () {
+module.exports = async function (options) {
   const Status = require('../structures/APIStatus.js');
   const parsed = await Parser.parseURL('https://status.hypixel.net/history.rss');
+  if (options.raw) return parsed;
   return new Status(parsed);
 };

package/src/API/getBoosters.js

@@ -1,5 +1,6 @@
 module.exports = async function () {
   const Booster = require('../structures/Boosters/Booster');
   const res = await this._makeRequest('/boosters');
+  if (res.raw) return res;
   return res.boosters.length ? res.boosters.map((b) => new Booster(b)).reverse() : [];
 };

package/src/API/getFriends.js

@@ -5,6 +5,7 @@ module.exports = async function (query) {
   const Friend = require('../structures/Friend');
   query = await toUuid(query);
   const res = await this._makeRequest(`/friends?uuid=${query}`);
+  if (res.raw) return res;
   if (res.records.length && res.records.length > 0) {
     return res.records.map((f) => new Friend(f, query));
   } else {

package/src/API/getGameCounts.js

@@ -1,5 +1,6 @@
 const GameCounts = require('../structures/GameCounts');
 module.exports = async function () {
   const res = await this._makeRequest('/counts');
+  if (res.raw) return res;
   return new GameCounts(res);
 };

package/src/API/getGuild.js

@@ -9,6 +9,7 @@ module.exports = async function (searchParameter, query) {
   if (isPlayerQuery) query = await toUuid(query);
   if (!['id', 'name', 'player'].includes(searchParameter)) throw new Error(Errors.INVALID_GUILD_SEARCH_PARAMETER);
   const res = await this._makeRequest(`/guild?${searchParameter}=${encodeURI(query)}`);
+  if (res.raw) return res;
   if (!res.guild && searchParameter !== 'player') {
     throw new Error(Errors.GUILD_DOES_NOT_EXIST);
   }

package/src/API/getKeyInfo.js

@@ -2,6 +2,7 @@ const Errors = require('../Errors');
 module.exports = async function () {
   const KeyInfo = require('../structures/KeyInfo');
   const res = await this._makeRequest('/key');
+  if (res.raw) return res;
   if (!res.success) {
     throw new Error(Errors.SOMETHING_WENT_WRONG.replace(/{cause}/, res.cause));
   }

package/src/API/getLeaderboards.js

@@ -2,6 +2,7 @@ const Errors = require('../Errors');
 module.exports = async function () {
   const Leaderboard = require('../structures/Leaderboard');
   const res = await this._makeRequest('/leaderboards');
+  if (res.raw) return res;
   if (!res.leaderboards) throw new Error(Errors.SOMETHING_WENT_WRONG.replace(/{cause}/, 'Try again.'));
   const lbnames = Object.create(require('../utils/Constants').leaderboardNames);
   // eslint-disable-next-line guard-for-in

package/src/API/getPlayer.js

@@ -8,6 +8,7 @@ module.exports = async function (query, options = { guild: false, recentGames: f
   const Player = require('../structures/Player');
   query = await toUuid(query);
   const res = await this._makeRequest(`/player?uuid=${query}`);
+  if (res.raw) return res;
   if (query && !res.player) throw new Error(Errors.PLAYER_HAS_NEVER_LOGGED);
   let guild = null;
   let recentGames = null;
@@ -22,5 +23,5 @@ module.exports = async function (query, options = { guild: false, recentGames: f
     rankedSW = getRankedSkyWars.call(this, query);
   }
   [guild, recentGames, rankedSW] = await Promise.all([guild, recentGames, rankedSW]);
-  return new Player(res.player, {guild, recentGames, rankedSW});
+  return new Player(res.player, { guild, recentGames, rankedSW });
 };

package/src/API/getRankedSkyWars.js

@@ -5,6 +5,7 @@ module.exports = async function (query) {
   const SkyWarsRanked = require('../structures/MiniGames/SkyWarsRanked');
   query = await toUuid(query);
   const res = await this._makeRequest(`/player/ranked/skywars?uuid=${query}`);
+  if (res.raw) return res;
   if (!res.result) return null;
   return new SkyWarsRanked(res.result);
 };

package/src/API/getRecentGames.js

@@ -8,6 +8,7 @@ module.exports = async function (query, playerData) {
   query = await toUuid(query);
 
   const res = await this._makeRequest(`/recentgames?uuid=${query}`);
+  if (res.raw) return res;
   if (res.games === []) {
     if (!playerData) throw new Error(Errors.PLAYER_IS_INACTIVE);
     if (Date.now() - playerData.lastLogoutTimestamp < day3) throw new Error(Errors.PLAYER_DISABLED_ENDPOINT);

package/src/API/getStatus.js

@@ -3,5 +3,6 @@ module.exports = async function (query) {
   const Status = require('../structures/Status');
   query = await toUuid(query);
   const res = await this._makeRequest(`/status?uuid=${query}`);
+  if (res.raw) return res;
   return new Status(res.session);
 };

package/src/API/getWatchdogStats.js

@@ -1,5 +1,6 @@
 module.exports = async function () {
   const WatchdogStats = require('../structures/Watchdog/Stats');
   const res = await this._makeRequest('/punishmentstats');
+  if (res.raw) return res;
   return new WatchdogStats(res);
 };

package/src/API/index.js

@@ -1,9 +1,23 @@
-/* eslint-disable no-extend-native */
-const fs = require('fs');
-// eslint-disable-next-line no-path-concat
-const curDir = __dirname + '/';
-module.exports = Array.from(fs.readdirSync(curDir, { withFileTypes: true }))
-  .filter((x) => x.name !== 'index.js')
-  .map((x) => x.isDirectory() ? Array.from(fs.readdirSync(curDir + x.name)).map((y) => ([y.split('.')[0], x.name + '/' + y])) : [[x.name.split('.')[0], x.name]])
-  .flat(1)
-  .reduce((pV, cV) => Object.assign(pV, { [cV[0]]: require(curDir + cV[1]) }), {});
+module.exports = {
+  getAPIStatus: require('./getAPIStatus'),
+  getBoosters: require('./getBoosters'),
+  getFriends: require('./getFriends'),
+  getGameCounts: require('./getGameCounts'),
+  getGuild: require('./getGuild'),
+  getKeyInfo: require('./getKeyInfo'),
+  getLeaderboards: require('./getLeaderboards'),
+  getPlayer: require('./getPlayer'),
+  getRankedSkyWars: require('./getRankedSkyWars'),
+  getRecentGames: require('./getRecentGames'),
+  getServerInfo: require('./getServerInfo'),
+  getStatus: require('./getStatus'),
+  getWatchdogStats: require('./getWatchdogStats'),
+
+  getEndedSkyblockAuctions: require('./skyblock/getEndedSkyblockAuctions'),
+  getSkyblockAuctions: require('./skyblock/getSkyblockAuctions'),
+  getSkyblockAuctionsByPlayer: require('./skyblock/getSkyblockAuctionsByPlayer'),
+  getSkyblockBazaar: require('./skyblock/getSkyblockBazaar'),
+  getSkyblockMember: require('./skyblock/getSkyblockMember'),
+  getSkyblockNews: require('./skyblock/getSkyblockNews'),
+  getSkyblockProfiles: require('./skyblock/getSkyblockProfiles')
+};

package/src/API/skyblock/getEndedSkyblockAuctions.js

@@ -2,6 +2,7 @@ const PartialAuction = require('../../structures/SkyBlock/Auctions/PartialAuctio
 const AuctionInfo = require('../../structures/SkyBlock/Auctions/AuctionInfo');
 module.exports = async function (includeItemBytes = false) {
   const res = await this._makeRequest('/skyblock/auctions_ended', false);
+  if (res.raw) return res;
   return {
     info: new AuctionInfo({ ...res, totalAuctions: res.auctions.length, totalPages: 1 }),
     auctions: res.auctions.length ? res.auctions.map((a) => new PartialAuction(a, includeItemBytes)) : []

package/src/API/skyblock/getSkyblockAuctionsByPlayer.js

@@ -5,6 +5,7 @@ module.exports = async function (query, includeItemBytes = false) {
   const Auction = require('../../structures/SkyBlock/Auctions/Auction');
   query = await toUuid(query);
   const res = await this._makeRequest(`/skyblock/auction?player=${query}`);
+  if (res.raw) return res;
 
   return res.auctions.length ? res.auctions.map((a) => new Auction(a, includeItemBytes)) : [];
 };

package/src/API/skyblock/getSkyblockBazaar.js

@@ -2,6 +2,7 @@ module.exports = async function () {
   const Product = require('../../structures/SkyBlock/Bazzar/Product');
 
   const res = await this._makeRequest('/skyblock/bazaar');
+  if (res.raw) return res;
 
   const productsKeys = Object.keys(res.products);
 

package/src/API/skyblock/getSkyblockMember.js

@@ -6,6 +6,7 @@ module.exports = async function (query, options = { fetchPlayer: false }) {
   if (!query) throw new Error(Errors.NO_NICKNAME_UUID);
   query = await toUuid(query);
   const res = await this._makeRequest(`/skyblock/profiles?uuid=${query}`);
+  if (res.raw) return res;
   if (!res.profiles || !res.profiles.length) {
     return new Map();
   }

package/src/API/skyblock/getSkyblockNews.js

@@ -1,5 +1,6 @@
 const SkyblockNews = require('../../structures/SkyBlock/News/SkyblockNews');
 module.exports = async function () {
   const res = await this._makeRequest('/skyblock/news');
+  if (res.raw) return res;
   return res.items.map((i) => new SkyblockNews(i));
 };

package/src/API/skyblock/getSkyblockProfiles.js

@@ -6,6 +6,7 @@ module.exports = async function (query, options = { fetchPlayer: false }) {
   if (!query) throw new Error(Errors.NO_NICKNAME_UUID);
   query = await toUuid(query);
   const res = await this._makeRequest(`/skyblock/profiles?uuid=${query}`);
+  if (res.raw) return res;
 
   if (!res.profiles || !res.profiles.length) {
     return [];

package/src/Client.js

@@ -2,7 +2,7 @@
 /* eslint-disable max-len */
 const validate = new (require('./Private/validate'))();
 const rateLimit = new (require('./Private/rateLimit'))();
-const requests = new (require('./Private/requests'))();
+const Requests = require('./Private/requests');
 const updater = new (require('./Private/updater'))();
 const Errors = require('./Errors');
 const API = require('./API/index');
@@ -18,6 +18,7 @@ class Client extends EventEmitter {
    */
   constructor (key, options = {}) {
     super();
+    this.requests = new Requests(this, options.cacheHandler);
     // eslint-disable-next-line no-console
     if (options && !options.silent) this.on('warn', console.warn);
     // Test to check for multiple instances of client
@@ -29,18 +30,27 @@ class Client extends EventEmitter {
     this.key = validate.validateKey(key);
     this.options = validate.parseOptions(options);
     validate.validateOptions(this.options);
-    // eslint-disable-next-line no-return-assign
-    Object.keys(API).forEach((func) => Client.prototype[func] = function (...args) {
-      return API[func].apply({ _makeRequest: this._makeRequest.bind(this, { ...(validate.cacheSuboptions(args[args.length - 1]) ? args[args.length - 1] : {}) }), ...this }, args);
-    });
-    if (this.options.checkForUpdates) {
-      updater.checkForUpdates();
+    // eslint-disable-next-line guard-for-in
+    for (const func in API) {
+      Client.prototype[func] = function (...args) {
+        const lastArg = args[args.length - 1];
+        return API[func].apply(
+          {
+            _makeRequest: this._makeRequest.bind(this, { ...(validate.cacheSuboptions(lastArg) ? lastArg : {}) }),
+            ...this
+          },
+          args);
+      };
+
+      if (this.options.checkForUpdates) {
+        updater.checkForUpdates();
+      }
     }
     /**
      * All cache entries
      * @type {Map<string,object>}
      */
-    this.cache = requests.cache;
+    this.cache = this.requests.cache;
     clients.push(this);
     rateLimit.init(this.getKeyInfo(), this.options, this).then(() => this.emit('ready'));
   }
@@ -54,10 +64,10 @@ class Client extends EventEmitter {
    */
   async _makeRequest (options, url, useRateLimitManager = true) {
     if (!url) return;
-    if (url !== '/key' && !options.noCacheCheck && requests.cache.has(url)) return requests.cache.get(url);
+    if (url !== '/key' && !options.noCacheCheck && await this.requests.cache.has(url)) return Object.assign(await this.requests.cache.get(url), { raw: !!options.raw });
     if (useRateLimitManager) await rateLimit.rateLimitManager();
     this.emit('outgoingRequest', url, { ...options, headers: { ...options.headers, ...this.options.headers } });
-    const result = await requests.request.call(this, url, { ...options, headers: { ...options.headers, ...this.options.headers } });
+    const result = await this.requests.request.call(this.requests, url, { ...options, headers: { ...options.headers, ...this.options.headers } });
     if (this.options.syncWithHeaders) rateLimit.sync(result._headers);
     return result;
   }
@@ -76,8 +86,7 @@ class Client extends EventEmitter {
    * // This example gets the first 100 friends of a player and gets their stats.
    * hypixel.once('ready',()=>{
    *  hypixel.getFriends('StavZDev')
-   *  .then(friends => friends.map(x=>x.uuid).slice(0, 100))
-   *  .then(hypixel.getPlayer)
+   *  .then(friends => friends.map(x=>x.uuid).slice(0, 100).map(hypixel.getPlayer))
    *  .catch(console.log);
    * })
    */
@@ -355,7 +364,7 @@ class Client extends EventEmitter {
    * .catch(console.log)
    */
   /**
-   * Allows you to get Ranked SkyWars data of a player
+   * Allows you to get Ranked SkyWars data for current season of a player
    * @method
    * @name Client#getRankedSkyWars
    * @param {string} query Player nickname or uuid
@@ -377,13 +386,14 @@ class Client extends EventEmitter {
    * @return {Promise<void|boolean[]>}
    */
   sweepCache (amount) {
-    return requests.sweepCache(amount);
+    return this.requests.sweepCache(amount);
   }
 }
 /**
  * @typedef {object} ClientOptions
  * @prop {boolean} [cache=false] Enable/Disable request caching.
  * @prop {number} [cacheTime=60] Amount of time in seconds to cache the requests.
+ * @prop {CacheHandler} [cacheHandler] Custom Cache Handler
  * @prop {AUTO|HARD|NONE} [rateLimit='AUTO'] Rate limit mode.
  * @prop {boolean} [syncWithHeaders=false] Sync with headers rate limit information. Usually not necessary nor recommended ( because of latency )
  * @prop {number} [keyLimit=120] Key limit of your key.
@@ -392,14 +402,23 @@ class Client extends EventEmitter {
  * @prop {object} [headers={}] Extra Headers ( like User-Agent ) to add to request.
  * @prop {boolean} [checkForUpdates=false] Enable/Disable check for new version of hypixel-api-reborn.
  */
+const defaultCache = require('./Private/defaultCache.js');
+/**
+ * @typedef {defaultCache} Cache
+ */
+/**
+ * @typedef {Cache} CacheHandler
+ */
 /**
  * @typedef {object} MethodOptions
+ * @property {boolean} [raw=false] Raw data
  * @property {boolean} [noCacheCheck=false] Disable/Enable cache checking
  * @property {boolean} [noCaching=false] Disable/Enable writing to cache
  * @prop {object} [headers={}] Extra Headers ( like User-Agent ) to add to request. Overrides the headers globally provided.
  */
 /**
  * @typedef {object} PlayerMethodOptions
+ * @property {boolean} [raw=false] Raw data
  * @property {boolean} [noCacheCheck=false] Disable/Enable cache checking
  * @property {boolean} [noCaching=false] Disable/Enable writing to cache
  * @property {boolean} [guild=false] Disable/Enable request for player's guild
@@ -409,6 +428,7 @@ class Client extends EventEmitter {
  */
 /**
  * @typedef {object} SkyblockMethodOptions
+ * @property {boolean} [raw=false] Raw data
  * @property {?boolean} [noCacheCheck=false] Disable/Enable cache checking
  * @property {?boolean} [noCaching=false] Disable/Enable writing to cache
  * @property {?boolean} [fetchPlayer=false] Disable/Enable player profile request for each member

package/src/Errors.js

@@ -34,5 +34,6 @@ module.exports = {
   CONNECTION_ERROR: '[hypixel-api-reborn] Failed to connect.',
   RATE_LIMIT_INIT_ERROR: '[hypixel-api-reborn] An error happened whilst initializing rate limit. We strongly recommend restarting the code as this can lead to desynchronization.',
   MULTIPLE_INSTANCES: '[hypixel-api-reborn] Multiple instances of hypixel-api-reborn are found so we merged them for you. Please refrain from spawning multiple instances in the future. For more information, join our Discord Server https://discord.gg/NSEBNMM.',
-  INVALID_HEADERS: '[hypixel-api-reborn] Invalid Headers are provided in ClientOptions. For help join our Discord Server https://discord.gg/NSEBNMM'
+  INVALID_HEADERS: '[hypixel-api-reborn] Invalid Headers are provided in ClientOptions. For help join our Discord Server https://discord.gg/NSEBNMM',
+  INVALID_CACHE_HANDLER: '[hypixel-api-reborn] An invalid cache handler is provideed. For help join our Discord Server https://discord.gg/NSEBNMM'
 };

package/src/Private/defaultCache.js

@@ -0,0 +1,78 @@
+/**
+ * This is the default cache implementation, using a Map.
+ * All cache implementations must have these methods below, they can be async :
+ * set(key, value) : Sets key to value
+ * has(key) : Whether there is an entry to this key. (can be an alias to get)
+ * get(key) : Gets by key (nullish value if not found)
+ * delete(key) : Deletes by key
+ * keys() : Array of keys, ordered by time of creation. To help you, the key will be deleted and set in case of an update
+ * size(): Size of cache (number of keys)
+ * clear(): Deletes all cache entries
+ * See JSDoc for more info
+ */
+class Cache {
+  /**
+   * Constructor
+   */
+  constructor() {
+    this.storage = new Map();
+  }
+  /**
+   * Sets an entry
+   * @param {string} key String key
+   * @param {*} value Any value
+   * @return {boolean}
+   */
+  set(key, value) {
+    return this.storage.set(key, value);
+  }
+  /**
+   * Check if there's an entry in the cache that has this key
+   * This doesn't have to return boolean, just a truthy/falsy value
+   * @param {string} key String key
+   * @return {boolean} Whether this key exists
+   */
+  has(key) {
+    return this.storage.has(key);
+  }
+  /**
+   * Gets an entry, return a nullish value if not found
+   * @param {string} key String key
+   * @return {*}
+   */
+  get(key) {
+    return this.storage.get(key);
+  }
+  /**
+   * Deletes an entry
+   * @param {string} key String key
+   * @return {boolean} Preferably, returns a boolean to check if the deletion is actually successful
+   */
+  delete(key) {
+    return this.storage.delete(key);
+  }
+  /**
+   * Returns Array of string (not an iterator preferably, it can break)
+   * @return {string[]}
+   */
+  keys() {
+    return Array.from(this.storage.keys());
+  }
+  /**
+   * Returns size of cache
+   * @return {number}
+   */
+  size() {
+    return this.storage.size;
+  }
+  /**
+   * Clears cache
+   * @return {void}
+   */
+  clear() {
+    this.storage.clear();
+  }
+}
+
+module.exports = Cache;
+

package/src/Private/requests.js

@@ -2,10 +2,19 @@
 const fetch = require('node-fetch');
 const BASE_URL = 'https://api.hypixel.net';
 const Errors = require('../Errors');
-const cached = new Map();
+const Cache = require('./defaultCache');
+
 module.exports = class Requests {
+  constructor(client, cache) {
+    if (cache && !this.validateCustomCache()) throw new Error(Errors.INVALID_CACHE_HANDLER);
+    /**
+     * @type {Cache}
+     */
+    this.cached = cache || new Cache();
+    this.client = client;
+  }
   async request (endpoint, options = {}) {
-    options.headers = {'API-Key': this.key, ...options.headers};
+    options.headers = {'API-Key': this.client.key, ...options.headers};
     const res = await fetch(BASE_URL + endpoint, options);
     if (res.status >= 500 && res.status < 528) throw new Error(Errors.ERROR_STATUSTEXT.replace(/{statustext}/, `Server Error : ${res.status} ${res.statusText}`));
     const parsedRes = await res.json().catch(() => {
@@ -18,22 +27,28 @@ module.exports = class Requests {
       throw new Error(Errors.SOMETHING_WENT_WRONG.replace(/{cause}/, res.cause));
     }
     parsedRes._headers = res.headers;
+    parsedRes.raw = !!options.raw;
     if (options.noCaching) return parsedRes;
     // split by question mark : first part is /path, remove /
-    if (this.options.cache && this.options.cacheFilter(endpoint.split('?')[0].slice(1))) {
-      if (this.options.cacheSize < cached.size) cached.delete(cached.keys().next().value); // Map and its special "iterators"
-      cached.set(endpoint, parsedRes);
-      if (this.options.cacheTime >= 0) setTimeout(() => cached.delete(endpoint), 1000 * this.options.cacheTime);
+    if (this.client.options.cache && this.client.options.cacheFilter(endpoint.split('?')[0].slice(1))) {
+      if (this.client.options.cacheSize < await this.cached.size()) await this.cached.delete(Array.from(await this.cached.keys())[0]);
+      await this.cached.delete(endpoint);
+      await this.cached.set(endpoint, parsedRes);
+      if (this.client.options.cacheTime >= 0) setTimeout(() => this.cached.delete(endpoint), 1000 * this.client.options.cacheTime);
     }
     return parsedRes;
   }
 
   get cache () {
-    return cached;
+    return this.cached;
   }
 
   async sweepCache (amount) {
-    if (!amount || amount >= cached.size) return cached.clear();
-    return Array.from(cached.keys()).slice(cached.size - amount).map((x) => cached.delete(x));
+    if (!amount || amount >= await this.cached.size()) return await this.cached.clear();
+    return await Promise.all(Array.from(await this.cached.keys()).slice(await this.cached.size() - amount).map((x) => this.cached.delete(x)));
+  }
+
+  validateCustomCache(cache) {
+    return !!(cache.set && cache.get && cache.delete && cache.keys);
   }
 };

package/src/Private/updater.js

@@ -20,8 +20,11 @@ class Updater {
     New version of hypixel-api-reborn is available!
     
     v${newVersion}
+    Changelog: https://github.com/Hypixel-API-Reborn/hypixel-api-reborn/releases/tag/${newVersion}
 
-    npm i hypixel-api-reborn@${newVersion}.
+    \x1b[33mnpm i hypixel-api-reborn@${newVersion}\x1b[0m
+    or
+    \x1b[33myarn add hypixel-api-reborn@${newVersion}\x1b[0m
     
     `);
   }

package/src/Private/validate.js

@@ -62,7 +62,7 @@ class Validation {
    */
   cacheSuboptions (input) {
     if (typeof input !== 'object' || input === null) return false;
-    if (!input.noCacheCheck && !input.noCaching) return false;
+    if (!input.noCacheCheck && !input.noCaching && !input.raw) return false;
     return true;
   }
 
@@ -89,9 +89,9 @@ class Validation {
    * @returns {void}
    * @private
    */
-  validateNodeVersion() {
+  validateNodeVersion () {
     const nodeVersion = parseInt(process.version.match(/v(\d{2})\.\d{1,}\.\d+/)[1], 10);
-    if (nodeVersion < 12 ) throw new Error(Errors.NODE_VERSION_ERR);
+    if (nodeVersion < 12) throw new Error(Errors.NODE_VERSION_ERR);
   }
 }
 module.exports = Validation;

package/src/structures/MiniGames/BedWars.js

@@ -105,6 +105,19 @@ class BedWars {
       diamond: data.diamond_resources_collected_bedwars || 0,
       emerald: data.emerald_resources_collected_bedwars || 0
     };
+    /**
+     * Loot chests
+     * @type {BedWarsLootChests}
+     */
+    this.lootChests = {
+      christmas: data.bedwars_christmas_boxes || 0,
+      lunar: data.bedwars_lunar_boxes || 0,
+      normal: data.bedwars_boxes || 0,
+      easter: data.bedwars_easter_boxes || 0,
+      halloween: data.bedwars_halloween_boxes || 0,
+      golden: data.bedwars_golden_boxes || 0,
+      total: (data.bedwars_christmas_boxes + data.bedwars_lunar_boxes + data.bedwars_boxes + data.bedwars_easter_boxes + data.bedwars_halloween_boxes + data.bedwars_golden_boxes) || 0
+    };
     /**
      * Beds lost/broken/BL Ratio
      * @type {BedWarsBeds}
@@ -291,6 +304,15 @@ function getLevelForExp (exp) {
  * @property {number} diamond Diamond
  * @property {number} emerald Emerald
  */
+/**
+ * @typedef {object} BedWarsLootChests
+ * @property {number} christmas Christmas chests
+ * @property {number} halloween Halloween chests
+ * @property {number} easter Easter chests
+ * @property {number} christmas Christmas chests
+ * @property {number} golden Golden chests
+ * @property {number} normal Normal chests
+ */
 /**
  * @typedef {object} BedWarsBeds
  * @property {number} lost Beds lost