Mjölnir

What is it?

This is a simple, yet powerful and expandable plugin that replaces Minecraft's native ban functionality.

It provides the following commands:

/infractions <player>
/ban <player> <reason>
/unban <player> <reason>
/tempban <player> <length> <reason>
/tempunban <player> <length> <reason>

Reason is always optional.

The infractions command is available to all players by default, and lists all events for the given player. The other four are pretty much self explanatory.

The commands require the following permissions, which are also self explanatory:

mjolnir.info
mjolnir.ban.temp
mjolnir.ban.perm
mjolnir.unban.temp
mjolnir.unban.perm

Extending

In addition to providing players and ops with new functionality, other plugins can also extend and use it. Simple include the jar in your project, and go! It exposes a lot of methods, and introduces two new events.

The first is IsBannedEvent. This is fired any time Mjölnir or another plugin invokes Mjolnir.isBanned() to see if a player is.. well.. banned, but only if Mjölnir doesn't see the player as banned in its local database first. You can insert your own data in the form of a Event (it.flaten.mjolnir.beans.Event) to change the outcome of the call.

The second is NewEventEvent, which is fired when a new Event (it.flaten.mjolnir.beans.Event) is about to be saved in the database. This happens when a player is banned or unbanned. A plugin can override the data in this event, or cancel it entirely.

See the Javadocs for more information.

Downloads

Development builds of this project can be acquired at the provided continuous integration server. These builds have not been approved by the BukkitDev staff. Use them at your own risk.

Latest snapshot

PS

The plugin and documentation is in development, and may contain bugs or be otherwise lacking. Please do submit tickets and pull requests on GitHub.