piston-mc 0.1.4-beta

# Piston-MC

A Rust library for interacting with the Minecraft game and its related services, such as asset downloading and version management.

## Features

- **Version Manifest Fetching** - Query all Minecraft versions from Mojang's official API
- **Client & Server Downloads** - Download Minecraft client and server JARs with progress tracking
- **Library Downloads** - Download game libraries including platform-specific native libraries
- **Asset Management** - Download and validate game assets (textures, sounds, etc.)
- **Java Runtime Management** - Fetch and install Java runtimes for any platform
- **Patch Notes** - Fetch patch notes for Java Edition, Bedrock Edition, Dungeons, and Launcher
- **News** - Fetch Minecraft news from Mojang's launcher content API
- **SHA1 Validation** - Verify file integrity after downloads
- **Parallel Downloads** - Configurable concurrent downloads for faster asset retrieval
- **Progress Reporting** - Real-time download progress via async channels
- **Async First** - Built on Tokio for easy integration with asynchronous Rust applications

## Cargo Features


| Feature                | Description                                      | Default |
|------------------------|--------------------------------------------------|---------|
| `java`                 | Java runtime management                          | Yes     |
| `assets`               | Asset downloading and validation                 | Yes     |
| `downloads`            | Download utilities (required by assets/java)     | Yes     |
| `news`                 | Minecraft news fetching                          | No      |
| `patch-notes`          | All patch notes modules                          | No      |
| `java-patch-notes`     | Java Edition patch notes                         | No      |
| `bedrock-patch-notes`  | Bedrock Edition patch notes                      | No      |
| `dungeons-patch-notes` | Minecraft Dungeons patch notes                   | No      |
| `launcher-patch-notes` | Minecraft Launcher patch notes                   | No      |
| `log`                  | Enable logging via the `log` crate               | No      |

To enable specific features:
```toml
[dependencies]
piston-mc = { git = "https://github.com/Drew-Chase/piston-mc.git", features = ["news", "patch-notes"] }
```

## Installation

You can install `piston-mc` from the git repostitory by adding this to the `Cargo.toml` file:
```toml
[dependencies]
piston-mc = { git = "https://github.com/Drew-Chase/piston-mc.git" }
```

or by running this command:
```bash
cargo add piston-mc --git https://github.com/Drew-Chase/piston-mc.git
```

## Usage

for usage information you can view the [examples](/examples) in the repository or the [wiki](https://github.com/Drew-Chase/piston-mc/wiki).