AntiMeteor

A lightweight Minecraft plugin that detects players using Meteor Client and automatically takes action based on your configuration.

Supports modern Minecraft versions and works without requiring mods on the server.

Features

• Detects Meteor Client through client brand checks
• Detects Meteor related plugin channels
• First detection kicks the player
• Second detection automatically bans the player
• Configurable ban duration
• Player whitelist system
• Optional inventory reset
• Optional ender chest reset
• Optional experience reset
• Optional economy reset through Vault
• Admin alerts
• Console logging
• Runtime configuration commands

How it works

When a player joins using Meteor Client, AntiMeteor checks whether they have been detected before.

First detection

The player is kicked from the server and a record is stored.

Second detection

If the same player rejoins using Meteor Client again, AntiMeteor can:

• Ban the player
• Clear inventory
• Clear ender chest
• Remove money through Vault
• Reset experience

The ban length can be changed in the config.

Commands

Main Command

/antimeteor

Alias:

/amtr

Admin Commands

/amtr help Shows all available commands

/amtr status Displays plugin status and settings

/amtr enable Enables AntiMeteor

/amtr disable Disables AntiMeteor

/amtr reload Reloads configuration and data

/amtr check <player> Checks a player's detection history

/amtr clearrecord <player> Removes stored kick and ban records

/amtr banlist Shows players banned by AntiMeteor

Whitelist Commands

/amtr whitelist add <player> Adds a player to the whitelist

/amtr whitelist remove <player> Removes a player from the whitelist

/amtr whitelist list Lists all whitelisted players

Configuration Commands

/amtr set <option> <value>

Used to change settings without editing the config file.

Vault Check

/amtr vault Shows whether Vault and an economy provider are available.

Permissions

amtr.admin

Gives access to all AntiMeteor commands and alerts.

Default: OP

Configuration

Example settings:

enabled: true

ban_days: 14

kick_window_hours: 24

op_always_whitelisted: true

broadcast_to_all: false

log_to_console: true

reset:
  inventory: true
  ender_chest: true
  money: true
  experience: false

Vault Support

AntiMeteor can reset player balances when a repeat offender is banned.

Requirements:

• Vault installed
• A supported economy plugin

If Vault is not available, money reset is automatically skipped.

Compatibility

• Paper
• Purpur
• Spigot
• Other Bukkit based servers

Designed for Minecraft 1.21+

Notes

No detection system is perfect. AntiMeteor focuses specifically on identifying Meteor Client through known client identifiers and channels.

For best results, combine AntiMeteor with a proper moderation system and server rules.