# centralcore
`centralcore` is a UI-independent, asynchronous Minecraft launcher library.
It provides Vanilla, Fabric and Forge planning; instance lifecycle operations;
authentication extension points; managed Java; signed static providers; cache,
repair and update workflows; process management; and structured events.
Install the published crate with:
```toml
[dependencies]
centralcore = "1"
tokio = { version = "1", features = ["macros", "rt-multi-thread"] }
```
On Debian/Ubuntu, building the native Secret Service credential backend requires
`libdbus-1-dev` and `pkg-config`:
```text
sudo apt-get install libdbus-1-dev pkg-config
```
```rust,no_run
use centralcore::{CentralCore, InstanceSpec};
#[tokio::main]
async fn main() -> centralcore::Result<()> {
let core = CentralCore::builder()
.data_dir("./centralcore-data")
.build()
.await?;
let instance = core.instances()
.create(InstanceSpec::vanilla("demo", "Demo", "1.21.1")?)
.await?;
println!("{}", instance.id());
Ok(())
}
```
The crate has no dependency on Tauri, Svelte, CentralPanel, or the official
CentralCorp CLI.
## Links
- [API documentation](https://docs.rs/centralcore)
- [GitHub repository](https://github.com/vexato/CentralCore)
- [Examples](https://github.com/vexato/CentralCore/tree/main/crates/centralcore/examples)
- [Changelog](https://github.com/vexato/CentralCore/blob/main/CHANGELOG.md)
- [Security policy](https://github.com/vexato/CentralCore/blob/main/SECURITY.md)
Licensed under MIT.