netherfoam / MaxBans

The original MaxBans - A Bukkit plugin to manage account bans, mutes and punishments
12 stars 20 forks source link

MaxBans

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!

Dependencies are in lib/ folder, and also requires CraftBukkit or Spigot which are freely available online (Last compiled on Bukkit for Minecraft 1.6)

Databases

MySQL SQLite (Flatfile)

Best Features

Here are the top ten features of MaxBans over other banning plugins:

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

If you want an in-depth analysis of each command, try here: http://dev.bukkit.org/server-mods/maxbans/pages/command-tutorial/

Permissions

All permissions are maxbans., 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 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 at http://dev.bukkit.org/bukkit-plugins/maxbans/

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.

Check out this guy's work for an amazing webpage setup to view MaxBans while using MySQL. Link: http://yive.me/maxbans/. I haven't personally set it up, but the page looks quite sleek and well done!

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 approx. 1.7MB and is downloaded from http://maxgamer.org/plugins/maxbans/geoip.csv automatically on the first run. The file is only downloaded once (Unless it is renamed/removed).