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.


    # 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: []
        enabled: true
        unban-on-approve: true
        resolve-reason-enabled: false
        fixed-reason: false
            - ''




/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


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:



  • HOUR

  • DAY

  • WEEK


  • 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.


/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"


Inside the message the following placeholders can be used




The banned player's username


The staff members username


The ban reason


Human readable duration. Only available with tempbans

Last updated