🛡️ AdventurePluginHide

一、简介

AdventurePluginHide —— 多平台插件隐藏系统,阻止玩家通过 Tab 补全或命令探测服务器安装的插件列表。支持 Spigot、BungeeCord 和 Velocity 三大平台。

基于 PacketEvents 数据包拦截,167 个类涵盖三端完整实现。

核心特性

  • 多平台支持 > Spigot + BungeeCord + Velocity
  • Tab 补全拦截 > 阻止命令补全泄露插件列表
  • 命令隐藏 > 隐藏指定命令
  • LuckPerms 集成 > 基于权限组的隐藏规则
  • Folia 兼容 > 支持 Folia 服务端
  • PacketEvents > 基于数据包级别的精确拦截

二、插件前置

  • PacketEvents — 必须,数据包处理框架
  • LuckPerms — 可选,权限组集成

📥 安装与配置

环境要求

项目要求
服务端Spigot / Paper 1.21+ 或 BungeeCord 或 Velocity
Java21+
必须前置PacketEvents

安装步骤

  1. 确保 PacketEvents 已安装
  2. 根据平台选择对应 JAR:
    • SpigotAdventurePluginHide-Spigot.jar
    • BungeeCordAdventurePluginHide-Bungee.jar
    • VelocityAdventurePluginHide-Velocity.jar
  3. 放入对应 plugins 目录,重启服务器
  4. 编辑配置文件,/ahide reload

三端架构

模块入口类说明
spigot/AdventurePluginHideSpigot/Paper 端实现
bungee/BungeeHidePluginBungeeCord 端实现
velocity/VelocityHidePluginVelocity 端实现

🛡️ 隐藏机制

工作原理

插件使用 PacketEvents 在数据包层面拦截 Tab 补全和命令相关数据包,在发送给客户端之前过滤掉需要隐藏的插件和命令信息。

隐藏范围

  • /plugins 命令 — 拦截插件列表输出
  • Tab 补全 — 过滤命令补全建议
  • 命令帮助 — 隐藏指定命令的帮助信息
  • 版本信息 — 拦截 /version 等探测命令

LuckPerms 集成

通过 LuckPerms 权限组可以为不同玩家组配置不同的隐藏规则。管理员可以看到完整的插件列表,而普通玩家只能看到允许的命令。

  • /ahide updategroup — 更新权限组缓存
  • /ahide check <玩家> — 检查玩家的隐藏状态

⌨️ 命令与权限

主命令 /ahide

命令说明
/ahide reload重载配置
/ahide check <玩家>检查玩家隐藏状态
/ahide updategroup更新 LuckPerms 权限组缓存
/ahide help帮助信息

权限节点

权限说明默认
ahide.admin管理员权限(查看所有插件)OP
ahide.bypass绕过隐藏规则OP