# NameGuard<\/p>\n
**Russian README**<\/p>\n
A plugin for blocking nicknames and adding additional checks for privileged accounts.<\/p>\n
– Supports Paper and BungeeCord
\n– Convenient declarative configuration
\n– Checks by IP, subnet, or virtual host
\n– Nickname blocking by exact match or regex pattern
\n– Reload with a single command: `\/nameguard reload`<\/p>\n
## Whitelist<\/p>\n
All access rules are described declaratively in the `access-groups.yml` file.<\/p>\n
“`yaml
\n# Group name. Can be anything and will be shown in logs if logging is enabled
\ngroup:<\/p>\n
# If disabled, the group will be ignored
\n enabled: false<\/p>\n
# Enable logging for failed join attempts
\n log-to-console: true<\/p>\n
# MiniMessage supported # Access rules match: # If the nickname is in this list, the player will be checked against this group # If the nickname matches at least one regex pattern from the list, If a player is checked by a group and does not pass any access rule, If a player is checked by a group and passes at least one access rule, The order in which groups are checked is determined by their order in the file.<\/p>\n","protected":false},"excerpt":{"rendered":" Allows to block nicknames using literal matching and regex patterns + adds additional checks for admins<\/p>\n","protected":false},"featured_media":108606,"template":"","meta":{"_minecraft_slug":"nameguard","_minecraft_project_id":"zctnrmn8","_minecraft_author":"envizar","_minecraft_license":"MIT","_minecraft_downloads":46,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"nameguard.zip","_minecraft_size_bytes":2918688,"_minecraft_version_count":6,"_minecraft_updated_at":"2026-05-15T21:19:13.363110Z","_minecraft_date_created":"2026-02-07T06:49:41.900834Z","_minecraft_date_modified":"2026-02-21T19:44:41.008411Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/nameguard","_minecraft_icon_attachment_id":108606,"_minecraft_imported_at":"2026-06-06T06:45:42+00:00","_minecraft_import_hash":"5225d3630dbf3ddeed1155311cdfac08","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[894,126,127,128,92,992],"mod_loader":[895,132,133,993],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-108605","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bungeecord","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-utility","mod_category-waterfall","mod_loader-bungeecord","mod_loader-paper","mod_loader-purpur","mod_loader-waterfall","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","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 kick-message: “
\n access-rules:
\n – “vhost:access.myserver.com”
\n – “ip:192.168.1.120”
\n – “subnet:127.0.0.1\/24”<\/p>\n
\n # If enabled, any player will be checked against this group
\n everything: false<\/p>\n
\n nicknames:
\n – owner
\n – helper<\/p>\n
\n # the player will be checked against this group
\n patterns:
\n – “b[a4]d_?w[o0]rd”
\n“`<\/p>\n
\nthe join attempt is denied with the `kick-message`, and a corresponding
\nmessage is logged to the console if `log-to-console` is enabled.<\/p>\n
\nthe player is allowed to join, and all further checks are skipped.<\/p>\n