( Home Page | bStats | Issue Tracker | Discord Server )
# General
Matrix is an anti-cheat solution dedicated to the rapid detection of mainstream hacking methods. This plugin can quickly detect the most common forms of hacking and cheats, such as KillAura or Speed. You can see below what types of cheating Matrix can detect. So far, Matrix has undergone more than a year of development, so the cumulative downloads of the platform have exceeded 52k+. (Matrix used to be free)
After purchasing, please contact me at Discord. I will give you an account and password. You need to enter the account password in config.yml to enable Matrix correctly. In addition, you can download optimized configuration files. I made different configuration files for minigame servers and survival servers, which you can download for free (as long as you purchase Matrix).
# You should know
1. If you find any bypass or false positives, please don't be angry, you can join our official discord server or create an issue on the GitHub issue tracker.
2. I am not very good at English, so the plugin and this overview page may contain spelling/grammar mistakes. If you happen to find any mistake, please report them to me on Discord or in the Discussion page, thank you!
3. Don't report bugs in the Reviews page. Your report will be ignored. Thank you!
4. Matrix support's Minecraft versions 1.8/1.12/1.13/1.14/1.15, but it doesn't support 1.9/1.10/1.11!
5. If you get a NullPointerException error after you update Matrix, please delete/update all old config files!
# Dependency:
ProtocolLib 4.5.0: https://github.com/dmulloy2/ProtocolLib/releases/download/4.5.0/ProtocolLib.jar
# Support & Test Server
-
- Github Issue Tracker: Click me
- Test server: eu.loyisa.cn or tree.ac [both 1.8]
> GUI Control:
Matrix has an in-game GUI for you to control Matrix better, you can use /matrix gui to open it!
> High Performance:
Matrix is a high-performance anti-cheat, it has a very good framework and well-optimized code. Matrix can also automatically disable some less relevant checks when your server is lagging, in order to maintain overall stability.
> Powerful
Matrix has a very comprehensive check that checks the vast majority of types of cheating and protects your server's fairness. All checks are tested multiple times, and we will fix the bypass first time.
> Configurable:
Matrix gives you some config files to customize the anti-cheat, you can also edit the punish commands or canceling violations. If you need any other customization options, I will add more for you!
- You can find all the config files here:config.yml: https://github.com/jiangdashao/Matrix-Issues/blob/master/config.yml
- language.yml: https://github.com/jiangdashao/Matrix-Issues/blob/master/language.yml
- checks.yml: https://github.com/jiangdashao/Matrix-Issues/blob/master/checks.yml
Please note this is not a comprehensive list of every hack blocked.
Format: Hack (Check)
Combat:
Format: Hack (Check)
Combat:
- KillAura/LegitAura/AimBot/MultiAura (KillAura/HitBox)
- Reach (HitBox)
- HitBox (HitBox)
- Autoclicker (KillAura)
- Criticals (KillAura)
- FastBow (FastBow)
- Regen (FastHeal/BadPackets)
- FastUse/FastEat (FastUse/BadPackets)
- SuperKnockback (KillAura)
- WallHit (Interact/HitBox)
- AntiKnockBack (Velocity)
- AutoPot (KillAura)
- FightBot (KillAura/HitBox)
- TPHit (HitBox/Speed/KillAura)
- Fly (Fly/Speed/BadPackets)
- Speed/BunnyHop/Y-Port/etc (Speed/Fly/BadPackets)
- Jesus/LiquidWalk (Jesus/Fly/Speed)
- AirJump (Fly/Speed)
- HighJump (Fly)
- LongJump (Speed/Fly)
- Timer (BadPackets)
- FastWeb (Speed)
- FastLadder/FastClimb (Speed/Fly)
- WallClimb/Spider (Fly/Phase)
- Step (Speed/Fly)
- ReserveStep (Fly)
- NoSlow (Speed)
- ElytraFly/Elytra+ (Elytra)
- VehicleFly/BoatFly/EntitySpeed (Vehicle)
- Sprin (Speed)
- Strafe (Speed)
- NoFall (Fly)
- Riptide Boost (Fly)
- Spam (Chat)
- FastBreak (Block)
- FastPlace (Block)
- Liquid (Interact)
- AbortBreak (Block)
- BedFu*ker (Interact)
- Scaffold (Scaffold)
- Tower (Scaffold)
- AutoFish (AutoFish)
- Nuker (Block)
- BookFlood Crash (BadPackets)
- SkinDerp (BadPackets)
- Teleport (BadPackets/Speed/Fly)
- InventoryMove (Inventory)
- ChestStealer (Inventory)
- Baritone (AutoBot)
# Machine Learning
Matrix has a machine learning KillAura check, it can automatically collect combat data and pre-process it, and then, based on these data, we analyze whether players are cheating or not. You can find a file which named "machine_learning.yml" in the plugin folder, it's a file which saved some pre-trained patterns, also, the plugin can automatically update that file when we release an update for it. If you want to train it, you can see the WIKI
I used the k-NN algorithm to cluster player combat data. Under the data visualization tool, they are distinguished. The orange dot indicates the cheating player, and the blue dot indicates the legit player. Due to the dimension reduction relationship, It’s not good in data visualization, but he’s great in actual performance!
# Compatibility:
Matrix may not be compatible with some plugins which change vanilla mechanics like:
- Velocity modifier
- Speed modifier
- Enchantment modifier
# Commands & Permission
> Commands:
/matrix gui - Open control panel
/matrix notify <message> - Send notify message to all online staff
/matrix verbose - Enable/Disable the verbose output
/matrix kick <player> <reason> - Kick a player out of the server
/matrix msg <player> <message> - Send a warning message to the player
/matrix violations - Open the violation GUI directly
/matrix cps <player> <duration> - view player's click speed
/matrix ping <player> - view player's latency value
/matrix reload - Reload the plugin
> Permissions:
matrix.command: Use the /matrix command
matrix.gui: Use the GUI command
matrix.bypass: Bypass the anti-cheat
matrix.kick: Use the kick command
matrix.notify: See the notify message
matrix.verbose: Use the verbose command and see the verbose output
matrix.warn: Use the "/matrix msg" command
matrix.togglechecks: Opening toggling checks GUI
matrix.violations: Use "/matrix violations" command
matrix.ping: Use the "/matrix ping" command
matrix.cps: Use the "/matrix cps" command
matrix.reload: Use the reload command
matrix.*: All the permissions mentioned above
* op will own these permissions by default
Matrix also has a built-in conditional commands system, you can learn more details here:
https://github.com/jiangdashao/Matrix-Issues/wiki/Conditional-Commands
# Q&A
1. What should you do when you find some false positives or bypass?
Report any odd behavior or bypass on our Issue Tracker
2. What should you do when you need some new checks or features?
You can always send me Suggestions through our Discord server or on the Issue Tracker
# API
Maven repository:
HTML:
<repository>
<id>jitpack.io</id>
<url>https://jitpack.io</url>
</repository>
HTML:
<dependency>
<groupId>com.github.jiangdashao</groupId>
<artifactId>matrix-api-repo</artifactId>
<version>317d4635fd</version>
<scope>provided</scope>
</dependency>PlayerViolationEvent
This event will be called when Matrix detected some cheats
Method:
// get the detected player
Player getPlayer()
// get the violations added
int getViolations()
// get the hack type
HackType getHackType()
// get the verbose message
String getMessage()
// get the component name
String getConponent()
MatrixAPI:
// First, you should get the API instance
MatrixAPI api = MatrixAPIProvider.getAPI();
// set the player's violations
api.setViolations(Player player, HackType hackType, int violations);
// get the player's violations
int violation = api.getViolations(Player player, HackType hackType);
// get the check is enabling
api.isEnable(HackType hackType);
// enable or disable a check
api.setEnable(HackType hacktype, boolean enable);
// Reload the permission cache system
api.reloadPermissionCache();
This event will be called when Matrix detected some cheats
Method:
// get the detected player
Player getPlayer()
// get the violations added
int getViolations()
// get the hack type
HackType getHackType()
// get the verbose message
String getMessage()
// get the component name
String getConponent()
MatrixAPI:
// First, you should get the API instance
MatrixAPI api = MatrixAPIProvider.getAPI();
// set the player's violations
api.setViolations(Player player, HackType hackType, int violations);
// get the player's violations
int violation = api.getViolations(Player player, HackType hackType);
// get the check is enabling
api.isEnable(HackType hackType);
// enable or disable a check
api.setEnable(HackType hacktype, boolean enable);
// Reload the permission cache system
api.reloadPermissionCache();
# Plugin Metrics
