mirror of
https://github.com/mat-1/azalea.git
synced 2025-08-02 14:26:04 +00:00
69 lines
1.5 KiB
Markdown
Executable file
69 lines
1.5 KiB
Markdown
Executable file
# Azalea
|
|
|
|
A Rust library for creating Minecraft bots.
|
|
|
|
I named this Azalea because it sounds like a cool word and this is a cool library. This project was heavily inspired by PrismarineJS.
|
|
|
|
## Goals
|
|
|
|
- Do everything a vanilla client can do
|
|
- Be easy to use
|
|
- Bypass most/all anticheats
|
|
- Support the latest Minecraft version
|
|
- Be fast
|
|
|
|
## Example code
|
|
|
|
Note that this doesn't work yet, it's just how I want the API to look.
|
|
|
|
```rs
|
|
use azalea::{Bot, Event};
|
|
|
|
let bot = Bot::offline("bot");
|
|
// or let bot = azalea::Bot::microsoft("access token").await;
|
|
|
|
bot.join("localhost".try_into().unwrap()).await.unwrap();
|
|
|
|
loop {
|
|
match bot.recv().await {
|
|
Event::Message(m) {
|
|
if m.username == bot.username { return };
|
|
bot.chat(m.message).await;
|
|
},
|
|
Event::Kicked(m) {
|
|
println!(m);
|
|
bot.reconnect().await.unwrap();
|
|
},
|
|
_ => {}
|
|
}
|
|
}
|
|
```
|
|
|
|
You can use the `azalea::Bots` struct to control many bots as one unit.
|
|
|
|
```rs
|
|
use azalea::{Bot, Bots, Event, pathfinder};
|
|
|
|
#[tokio::main]
|
|
async fn main() {
|
|
let bots = Bots::new();
|
|
|
|
for i in 0..10 {
|
|
bots.add(Bot::offline(format!("bot{}", i)));
|
|
}
|
|
|
|
bots.join("localhost".try_into().unwrap()).await.unwrap();
|
|
|
|
bots.goto(pathfinder::GotoGoal(azalea::BlockCoord(0, 70, 0))).await;
|
|
|
|
// destroy the blocks in this area and then leave
|
|
|
|
bots.fill(
|
|
pathfinder::FillGoal(
|
|
azalea::BlockCoord(-5, 60, -5),
|
|
azalea::BlockCoord(5, 70, 5)
|
|
),
|
|
azalea::block::Air
|
|
).await;
|
|
}
|
|
```
|