morpheus/XeroAntiCheat
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

v1.2.0: Implement improvement plan features

Browse Source 
- Setback System: Teleports flagged players to lastSafeLocation (opt-in per check)
- TPS Lag Compensation: isServerLagging() helper, guards in Fly/Spider/Glide checks
- Universal Buffer System: Buffer fields for Jesus/Reach/KillAura/Timer/FastPlace/Scaffold/FastEat
- /xac debug command: Shows check-specific debug info for players
- Public API: XACApi with isFlagged(), getViolationLevel(), getTotalViolations(), isBypassed()
- Performance Metrics: /xac stats command with checks/flags/punishments tracking
This commit is contained in:
Axel
2026-03-15 13:17:28 -03:00
parent a4a87e62de
commit 112a61cf0c
23 changed files with 387 additions and 16 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
src/main/java/com/xeroth/xeroanticheat/XeroAntiCheat.java
View File

@@ -1,5 +1,6 @@
package com.xeroth.xeroanticheat;
import com.xeroth.xeroanticheat.api.XACApi;
import com.xeroth.xeroanticheat.checks.combat.*;
import com.xeroth.xeroanticheat.checks.misc.*;
import com.xeroth.xeroanticheat.checks.movement.*;
@@ -11,6 +12,7 @@ import com.xeroth.xeroanticheat.listener.MovementListener;
import com.xeroth.xeroanticheat.manager.CheckManager;
import com.xeroth.xeroanticheat.manager.ConfigManager;
import com.xeroth.xeroanticheat.manager.DatabaseManager;
import com.xeroth.xeroanticheat.manager.MetricsManager;
import com.xeroth.xeroanticheat.manager.PunishmentManager;
import com.xeroth.xeroanticheat.manager.ViolationManager;
import com.xeroth.xeroanticheat.protocol.PacketListener;
@@ -42,6 +44,7 @@ public final class XeroAntiCheat extends JavaPlugin {
private CheckManager checkManager;
private PacketListener packetListener;
private DatabaseManager databaseManager;
private MetricsManager metricsManager;
private boolean protocolLibLoaded = false;
private org.bukkit.scheduler.BukkitTask decayTask;
@@ -56,6 +59,9 @@ public final class XeroAntiCheat extends JavaPlugin {
public void onEnable() {
instance = this;
// Initialize API
XACApi.init(this);
// Check for ProtocolLib
checkProtocolLib();
@@ -103,6 +109,9 @@ public final class XeroAntiCheat extends JavaPlugin {
databaseManager.close();
}
// Shutdown API
XACApi.shutdown();
getLogger().info("XeroAntiCheat disabled!");
}
@@ -122,6 +131,7 @@ public final class XeroAntiCheat extends JavaPlugin {
violationManager = new ViolationManager(this);
punishmentManager = new PunishmentManager(this, violationManager);
checkManager = new CheckManager(this);
metricsManager = new MetricsManager();
databaseManager = new DatabaseManager(this);
databaseManager.initialize();
@@ -267,6 +277,10 @@ public final class XeroAntiCheat extends JavaPlugin {
public DatabaseManager getDatabaseManager() {
return databaseManager;
}
public MetricsManager getMetricsManager() {
return metricsManager;
}
public boolean isProtocolLibLoaded() {
return protocolLibLoaded;

42
src/main/java/com/xeroth/xeroanticheat/api/XACApi.java Normal file
View File

@@ -0,0 +1,42 @@
package com.xeroth.xeroanticheat.api;
import com.xeroth.xeroanticheat.XeroAntiCheat;
import org.bukkit.entity.Player;
public class XACApi {
private static XACApi instance;
private final XeroAntiCheat plugin;
private XACApi(XeroAntiCheat plugin) {
this.plugin = plugin;
}
public static XACApi get() {
return instance;
}
public static void init(XeroAntiCheat plugin) {
instance = new XACApi(plugin);
}
public static void shutdown() {
instance = null;
}
public boolean isFlagged(Player player) {
return plugin.getViolationManager().hasViolations(player, 1.0);
}
public double getViolationLevel(Player player, String checkName) {
return plugin.getViolationManager().getViolationLevel(player, checkName);
}
public double getTotalViolations(Player player) {
return plugin.getViolationManager().getTotalViolations(player);
}
public boolean isBypassed(Player player) {
return player.hasPermission("xac.bypass");
}
}

16
src/main/java/com/xeroth/xeroanticheat/check/Check.java
View File

@@ -2,6 +2,7 @@ package com.xeroth.xeroanticheat.check;
import com.xeroth.xeroanticheat.XeroAntiCheat;
import com.xeroth.xeroanticheat.data.PlayerData;
import org.bukkit.Bukkit;
import org.bukkit.entity.Player;
/**
@@ -125,4 +126,19 @@ public abstract class Check {
|| player.hasPermission("xac.bypass." + getCategory())
|| player.hasPermission("xac.bypass." + name.toLowerCase());
}
protected void setback(Player player, PlayerData data) {
if (!getConfigBoolean("setback", false)) return;
org.bukkit.Location safe = data.getLastSafeLocation();
if (safe == null) return;
data.clearPositionHistory();
player.teleport(safe);
}
protected boolean isServerLagging() {
if (!plugin.getConfigManager().getBoolean("tps.enabled", true)) return false;
double tps = Bukkit.getTPS()[0];
double minTps = plugin.getConfigManager().getDouble("tps.min_tps_threshold", 18.0);
return tps < minTps;
}
}

9
src/main/java/com/xeroth/xeroanticheat/checks/misc/FastPlaceCheck.java
View File

@@ -35,7 +35,14 @@ public class FastPlaceCheck extends Check {
int bps = data.getBlocksPerSecond();
if (bps > maxBlocksPerSecond) {
flag(data, player, (bps - maxBlocksPerSecond) * 0.5);
data.incrementFastPlaceBuffer();
int buffer = getConfigInt("buffer_ticks", 2);
if (data.getFastPlaceBuffer() >= buffer) {
flag(data, player, (bps - maxBlocksPerSecond) * 0.5);
data.resetFastPlaceBuffer();
}
} else {
data.resetFastPlaceBuffer();
}
}
}

5
src/main/java/com/xeroth/xeroanticheat/checks/movement/FlyCheck.java
View File

@@ -31,6 +31,9 @@ public class FlyCheck extends Check {
// Ignore if player has bypass permission
if (isBypassed(player)) return;
// Skip if server is lagging
if (isServerLagging()) return;
// Ignore elytra gliding
if (player.isGliding()) {
return;
@@ -56,6 +59,7 @@ public class FlyCheck extends Check {
if (clientOnGround != serverOnGround) {
if (data.getAirTicks() > fallBuffer + desyncThreshold) {
flag(data, player);
setback(player, data);
}
}
@@ -69,6 +73,7 @@ public class FlyCheck extends Check {
if (data.getAirTicks() > fallBuffer) {
if (!data.hasJumpBoost()) {
flag(data, player);
setback(player, data);
}
}
}

4
src/main/java/com/xeroth/xeroanticheat/checks/movement/GlideCheck.java
View File

@@ -30,6 +30,9 @@ public class GlideCheck extends Check {
// Ignore if player has bypass permission
if (isBypassed(player)) return;
// Skip if server is lagging
if (isServerLagging()) return;
// Get thresholds
double minHorizontalSpeed = getConfigDouble("min_horizontal_speed", 0.5);
double maxYDecrease = getConfigDouble("max_y_decrease", 0.1);
@@ -63,6 +66,7 @@ public class GlideCheck extends Check {
if (data.getGlideTicks() > 5) {
flag(data, player);
setback(player, data);
}
} else {
data.resetGlideTicks();

10
src/main/java/com/xeroth/xeroanticheat/checks/movement/JesusCheck.java
View File

@@ -76,7 +76,15 @@ public class JesusCheck extends Check {
// If moving at reasonable speed on water, flag
if (horizontalSpeedSq > 0.01) {
flag(data, player);
data.incrementJesusBuffer();
int buffer = getConfigInt("buffer_ticks", 3);
if (data.getJesusBuffer() >= buffer) {
flag(data, player);
setback(player, data);
data.resetJesusBuffer();
}
} else {
data.resetJesusBuffer();
}
}
}

1
src/main/java/com/xeroth/xeroanticheat/checks/movement/PhaseCheck.java
View File

@@ -60,6 +60,7 @@ public class PhaseCheck extends Check {
if (result != null && result.getHitBlock() != null
&& result.getHitBlock().getType().isSolid()) {
flag(data, player, 3.0);
setback(player, data);
}
}
}

1
src/main/java/com/xeroth/xeroanticheat/checks/movement/SpeedCheck.java
View File

@@ -84,6 +84,7 @@ public class SpeedCheck extends Check {
int bufferTicks = getConfigInt("buffer_ticks", 5);
if (data.getSpeedViolationTicks() >= bufferTicks) {
flag(data, player, (speed - maxSpeed) * 2);
setback(player, data);
data.resetSpeedViolationTicks();
}
} else {

4
src/main/java/com/xeroth/xeroanticheat/checks/movement/SpiderCheck.java
View File

@@ -31,6 +31,9 @@ public class SpiderCheck extends Check {
// Ignore if player has bypass permission
if (isBypassed(player)) return;
// Skip if server is lagging
if (isServerLagging()) return;
// Get velocity
org.bukkit.util.Vector velocity = player.getVelocity();
@@ -69,6 +72,7 @@ public class SpiderCheck extends Check {
if (data.getSpiderTicks() > 5 && velocity.getY() > 0.1) {
flag(data, player);
setback(player, data);
}
} else {
data.resetSpiderTicks();

18
src/main/java/com/xeroth/xeroanticheat/checks/movement/TimerCheck.java
View File

@@ -36,7 +36,14 @@ public class TimerCheck extends Check {
// If ProtocolLib is active, packet counting is handled by PacketListener
if (plugin.isProtocolLibLoaded()) {
if (data.getPacketsThisSecond() > maxPacketsPerSecond) {
flag(data, player, (data.getPacketsThisSecond() - maxPacketsPerSecond) * 0.5);
data.incrementTimerBuffer();
int buffer = getConfigInt("buffer_ticks", 2);
if (data.getTimerBuffer() >= buffer) {
flag(data, player, (data.getPacketsThisSecond() - maxPacketsPerSecond) * 0.5);
data.resetTimerBuffer();
}
} else {
data.resetTimerBuffer();
}
return;
}
@@ -53,7 +60,14 @@ public class TimerCheck extends Check {
// Check for too many packets
if (data.getPacketsThisSecond() > maxPacketsPerSecond) {
flag(data, player, (data.getPacketsThisSecond() - maxPacketsPerSecond) * 0.5);
data.incrementTimerBuffer();
int buffer = getConfigInt("buffer_ticks", 2);
if (data.getTimerBuffer() >= buffer) {
flag(data, player, (data.getPacketsThisSecond() - maxPacketsPerSecond) * 0.5);
data.resetTimerBuffer();
}
} else {
data.resetTimerBuffer();
}
data.setLastMovePacketTime(now);

84
src/main/java/com/xeroth/xeroanticheat/command/XACCommand.java
View File

@@ -79,6 +79,18 @@ public class XACCommand implements CommandExecutor, TabCompleter {
}
toggleAlerts(sender, args[1]);
}
case "debug" -> {
if (!has(sender, "xac.command.verbose")) return true;
if (args.length < 3) {
sender.sendMessage(usage("/xac debug <player> <check>"));
return true;
}
showDebug(sender, args[1], args[2]);
}
case "stats" -> {
if (!has(sender, "xac.admin")) return true;
showStats(sender);
}
case "version" -> showVersion(sender);
default -> sendHelp(sender);
}
@@ -107,7 +119,9 @@ public class XACCommand implements CommandExecutor, TabCompleter {
new Cmd("/xac punish <player> <check>", "manual punishment", "xac.command.punish"),
new Cmd("/xac clearviolations <player>", "clear all VL for player", "xac.command.clearviolations"),
new Cmd("/xac verbose <player>", "toggle per-flag debug", "xac.command.verbose"),
new Cmd("/xac debug <player> <check>", "show check debug info", "xac.command.verbose"),
new Cmd("/xac alerts [on|off]", "toggle alert receiving", "xac.command.alerts"),
new Cmd("/xac stats", "show plugin stats", "xac.admin"),
new Cmd("/xac version", "show version", "xac.command.version")
).forEach(cmd -> {
if (sender.hasPermission(cmd.perm()) || sender.hasPermission("xac.admin")) {
@@ -219,11 +233,71 @@ public class XACCommand implements CommandExecutor, TabCompleter {
NamedTextColor.GOLD));
sender.sendMessage(Component.text("Built for Paper 1.21.x", NamedTextColor.WHITE));
}
private void showStats(CommandSender sender) {
var m = plugin.getMetricsManager();
sender.sendMessage(Component.text("— XeroAntiCheat Stats —", NamedTextColor.GOLD));
sender.sendMessage(Component.text("Uptime: " + m.getUptimeSeconds() + "s", NamedTextColor.WHITE));
sender.sendMessage(Component.text("Checks run: " + m.getTotalChecks(), NamedTextColor.WHITE));
sender.sendMessage(Component.text("Checks/sec: " + String.format("%.1f", m.getChecksPerSecond()), NamedTextColor.WHITE));
sender.sendMessage(Component.text("Flags issued: " + m.getTotalFlags(), NamedTextColor.WHITE));
sender.sendMessage(Component.text("Punishments: " + m.getTotalPunishments(), NamedTextColor.WHITE));
sender.sendMessage(Component.text("Players monitored: " + Bukkit.getOnlinePlayers().size(), NamedTextColor.WHITE));
}
private void showDebug(CommandSender sender, String playerName, String checkName) {
Player target = Bukkit.getPlayer(playerName);
if (target == null) {
sender.sendMessage(Component.text("Player not found.", NamedTextColor.RED));
return;
}
PlayerData data = plugin.getViolationManager().getPlayerData(target);
if (data == null) {
sender.sendMessage(Component.text("No data available.", NamedTextColor.RED));
return;
}
sender.sendMessage(Component.text(
"— Debug: " + checkName + " for " + target.getName() + " —",
NamedTextColor.GOLD));
sender.sendMessage(Component.text("VL: " + String.format("%.1f", data.getViolationLevel(checkName)), NamedTextColor.WHITE));
sender.sendMessage(Component.text("Ping: " + target.getPing() + "ms", NamedTextColor.WHITE));
sender.sendMessage(Component.text("airTicks: " + data.getAirTicks(), NamedTextColor.WHITE));
sender.sendMessage(Component.text("onGround(server): " + target.isOnGround(), NamedTextColor.WHITE));
switch (checkName.toLowerCase()) {
case "speed" -> {
PlayerData.PositionSnapshot curr = data.getLastPosition();
PlayerData.PositionSnapshot prev = data.getSecondLastPosition();
if (curr != null && prev != null) {
double dx = curr.x() - prev.x();
double dz = curr.z() - prev.z();
double speed = Math.sqrt(dx*dx + dz*dz);
sender.sendMessage(Component.text("speed(measured): " + String.format("%.4f", speed), NamedTextColor.WHITE));
sender.sendMessage(Component.text("speedViolationTicks: " + data.getSpeedViolationTicks(), NamedTextColor.WHITE));
}
}
case "killaura" -> {
sender.sendMessage(Component.text("lastAttackYaw: " + data.getLastAttackYaw(), NamedTextColor.WHITE));
}
case "autoclicker" -> {
sender.sendMessage(Component.text("CPS: " + data.getCPS(), NamedTextColor.WHITE));
}
case "spider" -> {
sender.sendMessage(Component.text("spiderTicks: " + data.getSpiderTicks(), NamedTextColor.WHITE));
}
case "glide" -> {
sender.sendMessage(Component.text("glideTicks: " + data.getGlideTicks(), NamedTextColor.WHITE));
}
}
}
@Override
public List<String> onTabComplete(CommandSender sender, Command command, String alias, String[] args) {
if (args.length == 1) {
return Stream.of("reload","status","punish","clearviolations","verbose","alerts","version")
return Stream.of("reload","status","punish","clearviolations","verbose","debug","alerts","stats","version")
.filter(sub -> sender.hasPermission("xac.command." + sub)
|| sender.hasPermission("xac.admin"))
.filter(sub -> sub.startsWith(args[0].toLowerCase()))
@@ -231,7 +305,7 @@ public class XACCommand implements CommandExecutor, TabCompleter {
}
if (args.length == 2) {
String sub = args[0].toLowerCase();
if (List.of("status","punish","clearviolations","verbose").contains(sub)) {
if (List.of("status","punish","clearviolations","verbose","debug").contains(sub)) {
return Bukkit.getOnlinePlayers().stream()
.map(Player::getName)
.filter(n -> n.toLowerCase().startsWith(args[1].toLowerCase()))
@@ -245,6 +319,12 @@ public class XACCommand implements CommandExecutor, TabCompleter {
.filter(n -> n.toLowerCase().startsWith(args[2].toLowerCase()))
.toList();
}
if (args.length == 3 && args[0].equalsIgnoreCase("debug")) {
return plugin.getCheckManager().getRegisteredChecks().stream()
.map(c -> c.getName())
.filter(n -> n.toLowerCase().startsWith(args[2].toLowerCase()))
.toList();
}
return List.of();
}

62
src/main/java/com/xeroth/xeroanticheat/data/PlayerData.java
View File

@@ -111,6 +111,18 @@ public class PlayerData {
// SpeedCheck tracking
private int speedViolationTicks = 0;
// Universal buffers for checks without built-in tick counters
private int jesusBuffer = 0;
private int timerBuffer = 0;
private int reachBuffer = 0;
private int killAuraBuffer = 0;
private int fastPlaceBuffer = 0;
private int scaffoldBuffer = 0;
private int fastEatBuffer = 0;
// Last safe location for setback
private Location lastSafeLocation = null;
// Alert cooldown tracking
private final Map<String, Long> lastWarnTime = new ConcurrentHashMap<>();
@@ -621,6 +633,41 @@ public class PlayerData {
this.speedViolationTicks = 0;
}
// Jesus buffer
public int getJesusBuffer() { return jesusBuffer; }
public void incrementJesusBuffer() { jesusBuffer++; }
public void resetJesusBuffer() { jesusBuffer = 0; }
// Timer buffer
public int getTimerBuffer() { return timerBuffer; }
public void incrementTimerBuffer() { timerBuffer++; }
public void resetTimerBuffer() { timerBuffer = 0; }
// Reach buffer
public int getReachBuffer() { return reachBuffer; }
public void incrementReachBuffer() { reachBuffer++; }
public void resetReachBuffer() { reachBuffer = 0; }
// KillAura buffer
public int getKillAuraBuffer() { return killAuraBuffer; }
public void incrementKillAuraBuffer() { killAuraBuffer++; }
public void resetKillAuraBuffer() { killAuraBuffer = 0; }
// FastPlace buffer
public int getFastPlaceBuffer() { return fastPlaceBuffer; }
public void incrementFastPlaceBuffer() { fastPlaceBuffer++; }
public void resetFastPlaceBuffer() { fastPlaceBuffer = 0; }
// Scaffold buffer
public int getScaffoldBuffer() { return scaffoldBuffer; }
public void incrementScaffoldBuffer() { scaffoldBuffer++; }
public void resetScaffoldBuffer() { scaffoldBuffer = 0; }
// FastEat buffer
public int getFastEatBuffer() { return fastEatBuffer; }
public void incrementFastEatBuffer() { fastEatBuffer++; }
public void resetFastEatBuffer() { fastEatBuffer = 0; }
public long getLastWarnTime(String checkName) {
return lastWarnTime.getOrDefault(checkName, 0L);
}
@@ -636,6 +683,21 @@ public class PlayerData {
spiderTicks = 0;
glideTicks = 0;
speedViolationTicks = 0;
jesusBuffer = 0;
timerBuffer = 0;
reachBuffer = 0;
killAuraBuffer = 0;
fastPlaceBuffer = 0;
scaffoldBuffer = 0;
lastSafeLocation = null;
}
public Location getLastSafeLocation() {
return lastSafeLocation;
}
public void setLastSafeLocation(Location loc) {
this.lastSafeLocation = loc != null ? loc.clone() : null;
}
public Deque<Long> getBlockPlaceTimestamps() {

22
src/main/java/com/xeroth/xeroanticheat/listener/CombatListener.java
View File

@@ -52,17 +52,31 @@ public class CombatListener implements Listener {
// Check for reach
if (reachCheck != null && reachCheck.checkReach(player, target)) {
if (!reachCheck.isBypassed(player)) {
plugin.getViolationManager().addViolation(player, "Reach", 1.0);
plugin.getPunishmentManager().evaluate(player, "Reach");
int buffer = plugin.getConfigManager().getInt("checks.reach.buffer_hits", 2);
data.incrementReachBuffer();
if (data.getReachBuffer() >= buffer) {
plugin.getViolationManager().addViolation(player, "Reach", 1.0);
plugin.getPunishmentManager().evaluate(player, "Reach");
data.resetReachBuffer();
}
}
} else {
data.resetReachBuffer();
}
// Check for kill aura (angle)
if (killAuraCheck != null && killAuraCheck.checkAngle(player, target)) {
if (!killAuraCheck.isBypassed(player)) {
plugin.getViolationManager().addViolation(player, "KillAura", 1.0);
plugin.getPunishmentManager().evaluate(player, "KillAura");
int buffer = plugin.getConfigManager().getInt("checks.killaura.buffer_ticks", 2);
data.incrementKillAuraBuffer();
if (data.getKillAuraBuffer() >= buffer) {
plugin.getViolationManager().addViolation(player, "KillAura", 1.0);
plugin.getPunishmentManager().evaluate(player, "KillAura");
data.resetKillAuraBuffer();
}
}
} else {
data.resetKillAuraBuffer();
}
// Check for multi-target

22
src/main/java/com/xeroth/xeroanticheat/listener/MiscListener.java
View File

@@ -55,9 +55,16 @@ public class MiscListener implements Listener {
ScaffoldCheck scaffoldCheck = (ScaffoldCheck) plugin.getCheckManager().getCheck("Scaffold");
if (scaffoldCheck != null && scaffoldCheck.checkScaffold(player, event.getBlockPlaced(), data)) {
if (!scaffoldCheck.isBypassed(player)) {
plugin.getViolationManager().addViolation(player, "Scaffold", 1.0);
plugin.getPunishmentManager().evaluate(player, "Scaffold");
int buffer = plugin.getConfigManager().getInt("checks.scaffold.buffer_ticks", 2);
data.incrementScaffoldBuffer();
if (data.getScaffoldBuffer() >= buffer) {
plugin.getViolationManager().addViolation(player, "Scaffold", 1.0);
plugin.getPunishmentManager().evaluate(player, "Scaffold");
data.resetScaffoldBuffer();
}
}
} else {
data.resetScaffoldBuffer();
}
}
@@ -79,9 +86,16 @@ public class MiscListener implements Listener {
FastEatCheck fastEatCheck = (FastEatCheck) plugin.getCheckManager().getCheck("FastEat");
if (fastEatCheck != null && fastEatCheck.checkFastEat(player, data, System.currentTimeMillis())) {
if (!fastEatCheck.isBypassed(player)) {
plugin.getViolationManager().addViolation(player, "FastEat", 1.0);
plugin.getPunishmentManager().evaluate(player, "FastEat");
int buffer = plugin.getConfigManager().getInt("checks.fasteat.buffer_ticks", 2);
data.incrementFastEatBuffer();
if (data.getFastEatBuffer() >= buffer) {
plugin.getViolationManager().addViolation(player, "FastEat", 1.0);
plugin.getPunishmentManager().evaluate(player, "FastEat");
data.resetFastEatBuffer();
}
}
} else {
data.resetFastEatBuffer();
}
}

2
src/main/java/com/xeroth/xeroanticheat/listener/MovementListener.java
View File

@@ -94,6 +94,7 @@ public class MovementListener implements Listener {
} else {
data.setWasAirborne(false);
data.resetAirTicks();
data.setLastSafeLocation(event.getTo());
}
// Check ice at feet
@@ -135,5 +136,6 @@ public class MovementListener implements Listener {
data.resetAirTicks();
data.clearServerVelocity();
data.setLastPlacementYaw(Float.NaN);
data.setLastSafeLocation(event.getTo());
}
}

1
src/main/java/com/xeroth/xeroanticheat/manager/CheckManager.java
View File

@@ -47,6 +47,7 @@ public class CheckManager {
public void runCheck(String checkName, PlayerData data, Player player) {
Check check = checksByName.get(checkName.toLowerCase());
if (check != null && check.isEnabled()) {
plugin.getMetricsManager().recordCheck();
check.check(data, player);
}
}

51
src/main/java/com/xeroth/xeroanticheat/manager/MetricsManager.java Normal file
View File

@@ -0,0 +1,51 @@
package com.xeroth.xeroanticheat.manager;
import java.util.concurrent.atomic.AtomicLong;
public class MetricsManager {
private final AtomicLong totalChecksRun = new AtomicLong();
private final AtomicLong totalFlagsIssued = new AtomicLong();
private final AtomicLong totalPunishments = new AtomicLong();
private long startTimeMs = System.currentTimeMillis();
public void recordCheck() {
totalChecksRun.incrementAndGet();
}
public void recordFlag() {
totalFlagsIssued.incrementAndGet();
}
public void recordPunishment() {
totalPunishments.incrementAndGet();
}
public long getTotalChecks() {
return totalChecksRun.get();
}
public long getTotalFlags() {
return totalFlagsIssued.get();
}
public long getTotalPunishments() {
return totalPunishments.get();
}
public long getUptimeSeconds() {
return (System.currentTimeMillis() - startTimeMs) / 1000;
}
public double getChecksPerSecond() {
long uptime = getUptimeSeconds();
return uptime > 0 ? (double) totalChecksRun.get() / uptime : 0;
}
public void reset() {
totalChecksRun.set(0);
totalFlagsIssued.set(0);
totalPunishments.set(0);
startTimeMs = System.currentTimeMillis();
}
}

3
src/main/java/com/xeroth/xeroanticheat/manager/PunishmentManager.java
View File

@@ -123,6 +123,7 @@ public class PunishmentManager {
kickCmd = kickCmd.replace("%player%", playerName).replace("%reason%", reason);
executeCommand(kickCmd);
logPunishment(type, player, checkName, vl);
plugin.getMetricsManager().recordPunishment();
}
case "TEMPBAN" -> {
String tempbanCmd = plugin.getConfigManager().getString("punishments.tempban_command",
@@ -130,6 +131,7 @@ public class PunishmentManager {
tempbanCmd = tempbanCmd.replace("%player%", playerName).replace("%reason%", reason);
executeCommand(tempbanCmd);
logPunishment(type, player, checkName, vl);
plugin.getMetricsManager().recordPunishment();
}
case "PERMBAN" -> {
String permbanCmd = plugin.getConfigManager().getString("punishments.permban_command",
@@ -137,6 +139,7 @@ public class PunishmentManager {
permbanCmd = permbanCmd.replace("%player%", playerName).replace("%reason%", reason);
executeCommand(permbanCmd);
logPunishment(type, player, checkName, vl);
plugin.getMetricsManager().recordPunishment();
}
}
}

2
src/main/java/com/xeroth/xeroanticheat/manager/ViolationManager.java
View File

@@ -83,6 +83,8 @@ public class ViolationManager {
if (plugin.getConfigManager().isDebug()) {
plugin.getLogger().info(player.getName() + " violated " + checkName + " (VL: " + newVl + ")");
}
plugin.getMetricsManager().recordFlag();
}
/**

26
src/main/resources/config.yml
View File

@@ -40,6 +40,8 @@ checks:
# ----------------------------------------
speed:
enabled: true
# Teleport player back to last safe location when flagged
setback: false
# Base maximum speed (blocks per tick)
max_speed: 0.56
# Ping compensation factor (scales latency leniency)
@@ -58,6 +60,8 @@ checks:
# ----------------------------------------
fly:
enabled: true
# Teleport player back to last safe location when flagged
setback: false
# Number of ticks to allow for stepping/slabs
fall_buffer: 10
# Maximum ground desync ticks before flagging
@@ -73,6 +77,10 @@ checks:
# ----------------------------------------
jesus:
enabled: true
# Teleport player back to last safe location when flagged
setback: false
# Number of consecutive ticks to flag before VL is added
buffer_ticks: 3
warn_vl: 10
kick_vl: 25
tempban_vl: 50
@@ -97,6 +105,8 @@ checks:
# ----------------------------------------
timer:
enabled: true
# Number of consecutive ticks exceeding max packets before flagging
buffer_ticks: 2
# Maximum packets per second allowed
max_packets_per_second: 22
# Milliseconds of no packets before flagging blink
@@ -112,6 +122,8 @@ checks:
# ----------------------------------------
spider:
enabled: true
# Teleport player back to last safe location when flagged
setback: false
warn_vl: 10
kick_vl: 25
tempban_vl: 50
@@ -123,6 +135,8 @@ checks:
# ----------------------------------------
glide:
enabled: true
# Teleport player back to last safe location when flagged
setback: false
# Minimum horizontal speed for glide detection
min_horizontal_speed: 0.5
# Maximum Y decrease per tick for glide curve
@@ -138,6 +152,8 @@ checks:
# ----------------------------------------
killaura:
enabled: true
# Number of consecutive out-of-angle attacks before flagging
buffer_ticks: 2
# Maximum angle in degrees from look direction
max_angle: 100
# Maximum rotation change between attacks
@@ -155,6 +171,8 @@ checks:
# ----------------------------------------
reach:
enabled: true
# Number of consecutive attacks exceeding reach before flagging
buffer_hits: 2
# Maximum reach in blocks (survival)
max_reach: 3.2
# Maximum reach in blocks (creative)
@@ -198,6 +216,8 @@ checks:
# ----------------------------------------
fastplace:
enabled: true
# Number of consecutive ticks exceeding max blocks before flagging
buffer_ticks: 2
# Maximum blocks per second
max_blocks_per_second: 20
warn_vl: 10
@@ -211,6 +231,8 @@ checks:
# ----------------------------------------
phase:
enabled: true
# Teleport player back to last safe location when flagged
setback: false
# Minimum movement distance before ray-cast runs (blocks)
min_distance: 0.5
# Maximum movement delta — larger values are treated as teleports
@@ -241,6 +263,8 @@ checks:
# ----------------------------------------
scaffold:
enabled: true
# Number of consecutive signal accumulations before flagging
buffer_ticks: 2
# Minimum pitch angle for suspicious placement
min_pitch: 75
# Number of signals required to flag
@@ -264,6 +288,8 @@ checks:
# ----------------------------------------
fasteat:
enabled: true
# Number of consecutive fast eats before flagging
buffer_ticks: 2
# Maximum eating duration in ticks (32 = 1.6s)
max_eat_ticks: 32
warn_vl: 10

2
src/main/resources/plugin.yml
View File

@@ -1,5 +1,5 @@
name: XeroAntiCheat
version: 1.1.3
version: 1.2.0
main: com.xeroth.xeroanticheat.XeroAntiCheat
author: Xeroth
description: Lightweight, accurate anti-cheat for Paper 1.21.x