Metadata-Version: 2.1
Name: arceus
Version: 2.0.1
Summary: Minecraft name sniper.
Home-page: UNKNOWN
Author: Aquild
License: GPL-3.0-or-later
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.8
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Description-Content-Type: text/markdown
Requires-Dist: arceus-net
Requires-Dist: requests
Requires-Dist: requests-random-user-agent
Requires-Dist: tcp-latency
Requires-Dist: bs4
Requires-Dist: pause
Requires-Dist: click
Requires-Dist: PyInquirer
Requires-Dist: colorama
Requires-Dist: termcolor
Requires-Dist: pyfiglet

# Arceus

The best (probably) free Minecraft name sniper.

## IMPORTANT - LICENSE TERMS

The arceus project is licensed under GNU GPLv3 or later. This means you CANNOT redistribute modifications to the project except under GNU GLPv3. In other words, any modifications you make must also be open source.

## Features

- Transfer and blocking sniper
- Benchmark to test settings
- Low latency by opening the TCP connections before sending requests
- High requests/second by bypassing HTTP overhead

## Installation

You can install using pip:

```sh
pip install arceus
```

## Usage

First, you'll need to create a `config.json`:

```jsonc
{
  "account": {
    "email": <ACCOUNT_EMAIL>,
    "password": <ACCOUNT_PASSWD>
  },
  "offset": <REQUEST_OFFSET>
}
```

CLI Options:

| Name         | Short |         Description |
| :----------- | :---: | ------------------: |
| `--target`   | `-t`  |       Name to snipe |
| `--config`   | `-c`  |  Config file to use |
| `--attempts` | `-a`  |    Request attempts |
| `--later`    | `-l`  | Days later to snipe |

Transfer Snipe:

```sh
arceus transfer
```

Block Snipe:

```sh
arceus block
```

## Benchmarking

CLI Options:

| Name         | Short |                  Description |
| :----------- | :---: | ---------------------------: |
| `--host`     | `-h`  |         Benchmark API to use |
| `--offset`   | `-o`  |        Request timing offset |
| `--attempts` | `-a`  |             Request attempts |
| `--delay`    | `-d`  | Seconds before the benchmark |

_Benchmarking doesn't read `config.json`, if you want to specify an offset, use the `--offset` option_

```sh
arceus benchmark
```


