diff options
| author | mat <git@matdoes.dev> | 2025-12-23 03:52:41 +0200 |
|---|---|---|
| committer | mat <git@matdoes.dev> | 2025-12-22 17:52:56 -0800 |
| commit | 83f720d9becd70f3c2333772f040b6092785a60e (patch) | |
| tree | 28a4d1967fa2fbbf7ac10bb038f26dba69bebd08 /azalea/src/join_opts.rs | |
| parent | 9097abb39bf1852676a50bac04575bcc6ec4150c (diff) | |
| download | azalea-drasl-83f720d9becd70f3c2333772f040b6092785a60e.tar.xz | |
move JoinOpts to a separate module
Diffstat (limited to 'azalea/src/join_opts.rs')
| -rw-r--r-- | azalea/src/join_opts.rs | 107 |
1 files changed, 107 insertions, 0 deletions
diff --git a/azalea/src/join_opts.rs b/azalea/src/join_opts.rs new file mode 100644 index 00000000..d7283674 --- /dev/null +++ b/azalea/src/join_opts.rs @@ -0,0 +1,107 @@ +use std::net::SocketAddr; + +use azalea_protocol::{address::ServerAddr, connect::Proxy}; + +/// Optional settings when adding an account to a swarm or client. +#[derive(Clone, Debug, Default)] +#[non_exhaustive] +pub struct JoinOpts { + /// The SOCKS5 proxy that this bot will use for connecting to the Minecraft + /// server. + pub server_proxy: Option<Proxy>, + /// The SOCKS5 proxy that will be used when authenticating the bot's join + /// with Mojang. + /// + /// This should typically be either the same as [`Self::server_proxy`] or + /// `None`. + /// + /// This is useful to set if a server has `prevent-proxy-connections` + /// enabled. + pub sessionserver_proxy: Option<Proxy>, + /// Override the server address that this specific bot will send in the + /// handshake packet. + #[doc(alias = "custom_address")] + pub custom_server_addr: Option<ServerAddr>, + /// Override the IP and port that this specific bot will use to connect + /// to the server. + #[doc(alias = "custom_resolved_address")] + pub custom_socket_addr: Option<SocketAddr>, +} + +impl JoinOpts { + pub fn new() -> Self { + Self::default() + } + + pub fn update(&mut self, other: &Self) { + if let Some(proxy) = other.server_proxy.clone() { + self.server_proxy = Some(proxy); + } + if let Some(proxy) = other.sessionserver_proxy.clone() { + self.sessionserver_proxy = Some(proxy); + } + if let Some(custom_server_addr) = other.custom_server_addr.clone() { + self.custom_server_addr = Some(custom_server_addr); + } + if let Some(custom_socket_addr) = other.custom_socket_addr { + self.custom_socket_addr = Some(custom_socket_addr); + } + } + + /// Configure the SOCKS5 proxy used for connecting to the server and for + /// authenticating with Mojang. + /// + /// To configure these separately, for example to only use the proxy for the + /// Minecraft server and not for authentication, you may use + /// [`Self::server_proxy`] and [`Self::sessionserver_proxy`] individually. + #[must_use] + pub fn proxy(self, proxy: Proxy) -> Self { + self.server_proxy(proxy.clone()).sessionserver_proxy(proxy) + } + /// Configure the SOCKS5 proxy that will be used for connecting to the + /// Minecraft server. + /// + /// To avoid errors on servers with the "prevent-proxy-connections" option + /// set, you should usually use [`Self::proxy`] instead. + /// + /// Also see [`Self::sessionserver_proxy`]. + #[must_use] + pub fn server_proxy(mut self, proxy: Proxy) -> Self { + self.server_proxy = Some(proxy); + self + } + /// Configure the SOCKS5 proxy that this bot will use for authenticating the + /// server join with Mojang's API. + /// + /// Also see [`Self::proxy`] and [`Self::server_proxy`]. + #[must_use] + pub fn sessionserver_proxy(mut self, proxy: Proxy) -> Self { + self.sessionserver_proxy = Some(proxy); + self + } + + /// Set the custom address that this bot will send in the handshake packet. + #[must_use] + pub fn custom_server_addr(mut self, server_addr: ServerAddr) -> Self { + self.custom_server_addr = Some(server_addr); + self + } + /// Set the custom resolved address that this bot will use to connect to the + /// server. + #[must_use] + pub fn custom_socket_addr(mut self, socket_addr: SocketAddr) -> Self { + self.custom_socket_addr = Some(socket_addr); + self + } + + #[doc(hidden)] + #[deprecated = "renamed to `custom_server_addr`."] + pub fn custom_address(self, server_addr: ServerAddr) -> Self { + self.custom_server_addr(server_addr) + } + #[doc(hidden)] + #[deprecated = "renamed to `custom_socket_addr`."] + pub fn custom_resolved_address(self, socket_addr: SocketAddr) -> Self { + self.custom_socket_addr(socket_addr) + } +} |
