请报告问题或提出建议
PluginHider
PluginHider 是一个 Paper 插件,用于向普通玩家隐藏插件枚举命令和命令补全提示。
它适用于不希望玩家、Tab 补全工具或客户端扫描器通过常见的 Bukkit、Paper 或命名空间命令表面轻松发现已安装插件的服务器。
功能特性
- 阻止直接常用插件列表命令的使用,例如
/plugins、/pl、/version、/ver、/about和/icanhasbukkit。 - 过滤被禁命令的命令建议和 Tab 补全内容。
- 在发送给玩家之前修剪 Paper/Brigadier 命令树。
- 默认隐藏命名空间命令,同时保留受信任的命名空间(如
minecraft和brigadier)。 - 隐藏配置的根命令别名,防止客户端扫描器通过这些别名推断插件。
- 支持用于工作人员或受信任用户的绕过权限。
- 使用简单的 YAML 配置文件。
支持的版本
此仓库为每个受支持的服务器/API 版本保留了单独的分支:
| 分支 | Paper API |
|---|---|
1.21.1 |
1.21.1-R0.1-SNAPSHOT |
1.21.5 |
1.21.5-R0.1-SNAPSHOT |
1.21.8 |
1.21.8-R0.1-SNAPSHOT |
1.21.11 |
1.21.11-R0.1-SNAPSHOT |
version/26.1.2 |
26.1.2.build.69-stable |
请使用与你的服务器版本匹配的分支。
安装
- 下载或构建适合你服务器版本的 jar 文件。
- 将 jar 文件放入服务器的
plugins/文件夹中。 - 启动或重启服务器。
- 如有需要,编辑
plugins/PluginHider/config.yml。 - 更改命令过滤行为后,执行完整重启。
配置
默认配置:
bypass-permission: ""
blocked-command-message: "&cUnknown command."
# 从补全/建议中隐藏,并在手动输入时阻止。
# 包括扫描客户端可能直接执行的插件/管理根命令。
# 保持面向玩家的正常命令(如 /home, /warp, /msg, /rtp, /spawn)
# 不在此列表中,以便玩家默认保留命令便利性。
# 移除那些希望允许普通用户运行的命令
blocked-command-paths:
- "plugins"
- "pl"
- "version"
- "ver"
- "about"
- "icanhasbukkit"
- "paper plugins"
- "paper version"
- "paper ver"
- "luckperms"
- "lp"
- "worldedit"
- "we"
- "worldguard"
- "rg"
- "grimac"
- "grim"
- "vulcan"
- "matrix"
- "karhu"
- "verus"
- "nocheatplus"
- "ncp"
- "spark"
- "viaversion"
- "viabackwards"
- "viarewind"
- "viaver"
- "protocollib"
- "packetevents"
- "protocolsupport"
- "coreprotect"
- "co"
- "placeholderapi"
- "papi"
- "geysermc"
- "geyser"
- "floodgate"
- "litebans"
- "lb"
- "advancedban"
- "ab"
- "authme"
- "tab"
- "tablist"
- "tabtps"
- "plan"
- "vault"
# 除非命名空间被允许,否则隐藏 pluginname:command 形式的命令。
hide-namespaced-commands: true
allowed-namespaces:
- "minecraft"
- "brigadier"
# 可选的仅隐藏根命令。已经在 blocked-command-paths 中的命令已经被
# 隐藏,因此不要在这里重复添加它们。
hidden-root-commands: []
选项说明
bypass-permission
允许玩家绕过 PluginHider 过滤的权限。操作员始终可以绕过过滤;留空此项以禁用额外的基于权限的绕过功能。
blocked-command-message
当使用被阻止的命令时发送的消息。
blocked-command-paths
对未绕过权限的玩家隐藏并阻止的命令或命令路径。
这里的条目会从 Tab 补全、Brigadier 命令建议和命令树中隐藏。如果手动输入也会被阻止。多词路径基于令牌匹配:example test 会阻止 /example test 和 /example test anything,但不会阻止 /example test2。
将此列表用于普通玩家完全不应能够执行的命令。默认列表包含常见的插件/管理根命令,如 luckperms、grimac、vulcan、spark 和 viaversion,因为扫描客户端可能会直接执行这些命令来指纹识别已安装的插件。
hide-namespaced-commands
启用后,除非其命名空间被允许,否则像 pluginname:command 这样的命令将被隐藏。
allowed-namespaces
当启用命名空间命令隐藏时,保持可见的命名空间。默认的允许命名空间是 minecraft 和 brigadier。
hidden-root-commands
从非绕过权限玩家的命令树和根建议中隐藏的无命名空间根命令。这对于插件根命令和别名(如 luckperms、grimac、lp、we、spark 或类似可由扫描器用作插件指纹的命令)非常有用。
此处列出的命令不会被阻止直接执行。如果玩家拥有 /home 的权限,他们仍然可以输入并运行 /home;它只是不会通过根命令补全进行推广。如果要同时拒绝执行,请将命令或命令路径添加到 blocked-command-paths。
默认列表为空,因为插件/管理扫描根命令已经在 blocked-command-paths 中,这会将它们隐藏并阻止。仅在你希望隐藏但仍允许手动执行的命令上使用 hidden-root-commands。
由于某些客户端扫描器会探测 /help a、/help b 及类似前缀以从返回的任何命令中推断插件名称,因此 /help 和 /? 内部的建议对非绕过权限玩家也是隐藏的。
行为示例
| 配置项 | 从 Tab 补全中隐藏? | 阻止手动执行? |
|---|---|---|
hidden-root-commands: ["debug"] |
是 | 否 |
blocked-command-paths: ["debug"] |
是 | 是 |
blocked-command-paths: ["example test"] |
隐藏/阻止 /example test ... |
不阻止 /example test2 |
现有配置
Bukkit/Paper 插件通常在更新后不会重写现有的 plugins/PluginHider/config.yml。如果你的服务器生成了旧版配置,hidden-root-commands 部分可能不会自动出现。
如果完全缺少该键,PluginHider 会使用保守的内置回退列表,以避免显示面向普通玩家的命令。一旦配置文件中存在 hidden-root-commands,就会使用该配置列表,因此你可以显式地移除或添加条目。
权限
| 权限 | 描述 | 默认值 |
|---|---|---|
pluginhider.bypass |
允许玩家绕过 PluginHider 的过滤。 | false |
管理员(Operators)始终会绕过 PluginHider 的过滤。如果配置中的 bypass-permission 为空,则不会检查任何额外的绕过权限。
构建
要求:
- Gradle
- 与目标分支匹配的 JDK
构建当前分支:
gradle build
编译后的 jar 文件将写入以下目录:
build/libs/
开发
切换到你要开发的版本对应的分支:
git switch 1.21.11
然后进行构建:
gradle build
当移植到另一个 Paper 版本时,请更新以下内容:
build.gradle.kts中的versionbuild.gradle.kts中的paper-api依赖项src/main/resources/plugin.yml中的api-version- Java 工具链/发布版本(如果目标服务器需要不同的 Java 版本)
注意事项
PluginHider 减少了玩家常见的探查已安装插件的方式,但它无法保证插件的完全保密性。某些插件仍可能暴露出具有标识性的行为、消息、权限、命令、数据包或其他侧信道信息。
Please Report Issues or Ideas
PluginHider
PluginHider is a Paper plugin that hides plugin-enumeration commands and command suggestions from regular players.
It is meant for servers that do not want players, tab-completion tools, or client-side scanners to easily discover installed plugins through common Bukkit, Paper, or namespaced command surfaces.
Features
- Blocks direct use of common plugin-listing commands such as
/plugins,/pl,/version,/ver,/about, and/icanhasbukkit. - Filters command suggestions and tab completions for blocked commands.
- Prunes Paper/Brigadier command trees before they are sent to players.
- Hides namespaced commands by default, while keeping trusted namespaces such as
minecraftandbrigadier. - Hides configured root command aliases that client scanners commonly use to infer plugins.
- Supports a bypass permission for staff or trusted users.
- Uses a simple YAML config.
Supported Versions
This repository keeps separate branches for each supported server/API version:
| Branch | Paper API |
|---|---|
1.21.1 |
1.21.1-R0.1-SNAPSHOT |
1.21.5 |
1.21.5-R0.1-SNAPSHOT |
1.21.8 |
1.21.8-R0.1-SNAPSHOT |
1.21.11 |
1.21.11-R0.1-SNAPSHOT |
version/26.1.2 |
26.1.2.build.69-stable |
Use the branch that matches your server version.
Installation
- Download or build the jar for your server version.
- Place the jar in your server's
plugins/folder. - Start or restart the server.
- Edit
plugins/PluginHider/config.ymlif needed. - Run a full restart after changing command-filtering behavior.
Configuration
Default config:
bypass-permission: ""
blocked-command-message: "&cUnknown command."
# Hidden from completions/suggestions and blocked when manually typed.
# Includes plugin/admin roots that scanner clients may execute directly.
# Keep normal player-facing commands like /home, /warp, /msg, /rtp, and /spawn
# out of this list so players keep command QoL by default.
# remove commands that you want to allow normal users to run
blocked-command-paths:
- "plugins"
- "pl"
- "version"
- "ver"
- "about"
- "icanhasbukkit"
- "paper plugins"
- "paper version"
- "paper ver"
- "luckperms"
- "lp"
- "worldedit"
- "we"
- "worldguard"
- "rg"
- "grimac"
- "grim"
- "vulcan"
- "matrix"
- "karhu"
- "verus"
- "nocheatplus"
- "ncp"
- "spark"
- "viaversion"
- "viabackwards"
- "viarewind"
- "viaver"
- "protocollib"
- "packetevents"
- "protocolsupport"
- "coreprotect"
- "co"
- "placeholderapi"
- "papi"
- "geysermc"
- "geyser"
- "floodgate"
- "litebans"
- "lb"
- "advancedban"
- "ab"
- "authme"
- "tab"
- "tablist"
- "tabtps"
- "plan"
- "vault"
# Hide pluginname:command unless the namespace is allowed.
hide-namespaced-commands: true
allowed-namespaces:
- "minecraft"
- "brigadier"
# Optional hide-only roots. Commands already in blocked-command-paths are already
# hidden, so do not duplicate them here.
hidden-root-commands: []
Options
bypass-permission
Permission that lets a player bypass PluginHider filtering. Operators always bypass filtering; leave this blank to disable additional permission-based bypasses.
blocked-command-message
Message sent when a blocked command is used.
blocked-command-paths
Commands or command paths to hide and block for non-bypassed players.
Entries here are hidden from tab completion, Brigadier command suggestions, and command trees. They are also blocked when manually typed. Multi-word paths are token-based: example test blocks /example test and /example test anything, but it does not block /example test2.
Use this list for commands that regular players should not be able to execute at all. The default list includes common plugin/admin roots such as luckperms, grimac, vulcan, spark, and viaversion because scanner clients may execute those commands directly to fingerprint installed plugins.
hide-namespaced-commands
When enabled, commands like pluginname:command are hidden unless their namespace is allowed.
allowed-namespaces
Namespaces that stay visible when namespaced command hiding is enabled. The default allowed namespaces are minecraft and brigadier.
hidden-root-commands
Unnamespaced root commands to hide from command trees and root suggestions for non-bypassed players. This is useful for plugin roots and aliases such as luckperms, grimac, lp, we, spark, or similar commands that scanners can use as plugin fingerprints.
Commands listed here are not blocked from direct execution. If a player has permission for /home, they can still type and run /home; it just will not be advertised through root command completions. To deny execution too, add the command or command path to blocked-command-paths.
The default list is empty because the plugin/admin scanner roots are already in blocked-command-paths, which hides and blocks them. Use hidden-root-commands only for commands you want to hide while still allowing manual execution.
Suggestions inside /help and /? are hidden from non-bypassed players because some client scanners probe /help a, /help b, and similar prefixes to infer plugin names from any returned command.
Behavior Examples
| Config entry | Hidden from tab complete? | Blocks manual execution? |
|---|---|---|
hidden-root-commands: ["debug"] |
yes | no |
blocked-command-paths: ["debug"] |
yes | yes |
blocked-command-paths: ["example test"] |
hides/blocks /example test ... |
does not block /example test2 |
Existing Configs
Bukkit/Paper plugins usually do not rewrite an existing plugins/PluginHider/config.yml after an update. If your server generated an older config, the hidden-root-commands section may not appear automatically.
If the key is missing entirely, PluginHider uses a conservative built-in fallback list that avoids normal player-facing commands. Once hidden-root-commands exists in your config, that config list is used instead, so you can remove or add entries explicitly.
Permissions
| Permission | Description | Default |
|---|---|---|
pluginhider.bypass |
Allows a player to bypass PluginHider filtering. | false |
Operators always bypass PluginHider filtering. If bypass-permission is blank in the config, no extra bypass permission is checked.
Building
Requirements:
- Gradle
- A JDK matching the target branch
Build the current branch:
gradle build
The compiled jar will be written to:
build/libs/
Development
Switch to the branch for the version you want to work on:
git switch 1.21.11
Then build:
gradle build
When porting to another Paper version, update:
versioninbuild.gradle.kts- the
paper-apidependency inbuild.gradle.kts api-versioninsrc/main/resources/plugin.yml- Java toolchain/release if the target server requires a different Java version
Notes
PluginHider reduces common ways players can inspect installed plugins, but it cannot guarantee complete plugin secrecy. Some plugins may still expose identifying behavior, messages, permissions, commands, packets, or other side channels.
下载 Plugin Hider for cheats
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Plugin Hider for cheats
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Plugin Hider for cheats
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Plugin Hider for cheats
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Plugin Hider for cheats
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Plugin Hider for cheats
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Plugin Hider for cheats
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Plugin Hider for cheats
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Plugin Hider for cheats
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Plugin Hider for cheats
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
暂无更新日志
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
ExyliaPlugins 的库。
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
一个在游戏内运行的 Minecraft 地图编辑器! 支持选区、蓝图、复制粘贴、笔刷和脚本。 可在创造模式中使用,也可在生存模式中临时使用。
插件
创建用户友好的菜单以前往不同的世界
插件
专为 Velocity 打造的自制聊天插件,功能丰富——支持跨服群组/全局/私聊消息,并集成 LibertyBans 的禁言功能。
插件
一个高度兼容、功能完善且稳定的 TPA 模组
评论 0
登录后参与评分
还没有评论,来抢沙发吧