gkursi / azalea

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

Azalea

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

Currently supported Minecraft version: 1.21.

Warning

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

Features

• Accurate physics (but some features like entity collisions and water physics 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.

Branches

There are several branches in the Azalea repository that target older Minecraft versions. Most of them are severely outdated compared to the latest version of Azalea. If you'd like to update them or add more, please open a PR.

• 1.20.5-1.20.6
• 1.20.4
• 1.20.2
• 1.20-1.20.1
• 1.19.4
• 1.19.3
• 1.19.2