NameGuard

NameGuard

Russian README

A plugin for blocking nicknames and adding additional checks for privileged accounts.

• Supports Paper and BungeeCord
• Convenient declarative configuration
• Checks by IP, subnet, or virtual host
• Nickname blocking by exact match or regex pattern
• Reload with a single command: /nameguard reload

Whitelist

All access rules are described declaratively in the access-groups.yml file.

# Group name. Can be anything and will be shown in logs if logging is enabled
group:
  
  # If disabled, the group will be ignored
  enabled: false

  # Enable logging for failed join attempts
  log-to-console: true

  # MiniMessage supported
  kick-message: "<red>Access denied"
  
  # Access rules
  access-rules:
    - "vhost:access.myserver.com"
    - "ip:192.168.1.120"
    - "subnet:127.0.0.1/24"

  match:
    # If enabled, any player will be checked against this group
    everything: false

    # If the nickname is in this list, the player will be checked against this group
    nicknames:
      - owner
      - helper

    # If the nickname matches at least one regex pattern from the list,
    # the player will be checked against this group
    patterns:
      - "b[a4]d_?w[o0]rd"

If a player is checked by a group and does not pass any access rule, the join attempt is denied with the kick-message, and a corresponding message is logged to the console if log-to-console is enabled.

If a player is checked by a group and passes at least one access rule, the player is allowed to join, and all further checks are skipped.

The order in which groups are checked is determined by their order in the file.