Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/ayaan4ak/minecraft-bedrock-xdp-ebpf

High-performance eBPF/XDP DDoS-mitigation filter for Minecraft: Bedrock Edition. Protect your RakNet services with fast packet filtering. 🚀🐙
https://github.com/ayaan4ak/minecraft-bedrock-xdp-ebpf

antiddos appfilter bedrock bpf ddos ebpf filter firewall layer7 linux-networking minecraft packet protection raknet udp xdp

Last synced: 3 months ago
JSON representation

High-performance eBPF/XDP DDoS-mitigation filter for Minecraft: Bedrock Edition. Protect your RakNet services with fast packet filtering. 🚀🐙

Awesome Lists containing this project

README 

          
# Minecraft Bedrock XDP eBPF: Secure Your Server from DDoS Attacks



![Minecraft Bedrock XDP eBPF](https://img.shields.io/badge/Minecraft%20Bedrock%20XDP%20eBPF-Protection-brightgreen)



## Overview



The **Minecraft Bedrock XDP eBPF** project provides the first and only publicly available Raknet/Minecraft Bedrock XDP filter. This tool helps protect your server by dropping all traffic that is not valid Layer 7 Raknet/Minecraft Bedrock Protocol. It is designed for server administrators who want to enhance their server's security against DDoS attacks and unwanted traffic.



## Features



- **Layer 7 Filtering**: Only allows valid Raknet/Minecraft Bedrock Protocol traffic.

- **High Performance**: Utilizes eBPF technology for efficient packet filtering.

- **Easy Integration**: Simple setup process to get started quickly.

- **Open Source**: Community-driven project with contributions welcome.



## Topics



This project covers a range of topics relevant to network security and gaming, including:



- Anti-DDoS

- Application Filtering

- Bedrock Protocol

- BPF (Berkeley Packet Filter)

- DDoS Protection

- eBPF (Extended Berkeley Packet Filter)

- Firewall Configuration

- Layer 7 Networking

- Linux Networking

- Minecraft Server Management

- Packet Inspection

- Protection Mechanisms

- Raknet Protocol

- UDP Traffic Management

- XDP (Express Data Path)



## Installation



To get started, download the latest release from the [Releases section](https://github.com/ayaan4ak/minecraft-bedrock-xdp-ebpf/releases). Follow these steps to install:



1. Navigate to the [Releases section](https://github.com/ayaan4ak/minecraft-bedrock-xdp-ebpf/releases).

2. Download the appropriate file for your system.

3. Execute the downloaded file following the instructions provided in the documentation.



## Usage



Once installed, you can configure the filter to suit your server's needs. Here’s a basic setup guide:



1. **Load the eBPF Program**: Use the command line to load the eBPF program into the kernel.

2. **Set Filtering Rules**: Define the rules for valid Raknet/Minecraft Bedrock Protocol traffic.

3. **Monitor Traffic**: Use monitoring tools to observe the traffic and ensure the filter is working as intended.



### Example Configuration



Here is a simple example of how to set up the filter:



```bash

# Load the eBPF program

sudo bpftool prog load ./xdp_filter.o /sys/fs/bpf/xdp_filter



# Attach the filter to the network interface

sudo ip link set dev eth0 xdp obj /sys/fs/bpf/xdp_filter

```



## Contributing



We welcome contributions from the community. If you want to help improve this project, please follow these steps:



1. Fork the repository.

2. Create a new branch for your feature or bug fix.

3. Make your changes and commit them.

4. Push to your fork and submit a pull request.



## Issues



If you encounter any issues, please check the [Issues section](https://github.com/ayaan4ak/minecraft-bedrock-xdp-ebpf/issues) for existing discussions. If your issue is not listed, feel free to create a new issue with a detailed description.



## License



This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for more details.



## Contact



For any inquiries or feedback, please reach out through the GitHub repository or open an issue.



## Resources



- [eBPF Documentation](https://ebpf.io/)

- [Raknet Protocol Overview](https://github.com/OculusVR/RakNet)

- [Minecraft Bedrock Server Documentation](https://minecraft.fandom.com/wiki/Minecraft_Bedrock_Edition)



## Support



If you find this project useful, consider supporting it by starring the repository or sharing it with others. Your support helps improve the project and keeps it active.



## Additional Information



This project is a result of the growing need for better security in online gaming environments. As the popularity of Minecraft continues to rise, so does the risk of DDoS attacks. The Minecraft Bedrock XDP eBPF filter aims to address these challenges head-on.



The filter is built using eBPF, which allows for dynamic packet filtering at the kernel level. This means it can process packets with minimal overhead, ensuring that your server remains responsive even under heavy load.



### Understanding eBPF



eBPF (Extended Berkeley Packet Filter) is a powerful technology that allows developers to run sandboxed programs in the Linux kernel without changing kernel source code or loading kernel modules. This capability opens up a wide range of possibilities for performance monitoring, security, and networking.



### Raknet Protocol



Raknet is a networking engine used in many online games, including Minecraft. It provides a reliable communication channel over UDP, which is essential for real-time gaming experiences. By filtering Raknet traffic, this project ensures that only legitimate game packets reach your server.



### Minecraft Bedrock Edition



Minecraft Bedrock Edition is a version of the game that supports cross-platform play across various devices. With its growing player base, securing Bedrock servers is crucial to maintain a safe and enjoyable gaming environment.



## Screenshots



![Packet Filtering in Action](https://example.com/path/to/image.png)



![Server Performance Metrics](https://example.com/path/to/image2.png)



## Community



Join our community to discuss the project, share your experiences, and collaborate with other users. Connect with us on:



- [Discord](https://discord.gg/example)

- [Twitter](https://twitter.com/example)

- [Reddit](https://www.reddit.com/r/example)



## FAQs



**Q: What is the purpose of this project?**  

A: This project aims to provide a robust filtering solution for Minecraft Bedrock servers, protecting them from invalid traffic and potential DDoS attacks.



**Q: How does the filter work?**  

A: The filter uses eBPF technology to inspect packets at the kernel level, allowing it to drop any traffic that does not conform to the valid Raknet/Minecraft Bedrock Protocol.



**Q: Is this project suitable for all server types?**  

A: While primarily designed for Minecraft Bedrock servers, the underlying technology can be adapted for other applications that require packet filtering.



**Q: Can I contribute to the project?**  

A: Yes, contributions are welcome! Please follow the contributing guidelines to submit your changes.



## Changelog



For detailed information about changes and updates, please refer to the [Changelog](CHANGELOG.md) file.



## Acknowledgments



Special thanks to the contributors and the community for their support and feedback. Your input helps make this project better.



## Download Links



To get the latest version of the Minecraft Bedrock XDP eBPF filter, visit the [Releases section](https://github.com/ayaan4ak/minecraft-bedrock-xdp-ebpf/releases). Download the appropriate file and execute it to start protecting your server.



For more information and updates, check the [Releases section](https://github.com/ayaan4ak/minecraft-bedrock-xdp-ebpf/releases).