readme.md
This commit is contained in:
parent
d9c5f13b42
commit
87015c951f
140
README.md
140
README.md
@ -2,8 +2,8 @@
|
|||||||
lightweight minecraft packets protocol support in pure rust \
|
lightweight minecraft packets protocol support in pure rust \
|
||||||
has compression (`MinecraftConnection::set_compression`) \
|
has compression (`MinecraftConnection::set_compression`) \
|
||||||
all types of packets you can find on [wiki.vg](https://wiki.vg/) \
|
all types of packets you can find on [wiki.vg](https://wiki.vg/) \
|
||||||
[on crates](https://crates.io/crates/rust_mc_proto)
|
[Crates](https://crates.io/crates/rust_mc_proto)
|
||||||
[on github](https://github.com/MeexReay/rust_mc_proto)
|
[Github](https://github.com/MeexReay/rust_mc_proto)
|
||||||
|
|
||||||
## how to use it
|
## how to use it
|
||||||
|
|
||||||
@ -13,7 +13,8 @@ pub type MCConn<T> = MinecraftConnection<T>;
|
|||||||
pub type MCConnTcp = MinecraftConnection<TcpStream>;
|
pub type MCConnTcp = MinecraftConnection<TcpStream>;
|
||||||
```
|
```
|
||||||
|
|
||||||
example of receiving motd: (`cargo run --example recv_motd`)
|
example of receiving motd:
|
||||||
|
|
||||||
```rust
|
```rust
|
||||||
use rust_mc_proto::{Packet, ProtocolError, MCConnTcp, DataBufferReader, DataBufferWriter};
|
use rust_mc_proto::{Packet, ProtocolError, MCConnTcp, DataBufferReader, DataBufferWriter};
|
||||||
|
|
||||||
@ -66,135 +67,6 @@ fn main() {
|
|||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
example of simple server that only send motd and ping (`cargo run --example status_server`)
|
[more examples](https://github.com/MeexReay/rust_mc_proto/tree/main/examples)
|
||||||
```rust
|
|
||||||
use std::{net::TcpListener, sync::{Arc, Mutex}, thread};
|
|
||||||
use rust_mc_proto::{DataBufferReader, DataBufferWriter, MCConnTcp, MinecraftConnection, Packet, ProtocolError};
|
|
||||||
|
|
||||||
/*
|
this crate can be used for a server on rust idk -_-
|
||||||
|
|
||||||
Example of simple server that sends motd
|
|
||||||
to client like a vanilla minecraft server
|
|
||||||
|
|
||||||
*/
|
|
||||||
|
|
||||||
struct MinecraftServer {
|
|
||||||
server_ip: String,
|
|
||||||
server_port: u16,
|
|
||||||
protocol_version: u16,
|
|
||||||
motd: String
|
|
||||||
}
|
|
||||||
|
|
||||||
impl MinecraftServer {
|
|
||||||
fn new(server_ip: &str,
|
|
||||||
server_port: u16,
|
|
||||||
protocol_version: u16,
|
|
||||||
motd: &str) -> Self {
|
|
||||||
MinecraftServer {
|
|
||||||
server_ip: server_ip.to_string(),
|
|
||||||
server_port,
|
|
||||||
protocol_version,
|
|
||||||
motd: motd.to_string()
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
fn accept_client(mut conn: MCConnTcp, server: Arc<Mutex<MinecraftServer>>) -> Result<(), ProtocolError> {
|
|
||||||
let mut handshake = false;
|
|
||||||
|
|
||||||
loop {
|
|
||||||
let mut packet = match conn.read_packet() {
|
|
||||||
Ok(i) => i,
|
|
||||||
Err(_) => {
|
|
||||||
break;
|
|
||||||
},
|
|
||||||
};
|
|
||||||
|
|
||||||
if handshake {
|
|
||||||
if packet.id() == 0x00 {
|
|
||||||
let mut status = Packet::empty(0x00);
|
|
||||||
|
|
||||||
let serv = server.lock().unwrap();
|
|
||||||
|
|
||||||
let motd = serv.motd.clone();
|
|
||||||
let motd = motd.replace(
|
|
||||||
"PROTOCOL_VERSION",
|
|
||||||
&serv.protocol_version.to_string());
|
|
||||||
|
|
||||||
status.write_string(&motd)?;
|
|
||||||
conn.write_packet(&status)?;
|
|
||||||
} else if packet.id() == 0x01 {
|
|
||||||
let mut status = Packet::empty(0x01);
|
|
||||||
status.write_long(packet.read_long()?)?;
|
|
||||||
conn.write_packet(&status)?;
|
|
||||||
}
|
|
||||||
} else if packet.id() == 0x00 {
|
|
||||||
let protocol_version = packet.read_i32_varint()?;
|
|
||||||
let server_address = packet.read_string()?;
|
|
||||||
let server_port = packet.read_unsigned_short()?;
|
|
||||||
let next_state = packet.read_u8_varint()?;
|
|
||||||
|
|
||||||
if next_state != 1 { break; }
|
|
||||||
|
|
||||||
println!("Client handshake info:");
|
|
||||||
println!(" IP: {}", conn.get_ref().peer_addr().unwrap());
|
|
||||||
println!(" Protocol version: {}", protocol_version);
|
|
||||||
println!(" Server address: {}", server_address);
|
|
||||||
println!(" Server port: {}", server_port);
|
|
||||||
|
|
||||||
handshake = true;
|
|
||||||
} else {
|
|
||||||
break;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
conn.close();
|
|
||||||
|
|
||||||
Ok(())
|
|
||||||
}
|
|
||||||
|
|
||||||
fn main() {
|
|
||||||
let server = MinecraftServer::new(
|
|
||||||
"127.0.0.1",
|
|
||||||
25565,
|
|
||||||
765,
|
|
||||||
"{
|
|
||||||
\"version\":{
|
|
||||||
\"protocol\":PROTOCOL_VERSION,
|
|
||||||
\"name\":\"Version name\"
|
|
||||||
},
|
|
||||||
\"players\":{
|
|
||||||
\"online\":0,
|
|
||||||
\"max\":1,
|
|
||||||
\"sample\":[
|
|
||||||
{
|
|
||||||
\"uuid\": \"\",
|
|
||||||
\"name\": \"Notch\"
|
|
||||||
}
|
|
||||||
]
|
|
||||||
},
|
|
||||||
\"description\": {
|
|
||||||
\"text\": \"Hello World!\",
|
|
||||||
\"color\": \"red\",
|
|
||||||
\"bold\": true
|
|
||||||
},
|
|
||||||
\"favicon\": \"data:image/png;base64,R0lGODlhAQABAIAAAP///wAAACwAAAAAAQABAAACAkQBADs=\"
|
|
||||||
}"
|
|
||||||
);
|
|
||||||
|
|
||||||
let addr = server.server_ip.clone() + ":" + &server.server_port.to_string();
|
|
||||||
let listener = TcpListener::bind(addr).unwrap();
|
|
||||||
let server = Arc::new(Mutex::new(server));
|
|
||||||
|
|
||||||
for stream in listener.incoming() {
|
|
||||||
let stream = stream.unwrap();
|
|
||||||
let local_server = server.clone();
|
|
||||||
|
|
||||||
thread::spawn(move || {
|
|
||||||
accept_client(MinecraftConnection::new(stream), local_server).unwrap();
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
I think this crate can be used for a server on rust idk -_-
|
|
Loading…
Reference in New Issue
Block a user