# PluginGuard<\/p>\n
#### Protect your server by hiding installed plugins from users<\/p>\n
For Minecraft Paper 1.21.1 – 1.21.10<\/p>\n
<\/p>\n
> Donate: https:\/\/ko-fi.com\/darkstarworks<\/p>\n
<\/p>\n
### PluginGuard features:
\n– **Hide Mode**
\n – (choose from several types of “Access Denied” messages)
\n– **Plugin Spoofing**
\n – (returns a configurable list of fake plugins)
\n– **Optional Bypass permission**
\n– **High-level bypass protection**
\n– **Command Redirection**
\n– **Advanced Protection**
\n– **Custom Protection**
\n– **Server MetaData Protection**
\n– **Optional Server Brand Spoofing**
\n – (returns e.g. “Vanilla” instead of “Paper”. configurable)
\n– **Optional Agressive Mode**
\n – (blocks all. read config below please)<\/p>\n
<\/p>\n
Options and how to configure `config.yml`:<\/p>\n
<\/p>\n
#### ===== BASIC SETTINGS =====<\/p>\n
Hide Mode Options:
\n– `”unknown-command”`: Shows “Unknown command” message (most realistic)
\n– `”empty”`: Shows “Plugins (0):”
\n– `”fake-list”`: Shows configured fake plugins below
\n– `”permission-denied”`: Shows permission error message
\n“`yaml
\nhide-mode: “unknown-command”
\n“`
\n<\/p>\n
Fake plugins to display when `hide-mode: “fake-list”`
\n(Use vanilla-sounding names to appear legitimate)
\n“`yaml
\nfake-plugins:
\n – “ServerCore”
\n – “WorldManager”
\n – “CoreProtect”
\n – “EveryoneChat”
\n“`
\n<\/p>\n
Permission node to bypass all plugin hiding (staff\/admin only)
\n“`yaml
\nbypass-permission: “pluginguard.bypass”
\n“`
\n<\/p>\n
#### ===== COMMAND PROTECTION =====<\/p>\n
Commands to intercept and hide (supports bukkit: and minecraft: prefixes)
\n“`yaml
\nprotected-commands:
\n – “pl”
\n – “plugins”
\n – “ver”
\n – “version”
\n – “?”
\n – “help”
\n – “about”
\n – “icanhasbukkit”
\n“`
\n<\/p>\n
Block all bukkit: and minecraft: prefixed commands (prevents probing)
\n“`yaml
\nblock-bukkit-commands: true
\n“`
\n<\/p>\n
Redirect `bukkit:` commands to show spoofed list instead of blocking
\nOnly works if `block-bukkit-commands: true`
\n“`yaml
\nredirect-bukkit-commands: false
\n“`
\n<\/p>\n
#### ===== TAB COMPLETION PROTECTION =====<\/p>\n
Remove plugin commands from tab-completion suggestions
\nPrevents discovery through `\/[tab]` probing
\n“`yaml
\nhide-tab-completion: true
\n“`
\n<\/p>\n
#### ===== ADVANCED PROTECTION =====<\/p>\n
Block unknown commands with permission errors
\nReturns “Unknown command” even if the player lacks permission
\nPrevents probing for plugin existence via permission responses
\n“`yaml
\nblock-unknown-commands: true
\n“`
\n<\/p>\n
Common plugin commands to block (case-insensitive)
\nAdd popular plugin commands that users might probe for
\n“`yaml
\ncommon-plugin-commands:
\n – “essentials”
\n – “ess”
\n – “worldedit”
\n – “we”
\n – “luckperms”
\n – “lp”
\n – “coreprotect”
\n – “co”
\n – “vault”
\n – “multiverse”
\n – “mv”
\n – “citizens”
\n – “npc”
\n – “clearlag”
\n – “dynmap”
\n – “griefprevention”
\n – “gp”
\n – “holographicdisplays”
\n – “hd”
\n“`
\n<\/p>\n
Block common plugin commands from the list above
\n“`yaml
\nblock-common-plugin-commands: true
\n“`
\n<\/p>\n
#### ===== SERVER METADATA PROTECTION =====<\/p>\n
Hide server software in query responses and MOTD ping
\nPrevents protocol-level discovery
\n“`yaml
\nhide-server-brand: true
\n“`
\n<\/p>\n
Fake server brand to display (e.g., “vanilla”, “1.21.1”, “custom”)
\n“`yaml
\nfake-server-brand: “vanilla”
\n“`
\n<\/p>\n
#### ===== AGGRESSIVE MODE =====<\/p>\n
**AGGRESSIVE MODE: Block ALL plugin commands for players without explicit permission**<\/p>\n
**WARNING**: This will hide even beneficial plugin commands for regular players.<\/p>\n
Use only<\/ins> if you want maximum security and manually grant command permissions<\/p>\n Requires players to have ` Protect your server by hiding installed plugins from users (and more)<\/p>\n","protected":false},"featured_media":123048,"template":"","meta":{"_minecraft_slug":"plugin-guard","_minecraft_project_id":"PNPJsQNG","_minecraft_author":"darkstarworks","_minecraft_license":"MIT","_minecraft_downloads":155,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"plugin-guard.zip","_minecraft_size_bytes":9444,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T13:23:31.896767Z","_minecraft_date_created":"2025-11-02T06:22:26.305253Z","_minecraft_date_modified":"2025-11-01T01:27:02.720244Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/plugin-guard","_minecraft_icon_attachment_id":123048,"_minecraft_imported_at":"2026-06-07T05:40:28+00:00","_minecraft_import_hash":"f48a13cca44e48f3b8c854e31e80d0bf","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,127,123,92],"mod_loader":[132],"minecraft_version":[37,40,73,74,38,78,79,80,81,82],"class_list":["post-123047","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-paper","mod_category-technology","mod_category-utility","mod_loader-paper","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n“`yaml
\naggressive-mode: false
\n“`<\/p>\n","protected":false},"excerpt":{"rendered":"