1.2.1 • Published 5 years ago

hypixel-node v1.2.1

Weekly downloads
30
License
MIT
Repository
github
Last release
5 years ago

Hypixel & Mojang API for Node.js

JS wrapper for the Hypixel and Mojang APIs.

NPM

Installation

npm install hypixel-node

Initializing Classes

const {Hypixel, Mojang} = require('hypixel-node');
const hypixel = new Hypixel(HYPIXEL_API_KEY);
const mojang = new Mojang();

Hypixel API

Example

const {Hypixel} = require('hypixel-node');
const hypixel = new Hypixel(HYPIXEL_API_KEY);

// With Callbacks
hypixel.getPlayer('Hypixel', (error, player) => {
  if (error) 
      return console.log(error);
  
  console.log(player)
});
  
// Promisified
hypixel.findGuildByPlayer('Hypixel')
    .then( guild => { ... })
    .catch( error => { ... });

Functions

ArgsReturns
getKeyInforecord
getBoostersboosters
getLeaderboardsleaderboards
getOnlinePlayersplayerCount
getWatchdogStatsobject
getGuildByNamenameguild
getGuildByPlayeruuidguild
getGuild*id/guildname/uuid/ignguild
getFriendsuuidrecords
getSessionuuidsession
getPlayerusername/uuidplayer

*Note: If you use an "ign" with getGuild, it will use 3 api calls.

Methods

These methods are added to certain properties for added functionality.

PropertyMethodDescriptionType
playergetLevelReturns the Hypixel level for the player.Number
getRankReturns the rank of the player.String
isOnlineReturns 'true' of the player is online.Boolean
guildgetGuildLevelReturns information about the guild's level.Object

Examples

async () => {
    let player = await hypixel.getPlayer('Hypixel');
    console.log(player.getRank()) // "[OWNER]"
    console.log(player.getRank(false)) // "OWNER"
    console.log(player.getLevel()) // 223
    console.log(player.isOnline()) // false

    let guild = await hypixel.getGuild('RandyGuild');
    console.log(guild.getGuildLevel())
    /*
    {
      level: 4,
      totalExp: 1500000,
      expToNextLevel: 250000
    }
    */
}

Mojang API

Example

const {Mojang} = require('hypixel-node');
const mojang = new Mojang();

// With Callbacks
mojang.getUUID('Hypixel', (error, uuid) => {
  if (error) 
      return console.log(error);
  
  console.log(uuid)
});
  
// Promisified
mojang.getNameHistory('Hypixel')
    .then( guild => { ... })
    .catch( error => { ... });

Functions

ArgsReturns
getUUIDnameuuid
getNameuuidname
getStatusobject
getNameHistoryname/uuidobject

License

MIT

1.2.1

5 years ago

1.2.0

5 years ago

1.1.0

5 years ago

1.0.2

5 years ago

1.0.1

5 years ago

1.0.0

5 years ago