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.

```yaml

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.