UltimateServerProtector - 服务器安全防护插件

UltimateServerProtector 是一款极其轻量级的服务器保护插件，它通过为每位管理员设置独立的密码来构筑一道坚固的安全防线。它不仅定期检查玩家权限，还支持IP白名单、惩罚机制和详尽的日志记录，有效防止未授权访问和恶意攻击。

💡核心特性

• 独立管理员密码：为每位拥有管理员权限的玩家设置专属密码，必须输入正确密码才能行使权限。
• 持续权限监控：插件会定期检查在线玩家的权限状态，而不仅仅在玩家加入时检查。
• 异步高性能：采用异步与多线程设计，确保高性能运行，几乎不占用服务器资源。
• 全面日志记录：可记录所有密码尝试、插件启用/禁用及管理员登录事件至独立日志文件。
• 可定制惩罚系统：对多次输入错误密码、超时未输入或非法获取权限的玩家执行自定义惩罚命令。
• IP白名单：可为管理员绑定IP地址，增强账户安全性。
• 会话管理：支持会话保持，玩家在一定时间内无需重复输入密码。
• 多服务器支持：通过代理网络广播消息，适用于多服环境。
• 高度可配置：提供丰富的设置选项，包括加密、视觉效果、声音、允许的命令列表等。

系统要求

• Java 17 或更高版本。

🎮配置文件详解

config.yml

这是插件的主配置文件，包含所有核心设置。

主要设置 (main-settings)

• serializer: 文本格式。LEGACY（使用 & 符号）或 MINIMESSAGE（使用 <color> 标签，适用于 1.17+）。
• proxy: 设置为 true 时，消息将广播到代理网络上的所有服务器。
• prefix: 插件消息前缀。
• use-command: 设置为 false 时，玩家需在聊天框输入密码；为 true 时使用命令。
• pas-command: 输入密码的命令（无需以 / 开头，默认为 pas）。
• enable-admin-commands: 启用用于在配置中添加新玩家的管理命令（如 /usp setpass）。
• check-interval: 主要检查间隔（单位：游戏刻，默认40）。

加密设置 (encryption-settings)

• enable-encryption: 是否启用密码加密。
• encrypt-method: 加密方法。支持 BASE64, MD5, SHA224, SHA256, SHA384, SHA512, SHA3-224, SHA3-256, SHA3-384, SHA3-512 以及 SALT。可同时使用多种方法，用分号分隔（例如：BASE64;SALT;MD5）。
• auto-encrypt-passwords: 启用后，插件启动时会自动加密 data.yml 中所有现有密码。

拦截设置 (blocking-settings)

控制在输入密码期间对玩家行为的限制。

• block-item-drop: 阻止丢弃物品。
• block-item-pickup: 阻止拾取物品。
• block-tab-complete: 阻止Tab补全。
• block-damage: 使玩家在输入密码期间无敌。
• block-damaging-entity: 阻止玩家对生物或其他玩家造成伤害。
• block-inventory-open: 阻止打开任何库存界面。
• hide-on-entering: 在输入密码时从Tab列表隐藏该玩家。
• hide-other-on-entering: 对正在输入密码的玩家隐藏其他玩家。

惩罚设置 (punish-settings)

• enable-attempts / max-attempts: 启用密码尝试次数限制及最大尝试次数。
• enable-time / time: 启用输入密码的时间限制及限制时长（秒）。
• enable-rejoin / max-rejoins: 启用对未输入正确密码就退出重连的惩罚及最大重连次数。

增强安全设置 (secure-settings)

• enable-op-whitelist: 对未列入白名单的OP玩家启用惩罚。
• enable-notadmin-punish: 对拥有管理员权限但未在配置文件中列出的玩家启用惩罚。
• enable-ip-whitelist: 启用管理员IP白名单。
• shutdown-on-disable: 插件被禁用时关闭服务器（可配合 shutdown-on-disable-only-if-plugman 使用）。

命令与列表 (commands, permissions, lists)

• commands: 为各种违规情况（如密码错误、不在配置中、IP不符等）设置要执行的惩罚命令。
• permissions: 需要输入管理员密码才能使用的权限列表。
• allowed-commands: 在输入管理员密码前允许玩家执行的命令列表（例如 /login, /register，方便与 AuthMe 等插件配合）。
• op-whitelist: 允许拥有OP权限的玩家名单。
• ip-whitelist: 允许以管理员身份登录的IP地址列表（支持通配符，如 1.2.3.*）。
• excluded-players: 免除特定检查的玩家名单（例如免密码输入、免OP检查等）。

message.yml

此文件包含所有插件发送的消息，支持变量如 %prefix%, %player%, %ip%。

• msg: 直接发送给玩家的消息（如提示输入密码、密码错误/正确等）。
• broadcasts: 发送给其他管理员的通知消息。
• titles: 全屏标题消息。
• uspmsg: 使用 /usp 命令时的反馈消息。
• system: 系统警告和更新提示。

data.yml

存储管理员用户名及其密码的文件。当启用加密时，密码应存储在 encrypted-pass: 字段下。

data:
  Overwrite:
    pass: '123123' # 或 encrypted-pass: '加密后的字符串'
  test99999:
    pass: '321321'

🔧权限与命令

权限 (Permissions)

• serverprotector.protect：拥有此权限的玩家会被要求输入管理员密码。插件内置，无需在配置中额外指定。
• serverprotector.admin：允许使用 /usp 命令并查看有关密码尝试成功/失败的通知。

命令 (Commands)

• /pas <密码>：输入管理员密码的命令（可在配置中更改 pas-command）。
• /usp reload：重载插件配置。
• /usp reboot：重启插件。
• /usp encrypt <密码>：显示指定密码的加密后版本。
• /ultimateserverprotector 与 /serverprotector：/usp 命令的别名。

可启用的管理命令

在配置中将 enable-admin-commands 设为 true 后可用：

• /usp setpass <玩家名> <密码>：将玩家及其密码添加到 data.yml。
• /usp addop <玩家名>：将玩家添加到OP白名单。
• /usp addip <玩家名> <IP>：将IP添加到指定玩家的IP白名单。
• /usp rempass <玩家名>：从 data.yml 移除玩家及其密码。
• /usp remop <玩家名>：从OP白名单移除玩家。
• /usp remip <玩家名> <IP>：从指定玩家的IP白名单中移除IP。

✨优势总结

与其他安全插件相比，UltimateServerProtector 具有以下突出优点：

• 持续主动检查：不仅检查OP状态或登录事件，还定期扫描所有在线玩家的权限。
• 功能全面且可定制：提供加密、IP绑定、惩罚、会话、视觉效果等大量可配置选项。
• 高性能设计：异步与多线程确保极低的服务器负载。
• 多服务器支持：原生支持跨服消息通知，适合网络环境。