MatrixChecks

⚠ 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.

1. Download checks.yml and language.yml.
   _{For specific Matrix versions, head to the releases page.}
2. Rename Matrix's original checks.yml and language.yml to something else. checks.old.yml/language.old.yml will work.
3. Upload/move the new files to your Matrix plugin folder. (/plugins/Matrix/)
4. If you downloaded a file besides checks.yml or language.yml, rename the file to checks.yml/language.yml.
5. Run /matrix reload!

Alternatively, you can just run /matrix dlcfg POWZQTPWMD 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.

1. Download config.yml and language.yml.
2. Rename Matrix's original config.yml and language.yml to something else. config.old.yml/language.old.yml will work.
3. Change cloud_config.enable: false to true in config.yml.
4. Run /matrix reload! The checks will now update on every reboot/reload.
   _{For specific Matrix versions, replace main in 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 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 checks.yml but with all kick commands removed.
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 same as the files above, but minified. These are a lot smaller in file size but are nearly impossible to read.
Because of the small file sizes, the files can be automatically updated quickly on server startup.
These are optimized for cloud usage with config.yml. For instructions, read Cloud Usage.

1. autoclicker.max_cps: 18 → 16 - 24: The highest human CPS is 24.
2. hitbox.max-reach: 3.2 → 3.3: If you have issues with the hitbox check.
3. speed.tolerance: 0.0225 → 0.015 - 0.0325: Decrease if players are bypass speed checks.
4. fly.setback_to_void: true → false: For sky-based servers when players are being teleported to the void.
5. nofall.damage: true → false: For servers with fall-damage disabled.
6. inventory.cancel_vl: 8 → 8 - 12: Laggy connections can cause issues with low numbers.
7. delay.min_delay: 7 → 5 - 9: Decrease if there are bypasses.
8. fastplace.max_place_per_second: 16 → 9 - 19: Decrease if there are bypasses.

FIRST:
Make sure this isn't an issue with the anticheat itself. Test with the default Matrix config files to see if it's an issue with MatrixChecks. If the issue persists, it's most likely an issue with Matrix. Not all issues 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.

• Matrix's Discord: Here
• Issue tracker: Here

THEN:
Make an issue 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.

• Issue Page: Here
• Pull Requests: Here

Do the "weird things" look like "%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 please don't claim it all as your own. (Credit the original authors)