The highly customizable, organized, and optimized checks configuration for Matrix Anticheat, a powerful, modern, and lightweight anticheat for Minecraft 1.8 and higher.
|
Make sure to use files compatible with your Matrix version!
|
|
⚠ REQUIRED INSTALLATION NOTE:
You must install language.yml to use placeholders!
Otherwise, many messages will be unreadable! Every message
contains placeholders that require the language file.
⚠ GENERAL NOTE:
config.yml and language.yml do not include any checks!
Install checks.yml to utilize the main detection changes.
- Download checks.yml and language.yml.
For specific Matrix versions, head to the releases page. - Rename Matrix's original
checks.ymlandlanguage.ymlto something else. - Upload/move the new files to your Matrix plugin folder. (
/plugins/Matrix/) - If you downloaded any optional files, rename them to
checks.yml/language.yml. - Run
/matrix reloador restart the server!
Alternatively, you can just run /matrix dlcfg OBCHXARALB in-game
to download the latest stable build of MatrixChecks. (This ID changes!)
The downside is that all comments are removed and the file size is reduced.
- Download config.yml and language.yml.
- Rename Matrix's original
config.ymlandlanguage.ymlto something else. - Change
cloud_config.enable: falsetotrueinconfig.yml. - Run
/matrix reloador restart the server! The checks will now update on every reboot/reload.
For specific Matrix versions, replacemainin the link with the compatible checks branch.
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!
The main checks file. Includes all of the advertised features.
Conditional commands, optimized checks, increased detection speed, etc.
The main language file. This file must be installed on every Matrix instance.
It contains all of the global placeholders used in checks.yml.
An optional file that only changes a few things from the original config.
Includes organization, minor tweaks, and a pre-set cloud config for MatrixChecks.
Same as language.yml but with the kick command disabled.
This is helpful for debugging or modifying checks without getting kicked.
Same as language.yml but with different kick messages based on confusion.
All kick messages are replaced with a generic message and a number for staff.
This allows staff to know why a player was kicked without letting the player knowing which hacks to disable.
Same as language.yml but with different kick messages based on confusion.
All kick messages are replaced with existing and made-up error messages.
This confuses hackers since they have no idea what they were kicked for.
The exact same as the files above, but minified. These are much smaller in file size but are nearly impossible to read.
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. For instructions, read Cloud Usage.
These are files that are only important for and used in this GitHub repository.
You can completely ignore these files as they have nothing of importance for the end-user.
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 |
|---|---|---|---|---|
killaura |
...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.2 |
3.3 |
Increase if there are many false-positives with this check. This value should never be less than 3.1! |
speed |
tolerance |
0.022 |
0.01 - 0.025 |
Increase if you have many false-positives when moving, decrease if you have many bypasses. RE recommends keeping this at 0.01, although I receive many false-positives with that value. |
fly |
setback_to_void |
true |
false |
Change this to false if players are being teleported to the void. Players may be able to fly and hover over the abyss if disabled! |
fly |
nofall.setback & nofall.damage |
true |
false |
Change both of these to false for servers and minigames where fall-damage is disabled. |
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 |
-1 |
4 - 5 |
Enable this check for minigame servers with chest mechanics such as survival games, skywars, etc. |
... = relative path |
X - X = range |
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.
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
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.
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.
