Protectcord

插件

· 作者 protectcord

Protectcord 是一款防 VPN/代理插件,它使用高级 API 来检查 IPv4/IPv6 是否为 VPN 或代理!

0 本站下载 0 关注 更新于 2 个月前

最新 1.3.10 · 26.1.2 · BungeeCord / Folia

一键开服(送7天)

ProtectCord — 高级 IP 保护与 Moderation(管理)

通过实时 IP 情报阻止 VPN、代理、机器人和恶意连接。内置 Moderation 功能、AutoMod 聊天过滤、小号检测以及 MySQL 多服务器同步 —— 全部集成在一个轻量级插件中。

ProtectCord 会在玩家加入服务器之前,将其连接信息与实时威胁情报数据库进行比对。结合全套 Moderation 套件,它是保持服务器整洁和社区安全的唯一必备工具。

✨ 里程碑

  • 2,300+ Modrinth 下载量
  • 100,000+ ProtectCord API 请求已服务
  • 46 个独特的 Minecraft 服务器同时运行 ProtectCord
  • 203 名受保护的并发玩家
  • 1,000+ 个已验证的独特 Discord 用户
  • 3,000+ 每日独特 API 请求
  • 555 个使用 @ProtectCord#0253 的 Discord Guilds
  • 守护着 100,000+ 名 Discord 用户

bStats:


✨ 主要功能

IP 保护

  • ?️ 实时 IP 验证 — 每次连接都会针对实时威胁情报进行检查
  • ? VPN、代理 & Tor 屏蔽 — 立即阻止封禁规避者和账号代练
  • ? 数据中心 IP 检测 — 标记并阻止用于机器人的主机提供商 IP
  • ⚠️ 基于风险的屏蔽 — 可配置的威胁等级:UNKNOWN → LOW → MEDIUM → HIGH → CRITICAL
  • ? 地理屏蔽 — 使用 ISO 代码屏蔽或白名单整个国家
  • ? 每 IP 账号数量限制 — 限制来自单个 IP 的同时连接数
  • ✅ 智能白名单系统 — 通过玩家名称、UUID 或 IP 绕过保护

Moderation 套件

  • ⚡ 渐进式警告系统 — 可配置从警告 → 踢出 → 封禁的自动升级机制
  • ⏱️ 临时封禁 & 临时静音 — 具有人类可读持续时间(1h, 7d, 30d)的限时惩罚
  • ? 静音系统 — 持久性静音,包含原因、执行者追踪和自动过期
  • ? 小号账号检测 — 通过共享 IP 查找小号 (/pc alts <player>) — 仅显示名称,绝不显示原始 IP
  • ? 警告历史 — 任何玩家(在线或离线)的完整时间戳警告日志
  • ? 清除 & 移除警告 — 按索引移除单个警告或一次性清除所有警告
  • ?️ 审计日志 — 自动记录所有 Moderation 操作
  • ? 离线玩家支持 — 对未在线的玩家进行警告、封禁、静音或检查

AutoMod(聊天过滤)

  • ? 反链接 — 屏蔽 URL,支持域名白名单
  • ? 反广告 — 屏蔽服务器 IP 和 Discord 邀请链接
  • ? 反垃圾信息 — 速率限制,支持可配置的消息窗口和重复检测
  • ? 反脏话 — 自定义单词黑名单,支持正则表达式和单字例外
  • ? 反大写 — 可按百分比配置的大写阈值
  • ? 反刷屏 — 屏蔽重复字符刷屏
  • ? 反 Unicode/Zalgo — 屏蔽不可见文本和字符滥用
  • ⚙️ 逐规则操作 — 每条规则独立设置为:BLOCK(屏蔽)、WARN(警告)、KICK(踢出)、MUTE(静音)或 TEMPMUTE(临时静音)

存储与多服务器

  • ?️ YAML 扁平文件存储 — 零设置,开箱即用
  • ? MySQL 存储 — 完整的 MySQL 后端,带有 HikariCP 连接池
  • ? 多服务器同步 — 在整个网络中共享一个 MySQL 数据库;封禁和静音将在每个服务器上强制执行
  • ? 实时迁移 — 随时通过 /pc migrate 在 YAML 和 MySQL 之间迁移
  • ? 数据清理 — 使用 /pc purge 清理旧警告、封禁、静音、IP 日志、审计条目和不活跃玩家

Staff 工具

  • ? 游戏内 Staff 警报 — 踢出、封禁、警告、静音、AutoMod 操作等的实时通知
  • ? IP 掩码 — 向 Staff 显示掩码后的 IP(192.168.1.*),直到他们获得 protectcord.ip.full 权限
  • ? 玩家举报 — 玩家通过 /report 提交举报;Staff 将在游戏内和通过 Discord 收到通知
  • ? API 统计 — 使用 /pc stats 检查使用情况、速率限制和 API 健康状况
  • ? 手动 IP 检查 — /pc check <player|ip> 用于按需威胁分析

平台与集成

  • ? 6 大平台支持 — Paper, Spigot, Folia, BungeeCord, Velocity 和 Forge
  • ? Discord Webhooks — 丰富的嵌入消息,包含国旗、城市、VPN/代理/Tor/风险字段、逐事件控制、速率限制和重试逻辑
  • ? Moderation 警报 Webhooks — 用于封禁/警告/静音/踢出等 Staff 事件的单独 webhook 频道
  • ⚡ 100% 异步 — 所有 IP 检查均为非阻塞;不影响主线程

? 支持的平台

Platform Versions Notes
Paper 1.13 – 1.21+ 推荐用于独立服务器
Spigot 1.8.8 – 1.21+ 完整的旧版本支持
Folia 1.19+ 多线程调度器支持
Velocity 3.0+ 推荐用于代理网络
BungeeCord 1.8.8 – 1.21+ 兼容 Waterfall
Forge 1.20.1+ 仅限服务端;登录后检查

网络提示: 仅在您的代理(Velocity/BungeeCord)上安装即可使用单个 API Key 保护所有后端服务器。


? 快速设置

1️⃣ 获取您的免费 API Key

  1. 访问 protectcord.com
  2. 创建免费账户
  3. 从 Dashboard → API Keys 生成 API Key
  4. 免费套餐包含每分钟 32 次请求 — 足以满足大多数服务器的需求

2️⃣ 安装插件

  1. 从 Modrinth 下载适合您平台的正确 JAR 文件
  2. 将其放入 plugins/ 文件夹(Forge 则为 mods/)
  3. 启动服务器 — 配置文件自动生成
  4. 将您的 API Key 添加到 plugins/ProtectCord/config.yml
  5. 运行 /protectcord reload 或重启服务器
  6. ✅ 您的服务器现已受到保护

⚙️ 完整配置参考

配置文件在首次运行时自动生成于 plugins/ProtectCord/config.yml。以下解释了每个选项。

Velocity 使用 config.toml(结构相同,TOML 语法)。Forge 使用 config/protectcord-forge.toml。


API 设置

# 您的 ProtectCord API Key — 可在 https://protectcord.com/dashboard/api-keys 免费获取
api-key: "YOUR_API_KEY_HERE"

# 等待 API 响应超时时间(毫秒)
api-timeout:
  connect: 15000   # 建立连接的时间(默认:15s)
  read: 15000      # 连接后等待响应的时长(默认:15s)

# 对失败/超时的 API 请求自动重试
api-retry:
  max-attempts: 3      # 在允许/拒绝玩家之前最大重试次数(1–5)
  initial-delay: 1000  # 第一次重试前的等待时长(毫秒)
  max-delay: 5000      # 重试之间的最大等待时长(毫秒)
  multiplier: 2.0      # 每次重试时延迟的倍增因子(指数退避)

服务器标识

# 用于玩家追踪和多服务器 MySQL 识别
server:
  name: "My Server"   # 友好名称 — 存储在 MySQL 中,作为每一行的 server_id
  ip: ""              # 你的公网 IP — 留空以自动检测
  port: 25565         # 你的服务器端口
  type: "spigot"      # 平台类型:paper / spigot / bungeecord / velocity / forge / folia

玩家追踪

# 通过 ProtectCord API 进行基于 UUID 的追踪
player-tracking:
  enabled: true
  block-flagged-players: true    # 阻止被 API 标记为恶意的玩家
  block-inactive-players: false  # 阻止账户被标记为不活跃的玩家

IP 保护

# 总开关 — 设置为 false 可禁用所有 IP 检查(不建议)
enable-ip-check: true

# 选择要阻止的连接类型
block-vpn: true         # 虚拟专用网络(封禁逃避者、小号)
block-proxy: true       # HTTP/SOCKS 代理和匿名器
block-tor: true         # Tor 出口节点
block-datacenter: true  # 数据中心托管 IP(常见机器人来源)
block-bogon: true       # 无效、保留或不可路由的 IP 范围

# 基于风险的拦截(可选,作为上述标志的补充运行)
# 启用此选项可通过整体威胁分数进行拦截,而非(或同时)使用单个标志
enable-risk-level-blocking: false
blocked-risk-level: "HIGH"
# 等级说明(每个等级会拦截自身及以上的所有等级):
#   LOW      — 拦截 LOW, MEDIUM, HIGH, CRITICAL  (非常严格)
#   MEDIUM   — 拦截 MEDIUM, HIGH, CRITICAL
#   HIGH     — 拦截 HIGH, CRITICAL               (如果启用则推荐)
#   CRITICAL — 仅拦截 CRITICAL                   (非常宽松)

地理封锁

geo-blocking:
  enabled: false
  mode: "blacklist"   # "blacklist" = 阻止列出的国家
                      # "whitelist" = 仅允许列出的国家(其他所有人均被阻止)
  countries:          # ISO 3166-1 alpha-2 国家代码
    - "CN"
    - "RU"

每 IP 账号数限制

# 限制同一 IP 地址上可同时连接的 Minecraft 账号数量
account-per-ip-limit:
  enabled: false
  max-accounts: 3          # 来自同一 IP 的最大同时连接数
  enforcement: "BLOCK"     # "BLOCK"       — 拒绝新连接
                           # "KICK_OLDEST" — 踢出最旧的会话以腾出空间

Discord Webhook(连接事件)

discord-webhook:
  enabled: false
  url: ""             # 在此粘贴你的 Discord webhook URL
  timeout: 10000      # 发送 webhook 的 HTTP 超时时间(毫秒)

  # 重试失败的 webhook 投递
  retry:
    enabled: true
    max-attempts: 3       # 对失败投递的重试次数(1–10)
    initial-delay: 1000   # 首次重试前的等待时长(毫秒)
    max-delay: 10000      # 重试之间的最大等待时长(毫秒)
    multiplier: 2.0       # 指数退避倍增因子

  # 速率限制 — Discord 允许每个 webhook 每秒约 5 次请求
  rate-limit:
    max-per-second: 2   # 每秒发送的请求数(1–5)
    burst-limit: 5      # 触发节流前的最大突发量

  # 哪些事件会发送 webhook 消息
  events:
    denied: true          # 玩家被 ProtectCord 阻止
    accepted: false       # 玩家通过所有检查并加入(高流量 — 默认关闭)
    whitelisted: true     # 白名单玩家加入
    error: true           # 检查过程中发生 API 错误

  # embed 中显示哪些数据字段
  data-fields:
    show-country: true
    show-country-flag: true   # 国家名称旁边的 ?? 国旗表情符号
    show-city: true
    show-vpn: true
    show-proxy: true
    show-datacenter: true
    show-tor: true
    show-mobile: true
    show-satellite: true
    show-crawler: true
    show-bogon: true
    show-risk-level: true
    show-abuser: true
    show-blacklisted: true
    show-company: true        # ISP / 托管提供商名称
    show-company-risk: true

  # 自定义每种 embed 的外观
  embeds:
    denied:
      title: "Connection Denied"
      emoji: "x"
      color: 15158332      # 十进制 RGB — 红色
      footer: ""           # 可选页脚文本
      thumbnail-url: ""    # 右上角可选图片
    accepted:
      title: "Connection Accepted"
      emoji: "white_check_mark"
      color: 3066993       # 绿色
      footer: ""
      thumbnail-url: ""
    whitelisted:
      title: "Whitelisted Player Joined"
      emoji: "white_circle"
      color: 16776960      # 黄色
      footer: ""
      thumbnail-url: ""
    error:
      title: "API Error"
      emoji: "warning"
      color: 15105570      # 橙色
      footer: ""
      thumbnail-url: ""

  # 高级 webhook 行为
  advanced:
    validate-url-on-startup: true   # 插件加载时发送测试 ping
    log-failures: true              # 将失败的投递打印到控制台
    log-retries: true               # 将重试尝试打印到控制台
    queue-size: 100                 # 丢弃最旧条目之前的最大排队 webhook 数量

员工警报

# 管理操作的游戏中和 Discord 通知
alerts:
  enabled: true

  # 向拥有 protectcord.alerts 权限的在线员工广播
  in-game:
    enabled: true

  # 仅用于管理团队事件的独立 webhook 频道
  discord-webhook:
    enabled: false
    url: ""

# 精确调整触发警报的操作
  events:
    kick: true
    ban: true
    unban: true
    warn: true
    clear-warnings: true
    remove-warning: true
    automod: true
    mute: true
    unmute: true
    tempmute: true
    tempban: true

警告系统

warnings:

  # 当玩家积累足够多的警告时自动采取行动
  auto-action:
    enabled: true
    action: "BAN"      # "BAN" — 永久封禁 | "KICK" — 仅踢出
    threshold: 3       # 触发自动行动的警告数量阈值

  # 在较低的阈值下,以“最终警告”消息踢出玩家
  kick-on-warn:
    enabled: true
    threshold: 2       # 在此警告数量时踢出玩家(低于封禁阈值)

  # 超过此时限的警告不计入阈值统计
  expiry:
    duration: "0"      # "0" = 警告永不过期
                       # 示例:"7d", "30d", "90d"

  # 升级层级 —— 启用时将覆盖自动行动
  # 每个层级在警告数量达到 `count` 时触发
  escalation:
    enabled: false
    tiers:
      - count: 1
        action: "WARN"
      - count: 2
        action: "TEMPMUTE"
        duration: "1h"
      - count: 3
        action: "TEMPBAN"
        duration: "1d"
      - count: 4
        action: "TEMPBAN"
        duration: "7d"
      - count: 5
        action: "BAN"
# 可用操作:WARN, KICK, MUTE, TEMPMUTE, TEMPBAN, BAN
# 持续时间格式:30s, 10m, 1h, 7d, 30d

自动 Moderation (聊天过滤)

automod:
  enabled: false           # 主开关 —— 必须为 true 才能运行任何规则

  # 阻止操作适用于触发规则的聊天消息。
  # 所有规则可用的操作:BLOCK, WARN, KICK, MUTE, TEMPMUTE
  # TEMPMUTE 的持续时间由下方的 tempmute-duration 设置。
  tempmute-duration: "10m"

  # 屏蔽聊天中的链接
  anti-link:
    enabled: true
    action: "BLOCK"
    whitelisted-domains:   # 允许通过的域名
      - "yourdomain.com"
      - "discord.gg/yourserver"

  # 屏蔽垃圾信息(消息过多过快,或重复内容过多)
  anti-spam:
    enabled: true
    action: "BLOCK"
    max-messages: 5          # 时间窗口内允许的最大消息数
    time-window-seconds: 10  # 滚动窗口大小(秒)
    max-duplicates: 3        # 窗口内允许的最大相同消息数

  # 屏蔽服务器 IP 和 Discord 邀请链接
  anti-advertising:
    enabled: true
    action: "BLOCK"
    block-server-ips: true       # 屏蔽类似 "play.someserver.net" 的模式
    block-discord-invites: true  # 屏蔽 discord.gg/... 链接
    whitelisted-domains:
      - "yourdomain.com"
      - "discord.gg/yourserver"

  # 屏蔽脏话和自定义禁用词汇
  anti-swear:
    enabled: false
    action: "BLOCK"
    use-regex: false          # 设为 true 可将 blocked-words 条目视为正则表达式模式
    blocked-words:
      - "badword1"
      - "badword2"
    whitelisted-words:        # 即使匹配模式,这些词也永远不会被屏蔽
      - "scrapbook"

  # 屏蔽过度使用大写字母
  anti-caps:
    enabled: false
    action: "BLOCK"
    min-message-length: 5      # 忽略短消息(例如 "OK", "YES")
    threshold-percent: 70.0    # 如果大写比例超过此百分比则屏蔽

  # 屏蔽字符泛滥(aaaaaaaaaa, !!!!!!!!!)
  anti-flood:
    enabled: false
    action: "BLOCK"
    max-repeated-chars: 5   # 连续相同字符的数量阈值,达到后屏蔽
    min-message-length: 3   # 忽略极短的消息

  # 屏蔽 Unicode 滥用和 Zalgo 文本
  anti-unicode:
    enabled: false
    action: "BLOCK"
    block-zalgo: true           # 屏蔽组合变音符号堆叠(z͎̤̙̘̭͇͠a̵͔͓l̡͔͍̦͚͙g̢͕̲͔͔͕ö̥́)
    max-unicode-percent: 50.0   # 如果非 ASCII 字符比例超过此百分比则屏蔽

玩家举报

reports:
  enabled: true
  cooldown-seconds: 60       # 玩家两次举报之间必须等待的时间(秒)

  # 将举报发布到 Discord 频道
  discord-webhook:
    enabled: false
    url: ""
    mention-role-id: ""      # 可选 —— 收到举报时 @ping 某个角色(例如 "123456789")

  notify-staff: true         # 向在线工作人员广播举报,附带 protectcord.alerts 权限

  predefined-reasons: []     # 可选列表,显示在 tab-complete 补全中
                             # 示例:["Hacking", "Spam", "Harassment", "Inappropriate name"]

数据库存储

database:
  type: "YAML"   # "YAML" — 扁平文件存储(默认,无需配置)
                 # "MYSQL" — MySQL/MariaDB(用于多服务器同步所需)
  mysql:
    host: "localhost"
    port: 3306
    database: "protectcord"   # 数据库名称(启动前必须存在)
    username: "root"
    password: ""
    table-prefix: "pc_"       # 所有表以此作为前缀(例如 pc_warnings, pc_bans)

    # HikariCP 连接池设置
    pool:
      max-pool-size: 10         # 最大同时数据库连接数
      min-idle: 2               # 保持打开的最小空闲连接数
      connection-timeout: 30000 # 从池中获取连接的最大等待时间(毫秒)
      idle-timeout: 600000      # 超过此时长后关闭空闲连接(毫秒)
      max-lifetime: 1800000     # 超过此时长后回收连接(毫秒)

IP 掩码

# 控制 IP 地址在命令输出中对工作人员的显示方式
# 拥有 protectcord.ip.full 权限的工作人员始终可以看到完整 IP
ip-masking:
  enabled: false
  mask-format: "last-octet"
  # "last-octet"      → 192.168.1.*       (隐藏最后一段)
  # "last-two-octets" → 192.168.*.*       (隐藏最后两段)
  # "full-mask"       → *.*.*.*           (隐藏所有内容)

自定义消息

# 所有消息均支持 & 颜色代码。各消息列出的占位符如下。
messages:

# 向被 IP 检查拦截的玩家显示 — {reason}, {risk}
  connection-denied: |
    &c&l连接被拒绝
    &7您的连接已被 ProtectCord 拦截。
    &7原因:&c{reason}
    &7风险等级:&c{risk}

    &7如果您认为这是误判,请联系服务器工作人员。

  # 当检查期间 API 不可用时显示
  api-error: |
    &c&l临时连接问题
    &7我们目前无法验证您的连接。
    &7请稍后重试。

  # 向因单 IP 账户数限制被阻止的玩家显示 — {max}, {current}
  account-limit-reached: |
    &c&l达到连接限制
    &7每个 IP 最大账户数:&c{max}
    &7来自您 IP 的当前连接数:&c{current}

    &7请在连接前断开另一个账户。

  # 向因执行 KICK_OLDEST 策略被踢出的最旧会话显示 — {max}
  account-limit-kicked: |
    &c&l您已断开连接
    &7有新账户从您的 IP 地址连接。
    &7每个 IP 最大账户数:&c{max}

  # 当玩家追踪阻止了有标记的玩家时显示 — {flags}
  player-flagged: |
    &c&l连接被拒绝
    &7您的账户已被标记。
    &7标记:&c{flags}
    &7如果您认为这是误判,请联系服务器工作人员。

  # 当玩家追踪阻止了不活跃玩家时显示
  player-inactive: |
    &c&l连接被拒绝
    &7您的账户已被停用。
    &7请联系服务器工作人员。

  # 向绕过 IP 检查的白名单玩家在聊天中显示
  whitelist-bypass: "&a您已绕过 IP 验证。"

---

## ? 命令与权限

**别名:** `/pc`, `/protect`

### 核心命令

| 命令 | 描述 |
|---------|-------------|
| `/pc reload` | 重载配置文件、白名单和存储数据 |
| `/pc stats` | 查看 API 使用情况和速率限制 |
| `/pc check <player\|ip>` | 按需进行 IP 威胁分析 |
| `/pc version` | 插件版本和平台信息 |
| `/pc health` | API 连通性健康检查 |
| `/pc alerts` | 切换游戏内工作人员警报的开/关状态 |

### 白名单命令

| 命令 | 描述 |
|---------|-------------|
| `/pc whitelist add player <name>` | 按名称将玩家加入白名单 |
| `/pc whitelist add uuid <uuid>` | 按 UUID 加入白名单 |
| `/pc whitelist add ip <address>` | 按 IP 地址加入白名单 |
| `/pc whitelist remove <type> <value>` | 移除白名单条目 |
| `/pc list` | 列出所有白名单条目 |

### 管理命令

| 命令 | 描述 |
|---------|-------------|
| `/pc kick <player> [reason]` | 踢出在线玩家并附带 IP 信息 |
| `/pc warn <player> <reason>` | 发出警告(自动升级处理) |
| `/pc warnings <player>` | 查看完整的警告历史 |
| `/pc clear warning <player>` | 清除所有警告 |
| `/pc clear ban <player>` | 清除封禁记录 |
| `/pc remove warning <player> [#]` | 通过索引移除特定警告 |
| `/pc ban <player> <reason>` | 永久封禁玩家 |
| `/pc tempban <player> <duration> <reason>` | 临时封禁(`1h`, `7d`, `30d`) |
| `/pc unban <player>` | 解封玩家 |
| `/pc mute <player> <reason>` | 永久禁言玩家 |
| `/pc tempmute <player> <duration> <reason>` | 临时禁言 |
| `/pc unmute <player>` | 解除禁言 |
| `/pc alts <player>` | 查找共享 IP 的副号账号 |

### 存储命令

| 命令 | 描述 |
|---------|-------------|
| `/pc migrate <yaml\|mysql>` | 在不同存储后端之间迁移所有数据 |
| `/pc purge <type> <days>` | 删除超过 X 天的数据 |

**清理类型:** `warnings`, `bans`, `mutes`, `iplogs`, `auditlog`, `inactive`, `all`

### 玩家命令

| 命令 | 描述 |
|---------|-------------|
| `/report [player] <reason>` | 举报玩家(或提交匿名举报) |

### 权限

| 权限 | 描述 | 默认值 |
|------------|-------------|---------|
| `protectcord.admin` | 所有 `/pc` 命令 | OP |
| `protectcord.bypass` | 加入时绕过 IP 检查 | false |
| `protectcord.alerts` | 接收游戏内工作人员警报 | OP |
| `protectcord.ip.full` | 在命令输出中查看未掩码的 IP | OP |
| `protectcord.automod.bypass.*` | 绕过所有 AutoMod 检查 | false |

---

## ⚡ 渐进式警告系统

根据警告数量自动升级处罚措施。提供两种模式:

### 简单模式(默认)

| 警告次数 | 行动 |
|---------|--------|
| 第 1 次 | 游戏内警告消息 |
| 第 2 次 | 被踢出,附带“最终警告”消息 |
| 第 3 次 | 永久封禁 |

### 升级阶梯模式(可配置)

完全自定义的升级流程 — 任何 WARN → TEMPMUTE → TEMPBAN → BAN 的组合均可:

1 次警告 → 警告消息 2 次警告 → 临时禁言(1 小时) 3 次警告 → 临时封禁(1 天) 4 次警告 → 临时封禁(7 天) 5 次警告 → 永久封禁


警告可以选择在配置的时间段后**过期**(`7d`, `30d` 等),这样过去的行为不会永远跟随玩家。

---

## ? AutoMod — 自动化聊天过滤

毫不费力地保护您的聊天环境。每个 AutoMod 规则独立运行,并可配置为对违规玩家执行 `BLOCK`(屏蔽)、`WARN`(警告)、`KICK`(踢出)、`MUTE`(禁言)或 `TEMPMUTE`(临时禁言)。

| 规则 | 检测内容 |
|------|----------------|
| **Anti-Link** | URL 链接,支持按域名设置白名单 |
| **Anti-Advertising** | 其他服务器 IP、Discord 邀请链接 |
| **Anti-Spam** | 消息频率和重复刷屏 |
| **Anti-Swear** | 自定义词库,支持正则表达式和例外情况 |
| **Anti-Caps** | 大写比例过高 |
| **Anti-Flood** | 重复字符滥用 |
| **Anti-Unicode** | Zalgo 文本和不可见字符滥用 |

---

## ? 副号账号检测

通过一条命令找出逃避封禁或使用多个账号的玩家:

/pc alts Notch → [ProtectCord] Notch 的副号账号:

  • Notch2 (共享 IP 数: 2)
  • AltAccount99 (共享 IP 数: 1)

IP 地址在副号输出中**永远不会显示** — 工作人员仅看到玩家名称,在识别逃避者同时保护隐私。

---

## ?️ MySQL 与多服务器同步

将所有数据(警告、封禁、禁言、IP 历史记录、审计日志)存储在 MySQL 数据库中,而不是本地 YAML 文件。

- **所有服务器共享一个数据库** —— 在 Factions 模式下禁用,在 Survival 模式下被阻止
- **HikariCP 连接池** —— 高性能且线程安全
- **自动建表** —— 首次启动时自动创建数据表
- **server_id 追踪** —— 每一行记录都包含操作来源的服务器 ID
- **实时迁移** —— 使用 `/pc migrate mysql` 命令从 YAML 配置迁移到 MySQL(或反向迁移)

/pc migrate mysql → 已迁移 47 名玩家、12 条 IP 封禁、203 条审计日志。 → 更新 config.yml 中的 database.type 并运行 /pc reload。


---

## ? 数据清理

使用精细化的清理命令保持数据库整洁:

/pc purge warnings 90 — 移除超过 90 天的警告 /pc purge bans 30 — 移除超过 30 天已过期的封禁 /pc purge mutes 30 — 移除超过 30 天已过期的静音 /pc purge iplogs 365 — 移除超过 1 年的 IP 历史记录 /pc purge auditlog 90 — 修剪审计日志 /pc purge inactive 180 — 移除超过 6 个月未出现的玩家记录 /pc purge all 90 — 执行以上所有清理操作


---

## ? Discord 集成

### 连接 Webhook

每当有玩家被封禁、接受或加入白名单时,获取丰富的 Discord 嵌入消息:

- 国家(带国旗 emoji)、城市、VPN/代理/Tor/数据中心/Bogon 标识、风险等级、所属公司
- 按事件类型切换通知 —— 仅接收你关心的事件
- 速率限制 —— 符合 Discord 的限制要求
- 自动重试 —— 采用指数退避策略

### 管理员警报 Webhook

用于管理事件的独立 Webhook:封禁、解封、警告、踢出、静音、AutoMod 操作 —— 让你的管理团队随时掌握动态。

### 30 秒完成设置

1. Discord → 服务器设置 → 集成 → Webhooks → 新建 Webhook → 复制 URL
2. 添加到 `config.yml`:
```yaml
discord-webhook:
  enabled: true
  url: "https://discord.com/api/webhooks/YOUR_WEBHOOK"
  1. /pc reload

?️ IP 检测原理

每位连接玩家的 IP 都会发送至 ProtectCord API 进行评估:

检查项 检测内容
VPN 用于隐藏位置的虚拟专用网络
Proxy HTTP/SOCKS 代理及匿名器
Tor Tor 出口节点
Datacenter 托管服务提供商(常见机器人来源)
Bogon 无效或保留的 IP 段
Risk Score AI 生成的风险评分,范围从 UNKNOWN 到 CRITICAL
Geo 来源国家(用于地理封锁)

自动绕过规则

以下情况不会调用 API:

  • 本地回环地址 (127.0.0.1, ::1)
  • 私有网络 (192.168.x.x, 10.x.x.x, 172.16–31.x.x)
  • 白名单中的玩家、UUID 或 IP

❓ 常见问题

这是免费的吗? 是的。免费 API 密钥包含 每分钟 32 次请求,足以满足大多数服务器的需求。

它会拖慢我的服务器性能吗? 不会。所有 IP 检查都是 完全异步 的,绝不会阻塞主线程。

合法玩家会被误封吗? 极少发生。可使用 /pc check <player> 查看原因,然后通过 /pc whitelist add player <name> 将其加入白名单。你也可以将 blocked-risk-level 设置为 CRITICAL 以降低封禁强度。

它支持离线模式吗? 支持。该插件可在在线模式和离线模式下正常运行。

关于代理网络怎么办? 仅在代理端(BungeeCord 或 Velocity)安装 ProtectCord。所有后端服务器只需一个插件和一个 API 密钥即可自动受到保护。

如果 API 宕机了怎么办? 默认情况下,在 API 中断期间允许玩家连接。这可以防止大规模锁服,并且可以在配置文件中更改此行为。

你们会存储玩家数据吗? 仅有 IP 地址会发送至 ProtectCord API。用户名或 UUID 不会对外传输。请参阅我们的 隐私政策。

我可以跨服务器同步封禁吗? 可以 —— 启用 MySQL 存储并将所有服务器指向同一个数据库。封禁和静音将在整个网络范围内自动强制执行。


? 故障排除

“API KEY NOT CONFIGURED!”(未配置 API 密钥!) 前往 protectcord.com/dashboard 获取你的密钥,将其添加到 config.yml,然后运行 /pc reload。

玩家被错误封禁 运行 /pc check <player> 查看原因。使用 /pc whitelist add player <name> 将其加入白名单,或降低 blocked-risk-level 的值。

达到速率限制 免费套餐:32 次请求/分钟(约每 2 秒 1 名玩家)。解决方案:将常玩玩家加入白名单以跳过 API 调用,或者仅在代理端而非所有后端服务器上安装插件。

Discord Webhook 无反应 验证 URL 是否正确、enabled: true 是否已设置、相关事件是否已启用,并检查控制台是否有错误信息。

MySQL 连接失败 检查配置文件中的主机/端口/凭据。确保 MySQL 用户拥有 CREATE TABLE 权限。请查看控制台中 HikariCP 的错误提示。


? 链接与支持


? 支持本项目

  • ⭐ 在 Modrinth 上关注
  • ? 加入 Discord 社区
  • ? 留下评论并分享你的体验
  • ? 在 Discord 上报告错误或提出功能建议

为 Minecraft 社区用心制作 —— ProtectCord,因为预防胜于治理。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源