How prismarinejs/mineflayer works
Mineflayer is a JavaScript library for creating high-level Minecraft bots. The principal workflow is for an application to create a bot, connect it to a Minecraft server, and use its API to observe world state and perform actions. Internal plugins provide distinct capabilities including world/block queries, entity tracking, movement, digging/building, inventory and crafting, chat, and game-state features. The loader and shared conversion/task utilities form the internal layer. Some plugin details are unsampled; capability coverage and plugin names rely on the README and loader index.
Main entry points: loader.js Bot loader · promise_utils.js Async task utilities · physics.js Physics and movement · entities.js Entity tracking
Components 20
Bot entry
- Mineflayer API
index.js - Bot loader
lib/loader.js - Plugin loader
lib/plugin_loader.js
World model
- Blocks and world
lib/plugins/blocks.js - Entity tracking
lib/plugins/entities.js
Bot actions
- Physics and movement
lib/plugins/physics.js - Digging
lib/plugins/digging.js - Block actions
lib/plugins/block_actions.js - Building and placement
lib/plugins/place_block.js - Inventory
lib/plugins/inventory.js - Crafting
lib/plugins/craft.js
Game state
- Chat
lib/plugins/chat.js - Game state
lib/plugins/game.js - Trading
lib/plugins/villager.js - Scoreboard
lib/plugins/scoreboard.js - Teams
lib/plugins/team.js
Internal utilities
- Protocol conversions
lib/conversions.js - Async task utilities
lib/promise_utils.js
Other components
- Bot application
- Minecraft server
Connections 31
- Bot application → Mineflayer API: uses API
- Mineflayer API → Bot loader: exports
index.js - Bot loader → Plugin loader: uses
lib/loader.js - Bot loader → Minecraft server: creates client
lib/loader.js - Bot loader → Blocks and world: loads plugin
lib/loader.js - Bot loader → Entity tracking: loads plugin
lib/loader.js - Bot loader → Physics and movement: loads plugin
lib/loader.js - Bot loader → Digging: loads plugin
lib/loader.js - Bot loader → Block actions: loads plugin
lib/loader.js - Bot loader → Inventory: loads plugin
lib/loader.js - Bot loader → Crafting: loads plugin
lib/loader.js - Bot loader → Chat: loads plugin
lib/loader.js - Bot loader → Game state: loads plugin
lib/loader.js - Bot loader → Trading: loads plugin
lib/loader.js - Bot loader → Scoreboard: loads plugin
lib/loader.js - Bot loader → Teams: loads plugin
lib/loader.js - Entity tracking → Protocol conversions: converts packets
lib/plugins/entities.js - Physics and movement → Protocol conversions: converts coordinates
lib/plugins/physics.js - Physics and movement → Async task utilities: uses tasks
lib/plugins/physics.js - Digging → Async task utilities: uses tasks
lib/plugins/digging.js - Inventory → Async task utilities: uses tasks
lib/plugins/inventory.js - Inventory → Protocol conversions: converts coordinates
lib/plugins/inventory.js - Crafting → Async task utilities: uses tasks
lib/plugins/craft.js - Chat → Async task utilities: uses tasks
lib/plugins/chat.js - Trading → Async task utilities: uses tasks
lib/plugins/villager.js - Scoreboard → Teams: uses team map
- Blocks and world → Minecraft server: receives updates
lib/plugins/blocks.js - Entity tracking → Minecraft server: receives updates
lib/plugins/entities.js - Physics and movement → Minecraft server: sends movement
lib/plugins/physics.js - Digging → Blocks and world: queries world
lib/plugins/digging.js - Bot application → Building and placement: builds