The Mute module allows for server staff to punish players who break chat rules by preventing them from speaking in global chat or sending messages. There is also a function to enact a “global” mute, and whitelist, or “voice” players
The mute module can jail players temporarily or permanently. Global mutes will only last over the lifetime of a server process, and will be deactivated when the server is restarted.
Use the /checkmute <player> command to see details surrounding a player’s muting.
A player can be muted by running the command
/mute <player> [time] [reason]
The player argument is required.
The reason argument is optional, but if specified, will be displayed to the mute player whenever they try to speak or
send a message.
The time argument is optional, but if specified, is of the Timespan Argument format.
For example: if you want to mute Notch for 3 hours, 45 minutes, the command would be:
/mute Notch 3h45m Muted by example!
If a timed mute is given to a player who is not currently logged on, their mute will start when they next log in. By default,
time towards a mute will include both time where the player is online AND offline, unless mute-time-counts-online-only is
set to true in main.conf.
The command /checkmute [player] allows you to check a player’s mute status. To see everyone currently muted on the server
in question, run /checkmuted.
When players are mute, Nucleus adds a permission context to the player permission set, so that you can change a player’s permissions when they are muted. This is useful to be able to prevent the player from performing additional tasks, though Nucleus automatically blocks most chat commands and actions.
Nucleus applies one context:
nucleus_muted will simply have the value “true” if the player is muted.Refer to your permission plugin documentation on how to set permissions on contexts.
There are times where you may need to mute the server. The command /globalmute [toggle] allows you to do this. The command
can either be run as a toggle, flipping between on or off, or specified with either true or false.
When the server is muted, only those with the nucleus.globalmute.voice.auto permission are allowed to speak. To grant
this permission to other players temporarily, grant them “voice” using the /voice <player> command. This status is
automatically removed when the global mute ends.
The mute module has several entries in main.conf:
block-commands specifies the commands that players cannot run whilst in muted. By default, the commands are primarily
chat and message based commands.maximum-mute-length specifies the maximum time, in seconds, that a player can be muted for, unless the player issuing the
mute has the nucleus.mute.exempt.length permission. If this is set to -1, then no limit is applied and all players with
the mute command can mute players permanently.see-muted-chat, if set to true, will allow those with the nucleus.mute.seemutedchat permission to see players who
try to chat, but are currently muted.muted-chat-tag is the tag that is placed at the start of any cancelled message that those with the nucleus.mute.seemutedchat
can see.mute-time-counts-online-only, if true, will only count time a player spends online as time served towards the mute.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.
Aliases:
checkmute
Root command aliases:
/ncheckmute
Usage: /checkmute <user/UUID>|<user/UUID>
Default Role: MOD
Basic Command Permission: nucleus.checkmute.base
Permissions
nucleus.checkmute.base - Default Role: MOD
Aliases:
checkmuted
Root command aliases:
/ncheckmuted
Usage: /checkmuted
Default Role: ADMIN
Basic Command Permission: nucleus.checkmuted.base
Permissions
nucleus.checkmuted.base - Default Role: ADMIN
Global muting is useful for times where you want to have an announcement or you need to defuse a server wide solution. Global mutes do not change a user's mute status, and do not persist across server restarts. All players with voice (apart from those with permission) are de-voiced when the global mute is turned on.
If you wish to allow someone to talk during a global mute period, you can grant them "/voice".
Aliases:
globalmute
Root command aliases:
/nglobalmute
Usage: /globalmute [<true|false>]
Default Role: ADMIN
Basic Command Permission: nucleus.globalmute.base
Permissions
nucleus.globalmute.base - Default Role: ADMIN
Aliases:
mute unmute
Root command aliases:
/nmute
Usage: /mute <user> [<duration>] [<reason…>]
Default Role: MOD
Basic Command Permission: nucleus.mute.base
Permissions
nucleus.mute.exempt.target - Default Role: MOD nucleus.mute.notify - Default Role: MOD nucleus.mute.base - Default Role: MOD nucleus.mute.seemutedchat - Default Role: ADMIN nucleus.mute.exempt.length - Default Role: ADMIN nucleus.mute.unmute - Default Role: MOD
This command is an equivalent to the following command(s) in Essentials:
/mute, /silence
If a server is globally muted, a player can be given the right to speak using the "/voice" command. This will allow messages being sent by the user too. This status may also be revoked if granted by running the "/voice" command again.
Aliases:
voice
Root command aliases:
/nvoice
Usage: /voice <player> [<true|false>]
Default Role: ADMIN
Basic Command Permission: nucleus.globalmute.voice.base
Permissions
nucleus.globalmute.voice.auto - Default Role: ADMIN nucleus.globalmute.voice.notify - Default Role: ADMIN nucleus.globalmute.voice.base - Default Role: ADMIN | Permission | Suggested Role | Description |
|---|---|---|
| nucleus.checkmute.base | MOD | Allows the user to run the command /checkmute |
| nucleus.checkmuted.base | ADMIN | Allows the user to run the command /checkmuted |
| nucleus.globalmute.base | ADMIN | Allows the user to run the command /globalmute |
| nucleus.globalmute.voice.auto | ADMIN | Automatically grants the user voice if a global mute is in effect. |
| nucleus.globalmute.voice.base | ADMIN | Allows the user to run the command /voice |
| nucleus.globalmute.voice.notify | ADMIN | If granted, this user is told when a player's voice status is changed. |
| nucleus.mute.base | MOD | Allows the user to run the command /mute |
| nucleus.mute.exempt.length | ADMIN | Allows the user to bypass the maximum mute length. |
| nucleus.mute.exempt.target | MOD | Exempts the user from being a target of the /mute command. |
| nucleus.mute.notify | MOD | Notifies the user about mutes when they occur. |
| nucleus.mute.seemutedchat | ADMIN | If true and enabled in the config, players with this permission will see chat from muted players. |
| nucleus.mute.unmute | MOD | If set in config, this permission is required to unmute players. |
# Commands to block when muted. This is in addition to chat and /m already being blocked.
blocked-commands=[
"minecraft:me",
say
]
# The maximum length a mute may last for (in seconds) unless the user handing the mute has a bypass permission. Set to -1 for no maximum.
maximum-mute-length=604800
# If true, mute time will only tick down when players are online.
mute-time-counts-online-only=false
# The tag to prepend any cancelled/muted messages with.
muted-chat-tag="&c[cancelled] "
# If true, then the permission "nucleus.mute.unmute" is required to unmute players.
require-separate-unmute-permission=false
# If true, those with the "nucleus.mute.seemutedchat" permission will see chat from those who are muted.
see-muted-chat=false