MaxBans
Support Spigot from 1.7.x to 1.12.x
MaxBans is a project I've been writing for my server, MaxGamer. I struggled to find a banning plugin that wasn't a joke, and the good plugins were all designed for Premium servers anyway. Nothing gave us the tools that SHOULD have been out there - Like temp mutes, temp IP bans, duplicate IP lookups, and good autocompletion!
It is thoroughly tested on an Offline-Mode server, so you can bet it's rock solid and feather light!
Databases
- MySQL
- SQLite (Flatfile)
Best Features
Here are the top ten features of MaxBans over other banning plugins:
- Full UUID support
- Ability to view players' previous username(s) - date of change
- Full server lockdown - Prevent anyone from joining with a custom message (Such as bot attacks)
- Offline player name auto completion
- Warnings system
- Duplicate IP detection
- DNSBL lookups to stop proxys!
- Multiline kick messages! No more running off the screen!
- Notifications when a banned player tries to join!
- All times are relative! (Eg. "You're banned for 4 minutes 6 seconds", not "You're banned til 5:43pm CST")
- Customize every colour!
- Block commands like /me when muted!
Commands
- /unban <name, IP or UUID>
- /ban <name, IP or UUID> <reason>
- /ipban <name, IP or UUID> <reason>
- /tempban <name, IP or UUID> <number> <minutes|hours|days|weeks|etc> <reason>
- /tempipban <name, IP or UUID> <number> <minutes|hours|days|weeks|etc> <reason>
- /mute <name or UUID>
- /tempmute <name or UUID> <number> <minutes|hours|days|weeks|etc>
- /kick <name, * for everyone or UUID>
- /checkip <name or UUID>
- /uuid
- /togglechat
- /dupeip <name, IP or UUID>
- /checkban <name, IP or UUID>
- /warn <name or UUID> <reason>
- /clearwarnings <name or UUID> <reason>
- /unwarn <name or UUID> - Removes a players most recent warning
- /unmute <name or UUID>
- /history [name] [number of records] - Displays a history of bans, kicks, mutes & more dealt
- /mbreload - Reloads the plugin
- /mbdebug - Outputs debug information for me if you're having issues!
- /mbwhitelist <name or UUID> - Allows the given user to bypass IP bans (Not regular bans! Eg, use for players with siblings who need to be IP banned)
- /ipreport - Basically, a mass /dupeip, on everyone who is online
- /lockdown [reason]
- /forcespawn - Teleports someone to the spawn (Twice, so /back won't work)
- /mbreload - Reloads maxbans
- /mbimport - Imports vanilla minecraft (And others) bans.
- /mbexport - Export bans to vanilla, MySQL or SQLite databases. (Allows swapping SQLite <-> MySQL), and others ban plugins.
- /rangeban <ip1-ip2> [reason] - Bans the IP range from ip1 to ip2 for the supplied reason.
- /temprangeban <ip1-ip2> <time> <hours/min/sec> [reason] - Temporary variant of above
- /unrangeban <ip> - Removes any RangeBan which overlaps with the given IP. Eg, if 127.0.0.1-127.0.0.5 is banned, unbanning 127.0.0.3 will lift the whole ban on 127.0.0.1-127.0.0.5.
Almost any command may have -s added in it to prevent announcing it, for example:
/tempban NewGuy101 -s 1 hour MaxBans is Awesome!
- Nobody will see the announcement that NewGuy101 was temp banned, just the fact he "has left the game."
If you want an in-depth analysis of each command, try here:
http://dev.bukkit.org/server-mods/maxbans/pages/command-tutorial/
Configuration Guide
http://dev.bukkit.org/server-mods/maxbans/pages/config-tutorial/
This is an in-depth guide on how to configure MaxBans :) If I've missed anything, ask in the comments!
Common Issues
http://dev.bukkit.org/server-mods/maxbans/pages/common-issues/
This is a list of common issues people have with MaxBans, such as plugin conflicts.
Features that will never implement
- Fines (Use your economy to do this!)
- Jails
- Regional bans
- Ban weightings
Ban Listing Webpage
Check out this guy's work for an amazing webpage setup to view MaxBans while using MySQL.
Demo (dont download from here): http://yive.me/maxbans/.
Its updated and is working on latest version of MaxBans!
You can download the updated version from here: https://github.com/FabioZumbi12/maxbans-php
- Added pagination;
- Fixed other ban pages not loading;
Metrics
This plugin uses Hidendra's plugin metrics system (http://mcstats.org/plugin/maxbans) which tracks server information including:
- A unique ID
- Java version
- Online/Offline mode
- Plugin & Server version
- OS name, version, architecture
- Number of CPU cores
- Players online
- Metrics version
These stats can be disabled using the PluginMetrics config file (BukkitServer/plugins/PluginMetrics/config.yml).
GeoIP Lookup
MaxBans will download a GeoIP.csv file, which allows it to look up the country of origin for IP addresses. The file is downloaded directly from maxmind GeopIP site. The file is only downloaded once (Unless it is renamed/removed).
FabioZumbi12:
Hello all. I am other dev and now i assuming the Project for bugfixes and possible improvements.
Netherfoam still busy but still online on comunity. I have a lot of time to code (i have a home work) and i can maintain this plugin (and my others) Always updated ;)
See ya o/




-
View User Profile
-
Send Message
Posted May 21, 2013It could be awesome if you made a mb vervsion for the update 1.2.5/for tekkit
-
View User Profile
-
Send Message
Posted May 18, 2013@netherfoam
Great! ... THANK YOU - THANK YOU - THANK YOU !!!
-
View User Profile
-
Send Message
Posted May 17, 2013@exclupl
@siemaeniu500
@IchCraft033
Half a day later, here you go. I hope you appreciate it. This has made a lot of my code very ugly to read and was very tedious to do.
Test link: https://dl.dropboxusercontent.com/u/72835893/Plugins/MaxBans.jar
I'm not uploading this to bukkit for a while, til I know its working. If you find any errors, tell me ASAP
-
View User Profile
-
Send Message
Posted May 15, 2013Please add the feature to change all messges. = Custom Messages ...It it there = BEST Ban-Plugin!
-
View User Profile
-
Send Message
Posted May 8, 2013Can u add posibility to translate messages ? Because i don't want to translate class files in each important version :)
-
View User Profile
-
Send Message
Posted May 7, 2013netherfoam, please, for the next version added a language file or edit config file. To edit all messages and their colors :)
-
View User Profile
-
Send Message
Posted May 7, 2013@arriej
You can't edit warnings, you can delete them and re-add them though if need be. You can warn offline players, and by default anyone may use /checkban on themselves, which reports all their active warnings.
-
View User Profile
-
Send Message
Posted May 7, 2013Hey a question before considering using it, Are you be able to edit warnings handed out? Delete warnings? and warn offline player, Can player see their own warnings?
Because i use this other plugin now ( witch i will not name) but he is not replaying to my ideas to add.
-
View User Profile
-
Send Message
Posted May 6, 2013@Chalkie19
My reason for writing documentation has been fulfilled!
-
View User Profile
-
Send Message
Posted May 6, 2013netherfoam is there a node to stop the join messages showing up?
^ Not so fun. I have no problems showing the IP since it's a proxy one.
Edit: Found it on the in-depth page, (maxbans.notify). Sorry.
-
View User Profile
-
Send Message
Posted Apr 29, 2013@MadeOke
Can you do /mbdebug file in chat, then send me the file Bukkit\plugins\MaxBans\debug.txt using privatepaste.com or dropbox or something, immediately after /warn'ing someone?
-
View User Profile
-
Send Message
Posted Apr 28, 2013@netherfoam
thanks.. but i have tried /warn <name> <message> but the player still have warnings :0
2013-04-29 14:22:00 [INFO] [Minecraft-Client] [CHAT] §fUser: §amadeoke
2013-04-29 14:22:00 [INFO] [Minecraft-Client] [CHAT] §fBanned: §aFalse
2013-04-29 14:22:00 [INFO] [Minecraft-Client] [CHAT] §fMuted: §aFalse
2013-04-29 14:22:00 [INFO] [Minecraft-Client] [CHAT] §fWarnings: §a(0)
2013-04-29 14:22:00 [INFO] [Minecraft-Client] [CHAT] §fWhitelisted: §aFalse
2013-04-29 14:22:00 [INFO] [Minecraft-Client] [CHAT]
-
View User Profile
-
Send Message
Posted Apr 28, 2013@MadeOke
/checkban lists warnings.
-
View User Profile
-
Send Message
Posted Apr 28, 2013please add check warn
-
View User Profile
-
Send Message
Posted Apr 25, 2013But could you make a list where we would put players that we dont want to get banned? smth like: players: name1 name2 . . .
And those players, that are in that list, cant get banned, kicked ...
-
View User Profile
-
Send Message
Posted Apr 25, 2013@siemaeniu500
Permissions systems aren't required to cache offline player permissions. In other words, the moment you're offline, you have no permissions... AKA, you can be banned by anyone.
-
View User Profile
-
Send Message
Posted Apr 25, 2013Can u write some reason why ? Just add ex. maxbans.ban.denyop
-
View User Profile
-
Send Message
Posted Apr 25, 2013@siemaeniu500
All permissions are maxbans.<commandName>, with the following exceptions:
Lockdown on/off: maxbans.lockdown.use
Lockdown bypass: maxbans.lockdown.bypass
Kick all (/kick *): maxbans.kick.*
Notification: maxbans.notify. This is for when the DNSBL discovers a proxy, or a banned player tries to join.
Check your own warnings/mutes: maxbans.checkban.self
See silent commands (Eg commands with -s in them): maxbans.seesilent
See broadcasts, such as kick messages of others: maxbans.seebroadcast
Also:
Features that I will NEVER implement
Ban weightings (If your mods are kicking/banning you, they should be demoted instead)
-
View User Profile
-
Send Message
Posted Apr 25, 2013Are there any permissions?
Becauste sometimes moderator banning (trolls) operator.
How i can block that ? That peoples with lower permissions can't kic/ban/warn players with higher permission.
-
View User Profile
-
Send Message
Posted Apr 21, 2013@siemaeniu500
I've elaborated on your issue in the FAQ, here: http://dev.bukkit.org/server-mods/maxbans/pages/common-issues/