Files
src
build.gradle
README.md
settings.gradle
Code
7 350
src/main/java/com/myguard/MyGuard.java
package com.myguard;
import org.bukkit.Bukkit;
import org.bukkit.ChatColor;
import org.bukkit.Location;
import org.bukkit.command.Command;
import org.bukkit.command.CommandSender;
import org.bukkit.entity.Player;
import org.bukkit.event.EventHandler;
import org.bukkit.event.Listener;
import org.bukkit.event.block.Action;
import org.bukkit.event.player.PlayerInteractEvent;
import org.bukkit.plugin.java.JavaPlugin;
import java.util.HashMap;
import java.util.HashSet;
import java.util.Locale;
import java.util.Map;
import java.util.Set;
import java.util.UUID;
import org.bukkit.configuration.file.YamlConfiguration;
import java.io.File;
import java.io.IOException;
public final class MyGuard extends JavaPlugin implements Listener {
private File dataFile;
private YamlConfiguration data;
private final Set<String> bypasses = new HashSet<>();
private final Set<String> alertsOff = new HashSet<>();
private final Map<UUID, Integer> signals = new HashMap<>();
private final Map<UUID, Long> lastAlert = new HashMap<>();
private boolean debug;
private CaveHiding caveHiding;
@Override
public void onEnable() {
saveDefaultConfig();
dataFile = new File(getDataFolder(), "data.yml");
data = YamlConfiguration.loadConfiguration(dataFile);
for (String name : data.getStringList("bypasses")) bypasses.add(name.toLowerCase(Locale.ROOT));
alertsOff.addAll(data.getStringList("alerts-off"));
getServer().getPluginManager().registerEvents(this, this);
caveHiding = new CaveHiding(this);
caveHiding.start();
}
@Override
public void onDisable() {
if (caveHiding != null) caveHiding.stop();
saveData();
signals.clear();
lastAlert.clear();
}
private void saveData() {
data.set("bypasses", new java.util.ArrayList<>(bypasses));
data.set("alerts-off", new java.util.ArrayList<>(alertsOff));
try { data.save(dataFile); } catch (IOException e) { getLogger().severe("Could not save data.yml: " + e.getMessage()); }
}
boolean isBypassed(Player player) {
return player.hasPermission("myguard.bypass")
|| (getConfig().getBoolean("bypass-operators", true) && player.isOp())
|| bypasses.contains(player.getName().toLowerCase(Locale.ROOT));
}
@EventHandler(ignoreCancelled = true)
public void onInteract(PlayerInteractEvent event) {
Player player = event.getPlayer();
if (!getConfig().getBoolean("interaction-monitor.enabled", true) || event.getClickedBlock() == null) return;
if (event.getAction() != Action.LEFT_CLICK_BLOCK && event.getAction() != Action.RIGHT_CLICK_BLOCK) return;
if (player.hasPermission("myguard.bypass") || (getConfig().getBoolean("bypass-operators", true) && player.isOp()) || bypasses.contains(player.getName().toLowerCase(Locale.ROOT))) return;
if (getConfig().getStringList("excluded-worlds").stream().anyMatch(w -> w.equalsIgnoreCase(player.getWorld().getName()))) return;
Location eye = player.getEyeLocation();
Location block = event.getClickedBlock().getLocation();
double dx = Math.max(0, Math.max(block.getX() - eye.getX(), eye.getX() - block.getX() - 1));
double dy = Math.max(0, Math.max(block.getY() - eye.getY(), eye.getY() - block.getY() - 1));
double dz = Math.max(0, Math.max(block.getZ() - eye.getZ(), eye.getZ() - block.getZ() - 1));
double distance = Math.sqrt(dx * dx + dy * dy + dz * dz);
double max = getConfig().getDouble("interaction-monitor.max-distance", 8.0);
if (!Double.isFinite(max) || max <= 0) max = 8.0;
if (distance <= max) return;
int score = signals.merge(player.getUniqueId(), 1, Integer::sum);
long now = System.currentTimeMillis();
long seconds = Math.max(0, Math.min(86400, getConfig().getLong("interaction-monitor.alert-cooldown-seconds", 30)));
if (now - lastAlert.getOrDefault(player.getUniqueId(), 0L) < seconds * 1000L) return;
lastAlert.put(player.getUniqueId(), now);
String message = ChatColor.RED + "[MyGuard] " + player.getName() + " interaction distance " + String.format(Locale.ROOT, "%.1f", distance) + " in " + player.getWorld().getName() + " at " + block.getBlockX() + ", " + block.getBlockY() + ", " + block.getBlockZ() + " (signals: " + score + ", confidence: low)";
for (Player staff : Bukkit.getOnlinePlayers()) {
if (staff.hasPermission("myguard.alerts") && !alertsOff.contains(staff.getUniqueId().toString())) staff.sendMessage(message);
}
if (debug) getLogger().info(ChatColor.stripColor(message));
}
@EventHandler
public void onQuit(org.bukkit.event.player.PlayerQuitEvent event) {
lastAlert.remove(event.getPlayer().getUniqueId());
signals.remove(event.getPlayer().getUniqueId());
}
@Override
public boolean onCommand(CommandSender sender, Command command, String label, String[] args) {
if (args.length > 0 && args[0].equalsIgnoreCase("alerts")) {
if (!(sender instanceof Player) || !sender.hasPermission("myguard.alerts")) { sender.sendMessage("Only staff players can toggle alerts."); return true; }
String id = ((Player) sender).getUniqueId().toString();
boolean enabled = alertsOff.remove(id);
if (!enabled) alertsOff.add(id);
saveData();
sender.sendMessage("MyGuard alerts " + (enabled ? "enabled" : "disabled") + ".");
return true;
}
if (!sender.hasPermission("myguard.admin")) { sender.sendMessage("You do not have permission."); return true; }
if (args.length == 0 || args[0].equalsIgnoreCase("status")) {
sender.sendMessage("MyGuard: interaction monitoring " + (getConfig().getBoolean("interaction-monitor.enabled", true) ? "enabled" : "disabled") + "; cave visual masking " + (getConfig().getBoolean("cave-hiding.enabled", true) ? "enabled" : "disabled") + "; " + bypasses.size() + " username bypasses. Packet-based hiding is not implemented.");
} else if (args[0].equalsIgnoreCase("reload")) {
caveHiding.stop(); reloadConfig(); caveHiding.start(); sender.sendMessage("MyGuard configuration reloaded.");
} else if (args[0].equalsIgnoreCase("debug")) {
if (!sender.hasPermission("myguard.debug")) { sender.sendMessage("You do not have permission."); return true; }
debug = !debug; sender.sendMessage("Debug logging " + (debug ? "enabled" : "disabled") + ".");
} else if (args[0].equalsIgnoreCase("check") && args.length == 2) {
Player target = Bukkit.getPlayerExact(args[1]);
if (target == null) sender.sendMessage("Player must be online.");
else sender.sendMessage(target.getName() + ": " + signals.getOrDefault(target.getUniqueId(), 0) + " interaction signals this session; not a freecam verdict.");
} else if (args[0].equalsIgnoreCase("bypass") && args.length == 2 && args[1].equalsIgnoreCase("list")) {
sender.sendMessage("Username bypasses: " + (bypasses.isEmpty() ? "none" : String.join(", ", bypasses)));
} else if ((args[0].equalsIgnoreCase("bypass") || args[0].equalsIgnoreCase("unbypass")) && args.length == 2) {
if (!args[1].matches("[A-Za-z0-9_]{1,16}")) { sender.sendMessage("Invalid Minecraft username."); return true; }
String name = args[1].toLowerCase(Locale.ROOT);
boolean adding = args[0].equalsIgnoreCase("bypass");
if (adding) bypasses.add(name); else bypasses.remove(name);
saveData(); sender.sendMessage("Username bypass " + (adding ? "added for " : "removed for ") + args[1] + ".");
} else {
sender.sendMessage("Usage: /myguard [status|reload|check <player>|alerts|bypass <name|list>|unbypass <name>|debug]");
}
return true;
}
}