
<div align="center">
<img alt="Logo" src=".github/assets/logo.png" width="400">
[](https://github.com/Tricked-dev/lowestbins/issues) [](https://github.com/Tricked-dev/lowestbins/network)
[](https://github.com/Tricked-dev/lowestbins/stargazers)
[](https://github.com/Tricked-dev/lowestbins/blob/master/LICENSE)

[](https://discord.gg/mY8zTARu4g)
[](https://github.com/sponsors/Tricked-dev)
[](https://forthebadge.com)
[](https://forthebadge.com)
# Lowestbins-rs
</div>
A fast and effecient lowestbins implementation this uses parrallel requests to fetch all lowestbins in less than **2.5 SECONDS** and uses the hyper server allowing for practically unlimited requests per second while only using 50mb of ram!
## Hosted Instance
- [lb.tricked.pro/](https://lb.tricked.pro/)
If you are using this in a project please credit me! or sponsor me on github [github.com/sponsors/Tricked-dev](https://github.com/sponsors/Tricked-dev)
## Usage
### Docker
```bash
docker run --name lowestbins -p 8080:8080 -e HOST=0.0.0.0 -e UPDATE_SECONDS=120 -d ghcr.io/tricked-dev/lowestbins:latest
```
## Building
- If you're on Linux, you can go to releases and download the binary
- Windows/MacOS: you need to install cargo and run cargo build --release and the exe/binary should be in the target/release/ folder.
## Config Options
Env variables
```env
PORT # The port to run the server on
HOST # The host to run the server on
SAVE_TO_DISK # set to 0 to not save the auctions to disk
OVERWRITES # Overwrite values format: `BLESSED_BAIT:200,ROCK_CANDY:6000,NON_EXISTENT_ITEM:200`
UPDATE_SECONDS # The amount of seconds to wait before updating the lowestbins
WEBHOOK_URL # The webhook url used for reporting the requests (discord/discord compatible)
```
## Features
- NBT parsing
- Fetching auctions and returning the lowest bin
- hyper server
- \+prob more things
> Licensed under the [Apache 2](./LICENSE) License