Bukkit- & BungeeCord-Plugin at once
Check out our Spigot-Page for more information!
Coded by Leoko
AdvancedBan is an All-In-One Punishment-System with warns, tempwarns, mutes, tempmutes, bans, tempbans, ipbans and kicks. There is also a PlayerHistory so you can see the players past punishments and the plugin has configurable Time & Message-Layouts which automatically calculate and increase the Punishment-Time for certain reasons. AdvancedBan provides also a full Message-File so you can change and translate all messages & a detailed config-file with a lot of useful settings. This is a BungeeCord & Bukkit/Spigot-Plugin in one and it supports MySQL and Local-File-Storage.
To use the API just add the AdvancedBan.jar to your BuildPath and as a dependency in your Plugin.yml You can use this API in Bukkit/Spigot-Plugins but also in Bungee-Plugins. The API-Methods can be accessed trough PunishmentManager.get() Here are the currently available methods:
// Get AdvancedBan
AdvancedBan advancedBan = AdvancedBan.get();
//To get a PlayerUUID use:
advancedBan.getUuidManager().getUuid("NAME");
advancedBan.getPunishmentManager().getPunishments(checkExpired);
// Returns a list of active punishments
// checkExpired - If it should check for expired punishments & remove them | should be on true
advancedBan.getPunishmentManager().getPunishments(uuid, type, current);
// Returns a list of Punishments
// uuid - Players uuid | null = all players
// type - Type of the punishments PunishmentType-Enum | null = all types
// current - If only currently active punishments should be displayed | true = currently active | false = all
// Example:
advancedBan.getPunishmentManager().getPunishments(UUIDManager.get().getUUID("Leoko"), PunishmentType.WARNING, true);
// Would return all active Warnings for the player Leoko
advancedBan.getPunishmentManager().getBan(uuid);
// Returns a Punishment of the type Ban, IPBan or Tempban | returns null if player is not banned
advancedBan.getPunishmentManager().getMute(uuid);
// Returns a Punishment of the type Mute or Tempmute | returns null if player is not muted
advancedBan.getPunishmentManager().getMute(id);
// Returns a Punishment of the type Warn or Tempwarn | returns null if there is no warn with that id
advancedBan.getPunishmentManager().isBanned/isMuted(uuid);
// Returns whether a player is banned or muted
advancedBan.getPunishmentManager().getCurrentWarns(uuid);
// Returns the count of a players current warnings
// Create Punishment
Punishment punishment = new Punishment(idenifier, name, operator, calculation, start, end, type);
// identifier - The UUID or IP to be punished
// name - The users name
// operator - The one who banned | You can just use "CONSOLE"
// calculation - TimeLayout | Can just be set to null
// start - The current time | use TimeManager.getTime()
// end - The end of the punishment | -1 for perma or TimeManager.getTime() + millisecs for temp
// type - The Type of the Punishment from the PunishmentType-Enum
// Set reason
punishment.setReason(reason);
// reason - The punishment reason | Can be null or a layout like "#LayoutName" or a basic reason "Hacking in FFA"
// Add Punishment
advancedBan.getPunishmentManager().addPunishment(punishment);
// Change reason and update
punishment.setReason("New reason");
advancedBan.getPunishmentManager().updatePunishment(punishment);