AdvancedBan Plugin

Links

Links

Introduction

Plugin home page: https://www.spigotmc.org/resources/advancedban.8695/

This plugin is installed on the Waterfall UniversalCraft server but the commands that it provides automatically then become available on all of the associated Paper servers.

Although the EssentialsX plugin provides mute/ban functionality, because the UniversalCraft playing environment consists of multiple Paper servers that are all accessed through a central Waterfall server, a suitable Bungeecord-compatible plugin was required so that bans/kicks/reprimands are valid and apply across all of the UniversalCraft servers.

Commands

Membership of the “moderator” group is required to issue temporary moderation commands. Membership of the “owner” group is required to issue permanent moderation commands and undo moderation commands.

For temporary commands that require a <Duration> value, this parameter should be specified in the format Nmo for months, Nd for days, Nh for hours, Nm for minutes and Ns for seconds. e.g. “7d” to issue a temporary seven day mute/warning/ban.

/advancedban help

Displays help information text.

/advancedban reload

Reload the plugin configuration files.

/ban <PlayerName> <Reason>

Permanently bans a player for the specified reason.

/banlist [PageNumber]

See all currently active notes, warnings, mutes and bans.

/change-reason <ID> <NewReason>

Change the reason for the historical punishment with the specified ID.

/change-reason ban <PlayerName> <NewReason>

Change the reason for the specified player’s most recent ban.

/change-reason mute <PlayerName> <NewReason>

Change the reason for the specified player’s most recent mute.

/check <PlayerName>

Displays the current moderation status of the specified player.

/kick <PlayerName> <Reason>

Remove a player from the UniversalCraft gaming world. This command serves little useful purpose and the /tempban command should be used by moderators instead.

/history <PlayerName>

Display an audit trail of all moderation actions about this specified player.

/ipban <Player|IPAddress> <Reason>

Permanently bans the specified IP address or the last known IP address of the specified player.

/mute <PlayerName> <Reason>

Permanently mutes a player for the specified reason.

/note <PlayerName> <Note Text>

Document an incident involving a player by adding a note to their file. For example, if player1 reports that player2 has griefed their building, the incident should be recorded as both a note issued to player1 and a warning issued to player2.

/notes

See the list of previously recorded moderator notes relating to your character.

/notes <PlayerName>

See a list of previously recorded moderator notes relating to the specified player.

/systemprefs

Displays system information.

/tempban <PlayerName> <Duration> <Reason>

Issue a temporary ban to the specified player.

/tempipban <Player|IPAddress> <Duration> <Reason>

Temporarily ban the specified IP address or the last known IP address of the specified player.

/tempmute <PlayerName> <Duration> <Reason>

Temporarily mutes a player for the specified reason.

/tempwarn <PlayerName> <Duration> <Warning Text>

Issues a temporary warning that expires after the specified duration. This command serves little useful purpose and the /warn command should be used by moderators instead as the warning history of a player should always be available for review.

/unban <PlayerName>

Unbans the specified player allowing them to reconnect to the UniversalCraft playing environment again. This command can only be done by server owners.

/unmute <PlayerName>

Unmute the specified player allowing them to talk in the various chat channels again.

/unnote <ID>

Removes a previously recorded note from a player’s permanent record.Specify the numeric identifier of the item to be removed from the player’s notes. This command can only be done in exceptional circumstances by server owners.

/unpunish <ID>

Remove a previously recorded warning/kick/ban from a player’s permanent record. Specify the numeric identifier of the item to be removed from the player’s notes. This command can only be done in exceptional circumstances by server owners.

/unwarn <ID>

Removes a previously recorded warning from a player’s permanent record. Specify the numeric identifier of the item to be removed from the player’s notes. This command can only be done in exceptional circumstances by server operators.

/unwarn clear <PlayerName>

Remove all warnings and notes for the specified player. This command can only be done in exceptional circumstances by server owners.

/warn <PlayerName> <Reason>

Send a warning message to the specified player. The warning message is also added to their notes.

/warns

See a history of all warnings that your character has received. This command is available to all players.

/warns <PlayerName>

Show the full history of warnings that the specified player has previously received.

Configuration

config.yml

Enable MySQL storage:

UseMySQL: true

Appropriate connection parameters have been specified.

Remove plugin prefix from every message:

Disable Prefix: true

Set maximum duration of all temporary moderation commands to one week:

TempPerms:
  1: 604800