Hive-bedrock-api NPM

Hive Bedrock API

An API wrapper for the Hive Minecraft Bedrock Edition server. Which allows you to get stats for leaderboards, players, cosmetics, unique player counts, maps and metadata.

Getting started

$ npm install hive-bedrock-api
$ yarn add hive-bedrock-api

Usage

See API.md for detailed documentation.

Fetch Player Infomation

import { getPlayerInformation } from "hive-bedrock-api";

// Returns player, cosmetics, server statistics and profile infomation
const { data, error } = await getPlayerInformation("player");

Fetch All-Time Player Statistics

import { getAllTimeStatistics, Game } from "hive-bedrock-api";

// Returns all games
const { data, error } = await getAllTimeStats("player");

// Returns a single game
const { data, error } = await getAllTimeStats("player", Game.HideAndSeek);

Fetch Monthly Player Statistics

import { getMonthlyStatistics, Game } from "hive-bedrock-api";

// Returns all games
const { data, error } = await getMonthlyStats("player");

// Returns a single game
const { data, error } = await getMonthlyStats("player", Game.BlockDrop);

// Returns a single game in a previous month (can return muliple games)
const { data, error } = await getMonthlyStats("player", Game.BlockDrop, {
    year: 2023,
    month: 1, // January
});

Fetch All-Time Leaderboard

import { getAllTimeLeaderboard, Game } from "hive-bedrock-api";

// Returns a single game
const { data, error } = await getAllTimeLeaderboard(Game.TreasureWars);

Fetch Monthly Leaderboard

import { getMonthlyLeaderboard, Game } from "hive-bedrock-api";

// Returns a single game
const { data, error } = await getMonthlyLeaderboard(Game.TreasureWars);

// Returns a single game from a previous month
const { data, error } = await getMonthlyLeaderboard(Game.BlockParty, {
    year: 2023,
    month: 11, // November
    amount: 50,
    skip: 20, // Sum of skip and amount must be <=100
});

Fetch Global Statistics

import { getGlobalStatistics } from "hive-bedrock-api";

// Returns unqiue total player counts for different games
const { data, error } = await getGlobalStatistics();

Fetch Maps

import { getMaps, Game } from "hive-bedrock-api";

// Returns data for a specific game's currently active maps
const { data, error } = await getMaps(Game.TreasureWars);

Fetch Metadata

import { getMetadata, Game } from "hive-bedrock-api";

// Returns data for a specific game's currently active maps
const { data, error } = await getMetadata(Game.TreasureWars);