minehut.js v3.0.4

Minehut.js

IMPORTANT

This package wouldn't have been possible without the help of my friend DeltaRays#0054.

About

Minehut.js is a TypeScript and JavaScript library that allows you to interact with the Minehut API.

Release 3.0.0

This release is focused on the FileManager, bringing some features I had forgotten about + the .watch() method:

• Added FileManager.watch();
• Added FileManager.createDir();
• Added FileManager.deleteFile();
• Added FileManager.deleteDir();
• FileManager.uploadWorld() now supports relative paths.

Created by Kiko#6282

Collections

The library uses the Collection class from Discord.js due to its useful methods such as .find(), .filter() and .first(). For more information, check the Discord.js Documentation.

Example

// Start server
import { Session } from "minehut.js"
const session = new Session()
session.login({
    email: "hello@testmail.com",
    password: "codingisawesome"
}).then(async session => {
    const server = session.servers.first()
    await server.start()
}, console.error)

Main Object

The Minehut object contains some methods and properties:

• .Session
• .getServers()
• .getServer(name: string)
• .getPlugins()
• .getPlugin(name: string)
• .getIcons()
• .getIcon(name: string)
• .getStats()
• .getPromotion()
• .signup()
• .checkCode()
• .confirmEmail()

.Session

See Session

.getServers()

Returns: Promise<Collection<string, Server>>

.getServer()

Returns: Promise\<Server>

.getPlugins()

Returns: Promise<Collection<string, Plugin>>

.getPlugin()

Returns: Promise\<Plugin>

.getIcons()

Returns: Promise<Collection<string, Icon>>

.getIcon()

Returns: Promise\<Icon>

.getStats()

Returns: Promise<MinehutStats>

.getPromotion()

Returns: Promise<Object { text: string, link: string }>

.signup()

Returns: Promise\

.checkCode()

Returns: Promise\ NOTE: While this method exists, I'm (still) not sure if it is necessary for signing up. Anyways, just to be sure, you should always use .signup(), .checkCode() and .confirmEmail()

.confirmEmail()

Returns: Promise\

MinehutStats

Represents an object containing network statistics.

Server

The Server class represents a Minehut server accessible with no authorization required. The structure is as follows:

There are also 2 methods:

.fetchPlugins()

Description: Fetches plugins (doesn't return them, only assigns) Returns: Promise\

.fetchIcons()

Description: Fetches icons (doesn't return them, only assigns) Returns: Promise\

The reason these exist is because Minehut.js doesn't store the plugins and icons as their respective class instances right away, which also explains why some plugin and icon properties are marked as partial.

Plugin

The Plugin class is one that doesn't have many uses. Instead, it exists just for the sake of having it.

Icon

Like the Plugin class, the icon class also exists just for the sake of it.

Session

Session is the class that manages a user's session. The constructor takes no parameters. Instead, after instanciating the class, you should use the .login() method to log in:

.login()

Description: Logs in to Minehut using specified credentials. Returns: Promise<Session>

When successfully logged in, you can either use the original variable or the variable resolved by the promise to access the complete Session object:

There's also a .fetch() method, but I don't recommend using it:

.fetch()

Description: Fetches with authorization. Returns: Promise\<Response>

User

The User class represents a logged in Minehut user.

.changePassword()

Description: Changes the password for the logged in user. Returns: Promise\

.purchaseSlots()

Description: Purchases a server slot. 400 credits are required for each slot. Returns: Promise\

.createServer()

Description: Creates a new server using a free slot. Returns: Promise\

.refresh()

Description: Re-fetches properties (doesn't return them, only assigns). Returns: Promise\

SessionServer

SessionServer represents a server belonging to the logged in user. It extends Server and has

.start()

Description: Starts the server up. Returns: Promise\

.restart()

Description: Restarts the server. Returns: Promise\

.stop()

Description: Starts the server up. Returns: Promise\

.setName()

Description: Changes the server name. Returns: Promise\

.setMOTD()

Description: Changes the server MOTD. Returns: Promise\

.setVisibility()

Description: Changes the server visibility. Returns: Promise\

.sendCommand()

Description: Sends a command to the server. Returns: Promise\

.editProperties()

Description: Edits the server properties. Returns: Promise\

.purchaseIcon()

Description: Purchases an icon. Returns: Promise\

.setIcon()

Description: Changes the server's icon. Returns: Promise\

.installPlugin()

Description: Installs a plugin. Returns: Promise\

.resetPlugin()

Description: Resets plugin data. Returns: Promise\

.uninstallPlugin()

Description: Uninstalls a plugin. Returns: Promise\

.refresh()

Description: Re-fetches the server properties. Returns: Promise\

FileManager

The FileManager class is used to manage everything that's file-related, such as world uploading, file creation and resets.

.createFile()

Description: Creates a file. Returns: Promise\

.createDir()

Description: Creates a directory. Returns: Promise\

.editFile()

Description: Edits a file. Returns: Promise\

.readFile()

Description: Reads a file, returning its content. Returns: Promise\<string>

.watch()

Description: Watches a directory/file and uploads it to Minehut on changes/delete. Warning: Deleted files will not sync to Minehut if they're deleted while this method isn't running. Returns: Promise\

.readDir()

Description: Reads a directory, returning its children. Returns: Promise\

.deleteFile()

Description: Deletes a file. Returns: Promise\

.deleteDir()

Description: Deletes a directory. Returns: Promise\

.uploadWorld()

Description: Uploads a world. Returns: Promise\

.saveWorld()

Description: Saves the world. Returns: Promise\

.resetWorld()

Description: Resets the world. Use with caution! Returns: Promise\

.repairFiles()

Description: Repairs the server's files. Returns: Promise\

.resetServer()

Description: Resets the server. Use with caution! Returns: Promise\

DirChild

An object with information about a directory's child element (file or folder).

ServerProperties

The ServerProperties type contains all of the properties that servers can have.

Minecraft

Object containing information of a user's linked minecraft account.

Transaction

Object containing information about a credit transaction.

Payment

Object containing information about a payment.