EclipseGuard | ModBan

EclipseGuard ModBan

Keep cheat clients and unwanted mods off your server. EclipseGuard ModBan checks what a joining player's client reports and automatically kicks or bans anyone using a mod on your blocklist, such as Meteor Client, Wurst or Freecam.

Why use it?

Most servers can't stop players from running client-side mods that give an unfair advantage. EclipseGuard ModBan gives you a simple, configurable blocklist. It acts the moment a banned mod is detected, so you don't have to catch it by hand.

Features

• Automatic detection: checks players when they join and keeps re-checking for a configurable number of seconds, so mods that register late are still caught.
• Kick or ban: choose whether offenders are kicked or permanently banned.
• Editable blocklist: add or remove mods in-game with /modban, with no restart needed.
• Loose mod-ID matching: case, dashes, underscores, dots, loader suffixes (-fabric, -forge, -neoforge, -quilt) and the letter "s" are ignored. Modrinth slugs like xaeros-world-map match the ID xaeroworldmap.
• Staff alerts: admins are told when a player is blocked, and which mod caused it.
• Fully customizable messages: change the prefix, kick message, alert and ban reason, with colour codes and %player% / %mod% placeholders.
• Bypass permission: exempt trusted players or staff from checks.
• Lightweight: no dependencies and no database.

Commands

• /modban add [modid] : Add a mod to the blocklist
• /modban remove [modid] : Remove a mod from the blocklist
• /modban list : Show all banned mods
• /modban check [player] : Show which banned mods a player's client reports
• /modban punishment [kick or ban] : Switch between kicking and banning
• /modban reload : Reload the config

Permissions

• eclipseguard.modban.admin : Use /modban and receive alerts (default: OP)
• eclipseguard.modban.bypass : Never checked for banned mods (default: nobody)

Configuration

Everything is set in config.yml:

• punishment: kick or ban
• check-seconds: how long after joining to keep re-checking the client
• banned-mods: the list of mods to block (meteor-client, wurst and freecam by default)
• messages: the prefix, kick message, alert and ban reason

Installation

1. Download the latest version and put the .jar file in your server's plugins folder.
2. Restart the server.
3. Edit plugins/EclipseGuardModBan/config.yml to set your blocklist and punishment.
4. Run /modban reload to apply changes.

Compatibility

• Minecraft: 1.21 and newer
• Software: Spigot, Paper and forks

Good to know

Detection relies on the client brand and plugin channels the client reports to the server. It works well against common cheat clients, but it isn't a complete anti-cheat. A modified client can hide what it reports, so use it alongside other protections.