mcdata/mcdata.js at npm · KallelGaNewk/mcdata · GitHub

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
/**
 * @name MCData
 * @version 1.0.9
 * @file Get minecraft player and server info
 * @author kallelganewk
 * @copyright KallelGaNewk 2021
 */

const { get } = require('axios');

module.exports = {
  /**
   * Gets the UUID, Nickname history and skin of the player
   * @param {string} username The username of a Minecraft Player
   * @param {object} options
   * @param {string} options.renderSize The size for avatars in pixels. `32 - 600`
   * @returns {Promise<object>} Player status
   */
  playerStatus: async (username, options = {}) => {
    if (!username) return;

    const res = await get(`https://mc-heads.net/minecraft/profile/${username}`);

    if (res.status !== 200) return;

    return {
        uuid: res.data.id,
        username: res.data.name,
        nameHistory: res.data.name_history,
        skin: {
          avatar: `https://mc-heads.net/avatar/${res.data.id}/${options.skinSize ? options.skinSize : '512'}`,
          renders: {
            head: {
              left: `https://mc-heads.net/head/${res.data.id}/left`,
              right: `https://mc-heads.net/head/${res.data.id}/right`
            },
            body: {
              left: `https://mc-heads.net/body/${res.data.id}/left`,
              right: `https://mc-heads.net/body/${res.data.id}/right`
            }
          },
          fullBody: `https://mc-heads.net/player/${res.data.id}/${options.skinSize ? options.skinSize : '512'}`,
          combo: `https://mc-heads.net/combo/${res.data.id}/${options.skinSize ? options.skinSize : '512'}`,
          texture: {
            get: `https://mc-heads.net/skin/${res.data.id}`,
            download: `https://mc-heads.net/download/${res.data.id}`,
            apply: `https://mc-heads.net/change/${res.data.id}`
          }
        }
      };
  },
  /**
   * Gets the Status, ping, version, motd and players of the server
   * @param {string} ip Minecraft server IP
   * @returns {Promise<Object>} Server status
   */
  serverStatus: async (ip) => {
    if (!ip) return { serverStatus: 'offline' };
    return (await get(`https://mcapi.xdefcon.com/server/${ip}/full/json`)).data;
  },
  player: {
    /**
     * Gets only the UUID of user
     * @param {string} username The username of a Minecraft Player
     * @returns {Promise<string>} User UUID
     */
    getUUID: async (username) => {
      if (!username) return;
      return (await get(`https://api.mojang.com/users/profiles/minecraft/${username}?at=${Math.round((new Date().getTime()) / 1000)}`)).data.id;
    },
    /**
     * Gets only the formatted username
     * @param {string} uuid The UUID of a Minecraft Player
     * @returns {Promise<string>} User Username
     */
    getUsername: async (uuid) => {
      if (!uuid) return;
      return (await get(`https://sessionserver.mojang.com/session/minecraft/profile/${uuid}`)).data.name;
    },
  }
};