# 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: 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
> 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/-Redacted-/master/config.yml
- language.yml: https://github.com/jiangdashao/Matrix-Issues/-Redacted-/master/language.yml
- checks.yml: https://github.com/jiangdashao/Matrix-Issues/-Redacted-/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 dotindicates 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>Developer API:
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
![⭐ UltimateFireworks ⭐ [1.7-1.19]](/data/resource_icons/7/7456.jpg?1518404240){kind=icon}
