MatrixChecks Save Abandoned
The optimized checks for Matrix Anticheat, a powerful anticheat for Minecraft.
⚠️ Archival Notice
This is being archived and requires a new maintainer.
I have fallen out-of-date within the anticheat community.
I'm no longer familiar with the methods clients use, and how to prevent them.
As such, I do not feel comfortable maintaining this repository.If you're willing to maintain, update, and improve this repository,
feel free to make a fork and notify me via email!
MatrixChecks
The highly customizable, organized, and optimized checks configuration for Matrix Anticheat, a powerful, modern, and lightweight anticheat for Minecraft 1.8 and higher.
- Works on free & premium Matrix!
- Improved violation & kick messages.
- Lower amount of false positives.
- Stricter checks. (Faster detection)
- Multiple file types to suit your needs!
- Tons of customization options.
⚠ REQUIRED INSTALLATION NOTE:
You must install language.yml to use this configuration!
Otherwise, all messages will be unreadable and commands will not work!
Every message contains placeholders that require the language file.
📷 Previews
Improved messages
Every single message has been modified to be easily read and understood.
Messages have also been greatly reduced in length to reduce notification spam.
Notifications, kick messages, comments, everywhere with text has been modified!
Hover messages and click commands
You can hover over notification messages to see more details!
This includes client version, ping, server TPS, and the root check/component.
When you click on notifications, you'll instantly spectate the suspected hacker!
And of course, the commands and visuals are customizable in language.yml.
Customization
Every aspect of the configuration is easily customizable via language.yml!
Commands, notification format, kick message, anything you'd ever need to change.
Changes you make will take effect everywhere the variable is used.
🔧 Setup
- Download checks.yml and language.yml.
- Rename Matrix's original
checks.ymlandlanguage.ymlto something else. - Upload/move the new files to your Matrix plugin folder. (
/plugins/Matrix/) - Run
/matrix reloador restart the server!
❔ FAQ
These checks may not work perfectly with your server.
Plugins, software, and performance can all affect how well these checks and the anticheat, in general, will work.
This is not a drag-and-drop solution! Some values may need to be changed to work best with your setup.
Matrix Anticheat, like most, isn't a perfect anticheat. It itself has bugs that we cannot fix.
These checks aim to mitigate those issues and improve what works well, but there's only so much we can do.
Tested and configured for survival and minigame servers. Tweak the checks for your own server!
What is the X folder/file?
Variations
These are modifications of the original checks configuration files (checks.yml, language.yml, config.yml) with pre-configured changes. These changes range from kick obscurity to new detection algorithms.
They're located in the variations folder of the repository. Each variation has its own readme file that describes the variation that shows up when you enter the variation's folder. Just click around to figure out what's offered!
Cloud Files
A directory that contains all of the configuration files, including variations, but minified. These are much smaller in file size but are impossible to read and modify.
Because of the small file sizes, these can be automatically downloaded and updated very quickly on server startup. These are optimized for Matrix cloud usage with config.yml.
Repository files
These are files that are only utilized by GitHub meant for repository information and the scripting system.
Namely:
-
.github/ -
overrides/ -
readme.md -
license.md
Contains various scripts used for repository automation that make everything easier. You can completely ignore these files as they have nothing of importance for the end-user.
Suggested (optional) changes
These are just suggestions, don't change them if you don't need to. Only use these if you're having issues with the listed checks!| Root Check | Path | Default | Suggestion | Reason |
|---|---|---|---|---|
click |
max_cps |
18 |
16 - 24 |
The highest possible CPS achieved by humans is 24. Lag may affect the accuracy of this value. |
hitbox |
max_reach |
3.18 |
3.2 - 3.3 |
Increase if there are many false-positives with this check. This value should never be less than 3.1! |
block |
fastplace.max_place_per_second |
13 |
10 - 18 |
Increase if there are many false-positives when placing blocks, decrease if there are many bypasses. |
scaffold |
...delay.min_delay |
8 |
5 - 9 |
Decrease if there are many false-positives when pillaring, increase if there are many bypasses. |
delay |
check_inventory_action |
4 |
-1 |
Disable this check if players receive many false-positives when shift-clicking in inventories. |
... = relative path |
X - X = range |
How do I report a bypass or false positive?
First:
Make sure this isn't an issue with Matrix itself. Test with the default Matrix config files. If the issue persists, it's most likely an issue with Matrix. You can report the issue to us, but not everything can be fixed with a checks file tweak. Head over to Matrix's support Discord and ask about the issue, or report the issue at their issue tracker.
Then:
Report the issue in the MatrixChecks support Discord or make a report at the issue page with the right template. If you describe what you want to be changed/fixed thoroughly, the chances are that it'll be taken care of quickly. If you already know what the issue is or how to fix it, feel free to make a pull request containing the change and why you made it.
There are weird symbols in every message!
Do the "weird things" look like something along the lines of "%gp_o_pr%"? If so, you have not installed language.yml.
This file is required to replace those placeholders with what they're meant to be. Installation
Can I modify the files in MatrixChecks?
Yes! I encourage you to do so. Since all servers are different, you most likely will have to modify the files anyway.
You can also distribute it all you want or use it on a large network; just don't remove copyright notices as that's against the license.
How can I contribute?
Contributions are very welcome! If you created a new optional file or made tweaks for different minigames, feel free to contact me or make a pull request.
I don't want to start any competition with this project! Having everything in one central repository makes it much easier for the end-user to find what they want.
Open Source Agenda Badge
