minecraft-java-rs-core 0.3.0

Core library for launching Minecraft Java Edition
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110

use thiserror::Error;

#[derive(Debug, Error)]
pub enum LaunchError {
    #[error("no authenticator provided")]
    NoAuthenticator,

    #[error("no internet connection and no local cache available")]
    NoInternetNoCache,

    #[error("game data not ready: call download_game first")]
    GameDataNotReady,

    #[error("corrupt local cache: {0}")]
    CorruptCache(String),

    #[error("version '{0}' not found in Mojang manifest")]
    VersionNotFound(String),

    #[error("Java process error: {0}")]
    ProcessError(String),

    #[error("archive error: {0}")]
    Archive(String),

    #[error("download error: {0}")]
    Download(#[from] DownloadError),

    #[error("loader error: {0}")]
    Loader(#[from] LoaderError),

    #[error("IO error: {0}")]
    Io(#[from] std::io::Error),

    #[error("JSON error: {0}")]
    Json(#[from] serde_json::Error),

    // For HTTP calls outside the downloader (version manifest, asset index, etc.)
    #[error("HTTP error: {0}")]
    Http(#[from] reqwest::Error),

    #[error("invalid data: {0}")]
    InvalidData(String),
}

#[derive(Debug, Error)]
pub enum LoaderError {
    #[error("installer download failed: {0}")]
    InstallerDownloadFailed(String),

    #[error("installer JAR not found at: {0}")]
    InstallerNotFound(String),

    // install_profile.json missing from the installer JAR
    #[error("install_profile.json not found in installer JAR")]
    ProfileNotFound,

    #[error("forge processor '{processor}' failed with exit code {code:?}")]
    ProcessorFailed {
        processor: String,
        code: Option<i32>,
    },

    #[error("loader API error: {0}")]
    ApiError(String),

    #[error("loader version not found: {0}")]
    VersionNotFound(String),

    #[error("archive error: {0}")]
    Archive(String),

    #[error("IO error: {0}")]
    Io(#[from] std::io::Error),

    #[error("HTTP error: {0}")]
    Http(#[from] reqwest::Error),

    #[error("JSON error: {0}")]
    Json(#[from] serde_json::Error),
}

#[derive(Debug, Error)]
pub enum DownloadError {
    #[error("checksum mismatch for '{file}': expected {expected}, got {actual}")]
    ChecksumMismatch {
        file: String,
        expected: String,
        actual: String,
    },

    #[error("no mirror available for: {0}")]
    NoMirrorAvailable(String),

    #[error("request timed out")]
    Timeout,

    /// The request never reached the server (DNS failure, unreachable route,
    /// connection reset/timeout). Carries a human description of the
    /// transport-level cause instead of reqwest's opaque "error sending
    /// request for url" message.
    #[error("could not reach {url} ({detail})")]
    Connection { url: String, detail: String },

    #[error("IO error: {0}")]
    Io(#[from] std::io::Error),

    #[error("HTTP error: {0}")]
    Http(#[from] reqwest::Error),
}