# earthmc [](https://crates.io/crates/earthmc) [](https://docs.rs/earthmc)
`earthmc` is an async Rust client to interact with the
[EarthMC](https://earthmc.net) API.
## Installation
Add the following to your `Cargo.toml`:
```toml
[dependencies]
earthmc = "2.0.0"
```
Alternatively you can run:
```bash
cargo add earthmc
```
## Usage
### Create a new client
```rust
let client = Client::default();
```
Detailed usage examples are in the `examples` directory.
## Examples
This package provides some usage examples in the [`examples`](/examples/)
directory. You can run a given example using e.g.
`cargo run --example query_towns` (or `just example query_towns` if you have
[`just`](https://just.systems/man/en/) installed)