Sonar

Releases | Issues | Pull Requests | Discord | License | Documentation

Notice about Sonar 3.0

We're excited to announce the public release of Sonar 3.0. If you are interested, please check out https://sonar.top/. You can read more about what sets Sonar 3.0 apart from Sonar 2.0 here. If you want more robust protection, better performance, and awesome new features, check out Sonar 3.0!

Design and Goal

• Effective, lightweight, and easy-to-use
• No unnecessary features and clean code
• Protection against all kinds of bot attacks
• No player should be annoyed by any sort of CAPTCHA
• No sort of checking for VPNs or proxies
• Multi-platform support (See supported versions)

Checks

Sonar analyzes a player's behavior before joining the actual server, therefore stopping malicious traffic from ever reaching the backend. It is supposed to be an instant, powerful, and simple method of verification that should prevent all typical and advanced types of bots.

1. Sonar sends the player to a lightweight fake server when they connect for the first time.
2. Sonar verifies that players obey the laws of Minecraft's physics, including gravity and proper block collision.
3. Sonar verifies that players send legitimate packets when interacting with vehicles (e.g. boats).
4. Sonar makes sure that players send legitimate packets according to the vanilla Minecraft protocol.

Sonar also protects against spambot attacks since it queues the incoming connections, therefore making it technically impossible to have a ton of bots join the server at the same time.

False positives

Sonar is unlikely to ever falsely prevent a player from joining the server since Minecraft uses the TCP protocol, which means that packets are always sent in the correct order. Therefore, lag or ping should not affect the bot check. If you or one of your players experiences a false positive, make sure to report it by opening a GitHub issue or a ticket on the Discord server.

Sponsors

If you are interested in sponsoring this project, please contact me via Discord.

Past Sponsors

Building

If you want to build your own version of Sonar, please take a look at the Sonar building documentation. You can also take a look at the gradle documentation for a better understanding of Gradle.

Contributing

If you are interested in contributing, you can check out the Contributing Guidelines for detailed instructions.

License

Sonar is licensed under the GNU General Public License 3.0.

Credits

• Special thanks to the contributors of Sonar.