Staff++
Search…
Banning
Staff++ overrides the default ban command with its own ban command. Next to the permanent ban command it also adds the tempban command. With every ban a reason must be given why this player is getting banned.

Configuration

1
ban-module:
2
# Whether or not the plugin will use Staff++ "/ban" features.
3
enabled: true
Copied!

Permissions

Permission
Description
staff.staffplus.ban
Permission for banning a player
staff.staffplus.tempban
Permission for temporarily banning a player
staff.staffplus.extendban
Permission for extending the duration of a temporary ban
staff.staffplus.reduceban
Permission for reducing the duration of a temporary ban.
staff.staffplus.unban
Permission for unbanning a player
staff.staffplus.ban-bypass
Permission for bypassing being banned
staff.staffplus.ban-notifications
Permission to receive notifications when someone is banned/unbanned
staff.staffplus.ban-silent
Permission to ban/unban players silently (no notification sent out)
Restricting tempban duration
The tempban command can also be configured to restrict the duration a staff member can use for a ban. Give the staff member and extra permission with a duration limit as suffix. Example: staff.staffplus.tempban.limit.2w , with this permission a staff member can only issue a ban for a maximum duration of 2 weeks.
A staff member must have both permissions to use the command. So for a 2 week duration limit the permissions needed are:
    staff.staffplus.tempban
    staff.staffplus.tempban.limit.2w
Possible time values:
    s = second
    m = minute
    h = hour
    d = day
    w = week
    M = month
    y = year
Time values cannot be combined. For example this is invalid: ".1m30s" instead type ".90s"

Commands

Command
Description
/ban [player] [reason]
Permanently ban a player
/tempban [player] [amount] [unit] [reason]
Temporary ban a player the given duration
/ban-extend [player] [amount] [unit]
Extend the ban duration of a temporarily banned player
/ban-reduce [player] [amount] [unit]
Reduce the ban duration of a temporarily banned player
/unban [player] [reason]
Unban a player from the server
/manage-bans
Opens the bans overview GUI

Integration

The discord integration plugin supports notifying to a discord channel whenever a player gets banned/unbanned.

Examples

Permanent banning

/ban [player] [reason]
1
/ban playername He was bothering me
Copied!

Temporary banning

/tempban [player] [amount] [unit] [reason]
1
/tempban playername 15 MINUTE He was bothering me
Copied!
The duration of the tempban is specified by [amount] [unit]
Amount must be a positive number > 0 and unit must be one of the following:
    SECOND
    MINUTE
    HOUR
    DAY
    WEEK
    MONTH
    YEAR

Extending/reducing ban duration

A ban duration can be extended or reduced by the following commands:
/ban-reduce [player] [amount] [unit] /ban-extend [player] [amount] [unit] This command can also be limited in duration the same way a tempban is limited. Giving the player the following 2 permissions will limit the extension duration for example:
    staff.staffplus.extendban
    staff.staffplus.extendban.limit.2w
When extending a ban, the staff member cannot extend the ban further than his tempban limit will allow. This is to prevent a staff member spamming an extend command. This means that if a player is banned for 2 months. His ban cannot be extended by a staff member whose tempban limit is 3 weeks for example.

Unbanning

/unban [player] [reason]
1
/unban playername We are friends now
Copied!

Silent banning

The -silent can be used to ban/tempban/unban players without sending out a notification to anyone.
1
/ban playername -silent He was bothering me
Copied!

Showing ban reason on ban/rejoin

If you want banned players can see the reason why they are banned you can edit the kick message in the lang files:
1
ban-tempbanned-kick: "[Banned] You have been temporarily banned from this server. Ban ends in: %duration%"
2
ban-permabanned-kick: "[Banned] You have been permanently banned from this server"
Copied!

placeholders

Inside the message the following placeholders can be used
placeholder
description
%target%
The banned player's username
%issuer%
The staff members username
%reason%
The ban reason
%duration%
Human readable duration. Only available with tempbans

Another plugin is overriding the /ban, /tempban, /unban

It is possible that another plugin like 'essentialsx' might get priority over the ban, tempban and unban command. To prevent this we suggest the same solution as is proposed by EssentialsX.
Configure your server aliases in such a way that the ban commands from Staff++ will always be used. This can be done by editing the commands.yml file and specifying your aliases there.
To enable Staff++ ban commands this would be done in this way:
1
aliases:
2
ban:
3
- "staffplus:ban $1-"
4
tempban:
5
- "staffplus:tempban $1-"
6
unban:
7
- "staffplus:unban $1-"
Copied!
More info on the bukkit wiki

GUI

Banned players can be listed and unbanned through the gui hub.
// TODO add screenshots
Last modified 2mo ago