Edam Belguith
  1. نظام الصلاحيات المتكامل (LuckPerms Compatible Permissions):

قم بإنشاء وتوثيق نظام صلاحيات دقيق ومكتمل في ملف plugin.yml وفي الأكواد، ليتم ربطه بسلاسة مع LuckPerms:

  • anticheat.admin : الصلاحية الكلية لإدارة الـ AntiCheat وإعادة تحميل الملفات (/ac reload).
  • anticheat.sus : الوصول لأمر /sus ورؤية قائمة المشتبه بهم والغشاشين وواجهة الـ X-Ray GUI.
  • anticheat.alerts : استقبال التنبيهات الفورية (Alerts) في الشات عند قيام أي لاعب بمخالفة (Combat/Movement/X-Ray).
  • anticheat.bypass : استثناء اللاعب من الفحص الكلي (Bypass) - مخصصة للآدمنز تجنباً للتنبيهات الخاطئة.
  • anticheat.bypass.movement : استثناء من فحوصات الحركة فقط (Speed, Fly, etc.).
  • anticheat.bypass.combat : استثناء من فحوصات القتال فقط (Killaura, Reach, etc.).
  • anticheat.bypass.xray : استثناء من نظام تتبع التنجيم والـ X-Ray.
  • anticheat.gui : فتح واجهات التحكم والمعاينة التفاعلية.

يرجى التحقق من الصلاحيات عبر Player#hasPermission() قبل تنفيذ أي أمر أو إرسال تنبيه، وإضافة خيار في الـ config.yml لتحديد الرسالة التي تظهر للاعب عند عدم امتلاكه للصلاحية (No Permission Message).

Kodari AI
KodariOct 24 at 10:50 am 1
SentinelAntiCheat
SentinelAntiCheat is a comprehensive Minecraft anti-cheat plugin with an integrated permission system designed for LuckPerms compatibility. It detects combat, movement, and X-Ray violations in real-time, sending instant alerts to authorized staff. The plugin features a /sus command for viewing suspected cheaters, an interactive X-Ray GUI, and a full bypass system with granular permission levels including anticheat.admin, anticheat.alerts, anticheat.bypass, anticheat.bypass.movement, anticheat.bypass.combat, anticheat.bypass.xray, and anticheat.gui. Administrators can reload configurations via /ac reload, with customizable no-permission messages stored in config.yml. All commands and alert systems validate permissions through Player#hasPermission() before execution.

سأنشئ أساس الإضافة، وأعرّف صلاحيات LuckPerms في plugin.yml، ثم أوصل فحوص الصلاحيات برسائل المنع القابلة للضبط وأوامر الإدارة والتنبيهات والواجهة.

أُنشئ أساس الإضافة ونظام الصلاحيات:

  • عُرّفت جميع الصلاحيات في plugin.yml مع أوصافها؛ وصلاحية anticheat.bypass تشمل تجاوزات الحركة والقتال وX-Ray.

  • أُضيفت فحوص الصلاحيات لأوامر /ac reload و/ac gui و/sus، ولإرسال التنبيهات. كما أُضيفت دالة للتحقق من التجاوز حسب نوع الفحص.

  • رسالة عدم امتلاك الصلاحية قابلة للتعديل في config.yml.

ملاحظة: المشروع بدأ بلا نظام تتبع للمشتبه بهم أو واجهة قائمة جاهزة؛ لذلك يعرض /sus رسالة عدم توفر بيانات، وتفتح صلاحية anticheat.gui واجهة فارغة إلى حين إضافة هذه الميزات.

Kodari can make mistakes. Review important code before using.
Files
src
build.gradle
Code
4 191
src/main/java/com/kodari/anticheat/AntiCheatPlugin.java
package com.kodari.anticheat;

import org.bukkit.ChatColor;
import org.bukkit.command.Command;
import org.bukkit.command.CommandExecutor;
import org.bukkit.command.CommandSender;
import org.bukkit.entity.Player;
import org.bukkit.inventory.Inventory;
import org.bukkit.plugin.java.JavaPlugin;

public final class AntiCheatPlugin extends JavaPlugin implements CommandExecutor {

    @Override
    public void onEnable() {
        saveDefaultConfig();
        getCommand("ac").setExecutor(this);
        getCommand("sus").setExecutor(this);
    }

    @Override
    public boolean onCommand(CommandSender sender, Command command, String label, String[] args) {
        if (command.getName().equalsIgnoreCase("sus")) {
            if (!hasPermission(sender, "anticheat.sus")) {
                sendNoPermission(sender);
                return true;
            }
            sender.sendMessage(message("messages.suspects-none", "&aلا توجد بيانات مشتبه بهم حالياً."));
            return true;
        }

        if (args.length == 0) {
            if (!hasPermission(sender, "anticheat.admin")) {
                sendNoPermission(sender);
                return true;
            }
            sender.sendMessage(message("messages.usage", "&eالاستخدام: /ac <reload|gui>"));
            return true;
        }

        if (args[0].equalsIgnoreCase("reload")) {
            if (!hasPermission(sender, "anticheat.admin")) {
                sendNoPermission(sender);
                return true;
            }
            reloadConfig();
            sender.sendMessage(message("messages.reload", "&aتمت إعادة تحميل إعدادات AntiCheat."));
            return true;
        }

        if (args[0].equalsIgnoreCase("gui")) {
            if (!(sender instanceof Player player)) {
                sender.sendMessage(message("messages.player-only", "&cهذا الأمر متاح للاعبين فقط."));
                return true;
            }
            if (!player.hasPermission("anticheat.gui")) {
                sendNoPermission(player);
                return true;
            }
            String title = message("messages.gui-title", "&8AntiCheat | المعاينة");
            Inventory inventory = getServer().createInventory(null, 27, title);
            player.openInventory(inventory);
            player.sendMessage(message("messages.gui-opened", "&aتم فتح واجهة AntiCheat."));
            return true;
        }

        if (!hasPermission(sender, "anticheat.admin")) {
            sendNoPermission(sender);
            return true;
        }
        sender.sendMessage(message("messages.usage", "&eالاستخدام: /ac <reload|gui>"));
        return true;
    }

    public void sendAlert(String alert) {
        String prefix = message("alerts.prefix", "&8[&cAntiCheat&8] &e");
        String formattedAlert = color(prefix + alert);
        for (Player player : getServer().getOnlinePlayers()) {
            if (player.hasPermission("anticheat.alerts")) {
                player.sendMessage(formattedAlert);
            }
        }
    }

    public boolean isBypassed(Player player, CheckCategory category) {
        if (player.hasPermission("anticheat.bypass")) {
            return true;
        }
        return switch (category) {
            case MOVEMENT -> player.hasPermission("anticheat.bypass.movement");
            case COMBAT -> player.hasPermission("anticheat.bypass.combat");
            case XRAY -> player.hasPermission("anticheat.bypass.xray");
        };
    }

    private boolean hasPermission(CommandSender sender, String permission) {
        if (sender instanceof Player player) {
            return player.hasPermission(permission);
        }
        return sender.hasPermission(permission);
    }

    private void sendNoPermission(CommandSender sender) {
        sender.sendMessage(message("messages.no-permission", "&cليس لديك صلاحية لتنفيذ هذا الأمر."));
    }

    private String message(String path, String fallback) {
        return color(getConfig().getString(path, fallback));
    }

    private String color(String text) {
        return ChatColor.translateAlternateColorCodes('&', text);
    }

    public enum CheckCategory {
        MOVEMENT,
        COMBAT,
        XRAY
    }
}