Takumi

A high-performance Minecraft proxy server written in Rust

Takumi sits between players and your Minecraft backend servers. Clients connect to the proxy, which handles the Minecraft protocol and routes traffic to the appropriate server.

Features

• Async I/O powered by Tokio
• Minecraft protocol handling (handshaking, status, login)
• Modular workspace with reusable crates:
  • minecraft_packet — packet parsing and connection management
  • takumi_macros — procedural macros for packet definitions

Requirements

• Rust (2024 edition)

Getting Started

Clone the repository and run the proxy:

git clone https://github.com/AxenoDev/Takumi.git
cd Takumi
cargo run

The proxy listens on 0.0.0.0:25565 by default.

Building

# Debug build
cargo build

# Release build
cargo build --release

The release binary is available at target/release/takumi.

Contributing

Contributions are welcome! Please read CONTRIBUTING.md before opening a pull request.

By participating in this project, you agree to abide by our Code of Conduct.

Security

If you discover a security vulnerability, please report it responsibly. See SECURITY.md for details.

License

Takumi is licensed under the GNU General Public License v3.0.

_{Some parts of the code are inspired by PicoLimbo.}