rcon2mc 0.1.0

A RCON client lib for Minecraft server.
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

/*
 * // Copyright (c) 2026 Jack Wang
 * //
 * // Permission is hereby granted, free of charge, to any person obtaining a copy
 * // of this software and associated documentation files (the "Software"), to deal
 * // in the Software without restriction, including without limitation the rights
 * // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * // copies of the Software, and to permit persons to whom the Software is
 * // furnished to do so, subject to the following conditions:
 * //
 * // The above copyright notice and this permission notice shall be included in all
 * // copies or substantial portions of the Software.
 * //
 * // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 * // SOFTWARE.
 * //
 * // Author: Jack Wang <wang@rjack.cn>
 * // GitHub: https://github.com/nearlyheadlessjack/rcon2mc
 */

use thiserror::Error;

#[derive(Error, Debug)]
pub enum CreatePacketError {
    #[error("Input payload should not contain 0x00")]
    InputPayloadContainsZero,
    #[error("Input payload oversize")]
    InputPayloadOversize,
    #[error("Missing field {0} when creating packet")]
    MissingField(&'static str),
}

#[derive(Error, Debug)]
pub enum BPacketConverterError {
    #[error("Invalid packet: {0}")]
    InvalidPacket(String),
    #[error("Segmenting Error: {0}")]
    SegmentingError(String),
}

#[derive(Error, Debug)]
pub enum RconConnectionError {
    #[error("TCPConnection Timeout")]
    TCPConnectionTimeoutError,
    #[error("TCPConnection Error")]
    TCPConnectionError(#[source] std::io::Error),
    #[error("Missing field {0} when creating TCP Stream")]
    MissingField(&'static str),
    #[error("Stream reading error")]
    StreamReadingError(#[source] std::io::Error),
    #[error("Stream writing error")]
    StreamWritingError(#[source] std::io::Error),
    #[error("Stream closing error")]
    StreamClosingError(#[source] std::io::Error),
}

#[derive(Error, Debug)]
pub enum RconError {
    #[error("Missing field {0} when creating an Rcon connection")]
    MissingField(&'static str),
    #[error("Authentication Failed: Incorrect Password")]
    IncorrectPasswordError,
    #[error("Rcon connection error")]
    RconConnectionError(#[from] RconConnectionError),
    #[error("Failed to create packet")]
    PacketCreationError(#[from] CreatePacketError),
    #[error("Failed to parse received packet")]
    PacketConversionError(#[from] BPacketConverterError),
    #[error("Feedback information is None")]
    FeedbackIsNone,
    #[error("Mismatched Response Packet ID")]
    MismatchedResponsePacketID,
    #[error("Port number is out of range")]
    PortOutOfRangeError,
    #[error("Invalid Command")]
    InvalidCommandError,
    #[error("UnknownParserError for {0}")]
    UnknownParserError(String),
    #[error("InvalidCoordinate: {0}")]
    InvalidCoordinate(String),
    #[error("InvalidArgument: {0}")]
    InvalidCommandArgument(String),
}