Getting started

HackedServer is a multi-platform Minecraft plugin that detects Forge mods, Fabric mods, Lunar Client mods, hacked clients, and other modified clients. It alerts your staff and can automatically punish cheaters.

Requirements

Minecraft Server: 1.18 or newer (Paper , Spigot , or similar)
Java: 17 or newer
PacketEvents: Required for Velocity proxy

Download server software from MCServerJars.com .

ProtocolLib is automatically downloaded at runtime for Spigot/Paper servers — no manual installation required.

HackedServer 3.x is a complete rewrite with simplified installation — no external dependencies like HackedCore are required anymore.

Installation

Spigot/Paper

Installing on Spigot/Paper

Download HackedServer.jar and place it in your /plugins/ folder
Restart your server

ProtocolLib will be automatically downloaded on first startup.

HackedServer has been tested with Spigot, CraftBukkit, PaperMC, Purpur, and other popular forks. Download server jars from MCServerJars.com .

If all goes well, you should see something like this in your console:

Logs

BungeeCord

Installing on BungeeCord

Start by installing HackedServer on every Spigot server as explained in the Spigot/Paper tab.

Make sure that:

bungeecord is set to true in your spigot.yml on each backend server
ip_forward is enabled in your BungeeCord config.yml

Then:

Download HackedServer.jar (same JAR as for Spigot)
Place it in your BungeeCord /plugins/ folder
Restart your proxy

Bungee Logs

If you are using a fork like Waterfall or Travertine, you may need to adjust configuration settings for optimal compatibility.

Velocity

Installing on Velocity

HackedServer supports Velocity proxy for detecting modified clients across your network.

Requirements:

PacketEvents installed on your Velocity proxy

Installation:

Install PacketEvents on your Velocity proxy
Download HackedServer.jar and place it in your Velocity /plugins/ folder
Restart your proxy

Velocity provides modern proxy features with better performance. HackedServer fully supports Velocity’s API for seamless integration.

Configuration Files

After the first run, HackedServer will generate configuration files in the plugin folder:

File	Description
`config.toml`	Main settings (language, debug mode)
`actions.toml`	Define actions triggered by detections
`generic.toml`	Configure client/mod detection rules
`lunar.toml`	Lunar Client Apollo integration settings
`forge.toml`	Forge/NeoForge mod detection settings
`languages/english.toml`	Message translations

See the Configuration page for detailed documentation, the Lunar Client page for Apollo integration, or the Forge/NeoForge page for Forge mod detection.

Quick Start

Once installed, HackedServer will automatically start detecting modified clients. Staff with the hackedserver.alert permission will receive alerts when players join with detected mods or clients.

Use /hs help to see available commands, or check the Commands & Permissions page for details.