MaxBans

Table of Contents

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/

Comments

netherfoam
- Location: Brisbane
- Join Date: 10/17/2008
- Posts: 1,093
- Member Details
#236 netherfoam

View User Profile

Send Message

Posted Apr 21, 2013
@Sie

1. Use /emute instead then, or remap using bukkit.yml's aliases section from mute to emute. Details here: http://wiki.bukkit.org/Bukkit.yml#aliases

2. You can't translate it without editing and compiling the sourcecode yourself. This might be possible in the future, but while I'm actively developing it, I refuse to add this feature as it makes the whole plugin messy and painful to code.

Rollback Post to Revision RollBack
_ForgeUser8775913
- Join Date: 4/21/2012
- Posts: 421
- Member Details
#235 _ForgeUser8775913

View User Profile

Send Message

Posted Apr 21, 2013
1. How i can off using mute/tempmute in this plugin ? Because i want to use that function in essentials?

2. How i can translate each message to my own language ?

Last edited by _ForgeUser8775913: Apr 21, 2013

Rollback Post to Revision RollBack
netherfoam
- Location: Brisbane
- Join Date: 10/17/2008
- Posts: 1,093
- Member Details
#234 netherfoam

View User Profile

Send Message

Posted Apr 21, 2013
@gaz1812

It broadcasts most actions (It doesn't currently broadcast announcements, though) as long as you have Syncing set up properly in the config (Including allowing ports on firewalls if your servers aren't on the same box)

The options you are looking at are the config settings in config.yml of the plugin, you need to look at all of them to set up syncing properly.

There is possibly an issue with cross-server kicking at the moment, it will be fixed in the next version I upload (But it's fairly minor, so it shouldn't bother you)

Rollback Post to Revision RollBack
_ForgeUser9260056
- Join Date: 7/20/2012
- Posts: 68
- Member Details
#233 _ForgeUser9260056

View User Profile

Send Message

Posted Apr 21, 2013
If I get this plugin will it broadcast both bans on my 2 servers? I have a factions and a survival server. I looked at your ban syncing page however which option should I choose to use?

sync.use This config option enables/disables Syncing totally. If this is false, Syncing will not occur, at all.
sync.server If this option is true, then this server is the SyncServer. If it is false, then it is a regular Syncer.
sync.host This defines the IP of the host. If Sync.Server is true, then this should be 127.0.0.1, or localhost. Otherwise, this is the IP of the SyncServer (the server with sync.server: true in its config)
sync.port The port for the syncer to connect using, or the SyncServer to be hosted on, if running in server mode.
sync.pass The password required to connect to the SyncServer.

Will the plugin broadcast who was banned/kicked/muted across my servers? I am pretty sure it does that right?

Thanks.
Last edited by _ForgeUser9260056: Apr 21, 2013

Rollback Post to Revision RollBack
netherfoam
- Location: Brisbane
- Join Date: 10/17/2008
- Posts: 1,093
- Member Details
#232 netherfoam

View User Profile

Send Message

Posted Apr 20, 2013
@ThisUsernameIsMine

Well, I'm glad to hear that! Next I'd like to know exactly what I changed that caused a difference lol. The database was changed, but in theory it should stay pretty much the same speed :|

Rollback Post to Revision RollBack
_ForgeUser8075891
- Join Date: 12/14/2011
- Posts: 2,145
- Member Details
#231 _ForgeUser8075891

View User Profile

Send Message

Posted Apr 20, 2013
netherfoam: Remember when i said that i would stop using MaxBans because of the massive delay on server stop? Well.. 1.6 seems to have solved the problem :)

I can finally enjoy your mod and i'm grateful for that! ^_^ (what was the catch?)

Thanks a lot bro(fist)! +1 :D

Last edited by _ForgeUser8075891: Apr 20, 2013

Rollback Post to Revision RollBack
netherfoam
- Location: Brisbane
- Join Date: 10/17/2008
- Posts: 1,093
- Member Details
#230 netherfoam

View User Profile

Send Message

Posted Apr 18, 2013
@CoderTristan12

Ahahahaha no. That would be an excellent tool for anyone that gained access to your server or a mods account and decided they didn't like it.

Rollback Post to Revision RollBack
_ForgeUser10876563
- Join Date: 3/31/2013
- Posts: 16
- Member Details
#229 _ForgeUser10876563

View User Profile

Send Message

Posted Apr 18, 2013
Can you add a /banall So you can ban all player on the server online and offline
ThanksComme on this server: 88.191.237.170:25629

Rollback Post to Revision RollBack
_ForgeUser10141173
- Join Date: 12/1/2012
- Posts: 15
- Member Details
#228 _ForgeUser10141173

View User Profile

Send Message

Posted Apr 18, 2013
Please, for the next version added a language file. To edit all messages and their colors. Suggestion .. Regards

Last edited by _ForgeUser10141173: Apr 19, 2013

Rollback Post to Revision RollBack
netherfoam
- Location: Brisbane
- Join Date: 10/17/2008
- Posts: 1,093
- Member Details
#227 netherfoam

View User Profile

Send Message

Posted Apr 15, 2013
@Chalkie19

Yup ofcourse, I know what I did wrong there and I dont even need to look at the source... Its because youre looking up an IP with no users I believe. I shpuld have it fixed in the next version

Rollback Post to Revision RollBack

_ForgeUser9265782

Join Date: 7/21/2012
Posts: 307
Member Details

#226 Posted Apr 15, 2013

Whilst trying to do /checkip or /dupeip. I get the following error. (Version 1.6)
Command works fine with a name (/dupeip Chalkie) not with IP's (/dupeip 123.123.123.123)

2013-04-15 04:44:27 [INFO] so2ro lost connection: disconnect.quitting
2013-04-15 04:44:27 [SEVERE] java.lang.NullPointerException
2013-04-15 04:44:27 [SEVERE] 	at java.util.HashSet.<init>(HashSet.java:116)
2013-04-15 04:44:27 [SEVERE] 	at org.maxgamer.maxbans.banmanager.BanManager.getUsers(BanManager.java:586)
2013-04-15 04:44:27 [SEVERE] 	at org.maxgamer.maxbans.commands.CheckIPCommand.run(CheckIPCommand.java:57)
2013-04-15 04:44:27 [SEVERE] 	at org.maxgamer.maxbans.commands.CmdSkeleton.onCommand(CmdSkeleton.java:107)
2013-04-15 04:44:27 [SEVERE] 	at org.bukkit.command.PluginCommand.execute(PluginCommand.java:44)
2013-04-15 04:44:27 [SEVERE] 	at org.bukkit.command.SimpleCommandMap.dispatch(SimpleCommandMap.java:189)
2013-04-15 04:44:27 [SEVERE] 	at org.bukkit.craftbukkit.v1_5_R2.CraftServer.dispatchCommand(CraftServer.java:546)
2013-04-15 04:44:27 [SEVERE] 	at net.minecraft.server.v1_5_R2.PlayerConnection.handleCommand(PlayerConnection.java:980)
2013-04-15 04:44:27 [SEVERE] 	at net.minecraft.server.v1_5_R2.PlayerConnection.chat(PlayerConnection.java:896)
2013-04-15 04:44:27 [SEVERE] 	at net.minecraft.server.v1_5_R2.PlayerConnection.a(PlayerConnection.java:841)
2013-04-15 04:44:27 [SEVERE] 	at net.minecraft.server.v1_5_R2.Packet3Chat.handle(Packet3Chat.java:44)
2013-04-15 04:44:27 [SEVERE] 	at org.spigotmc.netty.NettyNetworkManager.b(NettyNetworkManager.java:176)
2013-04-15 04:44:27 [SEVERE] 	at net.minecraft.server.v1_5_R2.PlayerConnection.d(PlayerConnection.java:110)
2013-04-15 04:44:27 [SEVERE] 	at net.minecraft.server.v1_5_R2.ServerConnection.b(SourceFile:35)
2013-04-15 04:44:27 [SEVERE] 	at org.spigotmc.netty.NettyServerConnection.b(NettyServerConnection.java:66)
2013-04-15 04:44:27 [SEVERE] 	at net.minecraft.server.v1_5_R2.MinecraftServer.r(MinecraftServer.java:582)
2013-04-15 04:44:27 [SEVERE] 	at net.minecraft.server.v1_5_R2.DedicatedServer.r(DedicatedServer.java:229)
2013-04-15 04:44:27 [SEVERE] 	at net.minecraft.server.v1_5_R2.MinecraftServer.q(MinecraftServer.java:471)
2013-04-15 04:44:27 [SEVERE] 	at net.minecraft.server.v1_5_R2.MinecraftServer.run(MinecraftServer.java:403)
2013-04-15 04:44:27 [SEVERE] 	at net.minecraft.server.v1_5_R2.ThreadServerApplication.run(SourceFile:573)

Last edited by _ForgeUser9265782: Apr 15, 2013

netherfoam
- Location: Brisbane
- Join Date: 10/17/2008
- Posts: 1,093
- Member Details
#225 netherfoam

View User Profile

Send Message

Posted Apr 13, 2013
@Chalkie19

There isn't one, can't do it because of offline permissions AFAIK either.But the change would be minimal.

Rollback Post to Revision RollBack
_ForgeUser9265782
- Join Date: 7/21/2012
- Posts: 307
- Member Details
#224 _ForgeUser9265782

View User Profile

Send Message

Posted Apr 12, 2013
@netherfoam

Is there a permission node to bypass being added to the history? Might be able to reduce the amount if staff are not logged and only the players.

Rollback Post to Revision RollBack
netherfoam
- Location: Brisbane
- Join Date: 10/17/2008
- Posts: 1,093
- Member Details
#223 netherfoam

View User Profile

Send Message

Posted Apr 12, 2013
@Chalkie19

Uh, I believe (2^31)/(60000) is the max number you can have, but honestly, a year (524,160) would do you fine I think. It only purges history on boot. Even ten years would work, but remember that it stores every action done by MaxBans, so you could end up with a ..rather large... ban database. (Not such an issue on MySQL, possibly an issue on SQLite)

I handle expiring bans smartly. When the server boots, it deletes any expired bans. When the "BanManager" is asked "Give me X's ban", it checks if it has expired first. If it is expired, it deletes it, and says "Nope, no bans here". This means nothing has to constantly check "Has it expired yet? Has it expired yet? Has it expired yet?". But I don't think history even does that because I'm lazy.. only does it on boot.

Rollback Post to Revision RollBack
_ForgeUser9265782
- Join Date: 7/21/2012
- Posts: 307
- Member Details
#222 _ForgeUser9265782

View User Profile

Send Message

Posted Apr 12, 2013
@netherfoam

I prefer to believe you hacked my server to add it :)
Is there a limit to how many 9's I can add? Also would a long number effect the plugin at all? Or is it just a check on boot? Id hate for it to have to check every x minutes for if it's been 137 years pr w/e yet.

Rollback Post to Revision RollBack
netherfoam
- Location: Brisbane
- Join Date: 10/17/2008
- Posts: 1,093
- Member Details
#221 netherfoam

View User Profile

Send Message

Posted Apr 12, 2013
@Chalkie19

Would you believe me if I said I actually wrote this feature, but forgot to add it to the config file? -_-

Just add this line:

history-expirey-minutes: 9999999

Or something to that effect, to your config.yml. Setting it to 0 will just make history expire everything on reboot.

Rollback Post to Revision RollBack
_ForgeUser9265782
- Join Date: 7/21/2012
- Posts: 307
- Member Details
#220 _ForgeUser9265782

View User Profile

Send Message

Posted Apr 12, 2013
@netherfoam

Yea a week is not long enough. If someone is re-banned within a week they more then likely should not be playing. We have kinda a 3 strikes and your out policy on small things (Like small griefs, spamming ect). Didn't even tell my staff about the command because I felt that a week was way to short.

The results should be fine at 15 still.

Last edited by _ForgeUser9265782: Apr 12, 2013

Rollback Post to Revision RollBack
netherfoam
- Location: Brisbane
- Join Date: 10/17/2008
- Posts: 1,093
- Member Details
#219 netherfoam

View User Profile

Send Message

Posted Apr 11, 2013
@Chalkie

So that would seem a bit awkward to add into the plugin, how about increasing the lifespan of /history? As it stands, you can do /history Chalkie to see all bans given to or given by Chalkie. If you want more than 15 results, you can append the number, eg /history Chalkie 50.

Currently though, it only lasts for a week and I dont think it is configurable. After that, the history 'expires' and is removed on reboot

Last edited by netherfoam: Apr 11, 2013

Rollback Post to Revision RollBack
_ForgeUser9265782
- Join Date: 7/21/2012
- Posts: 307
- Member Details
#218 _ForgeUser9265782

View User Profile

Send Message

Posted Apr 11, 2013
Hi...
I kinda have maybe another request -_-. This one "should" be simple, maybe in the check ban display it show how many times that player has had the /ban /tempban ect command used against them.

Temp Banned: 1
Banned: 3

I feel this would be handy for servers that have a large ban/appeal rate to keep track of multiple offenders. The reasons why they were banned would not be needed I feel since if you really needed to know you could track it down on the forums.

Just a thought :)

Rollback Post to Revision RollBack
DAZ1337
- Location: New York
- Join Date: 8/31/2011
- Posts: 652
- Member Details
#217 DAZ1337

View User Profile

Send Message

Posted Apr 11, 2013
@netherfoam

Thanks a lot, keep up the good work with your plugins.

I am taking General Studies in college, but I would like to do web design and coding for computers. What class would you prefer? I mostly want to do game design, modeling, scripts, all that stuff.

Rollback Post to Revision RollBack
To post a comment, please login or register a new account.

Project ID

48948
Created

Dec 25, 2012
Last Released File

May 18, 2017
Total Downloads

399,402
License

GNU General Public License ver...

Bukkit

MaxBans

Bukkit Plugins

MaxBans

Table of Contents

Databases

Best Features

Commands

Configuration Guide

Common Issues

Features that will never implement

Ban Listing Webpage

Metrics

GeoIP Lookup

Comments

About This Project

Categories

Members

Recent Files

Bukkit