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 Mar 3, 2023Great plugin! I love it's configuration and unique features. I do wish they would add more support for automoderation (i.e automatic ban/tempban after x kicks)
-
View User Profile
-
Send Message
Posted Dec 30, 2020When i tempban someone it doesnt ban it shows text that it should when banning but when you try to join back, it allows person to join back. so it works like kick, why ?. and when you try ban him again it says he is already banned. and i can unban him while he is in game. ????
-
View User Profile
-
Send Message
Posted Aug 28, 2020I am having an issue where it doesn't show all of the banned players when I do the command in game anyone know a fix?
-
View User Profile
-
Send Message
Posted Jun 11, 2020QUERIA SABER COMO PONHO O PLUGIN PARA BURGECORD ALGUEM ME EXPLICA ?
-
View User Profile
-
Send Message
Posted Mar 7, 2020I have a question, I use bungee cord and whenever I ban myself it shows up the ban message when I rejoin it says can't connect because I configured msgs in bungee and when I go onto the kitpvp server I ban myself I can still join the lobby, so is it a global banning system and why does the message change whenever I rejoin. so first it says the ban message then failed to connect please help.
-
View User Profile
-
Send Message
Posted Feb 8, 2020so does it auto ban people i could check but i don't feel like downloading a hack client right now
-
View User Profile
-
Send Message
Posted Feb 16, 2020In reply to frankenbabananna:
its not an anticheat
-
View User Profile
-
Send Message
Posted Feb 18, 2020In reply to Forge_User_41059799:
oh ok it is good tho with what it can do
-
View User Profile
-
Send Message
Posted Jul 31, 2020In reply to frankenbabananna:
stupid
-
View User Profile
-
Send Message
Posted Jan 28, 2020its nice but i cant give any permission for everyone
-
View User Profile
-
Send Message
Posted Jan 7, 2020Does anyone know of a support discord for this plugin? need some help with setting up the web page. Or a good youtube video explaining how to set it up.
-
View User Profile
-
Send Message
Posted Nov 10, 2019How can I add the appeal URL to the ban message?
-
View User Profile
-
Send Message
Posted Jan 13, 2019I have a problem, when i execute the command /tempban {player} 8 day [-s] {reason} then i can only ban the player for 1 week, i dont know how to fix it...
-
View User Profile
-
Send Message
Posted Sep 27, 2019In reply to Forge_User_59416133:
Go into your maxbans config file and change maxtempbantime to a bigger number into seconds
-
View User Profile
-
Send Message
Posted Oct 1, 2019In reply to YoutubeJT_Playz:
Ok, thank you very much
-
View User Profile
-
Send Message
Posted Oct 1, 2019In reply to Forge_User_59416133:
no problems =D
-
View User Profile
-
Send Message
Posted Oct 2, 2018I have a problem, when I say /tempban (player) 14 days Griefing it bans him only for 10minutes 5seconds, please help me, or fix it
-
View User Profile
-
Send Message
Posted Oct 4, 2018In reply to Forge_User_38162242:
-
View User Profile
-
Send Message
Posted Jul 13, 2019In reply to netherfoam:
sounds like propaganda...
-
View User Profile
-
Send Message
Posted Aug 30, 2019In reply to mrfrothbite:
I mean you go also use a way better plugin called LiteBans. It's a paid plugin but it works wonderful. :)