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 Nov 27, 2014Mutes are deleted on server reset, please could you save them? I have been using your plugin for around a year now :)
-
View User Profile
-
Send Message
Posted Nov 21, 2014@septini
It does support offline bans, you've typed the name incorrectly or it is matching a different name. You could alternatively use /checkip on the user and /ipban their ip address. For example, /ipban 127.0.0.1
@starg09
Hmm, I'm not actually sure what would cause that. Check your bungee server's log message, perhaps the kick message is too many characters long?
-
View User Profile
-
Send Message
Posted Nov 21, 2014@netherfoam
The thing is, that ipban does not support offline bans, http://prntscr.com/58ktwb .
-
View User Profile
-
Send Message
Posted Nov 20, 2014Hey there, big fan of your plugin! (Have been using it for over 2 years now, across different servers)
Anyway, I have a little problem. Recently I've started working with Bungee. I got everything working with all the Syncer system, but I have this little issue: When someone is kicked or banned, they won't get the corresponding message, but this one:
I'm 100% sure this is a bungeecord issue, and the message is sent correctly from the server (I see it being right on the live log). Also, once they're banned/tempbanned they get this message on trying to connect, so they don't know they're banned.
Do you have any ideas of how could I fix it so it gives the right message?
-
View User Profile
-
Send Message
Posted Nov 17, 2014@septini
Just use IPBan instead of ban, it's like two extra letters. I haven't coded IP mutes, though I plan on it.
@BlackAndWhite101
I really want to update it, but I'm lacking the time lately. I'm rewriting a new version from scratch, but have been struggling for time.
-
View User Profile
-
Send Message
Posted Nov 17, 2014Im just wondering but is this plugin still being updated?
-
View User Profile
-
Send Message
Posted Nov 17, 2014@netherfoam
But could you add a setting that would allow you to do that? Its not their fault that they'r cousins or siblings are cheating on the server, I understand that, but you have to understand aswell - gotta get dem cheaters out :D
-
View User Profile
-
Send Message
Posted Nov 16, 2014@Manic_Kaval
Strange, 0 should definitely make it stay forever.
-
View User Profile
-
Send Message
Posted Nov 16, 2014@septini
Just use ipban instead of ban if you want this feature. I do not recommend using this tactic, since most of my major players have friends and siblings who also play.
-
View User Profile
-
Send Message
Posted Nov 16, 2014Maxbans is awesome! but it would be more awesome and useful if you could add a feature so if someone bans someone, the banned player has banip automatiacly- so they just dont make a new account and play there..
-
View User Profile
-
Send Message
Posted Nov 15, 2014@Manic_Kaval
It seems that didn't work either, as now its expiring after a day.
-
View User Profile
-
Send Message
Posted Nov 11, 2014Great plugin, though I have a minor gripe and I figure I am doing something within the config incorrectly. I would like the history to stay indefinitely, rather than a week. Originally I had changed it to:
history-expirey-minutes: 0
Within the config in hopes that it would just stop any sort of expiration on the history, yet it reverted back to the default setting. I had just now changed it to three years (1577847 #156 week.) but if there is an option for never expiring that would be good to know.
-
View User Profile
-
Send Message
Posted Nov 10, 2014I love this plugin! Can you add the mute message to be editable in the next update? All it says when they are currently muted is 'You're Muted!' . It does not show the reason and how long the mute is.
Thank!
-
View User Profile
-
Send Message
Posted Nov 8, 2014This plugin works with my patched Spigot server. Thank you netherfoam for keeping it up to date. I haven't checked it out completely yet but the rangeban commands work and that is what I was looking for.
-
View User Profile
-
Send Message
Posted Nov 2, 2014@Christian2185
Everyone has permission for maxbans.seebroadcast, it is given out by default. Give anyone you don't want seeing the broadcast the negation of the node. Eg, specifically remove the permission from the players. In PermissionsEx this is done by adding a '-' prefix to the permission node, eg:
- -maxbans.seebroadcast
in a user's permission nodes will remove it.
TLDR; It is given by default to everyone.
-
View User Profile
-
Send Message
Posted Nov 1, 2014Hello, when a staff member bans someone, everyone on the server can see the broadcast. Only staff have the permission: maxbans.seebroadcast
Any Help?
-
View User Profile
-
Send Message
Posted Oct 22, 2014@floory565
The text is centered, your server title is not.
-
View User Profile
-
Send Message
Posted Oct 22, 2014@Kevdude0625
I don't run BungeeCord but I do use the plugin on two servers which then hook up into the same database so, it should work if the plugin is on all servers.
-
View User Profile
-
Send Message
Posted Oct 19, 2014Does this work for servers too? I have a BungeeCord network and when I ban someone will they be able to be globally banned? Or will I have to set that up in the config?
-
View User Profile
-
Send Message
Posted Oct 15, 2014Hi there! I have a problem with the messages displayed when someone is kicked/banned. The first line (under my server title) is never centred. :/ Any ideas?
In this image, "You were kicked" is not centred: http://i.imgur.com/Aq8Ebbo.png
In this image, "You are banned!" is not centred: http://i.imgur.com/v0r8F1U.png