EpicGuard - EpicGuard

EpicGuard 是一款适用于 Minecraft 服务器的机器人防护插件，支持 Bukkit、BungeeCord 及 Velocity 环境。它高度可配置且易于自定义。

> 注意：此版本的 EpicGuard 已过时，将不会在此发布新更新。此版本适用于旧版服务器和 Java 版本。如需最新版本，请访问 GitHub。

💡重要须知

• 此版本为旧版，适用于遗留服务器和 Java 版本。
• 新版本和更新将在 GitHub 上发布。

🎮核心特性

EpicGuard 提供全面的机器人攻击防护，包含以下功能：

防护检查

• 总计 8 种 反机器人检查机制。
• 所有检查均可按需配置：可设置为始终检查、仅在攻击期间检查或完全禁用。
• 支持自动白名单功能，确保真实玩家在机器人攻击期间不受影响。
• 可在攻击期间限制新玩家加入服务器。
• 支持限制单个 IP 地址可使用的昵称数量。
• 可使用正则表达式过滤玩家昵称。

连接与地理控制

• 通过 proxycheck.io 等服务阻止 VPN 和代理连接（支持自定义 API）。
• 允许或阻止特定国家/城市的连接。
• 强制用户将服务器添加到服务器列表并 Ping 后才能加入。

性能与显示

• 攻击状态会显示在 动作栏（Action Bar） 上。
• 可过滤控制台中不需要的刷屏消息。
• 可限制连接到服务器的频率（节流）。

平台兼容性

• 兼容 Spigot、PaperSpigot（及其分支）、BungeeCord、Waterfall（及其分支）以及 Velocity。

Spigot 版独有功能

以下模块可在 plugins/EpicGuard/spigot.yml 文件中配置，详情请参阅 Wiki 页面。

• 禁用原版 OP 机制。
• 阻止命名空间命令（包含 : 符号的命令，如 minecraft:me）。
• 可设置 “受信任管理员”列表，仅列表中的玩家可拥有 OP 权限。
• 阻止特定不希望玩家或管理员执行的命令。
• 配置普通玩家允许执行的命令列表。

🔧命令

• /guard - 显示所有命令。
• /guard stats - 显示插件统计信息。
• /guard notifications - 切换反机器人通知的接收状态。
• /guard whitelist <address> - 手动将指定地址加入插件白名单（如果该地址在黑名单中，则同时将其移除）。
• /guard blacklist <address> - 手动将指定地址加入插件黑名单。
• /guard reload - 重载插件配置和消息文件。

✨权限

• epicguard.admin - 使用命令和接收警报所必需的权限。
• epicguard.protection.notify - 查看 OP 保护相关警报的权限。
• epicguard.bypass.allowed-commands - 允许绕过 “allowed-commands” 模块的限制。
• epicguard.bypass.custom-tab-complete - 允许绕过 “custom-tab-complete” 模块的限制。
• epicguard.bypass.blocked-commands - 允许绕过 “blocked-commands” 模块的限制。
• epicguard.bypass.namespaced-commands - 允许绕过 “namespaced-commands” 模块的限制。

⭐配置摘要

配置文件允许你精细调整插件的所有行为。

常规配置 (config.yml)

主要设置项包括

地理检查

• country-check-mode: 国家检查模式 (NEVER, ALWAYS, ATTACK)。
• country-check-type: 检查类型 (BLACKLIST, WHITELIST)。
• country-check-countries: 国家代码列表。
• city-blacklist: 城市黑名单。

其他反机器人检查

• proxy-check: 代理/VPN 检查模式 (NEVER, ALWAYS, ATTACK)。
• proxy-check-key: proxycheck.io 的 API 密钥（可免费获取）。
• max-accounts-per-ip: 单个 IP 允许的最大账户数。
• reconnect-check: 重连检查模式。
• server-list-check: 服务器列表检查模式。
• attack-deny-join: 攻击期间是否阻止新玩家加入。
• auto-whitelist: 是否启用自动白名单。
• auto-whitelist-time: 玩家在线多久后被加入白名单（秒）。
• rate-limit-check: 连接频率限制检查模式。
• rate-limit-seconds: 再次加入服务器前需等待的秒数。
• max-cps: 触发攻击模式所需的每秒最大连接数。

其他设置

• custom-proxy-check-url: 自定义代理检查 API 地址（可使用 %ip% 占位符）。
• proxy-check-cache-duration: 代理检查结果的缓存时间（分钟）。
• console-filter-mode: 控制台过滤器模式 (ALWAYS, ATTACK, NEVER)。
• console-filter: 要过滤的控制台消息关键词列表。
• update-checker: 是否启用更新检查器。
• autosave-interval: 自动保存数据的时间间隔（分钟）。
• debug: 是否在控制台记录检测到的机器人信息。

消息配置 (messages.yml)

可自定义所有插件发送的消息，包括前缀、命令反馈、踢出信息等。支持颜色代码（&）和占位符（如 {IP}, {USAGE}, %cps%, %status%）。

❓支持

此旧版本不再提供支持。请查看本页面顶部的通知以获取最新版本信息。