mirror of
https://github.com/mat-1/azalea.git
synced 2025-08-02 14:26:04 +00:00
A collection of Rust crates for making Minecraft bots, clients, and tools.
https://azalea.matdoes.dev
mat
a928d83ade
i still haven't actually tested any of this yet lol but in theory it should all work
i'll probably either actually test az-client and fix all the remaining issues or update the azalea crate next
ok also one thing that i'm not particularly happy with is how the packet handlers are doing ugly queries like
```rs
let local_player = ecs
.query::<&LocalPlayer>()
.get_mut(ecs, player_entity)
.unwrap();
```
i think the right way to solve it would be by putting every packet handler in its own system but i haven't come up with a way to make that not be really annoying yet
|
||
|---|---|---|
| .cargo | ||
| .github | ||
| .vscode | ||
| azalea | ||
| azalea-auth | ||
| azalea-block | ||
| azalea-brigadier | ||
| azalea-buf | ||
| azalea-chat | ||
| azalea-client | ||
| azalea-core | ||
| azalea-crypto | ||
| azalea-language | ||
| azalea-nbt | ||
| azalea-physics | ||
| azalea-protocol | ||
| azalea-registry | ||
| azalea-world | ||
| bot | ||
| codegen | ||
| .gitignore | ||
| .gitpod.yml | ||
| Cargo.lock | ||
| Cargo.toml | ||
| LICENSE.md | ||
| README.md | ||
| rust-toolchain | ||
| rustfmt.toml | ||
Azalea
A collection of Rust crates for making Minecraft bots, clients, and tools.
Currently supported Minecraft version: 1.19.3.
⚠️ Azalea is still very unfinished, though most crates are in a somewhat useable state
I named this Azalea because it sounds like a cool word and this is a cool library. This project was heavily inspired by PrismarineJS.
Docs
The "stable" documentation is available at docs.rs/azalea and the unstable docs are at azalea.matdoes.dev
Matrix/Discord
If you'd like to chat about Azalea, you can join the Matrix space at #azalea:matdoes.dev or the Discord server at discord.gg/FaRey6ytmC.
Why
I wanted a fun excuse to do something cool with Rust, and I also felt like I could do better than Mineflayer in some areas.
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.
Stretch goals
- Server implementation. (if you're interested in making this then please contact me, I'd love for it to be a thing. @mat:matdoes.dev / mat#1592)
- Having branches for several popular Minecraft versions.