Skip to content

nick22985/ManacubeApi

Repository files navigation

 

ManacubeApi

This project has no association to the official manacube developers

Github top language Github language count Repository size License Github issues Github forks Github stars

🚧 ManacubeApi 🚀 Under construction... 🚧


About   |   Features   |   Technologies   |   Requirements   |   Starting   |   License   |   Author


🎯 About

This project is a npm wrapper to integrate with the manacube api (https://api.manacube.com/)

✨ Features

✔️ Api Client;
✔️ Typescript;\

🚀 Technologies

The following tools were used in this project:

✅ Requirements

Before starting 🏁, you need to have Node installed.

🏁 Starting

# Install the project
$ npm i manacube

# import / declare client
const manacubeApi = require("manacube")
let manacubeClient = new manacubeApi.ManaCubeApi()

# Run the project
you can now use the client and the function to interact with the manacube api

Functions

Declaring Client

// Declare api instance
// Has to options baseUrl and disableSafeUUIDCheck. BaseUrl changes the default api url
// disableSafeUUIDCheck will not run any checks against any UUID imputed into the api.
let manacubeClient = new manacubeApi.ManaCubeApi();
let manacubeClient = new manacubeApi.ManaCubeApi('https://api.manacube.com/api/', true); // Disables UUID CHECKS

Reforms UUID to the correct formatting for the api or returns Invalid UUID if UUID isn't the valid minecraft format.

manacubeClient.safeUUIDCheck('f91c3347-4be2-48f2-be73-9a4323f08497'); //return f91c3347-4be2-48f2-be73-9a4323f08497
manacubeClient.safeUUIDCheck('f91c3347-4be248f2be73-9a4323f08497'); //return f91c3347-4be2-48f2-be73-9a4323f08497
manacubeClient.safeUUIDCheck('f91c33474be248f2be739a4323f08497'); //return f91c3347-4be2-48f2-be73-9a4323f08497
manacubeClient.safeUUIDCheck('f91c33474be248323f08497'); //return Invalid UUID

Get Users sva's

@param uuid MCC UUID
@param gamemode gamemode to get stats for
@returns A single users svas

manacubeClient.getUserSvas(uuid, gamemode);

Get gamemode sva's

@param gamemode Gamemode to get stats for
@returns Get all SVAs that a player owns on a specific gamemode

manacubeClient.getAllGamemodeSvas(gamemode)

Get Patrons list of patrons and patron+

@returns List of patrons uuids

manacubeClient.getAllPatrons()

Gets a list of all Patrons

@returns List of patrons uuids

manacubeClient.getPatrons()

Get a list of all patron+

@returns List of patrons uuids

manacubeClient.getPatronPlus()

Get player levels

@param uuid UUID of player to get stats for
@returns Get a single players stats
manacubeClient.getPlayerLevels(uuid)

Get Top Guilds

@param total Total amount of guilds to get
@returns Get a list of x guilds stats

manacubeClient.getTopGuilds(total)

Get players guilds

@param uuid UUID of player to get stats for
@returns Get a single players stats

manacubeClient.getPlayerGuild(uuid)

Get Users Friends List

@param uuid UUID of player to get stats for
@returns Get a single players friend list

manacubeClient.getUserFriends(uuid)

Gets Factions Placeholders

@param season Factions Season payouts to get stats for
@returns Get a list of factions season payouts

manacubeClient.getFactionsSeasonPayouts(season)

Get factions Grace Placeholders

@param placeholder placeholder
@returns placeholder

getGracePlaceholder(placeholder)

Get Players cubit balance

@param uuid UUID of player to get stats for
@returns Get a single players cubit stats

getPlayersCubitBalance(uuid)

📝 License

This project is under license from MIT. For more details, see the LICENSE file.

Made with ❤️ by nick22985

 

Back to top