Getting started

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

Requirements

Minecraft Server: 1.18 or newer
Java: 17 or newer
ProtocolLib: Required for Spigot/Paper servers
PacketEvents: Required for Velocity proxy

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 and install ProtocolLib to your /plugins/ folder
Download HackedServer.jar and place it in your /plugins/ folder
Restart your server

HackedServer has been tested with Spigot, CraftBukkit, PaperMC, Purpur, and other popular forks.

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
`languages/english.toml`	Message translations

See the Configuration page for detailed documentation.

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.