Staff++
Search…
IP Banning
Staff++ added a simple ip banning system to ensure players with certain ip addresses cannot join the server.
NOTE: An IP ban is not player based! Banning an IP will most probably impact more than one player. If you want to block a specific player by username use the normal banning of staff++. If you still want to proceed with banning a player based on his IP, realize you might impact other players as well.
Luckily staff++ will always warn you what players will be impacted when banning unbanning an IP.

Configuration

1
ban-module:
2
# Whether or not the plugin will use "/ban-player" features.
3
enabled: true
4
permban-template: ''
5
tempban-template: ''
6
ipban:
7
enabled: true
8
permban-template: ''
9
tempban-template: ''
Copied!

Permissions

Permission
Description
staff.staffplus.ipban.ban
Permission to use the /ipban command
staff.staffplus.ipban.tempban
Permission to use the /iptempban command
staff.staffplus.ipban.unban
Permission to use the /ipunban command
staff.staffplus.ipban.ban-check
Permission to use the /ipban-check command
staff.staffplus.ipban.ban-view
Permission to use the /ipbans command
staff.staffplus.ipban.ban-silent
Permission to use the -silent option when banning
staff.staffplus.ipban.ban-template-overwrite
Permission to use the -template overwrite option when banning
staff.staffplus.ipban.ban-notifications
Permission to retrieve ban notifications

Commands

Command
Description
/ipban [player/ip-address/cidr]
Add an ip ban based on a player, ip or cidr
/iptempban [player/ip-address/cidr] [amount] [timeunit]
Temporarily add an ip ban based on a player, ip or cidr
/ipunban [player/ip-address/cidr]
Remove a ban based on a player, ip or cidr
/ipban-check [playername]
Check if the given player's ip is banned
/ipbans [-players]
List all active IP-bans or list all banned players

Examples

Permanent banning

/ipban [player/ip-address/cidr]
1
# By playername
2
/ipban player1
3
4
# By specific IP
5
/ipban 20.15.62.15
6
7
# By CIDR
8
/ipban 20.15.62.0/24
Copied!
Ip banning will always ask for a confirmation when executed from in game. An ip ban can impact multiple players. Staff++ will check the last known IP of on- and offline players and list players the will be impacted. Of course there is no 100% certainty other players might not be impacted. But at least this gives an indication.

Temporary banning

/tempban [player/ip-address/cidr] [amount] [unit]
1
# By playername
2
/iptempban player1 15 MINUTE
3
4
# By specific IP
5
/iptempban 20.15.62.15 15 MINUTE
6
7
# By CIDR
8
/iptempban 20.15.62.0/24 15 MINUTE
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

Unbanning

/ipunban [player]
1
# By playername
2
/ipunban player1
3
4
# By specific IP
5
/ipunban 20.15.62.15
6
7
# By CIDR
8
/ipunban 20.15.62.0/24
Copied!

Silent banning

The -silent can be used to ban/tempban/unban ips without sending out a notification to anyone.
1
/ipban playername -silent
Copied!
Last modified 1mo ago