enderpearl 1.0.1

Async proxy for Minecraft and HTTP traffic with automated server wake-up.
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
111
112
113
114
115
116
117
118
119
120
121
122

use std::fmt;

#[cfg(feature = "java")]
pub mod java;
#[cfg(feature = "web")]
pub mod web;

#[derive(Debug, Clone, Copy)]
pub enum ProtocolKind {
    Java,

    Web,
}

#[cfg(feature = "java")]
use crate::hooks::DebugHook;
#[cfg(feature = "java")]
use crate::protocols::java::MinecraftJava;
#[cfg(feature = "java")]
use refractium::hook_protocol;
#[cfg(feature = "web")]
use refractium::protocols::http::Http;
use std::sync::Arc;

#[cfg(feature = "java")]
hook_protocol!(
    wrapper: HookedJava,
    proto: MinecraftJava,
    hooks: [DebugHook]
);

impl ProtocolKind {
    /// Creates a protocol instance for this kind, if the feature is enabled.
    #[must_use]
    pub fn instantiate(self, debug: bool) -> Option<Arc<dyn refractium::RefractiumProtocol>> {
        match self {
            Self::Java => {
                #[cfg(feature = "java")]
                {
                    if debug {
                        Some(Arc::new(HookedJava::new()))
                    } else {
                        Some(Arc::new(java::MinecraftJava))
                    }
                }
                #[cfg(not(feature = "java"))]
                {
                    None
                }
            }

            Self::Web => {
                #[cfg(feature = "web")]
                {
                    if debug {
                        Some(Arc::new(web::HookedHttp::new()))
                    } else {
                        Some(Arc::new(Http))
                    }
                }
                #[cfg(not(feature = "web"))]
                {
                    None
                }
            }
        }
    }
}

impl fmt::Display for ProtocolKind {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        let name = match self {
            Self::Java => "Minecraft Java",

            Self::Web => "Web/HTTP",
        };
        write!(f, "{name}")
    }
}

pub struct ProtocolMeta {
    pub kind: ProtocolKind,
    pub id: &'static str,
    pub aliases: &'static [&'static str],
    pub feature: &'static str,
    pub is_enabled: bool,
    pub display_name: &'static str,
    pub config_key: &'static str,
    pub default_port: &'static str,
}

pub const PROTOCOLS: &[ProtocolMeta] = &[
    ProtocolMeta {
        kind: ProtocolKind::Java,
        id: "minecraftjava",
        aliases: &["minecraft_java", "java", "mcj"],
        feature: "java",
        is_enabled: cfg!(feature = "java"),
        display_name: "Minecraft Java",
        config_key: "minecraft_java",
        default_port: "127.0.0.1:25566",
    },
    ProtocolMeta {
        kind: ProtocolKind::Web,
        id: "http",
        aliases: &["web", "http", "website"],
        feature: "web",
        is_enabled: cfg!(feature = "web"),
        display_name: "Web/HTTP",
        config_key: "web",
        default_port: "127.0.0.1:8080",
    },
];

impl ProtocolMeta {
    #[must_use]
    pub fn lookup(name: &str) -> Option<&'static Self> {
        PROTOCOLS
            .iter()
            .find(|p| p.id == name || p.aliases.contains(&name))
    }
}