mineflayer 4.13.0 → 4.14.0

package/docs/api.md

@@ -136,6 +136,7 @@
       - [bot.foodSaturation](#botfoodsaturation)
       - [bot.oxygenLevel](#botoxygenlevel)
       - [bot.physics](#botphysics)
+      - [bot.fireworkRocketDuration](#botfireworkrocketduration)
       - [bot.simpleClick.leftMouse (slot)](#botsimpleclickleftmouse-slot)
       - [bot.simpleClick.rightMouse (slot)](#botsimpleclickrightmouse-slot)
       - [bot.time.doDaylightCycle](#bottimedodaylightcycle)
@@ -197,6 +198,7 @@
       - ["entityEquip" (entity)](#entityequip-entity)
       - ["entitySleep" (entity)](#entitysleep-entity)
       - ["entitySpawn" (entity)](#entityspawn-entity)
+      - ["entityElytraFlew" (entity)](#entityelytraflew-entity)
       - ["itemDrop" (entity)](#itemdrop-entity)
       - ["playerCollect" (collector, collected)](#playercollect-collector-collected)
       - ["entityGone" (entity)](#entitygone-entity)
@@ -223,6 +225,7 @@
       - ["blockBreakProgressEnd" (block, entity)](#blockbreakprogressend-block-entity)
       - ["diggingCompleted" (block)](#diggingcompleted-block)
       - ["diggingAborted" (block)](#diggingaborted-block)
+      - ["usedFirework"](#usedfirework)
       - ["move"](#move)
       - ["forcedMove"](#forcedmove)
       - ["mount"](#mount)
@@ -293,6 +296,7 @@
       - [bot.unequip(destination)](#botunequipdestination)
       - [bot.tossStack(item)](#bottossstackitem)
       - [bot.toss(itemType, metadata, count)](#bottossitemtype-metadata-count)
+      - [bot.elytraFly()](#botelytrafly)
       - [bot.dig(block, [forceLook = true], [digFace])](#botdigblock-forcelook--true-digface)
       - [bot.stopDigging()](#botstopdigging)
       - [bot.digTime(block)](#botdigtimeblock)
@@ -1037,6 +1041,10 @@ Number in the range [0, 20] respresenting the number of water-icons known as oxy
 Edit these numbers to tweak gravity, jump speed, terminal velocity, etc.
 Do this at your own risk.
 
+#### bot.fireworkRocketDuration
+
+How many physics ticks worth of firework rocket boost are left.
+
 #### bot.simpleClick.leftMouse (slot)
 
 abstraction over `bot.clickWindow(slot, 0, 0)`
@@ -1301,6 +1309,10 @@ Fires when an attribute of an entity changes.
 #### "entityEquip" (entity)
 #### "entitySleep" (entity)
 #### "entitySpawn" (entity)
+#### "entityElytraFlew" (entity)
+
+An entity started elytra flying.
+
 #### "itemDrop" (entity)
 #### "playerCollect" (collector, collected)
 
@@ -1417,6 +1429,10 @@ This occurs whether the process was completed or aborted.
 
  * `block` - the block that still exists
 
+#### "usedfirework"
+
+Fires when the bot uses a firework while elytra flying.
+
 #### "move"
 
 Fires when the bot moves. If you want the current position, use
@@ -1851,6 +1867,11 @@ This function returns a `Promise`, with `void` as its argument once tossing is c
    to match any metadata
  * `count` - how many you want to toss. `null` is an alias for `1`.
 
+#### bot.elytraFly()
+
+This function returns a `Promise`, with `void` as its argument once activating
+elytra flight is complete. It will throw an Error if it fails.
+
 #### bot.dig(block, [forceLook = true], [digFace])
 
 This function returns a `Promise`, with `void` as its argument when the block is broken or you are interrupted.
@@ -1946,7 +1967,9 @@ Use fishing rod
 
 #### bot.activateItem(offHand=false)
 
-Activates the currently held item. This is how you eat, shoot bows, throw an egg, etc.
+Activates the currently held item. This is how you eat, shoot bows, throw an
+egg, activate firework rockets, etc.
+
 Optional parameter is `false` for main hand and `true` for off hand.
 
 #### bot.deactivateItem()

package/docs/history.md

@@ -1,3 +1,8 @@
+## 4.14.0
+* [Update Jupyter notebook to install node 18, update the server in example (#3176)](https://github.com/PrismarineJS/mineflayer/commit/e8a967d4e832f72d665781492c037d26169ae5a0) (thanks @extremeheat)
+* [Update index.d.ts (#3175)](https://github.com/PrismarineJS/mineflayer/commit/d4db3991c135344180937b69621c0ee31daa39f0) (thanks @StayWithMeSenpai)
+* [Add elytra flying support and rocket support (#3163)](https://github.com/PrismarineJS/mineflayer/commit/010460e9dd752a56195d8a48f35a62e704dcf99f) (thanks @lkwilson)
+
 ## 4.13.0
 * [Switch to entity.displayName (#3168)](https://github.com/PrismarineJS/mineflayer/commit/2409ad458b952173de669a7d9cfaeb770effe3ae) (thanks @lkwilson)
 * [Update readme auth doc (#3169)](https://github.com/PrismarineJS/mineflayer/commit/f5d4a288a768ca6717fa4d22c72fb0267428c684) (thanks @extremeheat)

package/docs/mineflayer.ipynb

@@ -36,7 +36,7 @@
       "source": [
         "# Using mineflayer in Python\n",
         "\n",
-        "This is a tutorial on how to use mineflayer in Python. This example will connect you to the PrismarineJS test server. You can join it with prismarine-viewer or your Minecraft client at server IP **95.111.249.143:10000**.\n",
+        "This is a tutorial on how to use mineflayer in Python. This example will connect you to the PrismarineJS test server. You can join it with prismarine-viewer or your Minecraft client at server IP **pjs.deptofcraft.com:25565**.\n",
         "\n",
         "If you're new to Jupyter Notebooks, you can press the \"Play\" button at the left of each code block to run it. Make sure that you run the blocks in a correct order."
       ]
@@ -56,32 +56,35 @@
         "id": "K2ol06QOhL6s"
       },
       "source": [
-        "First, make sure you have Python version 3.7 and Node.js version 14 or newer installed"
+        "First, make sure you have Python version 3.10 and Node.js version 18 or newer installed. You can get Node.js 18 it from https://nodejs.org/en/download or use [Node.js version managers](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm#using-a-node-version-manager-to-install-nodejs-and-npm) like [`nvm`](https://github.com/creationix/nvm) or [`n`](https://github.com/tj/n) to install via the command line. Here we'll use `n` to install Node.js v18, then check our Node and Python versions:"
       ]
     },
     {
       "cell_type": "code",
+      "execution_count": 1,
       "metadata": {
         "colab": {
           "base_uri": "https://localhost:8080/"
         },
         "id": "8zCSpx8Bif5m",
-        "outputId": "f8888a33-03e7-4497-9776-ef6c34d9d337"
+        "outputId": "90ebac14-fc75-4136-f81d-34c5b2033da0"
       },
-      "source": [
-        "!python --version\n",
-        "!node --version"
-      ],
-      "execution_count": null,
       "outputs": [
         {
+          "name": "stdout",
           "output_type": "stream",
           "text": [
-            "Python 3.7.11\n",
-            "v14.16.0\n"
-          ],
-          "name": "stdout"
+            "v18.17.1\n",
+            "Python 3.10.12\n"
+          ]
         }
+      ],
+      "source": [
+        "# Use `n` to install nodejs 18, if it's not already installed:\n",
+        "!curl -fsSL https://raw.githubusercontent.com/tj/n/master/bin/n | bash -s lts > /dev/null\n",
+        "# Now write the Node.js and Python version to the console\n",
+        "!node --version\n",
+        "!python --version"
       ]
     },
     {
@@ -121,7 +124,7 @@
       "source": [
         "If all is well, we can import the `javascript` library. We can then import the `require` function which works similarly to the `require` function in Node.js, but does the dependency management for us.\n",
         "\n",
-        "You may notice the extra imports : On, Once, off and AsyncTask. These will be discussed later on. \n",
+        "You may notice the extra imports : On, Once, off and AsyncTask. These will be discussed later on.\n",
         "\n",
         "\n"
       ]
@@ -170,21 +173,21 @@
     },
     {
       "cell_type": "code",
+      "execution_count": null,
       "metadata": {
         "id": "1gfZSAUCDVMg"
       },
+      "outputs": [],
       "source": [
         "random_number = id([]) % 1000 # Give us a random number upto 1000\n",
         "BOT_USERNAME = f'colab_{random_number}'\n",
         "\n",
-        "bot = mineflayer.createBot({ 'host': '95.111.249.143', 'port': 10000, 'username': BOT_USERNAME, 'hideErrors': False })\n",
+        "bot = mineflayer.createBot({ 'host': 'pjs.deptofcraft.com', 'port': 25565, 'username': BOT_USERNAME, 'hideErrors': False })\n",
         "\n",
-        "# The spawn event \n",
+        "# The spawn event\n",
         "once(bot, 'login')\n",
         "bot.chat('I spawned')"
-      ],
-      "execution_count": null,
-      "outputs": []
+      ]
     },
     {
       "cell_type": "markdown",

package/examples/elytra.js

@@ -0,0 +1,66 @@
+// This example will shoot the player that said "fire" in chat, when it is said in chat.
+const mineflayer = require('mineflayer')
+
+if (process.argv.length < 4 || process.argv.length > 6) {
+  console.log('Usage : node elytra.js <host> <port> [<name>] [<password>]')
+  process.exit(1)
+}
+
+const bot = mineflayer.createBot({
+  host: process.argv[2],
+  port: parseInt(process.argv[3]),
+  username: process.argv[4] ? process.argv[4] : 'elytraer',
+  password: process.argv[5]
+})
+
+bot.on('error', err => {
+  console.log(err)
+})
+
+bot.on('kicked', err => {
+  console.log(err)
+})
+
+bot.on('spawn', async function () {
+  bot.chat(`/give ${bot.username} minecraft:elytra`)
+  bot.chat(`/give ${bot.username} minecraft:firework_rocket 64`)
+
+  await sleep(1000)
+  const elytraItem = bot.inventory.slots.find(item => item?.name === 'elytra')
+  if (elytraItem == null) {
+    console.log('no elytra')
+    return
+  }
+  await bot.equip(elytraItem, 'torso')
+  const fireworkItem = bot.inventory.slots.find(item => item?.name === 'firework_rocket')
+  if (fireworkItem == null) {
+    console.log('no fireworks')
+    return
+  }
+  await bot.equip(fireworkItem, 'hand')
+})
+
+bot.on('chat', async (username, message) => {
+  if (message === 'fly') {
+    await bot.look(bot.entity.yaw, 50 * Math.PI / 180)
+    bot.setControlState('jump', true)
+    bot.setControlState('jump', false)
+    await sleep(50)
+
+    // try to fly
+    try {
+      await bot.elytraFly()
+    } catch (err) {
+      bot.chat(`Failed to fly: ${err}`)
+      return
+    }
+    await sleep(50)
+
+    // use rocket
+    bot.activateItem()
+  }
+})
+
+function sleep (ms) {
+  return new Promise(resolve => setTimeout(resolve, ms))
+}

package/index.d.ts

@@ -8,6 +8,7 @@ import { Recipe } from 'prismarine-recipe'
 import { Block } from 'prismarine-block'
 import { Entity } from 'prismarine-entity'
 import { ChatMessage } from 'prismarine-chat'
+import { world } from 'prismarine-world'
 import { Registry } from 'prismarine-registry'
 
 export function createBot (options: { client: Client } & Partial<BotOptions>): Bot
@@ -92,6 +93,8 @@ export interface BotEvents {
   entityEquip: (entity: Entity) => Promise<void> | void
   entitySleep: (entity: Entity) => Promise<void> | void
   entitySpawn: (entity: Entity) => Promise<void> | void
+  entityElytraFlew: (entity: Entity) => Promise<void> | void
+  usedFirework: () => Promise<void> | void
   itemDrop: (entity: Entity) => Promise<void> | void
   playerCollect: (collector: Entity, collected: Entity) => Promise<void> | void
   entityAttributes: (entity: Entity) => Promise<void> | void
@@ -164,6 +167,7 @@ export interface Bot extends TypedEmitter<BotEvents> {
   version: string
   entity: Entity
   entities: { [id: string]: Entity }
+  fireworkRocketDuration: number
   spawnPoint: Vec3
   game: GameState
   player: Player
@@ -189,7 +193,7 @@ export interface Bot extends TypedEmitter<BotEvents> {
   teamMap: { [name: string]: Team }
   controlState: ControlStateStatus
   creative: creativeMethods
-  world: any
+  world: world.World
   _client: Client
   heldItem: Item | null
   usingHeldItem: boolean
@@ -260,6 +264,8 @@ export interface Bot extends TypedEmitter<BotEvents> {
 
   wake: () => Promise<void>
 
+  elytraFly: () => Promise<void>
+
   setControlState: (control: ControlState, state: boolean) => void
 
   getControlState: (control: ControlState) => boolean

package/lib/plugins/entities.js

@@ -358,6 +358,70 @@ function inject (bot) {
     }
   })
 
+  bot.fireworkRocketDuration = 0
+  function setElytraFlyingState (entity, elytraFlying) {
+    let startedFlying = false
+    if (elytraFlying) {
+      startedFlying = !entity.elytraFlying
+      entity.elytraFlying = true
+    } else if (entity.elytraFlying) {
+      entity.elytraFlying = false
+    }
+    if (bot.fireworkRocketDuration !== 0 && entity.id === bot.entity?.id && !elytraFlying) {
+      bot.fireworkRocketDuration = 0
+      knownFireworks.splice(0, knownFireworks.length)
+    }
+
+    if (startedFlying) {
+      bot.emit('entityElytraFlew', entity)
+    }
+  }
+
+  const knownFireworks = []
+  function handleBotUsedFireworkRocket (fireworkEntityId, fireworkInfo) {
+    if (knownFireworks.includes(fireworkEntityId)) return
+    knownFireworks.push(fireworkEntityId)
+    let flightDur = 1
+    if (fireworkInfo?.nbtData != null) {
+      let nbt = fireworkInfo.nbtData
+      if (nbt.type === 'compound' && nbt.value.Fireworks != null) {
+        nbt = nbt.value.Fireworks
+        if (nbt.type === 'compound' && nbt.value.Flight != null) {
+          nbt = nbt.value.Flight
+          if (nbt.type === 'int') {
+            flightDur += nbt.value
+          }
+        }
+      }
+    }
+    const baseDuration = 10 * flightDur
+    const randomDuration = Math.floor(Math.random() * 6) + Math.floor(Math.random() * 7)
+    bot.fireworkRocketDuration = baseDuration + randomDuration
+
+    bot.emit('usedFirework')
+  }
+
+  let fireworkEntityName
+  if (bot.supportFeature('fireworkNamePlural')) {
+    fireworkEntityName = 'fireworks_rocket'
+  } else if (bot.supportFeature('fireworkNameSingular')) {
+    fireworkEntityName = 'firework_rocket'
+  }
+
+  let fireworkMetadataIdx
+  let fireworkMetadataIsOpt
+  if (bot.supportFeature('fireworkMetadataVarInt7')) {
+    fireworkMetadataIdx = 7
+    fireworkMetadataIsOpt = false
+  } else if (bot.supportFeature('fireworkMetadataOptVarInt8')) {
+    fireworkMetadataIdx = 8
+    fireworkMetadataIsOpt = true
+  } else if (bot.supportFeature('fireworkMetadataOptVarInt9')) {
+    fireworkMetadataIdx = 9
+    fireworkMetadataIsOpt = true
+  }
+  const hasFireworkSupport = fireworkEntityName !== undefined && fireworkMetadataIdx !== undefined && fireworkMetadataIsOpt !== undefined
+
   bot._client.on('entity_metadata', (packet) => {
     // entity metadata
     const entity = fetchEntity(packet.entityId)
@@ -374,7 +438,25 @@ function inject (bot) {
       if (metas.sleeping_pos || metas.pose === 2) {
         bot.emit('entitySleep', entity)
       }
+
+      if (hasFireworkSupport && fireworkEntityName === entity.name && metas.attached_to_target !== undefined) {
+        // fireworkMetadataOptVarInt9 and later is implied by
+        // mcDataHasEntityMetadata, so no need to check metadata index and type
+        // (eg fireworkMetadataOptVarInt8)
+        if (metas.attached_to_target !== 0) {
+          const entityId = metas.attached_to_target - 1
+          if (entityId === bot.entity?.id) {
+            handleBotUsedFireworkRocket(entity.id, metas.fireworks_item)
+          }
+        }
+      }
+
       if (metas.shared_flags != null) {
+        if (bot.supportFeature('hasElytraFlying')) {
+          const elytraFlying = metas.shared_flags & 0x80
+          setElytraFlyingState(entity, Boolean(elytraFlying))
+        }
+
         if (metas.shared_flags & 2) {
           entity.crouching = true
           bot.emit('entityCrouch', entity)
@@ -396,16 +478,38 @@ function inject (bot) {
         bot.emit('entitySleep', entity)
       }
 
-      const bitField = packet.metadata.find(p => p.key === 0)
-      if (bitField === undefined) {
-        return
+      if (hasFireworkSupport && fireworkEntityName === entity.name) {
+        const attachedToTarget = packet.metadata.find(e => e.key === fireworkMetadataIdx)
+        if (attachedToTarget !== undefined) {
+          let entityId
+          if (fireworkMetadataIsOpt) {
+            if (attachedToTarget.value !== 0) {
+              entityId = attachedToTarget.value - 1
+            } // else, not attached to an entity
+          } else {
+            entityId = attachedToTarget.value
+          }
+          if (entityId !== undefined && entityId === bot.entity?.id) {
+            const fireworksItem = packet.metadata.find(e => e.key === (fireworkMetadataIdx - 1))
+            handleBotUsedFireworkRocket(entity.id, fireworksItem?.value)
+          }
+        }
       }
-      if ((bitField.value & 2) !== 0) {
-        entity.crouching = true
-        bot.emit('entityCrouch', entity)
-      } else if (entity.crouching) { // prevent the initial entity_metadata packet from firing off an uncrouch event
-        entity.crouching = false
-        bot.emit('entityUncrouch', entity)
+
+      const bitField = packet.metadata.find(p => p.key === 0)
+      if (bitField !== undefined) {
+        if (bot.supportFeature('hasElytraFlying')) {
+          const elytraFlying = bitField.value & 0x80
+          setElytraFlyingState(entity, Boolean(elytraFlying))
+        }
+
+        if ((bitField.value & 2) !== 0) {
+          entity.crouching = true
+          bot.emit('entityCrouch', entity)
+        } else if (entity.crouching) { // prevent the initial entity_metadata packet from firing off an uncrouch event
+          entity.crouching = false
+          bot.emit('entityUncrouch', entity)
+        }
       }
     }
   })

package/lib/plugins/physics.js

@@ -192,6 +192,44 @@ function inject (bot, { physicsEnabled, maxCatchupTicks }) {
 
   bot.physics = physics
 
+  function getEffectLevel (mcData, effectName, effects) {
+    const effectDescriptor = mcData.effectsByName[effectName]
+    if (!effectDescriptor) {
+      return 0
+    }
+    const effectInfo = effects[effectDescriptor.id]
+    if (!effectInfo) {
+      return 0
+    }
+    return effectInfo.amplifier + 1
+  }
+
+  bot.elytraFly = async () => {
+    if (bot.entity.elytraFlying) {
+      throw new Error('Already elytra flying')
+    } else if (bot.entity.onGround) {
+      throw new Error('Unable to fly from ground')
+    } else if (bot.entity.isInWater) {
+      throw new Error('Unable to elytra fly while in water')
+    }
+
+    const mcData = require('minecraft-data')(bot.version)
+    if (getEffectLevel(mcData, 'Levitation', bot.entity.effects) > 0) {
+      throw new Error('Unable to elytra fly with levitation effect')
+    }
+
+    const torsoSlot = bot.getEquipmentDestSlot('torso')
+    const item = bot.inventory.slots[torsoSlot]
+    if (item == null || item.name !== 'elytra') {
+      throw new Error('Elytra must be equip to start flying')
+    }
+    bot._client.write('entity_action', {
+      entityId: bot.entity.id,
+      actionId: 8,
+      jumpBoost: 0
+    })
+  }
+
   bot.setControlState = (control, state) => {
     assert.ok(control in controlState, `invalid control: ${control}`)
     assert.ok(typeof state === 'boolean', `invalid state: ${state}`)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mineflayer",
-  "version": "4.13.0",
+  "version": "4.14.0",
   "description": "create minecraft bots with a stable, high level API",
   "main": "index.js",
   "types": "index.d.ts",
@@ -21,7 +21,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "minecraft-data": "^3.37.0",
+    "minecraft-data": "^3.44.0",
     "minecraft-protocol": "^1.44.0",
     "prismarine-biome": "^1.1.1",
     "prismarine-block": "^1.17.0",
@@ -30,7 +30,7 @@
     "prismarine-entity": "^2.3.0",
     "prismarine-item": "^1.14.0",
     "prismarine-nbt": "^2.0.0",
-    "prismarine-physics": "^1.7.0",
+    "prismarine-physics": "^1.8.0",
     "prismarine-recipe": "^1.3.0",
     "prismarine-registry": "^1.5.0",
     "prismarine-windows": "^2.8.0",