Skip to content

imharvol/mineflayer-web-inventory

Repository files navigation

Mineflayer Web Inventory

A simple web-based inventory viewer for mineflayer with support for multiple types of windows and updated in real-time.

Install

npm install mineflayer-web-inventory

npm version

Minimum recommended mineflayer version: 4.2.0 Note that from version 1.3.0 mineflayer-web-inventory will only support mineflayer 3.X.X and 4.X.X versions If you still wish to use mineflayer-web-inventory with mineflayer 2.X.X you can install mineflayer-web-inventory@1.2.1: npm i mineflayer-web-inventory@1.2.1

Usage

  • Run npm install mineflayer-web-inventory.
  • Import mineflayer-web-inventory: const inventoryViewer = require('mineflayer-web-inventory').
  • Call inventoryViewer with your bot instance: inventoryViewer(bot).
const mineflayer = require('mineflayer')
const inventoryViewer = require('mineflayer-web-inventory')

const bot = mineflayer.createBot({
  host: 'localhost',
  port: 25565,
  username: 'bot',
  version: '1.18.2' // Its important to set this to the server's minecraft version. Otherwise it might not load data/textures correctly
})

inventoryViewer(bot)

This will start a web server in http://localhost:3000/. You can change the options using:

  let options = {
    port: PORT,
    webPath: PATH,
    express: EXPRESS,
    app: APP,
    http: HTTP,
    io: IO,
    startOnLoad: BOOLEAN,
    windowUpdateDebounceTime: INT
  }

  inventoryViewer(bot, options)

You can access the options in bot.webInventory.options

bot.webInventory.start()

Starts the web server. This function is called when the plugin is first loaded unless options.startOnLoad is false. Returns a Promise that resolves once the HTTP server is open.

bot.webInventory.stop()

Stops the web server. Returns a Promise that resolves once the HTTP server is closed.

You can also check the current status of the web server using bot.webInventory.isRunning which returns a boolean

Screenshots

Example Screenshot 1 Example Screenshot 2

Example.Video.mineflayer-web-inventory.mp4

Images

The images used in this project are from https://wiki.vg/Inventory and https://github.com/PrismarineJS/minecraft-assets