Staff++
latest
Search
⌃K

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

ban-module:
# Whether or not the plugin will use "/ban-player" features.
enabled: true
permban-template: ''
tempban-template: ''
# List of staff ranks. Ordered from low to highest rank.
# when configured, staff members can only ban player with a lower rank.
ranks: []
appeals:
enabled: true
unban-on-approve: true
resolve-reason-enabled: false
fixed-reason: false
reasons:
- ''

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

Permanent banning

/ban [player] [reason]
/ban playername He was bothering me

Temporary banning

/tempban [player] [amount] [unit] [reason]
/tempban playername 15 MINUTE He was bothering me
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

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.bans.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.bans.tempban
  • staff.bans.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"

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.bans.extendban
  • staff.bans.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]
/unban playername We are friends now

Silent banning

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

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:
ban-tempbanned-kick: "[Banned] You have been temporarily banned from this server. Ban ends in: %duration%"
ban-permabanned-kick: "[Banned] You have been permanently banned from this server"

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