Welcome to the new docs site for Nucleus v2! Still on Nucleus v1? Visit the old site here.

Name Ban Module

Introduction

The Name Ban module allows server owners to prevent players with certain names from joining their server, but is not tied to an account, allowing the player to change their name in order to gain access. Usually, this would be used to prevent someone with an inappropriate name from joining.

Banning a name

To ban a name, simply run the command

/nameban <name> [reason]

A player with the supplied Minecraft IGN (case insensitive) will no longer be allowed to join.

The following are incompatibilities that may occur with this module, along with how to resolve the problem. For the full mod/plugin incompatibility list, see the compatibility page.

No plugin incompatibilities have been reported.

/nameban
Module: nameban
Bans a specific IGN (rather than specific player) from joining the server.

Using /nameban, instead of /ban, prevents any player with a specific username from joining the server - allowing them to join if they subsequently change their name. This does not affect server level nicknames, this is their Mojang registered nicknames.

A reason can be given for banning a specific name. This is intended to prevent the use of offensive usernames on servers.

Aliases: /nameban

Usage: /nameban <name> [<reason…>]

Default Role: admin

Basic Command Permission: nucleus.nameban.base

Permissions

  • nucleus.nameban.base - Default Role: admin
    Allows the user to run the command /nameban
/nameunban
Module: nameban
Allows a specific IGN (rather than specific player) to join the server again.

Aliases: /nameunban, /namepardon

Usage: /nameunban <name>

Default Role: admin

Basic Command Permission: nucleus.nameban.unban.base

Permissions

  • nucleus.nameban.unban.base - Default Role: admin
    Allows the user to run the command /nameunban
Permission Suggested Role Description
nucleus.nameban.base admin Allows the user to run the command /nameban
nucleus.nameban.unban.base admin Allows the user to run the command /nameunban
The following configuration is the default for this module:
                            default-reason="Your Minecraft username is not appropriate for this server. Please change it before attempting to access this server."

                        
Search

Downloading search database, this won't take long...