piston-mc
| Crates.io | piston-mc |
| lib.rs | piston-mc |
| version | 0.1.4-beta |
| created_at | 2025-12-29 04:41:08.425359+00 |
| updated_at | 2026-01-19 05:28:29.76557+00 |
| description | A library for interacting with mojangs piston-mc api |
| homepage | |
| repository | https://github.com/Drew-Chase/piston-mc.git |
| max_upload_size | |
| id | 2009957 |
| size | 221,417 |
Drew Chase (Drew-Chase)
documentation
https://github.com/Drew-Chase/piston-mc/wiki
README
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:
[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:
[dependencies]
piston-mc = { git = "https://github.com/Drew-Chase/piston-mc.git" }
or by running this command:
cargo add piston-mc --git https://github.com/Drew-Chase/piston-mc.git
Usage
for usage information you can view the examples in the repository or the wiki.