112batman/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.20.4.

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. It is not guaranteed that they will be up-to-date with the latest version of Azalea. If you'd like to update them or add more, please open a PR.

• 1.20.2
• 1.20-1.20.1
• 1.19.4
• 1.19.3
• 1.19.2