MeteorDetect

This is a simple server-side mod that will detect meteor client on the client by utilizing this issue. It works very similarly to DonutSMP’s detection.

DISCLAIMER: I am ashamed, but not afraid to admit that this code is 100% made by AI (Claude, Opus 4.6). I did not write this code. Feel free to do whatever you want with this code; it’s not mine.

Once meteorclient patches this issue, or if a better alternative to this mod becomes available, I will make this project unlisted.

How to use

By default, this mod will ban any player who joins the server with meteorclient installed. A check will force-exit any container-gui that the player may be interacting with, so that is something to keep in mind.

Config Options

1. action — What happens if meteorclient is detected. KICK disconnects them, BAN runs /ban, ALERT notifies ops.
2. checkOnJoin — Run a check when players join. This can be true or false.
3. joinCheckDelayMin / joinCheckDelayMax — Random delay range in seconds before the check fires after join.
4. periodicCheck — Check players periodically while online. true or false.
5. periodicCheckIntervalSeconds — How often periodic checks run in seconds.
6. checkTimeoutSeconds — How long to wait for a response before giving up.
7. kickMessage — Message shown to kicked players. %player% replaced with their name.
8. banMessage — Reason used in /ban command. %player% replaced with their name.
9. staffAlertMessage — Alert sent to online players on detection. %player% replaced.
10. staffOpLevel — Does literally nothing.
11. detectionKeys — Translation key to test. You cannot test more than 1 right now.

A recommended config is below. This will immediately ban a player with meteorclient when they attempt to join. It also won’t mess with exiting container gui’s because the check is immediate. Since players are checked upon joining, there is no need to periodically check players again.

{
  "action": "BAN",
  "checkOnJoin": false,
  "joinCheckDelayMin": 1,
  "joinCheckDelayMax": 1,
  "periodicCheck": false,
  "periodicCheckIntervalSeconds":3600,
  "checkTimeoutSeconds": 7200,
  "kickMessage": "Disconnected: You have been kicked for the following reason: Cheating. Do not cheat again, or you will be permanently banned.",
  "banMessage": "Disconnected: You have been banned for the following reason: Cheating.",
  "staffAlertMessage": "%player% was flagged for using a modified client.",
  "staffOpLevel": 2,
  "detectionKeys": [
    "key.meteor-client.open-gui"
]