Azalea

A collection of Rust crates for making Minecraft bots, clients, and tools.

Currently supported Minecraft version: 1.21.5.

Warning

Azalea is still unfinished, though most crates are in a useable state

Features

• Accurate physics (but some features like entity pushing and elytras aren't yet implemented)
• Pathfinder
• Swarms
• Breaking blocks
• Block interactions & building (this doesn't predict the block interactions/placement on the client yet but it's usually fine)
• Inventories
• Attacking entities (but you can't get the entity at the crosshair yet)

Docs

The "stable" documentation is available at docs.rs/azalea and the unstable docs are at azalea.matdoes.dev (recommended).

Matrix/Discord

If you'd like to chat about Azalea, you can join the Matrix space at #azalea:matdoes.dev (recommended) or the Discord server at discord.gg/FaRey6ytmC (they're bridged so you don't need to join both).

Goals

• Do everything a vanilla client can do.
• Be intuitive and easy to use.
• Make it easy to have many bots working at the same time.
• Don't trigger anticheats.
• Support the latest Minecraft version.
• Be fast and memory efficient.

Non-goals

• Supporting several versions of Minecraft on the same branch*.
• Bedrock edition.
• Graphics.

Real-world bots using Azalea

Here's an incomplete list of bots built using Azalea, primarily intended as a reference in addition to the existing documentation and examples:

• ShayBox/ShaysBot - Pearl statis bot featuring a Discord bot, an HTTP API, and more.
• EnderKill98/statis-bot - This bot can automatically detect thrown pearls and later walk there and pull them for you.
• as1100k/aether - Collection of Minecraft bots and plugins.
• mat-1/potato-bot-2 - Hardened Discord chat bridge created for the LiveOverflow SMP.
• ErrorNoInternet/ErrorNoWatcher - A Minecraft bot with Lua scripting support.

You can see more projects built with Azalea in the GitHub dependency graph.

Plugins

Azalea has support for Bevy plugins, which can significantly alter its functionality. Here's some plugins you may find useful:

• azalea-rs/azalea-viaversion - Multi-version compatibility for your Azalea bots using ViaProxy.
• azalea-rs/azalea-hax - Anti-knockback.

If you've created your own plugin for Azalea, please create a PR to add it to this list :).