Module: Ban - Module ID: ban

Introduction

The Ban module allows for server staff to impose and pardon bans on players. The ban module can ban players temporarily or permanently. Any bans that are placed are put into the Minecraft ban system, so will remain if the module is disabled or Nucleus is removed.

Banning Temporarily

The syntax for the /tempban is

/tempban <player> <time> [reason]

The time parameter is of the Timespan Argument format. For example: if you want to ban Notch for 3 hours, 45 minutes, the command would be:

/tempban Notch 3h45m Banned by Nucleus

A Note on Reasons

All reasons support Minecraft Colour codes, prefixed by an &. So, for example, to make a message show up in light red, prefix it with a &c.

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.

/ban

Module: ban

Bans a player.

Aliases: ban

Root command aliases: /nban

Usage: /ban <user uuid>|<user>|<name> [<reason…>]

Default Role: MOD

Basic Command Permission: nucleus.ban.base

Permissions

nucleus.ban.notify - Default Role: MOD
Notifies the user about bans when they occur.
nucleus.ban.base - Default Role: MOD
Allows the user to run the command /ban
nucleus.ban.offline - Default Role: MOD
Allows the user to ban offline users.
nucleus.ban.exempt.target - Default Role: MOD
Exempts the user from being a target of the /tempban command.

This command is an equivalent to the following command(s) in Essentials: /ban

/checkban

Module: ban

Checks the ban status for a player.

Aliases: checkban

Root command aliases: /ncheckban

Usage: /checkban <user uuid>|<user>

Default Role: MOD

Basic Command Permission: nucleus.checkban.base

Permissions

nucleus.checkban.base - Default Role: MOD
Allows the user to run the command /checkban

/tempban

Module: ban

Temporarily bans a player.

Aliases: tempban

Root command aliases: /ntempban

Usage: /tempban <user> <duration> [<reason…>]

Default Role: MOD

Basic Command Permission: nucleus.tempban.base

Permissions

nucleus.tempban.offline - Default Role: MOD
Allows the user to temp ban offline users.
nucleus.tempban.base - Default Role: MOD
Allows the user to run the command /tempban
nucleus.tempban.exempt.target - Default Role: MOD
Exempts the user from being a target of the /tempban command.
nucleus.tempban.exempt.length - Default Role: MOD
Allows the user to bypass the maximum tempban length.

This command is an equivalent to the following command(s) in Essentials: /tempban

/unban

Module: ban

Unbans a player.

Aliases: unban pardon

Root command aliases: /nunban

Usage: /unban <user uuid>|<user>

Default Role: MOD

Basic Command Permission: nucleus.unban.base

Permissions

nucleus.unban.base - Default Role: MOD
Allows the user to run the command /unban

This command is an equivalent to the following command(s) in Essentials: /unban, /pardon

Permission	Suggested Role	Description
nucleus.ban.base	MOD	Allows the user to run the command /ban
nucleus.ban.exempt.target	MOD	Exempts the user from being a target of the /tempban command.
nucleus.ban.notify	MOD	Notifies the user about bans when they occur.
nucleus.ban.offline	MOD	Allows the user to ban offline users.
nucleus.checkban.base	MOD	Allows the user to run the command /checkban
nucleus.tempban.base	MOD	Allows the user to run the command /tempban
nucleus.tempban.exempt.length	MOD	Allows the user to bypass the maximum tempban length.
nucleus.tempban.exempt.target	MOD	Exempts the user from being a target of the /tempban command.
nucleus.tempban.offline	MOD	Allows the user to temp ban offline users.
nucleus.unban.base	MOD	Allows the user to run the command /unban

The following configuration is the default for this module:

# The maximum length a temporary ban may last for (in seconds) unless the user handing the mute has a bypass permission. Set to -1 for no maximum.
maximum-tempban-length=604800